> Source: https://ashareapi.com/changelog/  ·  Markdown version for LLMs / AI agents

产品在维护

# 更新日志
 记录功能变更、新增端点、修复。也说明我们如何对待破坏性变更。

 变更政策
 加新端点 不另行收费（按调用次数计，端点数不影响价格）
 改返回结构 会提前公告；字段只增不删（除非有明确缺陷）
 下线功能 提前 30 天公告
 Bug 修复 直接上线，记在本页

 `2026-10-31` 上线 选股员（scanner Agent）上线，新增 /v1/scanner 与 MCP 工具

- · 新增 `GET /v1/scanner`：自然语言条件 → 只读工具 → 候选池 + 引用 + 工具轨迹。

- · MCP 新增 `ashare_scanner` 工具，Claude Code / Cursor / Codex 等客户端可直接调用。

- · **BYOK**：除 ashareapi Key 外，还需 `X-LLM-Key`（远程 MCP 用 `ASHARE_LLM_KEY` 环境变量）；模型 token 由客户自己付。

- · scanner 额度独立：99 专业版 2,000 次（生命周期），199 机构版 10,000 次/月；不占数据 API 的 500k 总池。

- · 只有 `ok:true` 且返回非空选股结果才扣次数；失败 / 空结果退回。

- · ⚠️ 暂不支持流式；不构成投资建议，不自动交易。

 `2026-10-31` 教程 新增 Personal Agent 汇总页与 Today / Grok Bot / Muse / Dots / Duet 五个接入教程

- · 汇总页：`/docs/guides/personal-agent` —— 统一说明 Personal Agent 是什么、哪些支持 MCP、各自入口和账号边界。

- · 统一接入地址：`https://api.ashareapi.com/mcp`，认证为 `Authorization: Bearer `。

- · Today：设置 → 连接应用 → 添加自定义 MCP → 通过链接添加 → Bearer Token（已验证）。

- · Grok Bot：Connect apps 添加远程 MCP，填 URL 和 Bearer Header；团队版受 Cursor connector policy 控制。

- · Muse：Settings → Connectors 创建 Custom Connector。Dots：先在用户自己的 ChatGPT connectors/plugins 添加 MCP。Duet：先在用户自己的 Claude connectors 添加 MCP。

- · 账号和套餐由用户自己准备；我们只提供 MCP 服务、Key 和教程，不提供 Today/ChatGPT/Claude/Grok/Muse 账号。

 `2026-10-30` 修复 修复数据缺失与过滤逻辑，新增逐只标注 / 风险标记 / 宏观历史条数

- · 补入 2026-10-29 全市场日线 5,569 只：`/v1/market-kline` 与 `/v1/kline-full` 的当日数据已恢复。当日数据滞后时会自动补数并重试，补不上会明确报未同步，不会再整天缺失。

- · `/v1/market-kline` 的 `codes` 过滤改到分页**之前** —— 此前 `codes=sh600519&limit=1` 会先取代码最小的那只再过滤，导致指定标的返回空。现在先过滤再分页，且 `600519` 与 `sh600519` 等价。

- · `/v1/market-kline` 传 `codes` 时新增 `requested` / `returned` / `missing`：逐只说明哪些没取到、为什么（`not_covered` = 不在本端点覆盖范围；`no_data` = 当日无行情）。分页截断时标 `partial:true` —— 未出现在本页**不等于**没有数据。

- · `/v1/macro` 新增 `limit`（默认 12，上限 120）：此前固定只返回 3 条。取多年 LPR / CPI / PPI 走势请传 `limit=60`（实测 LPR 可得 58 条）。

- · `/v1/screen` 结果新增 `风险标记` 列（`-` / `ST` / `退市整理`），程序化读取另带 `isST` / `isDelisting` / `status`，五个模式全部生效。**只标记不过滤** —— 排不排由你决定，回测可复现。

- · ⚠️ 9 个批量端点：一只都没取到时外层返回 `ok:false`（此前恒为 `ok:true`）。部分成功仍为 `ok:true`，逐条 `ok` / `error` 字段不变。**如果你的代码只看外层 ok 判断整批成功，请改为同时看 returned 。**

- · 数据源限流时，批量分项 `error` 明确写「数据源限流，请稍后重试（约 60 秒）」，不再混成「停牌 / 代码无效」。

- · 参数取值不被接受时（如 `screen` 的 `type` 填了不存在的值）返回 `ok:false` + `reason:"invalid_param"` + `hint`（含数据源原话与正确取值入口 `?mode=xxx&list=true`），并退还本次次数。

- · ⚠️ `/v1/consensus` 的 `institutionCnt` 改为 `null`：该列在数据源本身没有有效值，此前恒为 `0` 会被误读成「零家机构覆盖」。请勿再用它判断机构覆盖度，`targetPrice` 与各年度预测不受影响。

- · `/v1/finance` 补充银行报表口径：商业银行不提供 `TotalAssets` —— 总资产用 `TotalLiability + TotalShareholderEquity`，资产负债率直接用 `DebtAssetsRatio`，不要用「流动资产 + 非流动资产」推导。

 `2026-10-29` 教程 新增 Qoder / Trae / WorkBuddy 三个平台接入教程

- · Qoder：改 `~/.qoder-cn/mcp.json` 填 URL 与 headers 即可，支持自定义请求头、保存后自动重连；界面手工添加只有名称和服务地址，填不了 Key —— 要用付费工具请走配置文件。

- · Trae：设置 → MCP → 手动添加，粘贴一段 JSON；官方 HTTP 配置本身带 `headers` 字段，也支持项目级 `.trae/mcp.json`（需打开「启用项目级 MCP」开关）。

- · WorkBuddy：左侧「专家·技能·连接器」→「连接器」→「自定义连接器」→「添加 MCP」，保存后到连接器管理页点一次「**信任**」才生效。

- · 三个平台都支持自定义请求头，付费工具可正常使用；国内平台总览同步更新为 9 家。

 `2026-10-28` 上线 选股员（scanner Agent）上线：`ashare/scanner@deepseek-flash`

- · 专业版（¥99）起可用。模型根据问题选择只读工具（涨停池 / 炸板池 / screen / quote / 市场总览），参数由校验层检查。

- · 支持首板+资金、炸板+资金、因子、标签、排行、策略、事件；响应带 `x_citations` 与 `x_tool_trace`。

- · ⚠️ 只做条件选股，不做涨跌预测或买卖建议；工具失败可降级；投研 Agent Team 仍在规划中，开放方式另行公告。

 `2026-10-27` 上线 OpenAI 兼容端点上线：`/v1/chat/completions` + `/v1/responses`

- · `base_url` 设为 `https://api.ashareapi.com/v1`，`apiKey` 写成 `ct-xxx:sk-yyy`（前半我们的 key，后半你的模型 key）—— OpenAI SDK / Cherry Studio / ChatBox / OpenWebUI 可直接用。

- · `model` 支持 `ashare/deepseek-flash` / `gpt-5.6-luna` / `claude-*` 等；`stream=true` 为流式 SSE，`stream=false` 返回完整 JSON。

- · ⚠️ 首版忽略 `tools`；Responses 不支持服务端会话 `previous_response_id`。档位：专业版（¥99）起。

- · `/v1/models` 也上线：返回真实可用的 `deepseek-flash` / `gpt-5.6-luna` / `claude-*` 清单。

 `2026-10-27` 上线 Anthropic Messages 协议上线：`/v1/messages`

- · 给 Claude Code / Anthropic SDK 的 Messages 协议接入点：`x-api-key` 写成 `ct-xxx:sk-ant-yyy`（前半我们的 key，后半你的 Anthropic key）；也兼容 `Authorization: Bearer ct-xxx` + `x-api-key: sk-ant-yyy`。

- · `max_tokens` 必填；支持 SSE（流式：上游 token 边生成边转发；`stream=false` 返回完整 message）；`claude-*` + `sk-ant-...` 走 Anthropic，`deepseek-*` / `claude-*` + `sk-...` 走 DeepSeek。

- · ⚠️ 首版忽略 `tools`（普通聊天可用；Claude Code 的文件/终端工具用不了）；要 OpenAI 协议用 `/v1/chat/completions` / `/v1/responses`。档位：专业版（¥99）起。

 `2026-10-27` 数据 `/v1/fund-flow` 支持沪深历史区间（`start` / `end`）

- · 传 `start` + `end`（YYYY-MM-DD，单代码）⇒ 返回该区间逐日资金流；不传 ⇒ 仍只返最新交易日一行。

- · 历史区间仅支持沪深（`sh*` / `sz*`）；港股只取最新。⚠️ **美股没有资金流数据**（任何档位都返回空），美股资金面请用 `/v1/fund-short`（卖空）。金额单位元，原值返回。

- · 区间与「最新一行」可能因上游口径有细微差异 ⇒ 同一请求只用同一通道，不要和 `/v1/fund` 的 5/10/20 日累计混算。

 `2026-10-26` 新端点 `/v1/auction` 新增 `is_limit_down` —— 竞价触及跌停判定

- · 与既有的 `is_limit_up`（竞价触及涨停）**完全对称**：`is_limit_down` = 竞价段最低价 ≤ 跌停价，返回在顶层 `meta`，`mode=stock` 与 `mode=stock-history` 都有。

- · 跌停价取自行情源原始字段（非我们推算）⇒ 主板 10% / 创业板科创 20% / ST 5% / 北交所 30% 的差异自动正确，不需要自己套公式。

- · `meta` 同时给出 `lprice` 竞价段最低价（`stock-history` 由秒级逐笔归算），判定结果可以直接自己复核。

- · 判据只回答「竞价段有没有到过跌停价」，不判断是否封死，也不预测开盘后走势。

 `2026-10-26` 上线 MCP 支持用 URL 参数传 Key（`?key=`）

- · 给「填不了自定义请求头」的客户端用：`https://api.ashareapi.com/mcp?key=你的KEY` 直接可用，典型场景是 ChatGPT 网页版的自定义 connector。

- · 工具范围、额度、限流、计费与 `Authorization: Bearer` 方式**完全一致** —— 同一个 Key、同一套额度，不额外消耗。

- · 两种都填时以请求头为准。生产环境仍建议用请求头：Key 不进 URL，更不容易泄漏。

 `2026-10-25` 新端点 新增 /v1/stocks：一次拿全 A 股清单

- · 一次调用返回**当前在册的全部 A 股**（约 5576 只）：代码、名称、市场、上市日期、行业、板块、发行价、注册资本 —— 可直接入库当标的池。

- · 与 `/v1/search` 的分工：search 必须给关键词、一次查单只；本端点**不需要关键词**，直接给全量清单。

- · 支持 `market=sh|sz|bj`、`industry=食品饮料` 过滤，`limit`/`offset` 分页。全量响应约 1 MB，建议初始化时拉一次、之后按需增量。

- · 口径是**当前在册**：已退市的不在清单里；新股在调用时自动补入，不需要等我们更新。

- · 档位：体验版（¥9.9）起可用。

 `2026-10-24` 调整 ¥199 档更名为「机构版」

- · 原「不限量版」更名为**机构版**。这一档的定位是 **L2 微观结构数据**（大单 / 席位 / 全市场资金榜），不是一个"次数套餐"。

- · **权益完全不变**：调用不限量、50 个 IP、90 个端点全开、重型请求独立配额。已购用户无需换 Key，也不需要重新开通。

- · 为什么改名：这一层在券商终端里叫「Level-2 增强」，通常按机构版单独收费 —— 名字应该说明它**是什么**，而不是说它**有多少次**。

 `2026-10-24` 新端点 新增 6 个短线情绪与机构视角端点

- · **/v1/market-mood 市场情绪**：破板率，以及最近 9 个交易日的成功率与盈利概率，用来判断短线情绪冷热。

- · **/v1/limit-reason 涨停原因**：单只票每一次涨停的完整原因文案，附所属板块与当日「日内龙几」。

- · **/v1/broken-board 炸板历史**：某日涨停被砸开的个股清单，附题材标签。与涨停池对照即可看出当天封板质量。

- · **/v1/tail-chase 尾盘抢筹**：全市场约 292 只，附抢筹金额、题材与涨幅。部分标的受数据源限制不显示代码与名称（`masked` 标记），金额完整。

- · **/v1/northbound A 股北向分板块持仓**：按季度公布，含区间净额与总持仓。传季度末日期（如 `2026-09-30`）即可查询。

- · **/v1/new-high 百日新高**：按题材汇总的新高家数，新高集中的题材就是资金正在做的主线。

- · 以上 6 个端点均为机构版（¥199）专属。

 `2026-10-24` 新端点 新增**龙虎榜机构参与个股榜** `/v1/lhb-agency`（不限量版）

- · **/v1/lhb-agency 龙虎榜机构参与个股榜**：某个交易日**机构席位在龙虎榜上参与过的全部个股**，一次拿完 —— 实测单日 **51 只**。回答的是「**今天机构买了哪些票**」（全市场往上筛），而「这只票是谁买的」（单票往下看营业部）请用 `/v1/lhb-seats`。

- · **net_buy 是机构净买入额（元）**：买入 − 卖出，**可为负** —— 实测 51 只里 **26 只为负**（= 机构净卖出）。负值不要取绝对值当买入额。

- · **一行还给**：参与机构家数 `join_num`、涨幅、振幅、换手率、流通市值、总市值、所属风口板块代码。

- · ⚠️ 龙虎榜是**盘后数据**：`date` 留空 = 数据源最近交易日，**以返回的 date 为准**。

- · **参数**：`date`（YYYY-MM-DD）· `sort`（净买入 / 参与机构数 / 涨幅 / 换手 等）· `limit`。

 `2026-10-24` 数据 量化能力统一归入专业版

- · 量化回测、量化因子库（88 因子）、量化策略清单（29 条）、量化方法论库（25 条）、因子选股，统一归入 **专业版（¥99）**

- · **已购标准版的用户权益不变** —— 上述能力在**本次购买的额度内继续可用（用完为止，不设到期日）**，限速与额度按原档位

- · 标准版（¥29.9）保留全部数据端点 + 35 字段快照 + 全历史 K 线；新增公告 · 新闻 · 涨停 · 停复牌 · 回购 · 披露日历

- · ⚠️ 2026-10-24 起新购标准版按新档位；需要量化能力请选专业版

 `2026-10-23` 新端点 新增**股票评分**与**卖方研报**两个端点

- · **/v1/score 股票评分**（专业版起 · 仅 A 股）：基本面 / 技术 / 综合 / 资金 / 风险**五维评分**，每维带周 / 月 / 季变动。实测 `sh600519` 综合 **79.73**、基本面 85.66、技术 72.74、资金 78.75、风险 82.56；`codes` 支持逗号多只对比。

- · ⭐ **返回值已结构化**：每维是 `{value, chg_week, chg_month, chg_quarter}` —— **不需要自己解析字符串**（上游原文是 `85.66 (周↓-1.13 月↓-0.84 季↑+85.66)` 这种混排文本）。⚠️ `chg_quarter` 是**本季累计**（评分每季重置，通常等于 `value`），不是 0。

- · **/v1/report 卖方研报**（专业版起 · A 股 / 港股）：不传 `id` 给**列表**（标题 / 机构 / 投资评级 / 类型 / 时间）；传 `id` 给**研报全文**（Markdown，实测腾讯研报全文 2254 字，含财务点评）。

- · ⚠️ **研报列表单次最多 20 条**（`limit` 传更大值会 422），翻页用 `offset`；上游文案「共 9999 条」是**历史总数**，不是一次返回量。**没有时间范围参数**，按时间找只能翻页。

- · ⚠️ **/v1/score 仅 A 股**（港股 / 美股 422）；`date` 可查历史评分，但**最早只能回到 2026-04 下旬**（更早为空，不是故障）。

- · **档位**：评分与研报均为 **专业版（¥99）** —— 两者同属「观点型 / 内容型」高价值数据（评分与 rating / consensus 同族，研报是券商观点 + 全文），故不向标准版开放。

 `2026-10-23` 新端点 美股上线：**16 个入口**＋三大指数可查（标普代码 `usINX`）

- · **美股现在有 16 个入口**：行情 / K 线 / 分时 / 技术指标 / 财务三表 / 分红 / 公司简况 / **机构评级** / 财报披露日 / 停复牌 / 新股 / 搜索 / 新闻 / 公告 / **卖空** / **美股选股**。

- · ⭐ **美股三大指数可直接查**（`/v1/quote` 与 `/v1/kline`）：道指 **usDJI** 52,867.98 · 纳指 **usIXIC** 26,008.86 · 标普 500 **usINX** 7,663.43（2026-10-23 实测）。⚠️ 指数只有 `day` 线，没有分钟线。

- · ⚠️ **标普 500 的代码是 usINX ，不是 usSPX** —— `usSPX` / `usGSPC` / `usSPX500` 都查不到，这是最常踩的坑。

- · **/v1/fund-short 覆盖美股卖空**：实测 `usAAPL` 2026-09-30 卖空比率 **0.83%**、回补天数 **2.82**、卖空股数 **1.21 亿**。⚠️ **必须传 date**，否则只返回标识字段。

- · **美股选股可用**：`/v1/screen?market=us`，但表达式字段必须是 **PeTTM**（大小写敏感，写成 `PE_TTM` 会失败）。

- · **/v1/kline 的描述更正**：此前写「港股 / 美股不支持日期范围」，实际是**不提供**（同一标的在不同通道复权口径不同，带范围会给出不同价格口径）—— 原因已写明，请用 `count` 取最近 N 条。

- · ⚠️ **美股没有**（数据覆盖边界）：股东明细 / 事件日历 / 公司回购 / 一致预期 / 个股资金流 / 指数成分股 / 筹码 / 板块 / 龙虎榜 / 两融。美股目标价与预测请用 `/v1/rating`。

 `2026-10-23` 新端点 港股能力补全：**22 个入口**（新增 10 个端点）

- · **港股现在有 22 个可用入口**（命令级 18 + 子命令级 4）：行情 / 技术 / 财务 / 股东 / 分红 / 简况 / 新闻公告 / 日历 / 新股 / 搜索 / 回购 / 一致预期 / 停复牌 / 披露日历 / 机构评级 + 个股资金流 / 卖空 / 南下持仓 / 指数清单。

- · **新增 10 个端点**：`/v1/suspension` 停复牌（沪深/港股/美股）· `/v1/buyback` 公司回购 · `/v1/consensus` 一致预期（目标价+盈利预测）· `/v1/rating` 机构评级（**港股/美股专属**，实测 `hk00700` 目标价均值 **732.68**、覆盖 49 家）· `/v1/disclosure` 财报披露日历 · `/v1/fund-flow` 个股资金流（A股/港股）· `/v1/fund-short` 卖空（港美股）· `/v1/fund-south` 南下资金持仓（港股通季度，实测腾讯占比 **12.03%**）· `/v1/index-list` 指数清单（**1223 个**）· `/v1/index-constituent` 指数成分股（沪深300 **300 只**全量）。

- · **/v1/index-constituent 支持港股指数**：`hkHSI` 恒生 / `hkHSCEI` 国企 / `hkHSTECH` 恒生科技（各 20 只）。⚠️ **字段按市场不同**：A 股是 `code`/`name`/`IndexName`，港股是**中文键** `代码`/`名称`/`涨跌幅`/`成交额`；**一次只查 1 个**（逗号多只返回空）。

- · **/v1/fund 不能查港股**（A 股综合口径：龙虎榜/大宗/两融）—— 传 `hk*` 会返回 422 并指向 `/v1/fund-flow`。

- · **口径提示**：`/v1/fund-short` **请传 date**（不传且当日数据未发布时只回标识字段）；`/v1/rating` **仅港美股**，A 股请用 `/v1/consensus`；`/v1/consensus` 港股**没有目标价**（只有 `*Forecast` 一整套）。

- · ⚠️ **不支持港股**：筹码 / 板块 / 热度榜 / 龙虎榜 / ETF / 宏观 / 期货 / 外汇 / 可转债 / 产业链 / 研报 / 两融。

 `2026-10-23` 新端点 ETF 能力补全：`/v1/etf` 支持**历史快照** · 复权口径归入付费档

- · **/v1/etf 新增 date （历史快照）**：`kind=概览` 传日期可拿**那一天的折溢价 / 规模 / 估值百分位**（实测 `sh510300` 2026-06-30：涨跌 1.21%、折溢价 0.13%、PE 14.54，与当日 1.86%/-0.15%/12.78 明显不同）；`kind=持仓` 传日期可拿**那天的重仓股**。不传 `date` 时输出与改动前**完全一致**。

- · **复权口径（ fq ）属付费档，免费 K 线固定前复权**：`/v1/kline` 不提供 `fq` 参数（传了会收到 422 与指引）—— 同一个 code 在免费端点**永远同一个价格口径**，避免「同一接口两种复权」混用出错。需要 `nofq`（真实成交价）或 `hfq`（后复权做收益归因）请用 **/v1/kline-full （标准版，仅 A 股）** 或 **/v1/kline-batch （专业版）**。

- · **口径说明补全**：`/v1/chip` 筹码**支持 ETF**（实测平均成本 4.39 / 获利比例 13.47%），此前描述写「仅沪深 A 股」容易让人误以为 ETF 不可用；`/v1/margin-trade` 明确「**ETF 不在两融名单**」，不要把 `NOT_DISCLOSED` 当成数据延迟反复重试。

- · **顺带**：`/v1/etf` 的 `kind=持仓` 口径更正为 **Top20**（此前文档写「全量」，实测 `sh510300`/`sz159915` 都是 20 行）。

 `2026-10-23` 新端点 `/v1/screen` 调整为**标准版**起 —— 五种选股用法统一归入标准版

- · 选股（`/v1/screen`）的准入门槛调整为 **标准版（¥29.9）及以上**。一次接口含五种用法：**因子筛选**（88 个因子自由组合）/ **属性标签**（108 个，含央企、ST、破净、次新、市值档位等）/ **全市场排行**（综合·资金·基本面·风险·技术评分）/ **策略选股**（98 个：MACD 金叉、突破年线、高股息、大师策略…）/ **事件选股**（42 个：分红、业绩预告、定增、解禁、董监高增减持…）。

- · **为什么按「能力」分档而不是按「量」分档**：选股一次就给出可研究的结果集，是研究链路的**入口**；这类能力按套餐档位定，与「按调用次数消耗额度」的接口分开处理，档位才清晰。

- · **体验版不受影响**：行情、K 线、热榜、大盘概览、涨跌分布等基础端点照常可用。

- · **标准版还多出**：全历史 K 线（`/v1/kline-full`）、公告（可翻 16 年）、7×24 快讯、财务、回测，以及因子库与方法论库。

- · ⚠️ 若选股是你的主力用法，标准版额度为 10 万次（体验版 1 万次）、限流 120 次/分（体验版 30 次/分）。

 `2026-10-22` 新端点 `/v1/limit-up` 新增 `mode=auction` —— 竞价涨停（09:25 定盘即封板）

- · **筛「竞价就封板」的票**：打板族盘前最常看的一张表。`mode=auction` 只留 **09:25 定盘价就封在涨停价**的票（一字板 / 竞价抢筹），其余全部剔除。

- · **判据说明（重要）**：竞价中**摸过**涨停价、但定盘前被砸开的票**不算**——它们会在开盘后重新封板，`limit_time` 给的是重封时刻（比如 09:30）。所以这张表的口径是「**定盘涨停**」，不是「触及涨停」。

- · **一次调用替代逐只查**：以前要一只一只问「这只竞价涨停了吗」，现在一次拿全市场当日竞价涨停清单，含 `reason` 涨停原因 / `seal_amount` 封单额 / `streak` 连板数 / `main_net` 主力净额。

- · **准确率**：与「竞价定盘价 == 涨停价」这一独立口径交叉验证 **3 个交易日、147 只涨停股，零误报零漏报**。

- · **档位不变**：`/v1/limit-up` 仍为**标准版（¥29.9）起**，`mode=auction` 同档位可用，未抬高门槛。

 `2026-10-22` 新端点 `ashare_agent_search` 扩展：新增微信 / 网页检索 + 句级定位

- · **能搜公众号了**：`scope=wechat` 直接在**微信公众号**里检索（等价于限定 `mp.weixin.qq.com`），`scope=web` 是全网网页检索。补上我们自有库之外的内容 —— 行业政策、宏观解读、非 A 股公司。

- · **句级定位**：网页正文类证据现在带 `start_char` / `end_char`（字符区间），可以精确回答「**哪一句、第几个字符**」，而不只是给个链接。`end_char` 与 `value` 长度一致，可对账。

- · **相关性评分**：网页 / 微信检索的每条结果带 `rerank_score`（0~3，**≥1.5 为优质**）与 `quality`（`good` / `fair`）—— 判断这批结果够不够好，**别只看条数**。

- · **可选重放对账**：`replay=true` 会额外跑一次并比对输出，标 `match` / `non_deterministic` 等。⚠️ 模型路径下通常是 `non_deterministic`（同一输入、输出字节可能不同）—— **这不代表结论不可靠**。默认关闭。

- · ⚠️ **需自带模型 key**：网页 / 微信检索走 `X-LLM-Key`（费用由你的 key 承担）；⛔ 不传则不会用我们的额度兜底。

- · ⚠️ **显式传 scope=web / wechat 时只在该通道内找** —— 取不到会如实 `ok:false` 并说明，⛔ 不会退回别的通道凑答案。

 `2026-10-21` 新端点 L2 主力资金三件套：历史大单 / 主力四分解 / 全市场净额榜（不限量版）

- · **/v1/bigorder-history 历史大单净额**：往回最多 **100 个交易日**，每天一个值。补上"大单只能看今天"这个最大的缺口 —— 判断大单是**持续在吸**还是**只今天冲一下**，哪天开始转向。

- · **/v1/bigorder-split 主力四分解**：分钟级把主买拆成**主动买 + 被动买**、主卖拆成**主动卖 + 被动卖**，另给主力买/卖的**加权均价**。主动买高 = 有人在扫货；被动买高 = 挂单被砸着成交。**支持回看历史**，无条数上限。

- · **/v1/bigorder-rank 全市场主力净额榜**：一次拿到全市场 **约 5568 只**的主力买卖与净额，8 种排序（净流入/净流出/主力买入/主力卖出/涨幅/跌幅/换手率/市值），支持翻页与历史回看。这是"今天主力在买什么"最快的答案。

- · **恒等式可自检**：`主力买 + 主力卖 = 主力净额`、`主力买 = 主动买 + 被动买` —— 全市场 5568 行 **100% 成立**，你拿到数据可以自己验一遍。

- · **怎么配合用**：先 `bigorder-rank` 从全市场挑出票 → 再用 `bigorder`（分钟净额）/ `bigorder-split`（四方向结构）/ `bigorder-flow`（逐笔成交）/ `bigorder-queue`（挂单撤单）下钻到个股。六个端点构成完整的 L2 主力资金链路。

- · ⚠️ **不限量版专属**：专业版及以下返回明确说明与升级链接。

 `2026-10-21` 新端点 `/v1/auction` 档位调整：改为专业版（¥99）起

- · **为什么调整**：集合竞价是打板链条最前端的数据。`mode=stock-history`（历史秒级逐笔）每次请求需 **2 次数据源调用**，且与涨停池、复盘**共用同一条数据通道**（串行、最小间隔 0.35 秒）—— 标准版档内大量调用会挤占同档其它端点的实时性，因此把竞价整体归入专业版。

- · **谁能用**：**专业版（¥99）及以上**（不限量版同）。标准版 / 体验版调用会返回明确说明与升级链接。

- · **不受影响**：`/v1/minute`（分时）、`/v1/limit-up`（涨停池）、`/v1/review`（复盘）**仍为标准版（¥29.9）起**，不变。

- · **标准版用户怎么办**：补差价升级专业版即可解锁；已有额度与调用记录不受影响。

- · ⚠️ **破坏性变更**：标准版密钥调用 `/v1/auction` 自本日起返回 403（响应内含 `min_tier` 与升级链接）。

 `2026-10-20` 新端点 MCP 新增 `ashare_agent_search`：一句话取数 + 证据链（工具 60 → 61）

- · **把自然语言问题直接变成数据**：「宁德时代最近资金流入怎么样」→ 直接返回数据 + 完整证据，不用先猜该调哪个端点。

- · **每条结果都能核验**：带 `value_hash` / `source_endpoint` / `params` / `as_of`，拿这几样可独立重取比对。

- · **逐条裁决**：`verification.claims[]` 明确告诉你**哪些已验、哪些没验** —— 这是与同类产品最大的差别。

- · ⚠️ **覆盖边界**：支持**单个或多个 A 股标的**的**资金流 / 行情 / 公告资讯 / 龙虎榜 / 大宗 / 两融**（如「宁德时代和比亚迪哪个资金流入更多」）；板块、大盘统计、技术面、基本面、预测荐股会**明确拒答**，⛔ 不会拿别的字段凑数。

 `2026-10-20` 新端点 选股能力扩充：一个端点五种选股方式（标签 / 排行 / 策略 / 事件）

- · **[选股](/docs/endpoints/screen/)** 现在用 `mode` 选方式，原来的因子选股不变（`mode=condition`，默认）。

- · **mode=label 按属性标签选**：央企/国企/民企/QFII、ST/退市/破发、破净、亏损、现金流结构、上市时间、市值档位…共 **108 个标签**；`asset=etf` 切 ETF 主题池。

- · **mode=ranking 全市场排行**：综合/资金/基本面/风险/技术评分、两融余额及日周月季年变动、主力与散户资金流入、北向活跃度、涨跌停天数…

- · **mode=strategy 技术/风格策略**：MACD金叉、KDJ金叉、突破年线、首次涨停、连板、高股息、大师策略（巴菲特/格雷厄姆/费雪…）共 **98 个策略**。

- · **mode=event 事件驱动**：分红预案/决案/实施/除权、业绩预告/快报/披露、定增上市前后、董监高变更与增减持、大宗交易、解禁…共 **42 个事件**。

- · ⭐ **不知道有哪些取值就传 list=true** —— 直接列出该模式全部可用取值（带中文名与分组），⛔ 不用猜。

 `2026-10-20` 新端点 新增交易日历（开市/休市 · 年末最后交易日）—— 免费

- · **新增 [交易日历](/docs/endpoints/trade-calendar/)**：逐个日期给出**是否开市**，以及该日是不是**本周/本月/本季/本年的最后一个交易日** —— 做结算日、到期日、调仓日的时候直接查。

- · **三种查法**：不传参数 = 当月 · `date=2026-10-16` = 单日 · `start`+`end` = 任意区间，或 `year=2026` = 整年。加 `trading_only=true` 只返回开市日（整年约 242 行）。

- · ⚠️ **和 /v1/calendar 不是一回事**：那个是**个股事件日历**（分红/解禁/财报披露），这个**只讲市场开不开市**。

- · **本端点免费**（不需要 API Key）。

 `2026-10-19` 参考 空结果文档：补充「数据源临时不可用」怎么识别（degraded 字段）

- · **[空结果不等于故障](/wiki/empty-result/)** 多了一条判据：响应里出现 **degraded: true**，表示这次是**数据源临时不可用**（例如一时请求过于频繁），**不是这个标的没有数据**。

- · 同时会给出 `reason` 和 **retry_after_s**（还有多少秒可以重试）—— **稍后重试通常就有**，别把它当成"没数据"跳过。

- · **没带 degraded 的 ok:false** 才是"这个标的确实没有这项数据"，这个语义**没有变**；正常请求的返回结构也**完全不变**。

 `2026-10-18` 新端点 新增财经多源取证（公告 + 资讯 · 跨源去重 · 带证据指纹）

- · **新增 [财经多源取证](/docs/endpoints/evidence/)**：一次查询同时检索**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成同一张表。

- · **转载去重**：同一条消息被多家转时只出现一次，其余收在 `also_on` 里 —— 不会一屏都是同一件事。

- · **每行带证据指纹**：`cit_endpoint` / `cit_field_path` / `cit_value_hash` / `cit_retrieved_at`，拿这三样可以独立复现并核对这条结果。

- · **权威性分档**：公告 `authority=1.0`（交易所指定披露平台）、资讯 `0.5`（门户）；返回按**源平分名额**而不是纯按时间，否则公告会被当日新闻挤掉。

- · ⚠️ 公告给的是 **PDF 链接**（巨潮原始披露），资讯给原文链接；结果缓存 5 分钟。

- · **谁能用**：标准版（¥29.9）起；一次查询**同时检索公告与资讯两类来源**，按 **2 次**额度计。

- · **加 scope=report 可一并要券商研报**：标题 + 券商 + 日期 + 研报详情页链接。研报**单独算名额**，不会被资讯挤掉，也**不额外计费**。研报没有摘要，`snippet` 为空。

- · **证据指纹改用公开的规范算法**：`cit_value_hash` 改为 16 位、算法名写进 `cit_hash_alg`，端点描述里给出完整公式；`cit_endpoint` 换成**你自己就能请求的地址**，数据原始来源移到 `cit_upstream`。

 `2026-10-18` 新端点 新增 7×24 财经快讯（全市场电报）

- · **新增 [财经快讯](/docs/endpoints/flash/)**：全市场快讯流（财联社等来源），按时间倒序，每条含 `time` / `title` / `content` / `source` / `url`。

- · **和「个股资讯」的区别**：那个要传股票代码、只给某只票的消息；这个是**全市场电报**，问「今天有什么大消息 / 刚才发生了什么」用这个。

- · **翻页**：`index` 从 0 开始，步长 = 上次的 `limit`（`limit=20&index=20` 是第二页），只能往回翻。

- · ⚠️ `limit` 上限 **200**；缓存 **1 分钟**（同一分钟内重复请求不重复消耗）。

- · **谁能用**：标准版（¥29.9）起；免费额度不含。

 `2026-10-18` 新端点 新增 L2 大单委托流 + 龙虎榜席位明细（不限量版专属）

- · **新增 [L2 大单委托流](/docs/endpoints/bigorder-queue/)**：当日**挂单明细**（委托量 ≥ 500 手或金额 ≥ 30 万），每笔带**涨停价挂单**与**已撤单**标记。⭐ 它回答「**封单是真的还是演的**」—— 大额买单挂上去又撤，就是典型假封单。

- · **新增 [龙虎榜席位明细](/docs/endpoints/lhb-seats/)**：某只票某次上榜的**营业部买卖席位**（最多 10 个），含买入额 / 卖出额 / 净买额 / **游资标记**。比「机构榜统计」更具体：能看到是「沪股通专用」、某证券营业部，还是游资席位。

- · **配合用法**：`bigorder-queue` 看**挂单**（可能撤）、`bigorder-flow` 看**成交**（真买了）—— 两个一起看才能分清「挂了没成」和「真买了」。

- · ⚠️ 委托流**仅当日**；龙虎榜是**盘后数据**，`date` 留空 = 最近一次上榜日（以返回 `date` 为准）。

- · ⚠️ 委托是**挂单口径**不是成交；席位最多 10 行（数据源限制）。

- · **谁能用**：不限量版（¥199/月）专属；其他档位返回明确说明与升级链接。

 `2026-10-18` 新端点 新增 L2 大单成交明细（主动/被动拆分 · 不限量版专属）

- · **新增 [L2 大单成交明细](/docs/endpoints/bigorder-flow/)**：单只股票当日**每一笔成交额 ≥ 阈值的大单**，每笔标出**主动/被动 × 买/卖**四种方向（`1 被动卖 · 2 主动买 · 3 被动买 · 4 主动卖`）。

- · **参数**：`money` 0~4 → **30万 / 50万 / 100万 / 300万 / 1000万** 金额阈值；`limit` 最多 200 笔。

- · **能回答什么**：这票是有人在**主动扫货**（主动买占优）、**挂单被砸**（被动买多），还是**主动出货**（主动卖集中）—— 只看净额是分不出来的。

- · ⚠️ **仅当日**；`total` 是当日满足阈值的总笔数，`truncated=true` 表示被 `limit` 截断（此时 `summary` 只是本次样本合计）。

- · ⚠️ 这是**成交口径**，不是逐笔委托、也不是十档盘口。

- · **谁能用**：不限量版（¥199/月）专属；其他档位返回明确说明与升级链接。

 `2026-10-18` 新端点 新增 L2 大单资金分时（不限量版专属）

- · **新增 [L2 大单资金分时](/docs/endpoints/bigorder/)**：单只股票的**当日分钟级大单净额曲线**（`time` + `net`，单位元），正数=大单净买入，负数=净卖出。

- · **能看什么**：大单在持续流入还是在撤、哪一分钟集中砸盘、当天大单资金的分时节奏。

- · ⚠️ **仅当日**：非交易日或盘前返回**最近一个交易日**的完整分时，以返回的 `day` 为准；盘中调用时点数会随交易时段增长（09:30–15:00 约 242 点）。

- · ⚠️ 这是**大单口径**（按成交金额聚合），不是逐笔委托、也不是十档盘口。

- · **谁能用**：不限量版（¥199/月）专属；其他档位调用会返回明确说明与升级链接。

 `2026-10-18` 新端点 新增 5 个 MCP 工具 —— 公司简况 / 产业链 / 事件日历 / 融资融券 / 大宗交易

- · **变化**：MCP 工具新增 `ashare_profile`（公司简况）、`ashare_industry_chain`（产业链 · 183 主题）、`ashare_calendar`（个股事件日历）、`ashare_margin_trade`（融资融券明细）、`ashare_block_trade`（大宗交易明细）—— 工具总数 **49 → 54**。

- · ⭐ **这 5 个能力现在在 MCP 客户端里都能直接调用了** —— 此前只能自己拼 REST 请求，现在装好 MCP 就能让 AI 直接用。

- · **ashare_profile**：上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 —— 问「这家公司是做什么的」用这个，问「贵不贵」用 `ashare_snapshot`。缓存 24 小时。

- · **ashare_industry_chain**：183 个产业链主题，`mode=list` 主题列表 / `graph` 产业链图谱（上下游位置）/ `stock` 个股定位（含关联度与业务描述）。

- · **ashare_calendar**：分红派息 / 限售解禁 / 财报披露 / 新股 / 会议 / 增发，约 1 个月窗口。⚠️ 返回是**多段结构**，某类事件为 0 条时该段会**整段不出现**（不是丢数据）；⚠️ 它不是宏观日历。

- · **ashare_margin_trade**：融资余额 / 买入 / 偿还 + 融券明细，`code` 支持逗号批量。⚠️ 两融是 **T+1 披露**，当天查不到当天的。

- · **ashare_block_trade**：成交价 / 折溢价率 / 买卖方营业部，`code` 留空 = 当日**全市场**。⚠️ 当日无大宗时返回的是行情元信息（证明标的没问题），判「有没有大宗」要看有没有成交字段。

- · **谁能用**：这 5 个工具**不是专业版专属** —— **体验版（¥9.9）起**即可调用。

 `2026-10-18` 新端点 新增批量技术指标端点（专业版）—— 一次给整个池子算 55 项技术指标

- · **变化**：新增 `/v1/technical-batch` —— 一次最多 **500 只**（不限量版 1000 只）的 MA / EMA / MACD / KDJ / RSI / BOLL / BIAS / WR / DMI / OBV / VR / BBI / TRIX / DPO / PSY / ENE / CCI 等**共 55 项**，**逐只标明成功与否**，每一项的结构与 `/v1/technical` 的单行完全一致。

- · **此前怎么做**：`/v1/technical` 一次只能问一只，扫 500 只就得调 500 次（约 8 分钟，还会撞限频退避）；现在一次拿完，实测 **500 只 1.2 秒 / 1000 只 1.8 秒**。

- · **与 /v1/technical 的区别**：`/v1/technical` 的 `code` 虽然也支持逗号，但返回是**一整张宽表**、**没有逐只状态**，无效代码会**静默消失** —— 少了哪只根本算不出来。新端点逐只回填，缺谁、为什么缺都写清楚。

- · **怎么计费**：**按实际返回的只数扣次数**，失败的不计。

- · ⭐ **这是目前唯一没有数据源瓶颈的批量端点**：实测 **3000 只 2.8 秒、100% 返回、零限频**，所以上限改由**响应体积**决定（55 列 × N 行），给到了 500 / 1000 —— 比其它批量端点的 200 / 300 宽得多。

- · ⭐ **市场覆盖最广**：A 股（**含北交所**）/ 港股 / 美股**可以混在一起传**，**指数也能取**（`sh000001`）—— 这是其它批量端点做不到的。

- · ⚠️ **只有日线口径**：数据源的周期参数实测**不生效**（传 `week` / `month` / `m30` 返回的数值与日线**完全一样**），因此本端点**不提供周期参数** —— 免得你以为拿到的是周线 MA5，其实是日线。

- · **历史回看**：`date=YYYY-MM-DD` 取指定交易日的指标（对所有代码同时生效），非交易日自动回退到最近交易日，以返回行里的 `date` 为准。

- · **谁能用**：**专业版（¥99）及以上**。

 `2026-10-18` 新端点 新增批量财报端点（专业版）—— 一次看完一个池子的三大报表

- · **变化**：新增 `/v1/finance-batch` —— 一次最多 **10 只**（不限量版 20 只）的利润表 / 资产负债表 / 现金流量表，可指定 `periods`（默认 4 期）、`type`（只取一张表）、`fields`（`all` 186 列 / `core` 69 列），**逐只标明成功与否**。

- · **此前怎么做**：`/v1/finance` 一次只能问一只，筛出 10 只就得调 10 次；现在一次拿完，实测 **10 只 × 4 期 4.2 秒**。

- · **与 /v1/finance 的区别**：`/v1/finance` 的 `code` 虽然也支持逗号，但返回是**扁平的 3 张表**，哪只没回来、为什么没回来**完全看不出来**。新端点逐只回填，缺谁、为什么缺都写清楚。

- · **怎么计费**：**按实际返回的只数扣次数**，失败的不计；命中数据源限频时自动退还。

- · ⚠️ **上限：专业版 10 只 / 不限量 20 只，且「只数 × 期数 ≤ 40」**：财报数据源配额是按「只 × 期」消耗的 —— 实测 10 只 × 4 期 三次全中、20 只 × 2 期 全中；但 20 只 × 4 期 只回 5 只、50 只直接限频。需要更大规模请分批（批间隔几秒）。

- · ⚠️ **仅 A 股**：港股 / 美股在批量里未验证，传了会明确标失败并提示改用单只查询。

- · **谁能用**：**专业版（¥99）及以上**。

 `2026-10-18` 新端点 新增批量股东研究端点（专业版）—— 一次看清一个池子谁在持有

- · **变化**：新增 `/v1/shareholder-batch` —— 一次最多 **200 只**（不限量版 300 只）的十大股东 / 十大流通股东 / 股东户数统计，**逐只标明成功与否**，返回结构与 `/v1/shareholder` 完全一致。

- · **此前怎么做**：`/v1/shareholder` 一次只能问一只，扫 200 只就得调 200 次（约 3 分钟，还会撞限频退避）；现在一次拿完，实测 **200 只 4.1 秒 / 300 只 5.6 秒**。

- · **与 /v1/shareholder 的区别**：`/v1/shareholder` 的 `code` 虽然也支持逗号，但返回是一大坨 markdown、**没有逐只状态**，无效代码会**静默消失** —— 少了哪只根本算不出来。新端点逐只回填，缺谁、为什么缺都写清楚。

- · **怎么计费**：**按实际返回的只数扣次数**，失败的不计。

- · ⚠️ **支持沪深 A 股 + 港股**：北交所 / ETF / 指数 / 美股在批量取数里拿不到数据，传了会明确标失败并提示改用单只查询。

- · ⚠️ **A 股与港股段语义不同**：A 股是十大股东 / 十大流通股东 / 股东户数统计，港股是持股股东信息 / 股东分布 / 机构持仓统计 —— 按返回里的 `market` 与 `slug` 取，别按序号。

- · **谁能用**：**专业版（¥99）及以上**。

 `2026-10-18` 新端点 新增批量筹码分布端点（专业版）—— 一次看完一个池子的套牢盘与成本

- · **变化**：新增 `/v1/chip-batch` —— 一次最多 **200 只**（不限量版 300 只）的获利盘比例 / 平均成本 / 90% 与 70% 集中度，**逐只标明成功与否**，可指定 `date` 回看历史（约近 1 年）。

- · **此前怎么做**：`/v1/chip` 一次只能问一只，扫 200 只就得调 200 次；现在一次拿完，实测 **200 只 3.9 秒**。

- · **与 /v1/chip 的区别**：`/v1/chip` 的 `code` 虽然也支持逗号，但返回是**横向并排的对角矩阵**（第 i 行只有第 i 只的数据、其余全是 `-`），而且**无效代码那一整组列会直接消失** —— 少了哪只根本算不出来。新端点逐只回填，缺谁、为什么缺都写清楚。

- · **怎么计费**：**按实际返回的只数扣次数**，失败的不计。

- · ⚠️ **仅沪深 A 股**：港股 / 美股 / 板块在批量取数里不可靠，传了会明确标失败并提示改用单只查询。

- · **谁能用**：**专业版（¥99）及以上**。

 `2026-10-18` 新端点 新增批量公司简况端点（专业版）—— 选完股，一次看完全部公司信息

- · **变化**：新增 `/v1/profile-batch` —— 一次最多 **100 只**（不限量版 150 只）的上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 联系方式，**逐只标明成功与否**。

- · **此前怎么做**：`/v1/profile` 一次只能问一只，筛出 100 只就得调 100 次；现在一次拿完，实测 **100 只 6.8 秒**。

- · **与 /v1/profile 的区别**：`/v1/profile` 的 `code` 虽然也支持逗号，但返回是混在一起的扁平行、**无效代码会被静默丢掉** —— 少了哪只你算不出来。新端点逐只回填，缺谁、为什么缺都写清楚。

- · **怎么计费**：**按实际返回的只数扣次数**，失败的不计。

- · ⚠️ **仅 A 股**（含指数与 ETF）：港股 / 美股 / 板块在批量取数里不稳定，传了会明确标失败并提示改用单只查询（不会给你错数据）。

- · **谁能用**：**专业版（¥99）及以上**。

 `2026-10-18` 新端点 新增 4 个批量取数端点（专业版）—— 扫一个池子不用再写循环

- · **变化**：新增 3 个批量端点 —— `/v1/quote-batch`（行情）· `/v1/kline-batch`（K 线）· `/v1/snapshot-batch`（估值/市值/股本等全字段画像）。此前的 `/v1/fund-batch`（资金流）也一并接进了 MCP 客户端。

- · **此前怎么做**：要取 300 只股票，只能一只一只调 —— 300 次请求、每只等约 0.7 秒，全程 **3 分半钟**，中途还可能被限频打断。现在一次调用拿完，**4 秒左右**。

- · **返回什么**：每只一条记录，逐只标明成功还是失败（取 300 只就回 300 条，缺了哪只一眼看得到），并附「请求几只 / 返回几只 / 失败几只」的计数。

- · **怎么计费**：**按实际返回的只数扣次数**，失败的、停牌的不计。

- · **上限**：专业版单次 200 只，不限量版 250～1000 只（看端点）。

- · **谁能用**：**专业版（¥99）及以上**。标准版不含批量端点。

- · ⚠️ **分时（ /v1/minute ）不支持批量** —— 数据源一次只接一只，做不到多只同时取。

 `2026-10-17` 修复 匿名单次超 5 只标的的错误码由 `401` 改为 `422`

- · **变更内容**：`/v1/kline`、`/v1/quote` 匿名调用（不带 Key）单次超过 **5 只**标的时，状态码由 `401` 改为 **422**。响应体不变，仍含 `max_codes` / `requested_codes` / `pricing`。

- · **为什么改**：`401` 表示「未认证」，容易被客户端理解成 Key 失效并触发自动重试；而实际原因是**单次标的数超限**（参数问题），`422` 才是准确语义。

- · **对谁有影响**：**仅匿名批量调用**。带 Key 的调用、以及单只 / 5 只以内的匿名调用**完全不受影响**。

- · **是否需要改代码**：如果你的代码靠 `401` 判断「需要购买 Key」，请改为判断 **422**（或直接读响应体的 `error` 字段）。

- · 📌 **对照**：匿名**每日条数额度**用完仍返回 `429`（带 `Retry-After` 头）—— 两者是不同性质的限制，请分别处理。

 `2026-10-17` 新端点 `/v1/chip` 新增 `date` 回看历史 · `/v1/etf` 新增 `kind` 选子集（详情/持仓/净值/公司/持有人/财务）

- · **/v1/chip 新增 date**（`YYYY-MM-DD`，缺省 = 最新）：可回看任意交易日筹码（平均成本 / 70%·90% 集中度 / 获利盘比例 / 当日收盘价）。

- · ⚠️ **筹码历史仅保留约近 1 年**（实测 2025-10-24 起有数据）。更早的日期返回空结果 —— 响应 `ok:false`，**不扣次数**。

- · ⚠️ **非交易日 / 未来日期会自动回退到最近交易日**（例：`date=2026-10-17`（周六）实际返回 2026-10-16 的数据）—— 请以**返回行的 date 字段**为准，不要假定它等于你传入的日期。

- · **/v1/etf 新增 kind**：`概览`（默认，行为与之前完全一致）· `详情`（基金要素 / 费率 / 份额）· `持仓`（成分股及权重）· `净值`（历史净值，**须同时传 start 与 end**；返回 `nav` 4 位小数 + `closePrice`，可自算折溢价）· `公司`（管理人 / 托管人 / 跟踪指数）· `持有人`（户数 / 机构个人占比）· `财务`（股 / 债 / 商品 / 基金占比）。

- · ⭐ **kind=净值 的 nav 是真实单位净值**（4 位小数），不是收盘价 —— 折溢价大的品种（跨境 / 商品 ETF）两者可能相差 10% 以上，请勿混用。

- · ⭐ **代码可传裸 6 位**（`510300`）或带前缀（`sh510300`），两种写法结果一致。

- · ⭐ **取字段请用 structured / tables**：`data` 仍是数据源排版文本（与之前一致），`structured` = 首表、`tables` = 全部表。`kind=详情`（3 张表）与 `kind=公司`（2 张表）**只有 tables 能拿全**（含基金经理段）。

- · ⚠️ `/v1/etf` **仅接受 ETF 代码**：传个股代码返回 `ok:false` 且 **不扣次数**（不再返回字段全 0 的假数据）—— 代码不确定请先用 `/v1/search` 或 `/v1/hot?type=etf` 确认。

- · **是否需要改代码**：**不需要**。不传新参数时，两个端点的响应与之前**逐字节一致**。

- · ⚙️ MCP 工具 `ashare_etf` 同步新增 `kind` / `start` / `end` 参数（工具总数不变，仍为 39）。

 `2026-10-16` 新端点 匿名批量取数调整：`/v1/kline`·`/v1/quote` 单次最多 5 只标的

- · **调整内容**：`/v1/kline` 与 `/v1/quote` 的 `code` 支持逗号批量；即日起**匿名调用（不带 Key）单次最多 5 只标的**，超出返回 `401`（响应含 `max_codes: 5`）。⚠️ **该状态码已于 2026-10-17 修正为 422** —— 见上方最新条目。

- · **对谁生效**：**仅匿名调用**。**带 Key 的调用不受任何影响**，标的上限保持不变。

- · **是否需要改代码**：**不需要**。查询单只标的（最常见用法）与原来完全一致。

- · **另新增**：`/v1/kline` 单请求条数上限 —— 预估超过 **60,000 条** 返回 `413`。按常用参数（如 `count=30`）单只标的取数不会触发。

- · **需要批量取数？** 申请 API Key 即可解除标的数上限：https://ashareapi.com/pricing

 `2026-10-16` 修复 更正 `/v1/auction` 的 `stage` 字段说明 —— 该字段语义未公开，请勿依赖

- · ⚠️ **说明更正**：`/v1/auction` 返回的 `stage` 字段此前标注为「竞价阶段（0 = 可撤单 09:15–09:20 · 1 = 不可撤单 09:20–09:25）」（见 **2026-10-15** 更新日志），**该标注不成立**。实测（2026-10-16 · 10 只标的 · 550 条）：09:15–09:19（可撤单段）有 **35%** 为 `1`；09:20–09:24（不可撤单段）有 **59%** 为 `0`；**09:24**（应恒为 `1`）10 只中有 **7 只**返回 `0`。

- · ⭐ **正确用法**：该字段是**行情源侧的标记位**，源方公开说明中**未定义**其取值含义 ⇒ 请**不要依赖**它做判断。要区分可撤单 / 不可撤单段，请**直接用 time**：**09:15–09:20 可撤单** · **09:20–09:25 不可撤单**（全市场统一规则、固定不变）。

- · ✅ **不受影响**：`time` / `price` / `volume`，以及 `is_limit_up` / `up_px` / `down_px` / `open_px` / `preclose_px` / `hprice` 均无变化；该字段**仍保留在返回中**，现有代码不会中断。

 `2026-10-15` 新端点 新增 `/v1/auction` —— 集合竞价（当日分时 / 历史逐笔 / 竞价量额 + 竞价触及涨停判定）

- · **新增端点** [/v1/auction](/docs/endpoints/auction)：**个股 9:15–9:25 集合竞价**数据，含**「竞价触及涨停」判定**。

- · **mode 3 类**：`stock` **当日竞价分时**（默认，每分钟逐笔，含 09:15–09:24 全程）· `stock-history` **历史竞价分时**（**秒级**逐笔，需 `date`）· `volume` **当日竞价量 / 资金净额**（单点）。

- · ⭐ **is_limit_up = 「竞价触及涨停」判定** —— 竞价段最高价 ≥ 涨停价即判为真。**涨停价取自行情源的原始字段（非推算）**，因此**主板 10% / 创业板·科创板 20% / ST 5% / 北交所 30%** 的差异**天然正确**，无需用户自己套公式。

- · **返回**：每行 `time` 时间 / `price` 价 / `stage` 竞价阶段（0 = 可撤单 09:15–09:20 · 1 = 不可撤单 09:20–09:25）/ `volume` 累计量；顶层含 `up_px` 涨停价 / `down_px` 跌停价 / `open_px` 09:25 撮合价 / `preclose_px` 昨收 / `hprice` 竞价段最高价。

- · ⚠️ `mode=stock` **仅当日**（数据源限制）；查历史请用 `mode=stock-history` 且传 `date`（须为真实交易日）。

- · ⚠️ 档位：**标准版（¥29.9）及以上**。

- · ⚙️ MCP 同步新增工具 `ashare_auction`（工具总数 **38 → 39**）。

 `2026-10-14` 修复 分时与分钟线档位补齐（standard 起）· 付费档行情实时

- · ⚠️ **破坏性变更**：`/v1/minute`（分时）与 `/v1/kline` 的**分钟线**（`period=m1~m120`）现需 **standard（¥29.9）及以上**档位，`trial`（¥9.9）不再可用。

- · ⭐ **原因**：这两项属**盘中实时**数据，此前**漏登记档位门槛** ⇒ 体验版即可调用，与全站「时效类端点 standard 起」的惯例不符（同日上线的 `/v1/minute` 与分钟线是同一份能力的两个入口，一并收紧）。

- · ✅ **付费档行情实时**：`/v1/quote`、`/v1/kline`、`/v1/minute` 对**付费用户取消缓存**（每次取此刻最新）；免费/匿名档保留 5 分钟缓存以保障服务稳定性。

- · **不影响的**：`/v1/kline` 的**日 / 周 / 月 / 季 / 年线仍免费**（无需 Key），字段与口径均未变。

 `2026-10-14` 数据 行情实时性分档 —— 付费档报价无缓存，每次取此刻最新

- · ⭐ **付费档行情无缓存**：`/v1/quote`（实时行情快照）与 `/v1/kline` 的**日 / 周 / 月线**，每次调用都返回**此刻最新**的数据 —— 盘中连续查询即可看到价格随行情变动。

- · ⭐ **standard（¥29.9）及以上**另有**盘中数据**同样无缓存：`/v1/kline` 的**分钟线**（`period=m1~m120`）与 `/v1/minute`（分时）。

- · **免费 / 匿名档保留 5 分钟缓存**：为保障服务稳定性（免费流量占比高、多为持续轮询），免费档的行情按 5 分钟刷新。

- · ⭐ **数据本身一直是当日的**（含今日盘中 K 线），字段与口径均未变。

- · ⚠️ 说明：行情为**当日盘中滚动更新**；历史日线（已收盘的交易日）不受影响。

 `2026-10-14` 新端点 新增 `/v1/review` 与 `/v1/limit-up` —— 短线复盘 / 打板（涨停结构 + 涨停池明细）

- · **新增 2 个端点**：复盘看**结构**，打板看**明细** —— 两个视角互补，覆盖短线用户的日常。

- · **/v1/review**（复盘视图）`mode` 2 类：`board` **板块主线**（今天钱在哪些题材：板块 + `limit_count` 涨停数 + `amount` 板块成交额 + `stocks` 成分股）· `ladder` **连板梯队**（按连板高度分组，含 `board_name` 所属板块 / `market_cap` 总市值 / `tips` 如「7天4板」/ `max_streak` 区间最高连板 / `limit_days` 区间涨停天数 / `is_repack` **反包标记**）。

- · **/v1/limit-up**（打板视图）`mode` 1 类：`limit` **涨停池明细** —— 一次返回**全量**涨停股（各连板高度合并），每只含 `reason` **涨停原因** / `seal_amount` 封单额 / `seal_amount_max` 最大封单 / `main_net` 主力净额 / `main_buy`·`main_sell` / `amount` 成交额 / `concepts` 概念 / `float_cap` 流通市值 / `turnover` 换手% / `streak` 连板数 / `pct` 涨幅%。

- · ⭐ 两者都支持 `date`（YYYY-MM-DD）取该交易日历史；留空 = 实时。**历史须为真实交易日**（非交易日返回空）。

- · ⭐ `data` 恒为**行数组**（可直接落 DataFrame）；`limit` 的当日总条数在顶层 `count`。

- · ⚠️ 档位：**标准版（¥29.9）及以上**。

- · ⚙️ MCP 同步新增工具 `ashare_review` · `ashare_limit_up`（工具总数 **36 → 38**）。

 `2026-10-14` 参考 新增「AI 选股」落地面 —— 因子 → 筛选 → 回测，三步走完选股链路

- · **新增 [/ai-screener/](/ai-screener)：AI 选股的落地面** —— 讲清用我们的 API 怎么选股：**88 个因子 → 表达式筛选 → 29 个策略回测**，一套 API 走完全链路。

- · ⭐ **三步各对应端点**：[/v1/factors](/docs/endpoints/factors) 定因子 · [/v1/screen](/docs/endpoints/screen) 写条件 · [/v1/backtest](/docs/endpoints/backtest) 验结果（含真实交易成本）。附一条可直接跑的筛选表达式。

- · ⚠️ **先把边界说清**：不推荐股票 · 不承诺收益 · 不碰自动交易 —— 给的是**选股能力**（可复算），不是选股结果。

- · **同族页面**：[Agent 量化](/agent-quant)（品类定义 · 数据可核对）。

- · **中英都有**：[English page](/en/ai-screener/)。

 `2026-10-13` 新端点 新增 `/v1/abnormal` —— 异动 / 偏离值（短线监管异动）

- · **新增端点** [/v1/abnormal](/docs/)：**短线监管异动 / 偏离值**体系 —— 触发「严重异动」、「10日100% 偏离」、异动盯盘名单。这是**短线风控的关键信号**（个股因连续大涨/大跌被标记异动）。

- · `mode` 7 类：`deviation` 偏离值热门榜（今日，默认）· `deviation_hist`（历史，需 `date`）· `deviation_plan`（**今日 + 明日**两组，`group` 字段区分）· `abnormal` **异动频率 + 异动原因**（需 `date`，每日全量）· `watch` 异动盯盘名单（今日）· `watch_hist`（历史，需 `date`）· `alert` **严重异动提醒**（今日，`reason` 为人读提醒原因）。

- · ⭐ 字段：`reason` 触发规则说明（如 `10日100%`）· `pct` 涨跌幅% · `turnover` 换手%（偏离榜）· `board_desc` 连板描述 · `concepts` 概念 · `window` 偏离窗口 · `rule2` 第二条规则 · `trigger_pct` 触发阈值% · `limit_price` 参考价 · `status` 异动状态 · `date` 数据日期 · `price` 现价 · `abn_start` 异动起始日（未触发为 `0000-00-00`）。

- · ⭐ `data` 恒为**行数组**（可直接落 DataFrame）；`abnormal` 的当日总条数在顶层 `total`，`deviation_plan` 每行带 `group`（`today`/`tomorrow`）区分。

- · ⚠️ 历史类 mode 的 `date` 须为**真实交易日**（非交易日返回空）；**档位：标准版（¥29.9）及以上**。

- · ⚙️ MCP 同步新增工具 `ashare_abnormal`（工具总数 **35 → 36**）。

 `2026-10-13` 修复 修复 `/v1/search`（股票搜索）对大部分 A 股名称/代码返回空的问题

- · **问题**：`/v1/search` 按**股票名称**（如「茅台」「五粮液」「比亚迪」）或**代码**（如 `600519`）查询时，**返回空结果** —— 而该端点的用途正是"只给名称时先确认代码"，等于对最常见的用法失效。

- · ⭐ **原因**：搜索时**类别条件被同时设成了股票 + 基金 + 板块**，三者取的是**交集** ⇒ 只要关键词没有同时命中这三类就返回空。

- · **修复**：改为**不限定类别**，一次返回全部匹配（股票 / 基金 / 板块 / 港股 / 美股）。

- · ✅ **实测**（付费档）：`茅台` → `sh600519` · `五粮液` → `sz000858` · `太极实业` / `600667` → `sh600667` · `平安` → 中国平安 + 平安银行 + 港股/美股，全部正常返回。

 `2026-10-13` 教程 开发者页新增 QMT / Ptrade 接入说明（含可复制示例）

- · **新增「接到 QMT / Ptrade」章节**（[开发者页](/developers/)）：两个终端的内置 Python 版本较旧（QMT 3.6 · Ptrade 3.5），且有券商库白名单与沙箱限制，第三方包默认装不进去。

- · ⭐ 给出可行做法：**「外部取数、终端读文件」** —— 在终端之外用 SDK 拉数落 CSV，策略内只用终端自带的 pandas 读本地文件（不装包、不联网）。附**两段可直接复制的示例**。

- · ⚙️ 同步：文档页与开发者页的 **Python / Node 安装命令改为切换式**（此前两块并排显示）。

 `2026-10-13` 教程 新增[开发者入口](/developers/) —— SDK 快速上手、常用方法与接入场景

- · **新增 [/developers/](/developers/) 开发者页面**：Python 与 Node.js 两条**可直接复制**的上手示例、常用方法表、以及"能接进什么"（本地研究 / 自建看板 / 策略脚本 / 批量扫描）。

- · ⭐ **导航新增「开发者」入口**，首页与定价页各加 SDK 区块 —— 此前 SDK 只出现在功能清单里，没有独立入口。

- · ⚙️ **文档页同步**：[/docs/](/docs/) 的快速开始现在**同时讲 curl 与 SDK**（此前只讲 curl）。

- · **官方 SDK**：`pip install ashareapi` · `npm install ashareapi` —— 免费端点装上就能跑，无需 Key。

 `2026-10-13` 教程 文档页「快速开始」改为 curl + 官方 SDK 双轨 —— 两行代码拿到 DataFrame

- · **新增官方 SDK 接入区块**（[文档页](/docs/)）：Python（`pip install ashareapi`）与 Node.js / TypeScript（`npm install ashareapi`）各自给出安装命令与**两行示例代码**，含一键复制。

- · ⚙️ **接入引导调整**：此前文档页只讲 curl，现在 **curl 与 SDK 并列** —— 直接调接口的继续用 curl；写脚本 / 接看板 / 进策略代码的用 SDK，返回结构一致。

- · ⭐ 两个包都已发布在 PyPI 与 npm，版本与用法以包页面为准。

 `2026-10-12` 新端点 新增量化专属批量端口 `/v1/fund-batch` —— 一次拿一批股票的资金流，专业版 / 不限量版可用

- · **新增 [/v1/fund-batch](/docs/endpoints/fund-batch)：批量资金流端点** —— 一次调用拿**多只**股票的资金流（主力资金 + 龙虎榜 + 大宗 + 融资融券），用 `codes=sh600519,sz000001,sz300750` 逗号分隔。给**做量化**的用户扫池子用，不必一只一只调 `/v1/fund`。

- · ⭐ **单次上限**：专业版 **200 只**（约一个行业）· 不限量版 **1000 只**。**按实际返回只数计费**，失败的不计。

- · **逐只标明结果**：返回带 `requested` / `returned` / `failed` 计数，`data` 里每只标 `ok` —— 哪只拿到了、哪只没有，一眼看清（资金流仅覆盖 A 股；港股只有主力净流入，美股无此数据）。

- · **独立端口**：与单只的 `/v1/fund` 完全分开，原有接口**一行不动**。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-12` 参考 新增「Agent 量化」品类定义页 —— 讲清与传统量化的区别，以及数据为什么必须可核对

- · **新增 [/agent-quant/](/agent-quant)：Agent 量化的品类定义页** —— 讲清什么是 Agent 量化、跟传统量化（聚宽 / 米筐 / 优矿 / 掘金）的区别，以及「Agent 会不会编」为什么是这个品类真正的瓶颈。

- · ⭐ **核心主张**：传统量化出错能 debug，Agent 量化出错**分不清「算出来的」和「编出来的」** ⇒ 所以 Agent 量化要的不是「数据多」，是「**数据可核对**」（固定前复权 / 单位统一 / 空结果≠故障 / 固定信封）。

- · ⚠️ **先说边界**：不承诺收益 · 不碰自动交易 · 不跟竞品比「AI 选股准不准」。

- · **怎么做**在 [/docs/ai-quant/](/docs/ai-quant)（四条数据路径对比 · REST 与 MCP · 回测最容易骗自己的四个坑），本页只负责**定义品类**。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-12` 教程 国内平台接入新增「单平台详情页」—— 豆包打头，后续平台逐个补齐

- · **新增 [/docs/mcp-china/doubao/](/docs/mcp-china/doubao)：豆包接入独立详情页** —— 把安装步骤、Key 填法、可问示例、常见问题收在一页，比总览页的一行摘要更好照着做。

- · **总览页 [/docs/mcp-china/](/docs/mcp-china) 每个平台卡片新增「查看详情 →」入口**，从对照表直达单平台步骤。

- · ⭐ **逐平台一页**：后续百炼 / 扣子 / 元器 / 腾讯云 / 火山方舟按同一模板补齐，地址规律 `/docs/mcp-china/ /`。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-12` 教程 国内平台接入教程新增「豆包工作」—— 官方支持自定义 Headers，付费工具可用

- · **[/docs/mcp-china/](/docs/mcp-china) 新增豆包工作的接入步骤**：左侧「插件·技能·伙伴」→「插件」页右上角 **+ 添加** → **新建自定义插件** → 传输类型选 **HTTP**、服务器 URL 填 `https://api.ashareapi.com/mcp` → 在「**自定义 Headers**」加一条（名称 `Authorization`、值 `Bearer `）→ 保存后在对话框输入 `/` 或 `@` 搜 `ashareapi` 使用。

- · ⭐ **豆包支持自定义请求头**（官方《在豆包工作中使用插件》明确「HTTP 类型 + 自定义 Headers」）⇒ **付费工具也能用**，不是百炼 / 扣子那种只能用免费工具。

- · ⚠️ 豆包官方现称「**插件**」（入口「插件·技能·伙伴」），早期第三方教程里的"连接器"是同一功能旧称；首次可能提示「运行失败」，到插件列表点「重新启动」即可。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-12` 参考 快速开始与定价页新增「代码格式速查」入口 —— 股票代码必须带小写市场前缀

- · **/docs/ 与 /pricing/ 各新增一个「代码格式」入口**，直达[代码格式速查](/wiki/code-format)：`sh600519`（沪）· `sz000001`（深）· `bj920002`（北交所）· `hk00700`（港股）· `usAAPL`（美股）。

- · ⭐ **为什么加**：行情端点**只认「小写前缀 + 代码」**。实测（2026-10-12）：上面五种规范写法**均正常返回**；而 `600519`（不带前缀）· `600519.SH`（点号写法）· `SH600519`（大写前缀）· `sh60051`（位数不对）**全部返回空**（`ok:false` + 空数组）—— 看着像「没有这只票」，其实是格式问题。

- · **一律带前缀**是最省事的做法；代码不确定时，用 `/v1/search` 按名称搜出规范代码再调。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-12` 数据 方法论库 `/v1/playbooks` 扩充：13 → 25 条（新增交易执行与风控类）

- · **/v1/playbooks （量化方法论库）由 13 条扩充到 25 条**：新增**交易执行与风控**类方法论 —— **低吸承接判定 · 回调机会筛选 · 平台突破候选 · 突破交易执行 · 假突破撤退 · 关键位预警 · 目标价到位处理 · 分批止盈 · 止损纪律（价格/时间/逻辑）· 仓位决策 · 减仓或持有决策 · 盈利加仓决策**。

- · **每条仍遵循同一体例**：`signals`（判据：算式 + 数据 + 阈值）· `stages`（阶段划分）· `action`（各档应对）· `avoids`（⭐ 能避开什么亏损）· `evidence`（实测证据，未跑过的标「待实测」，**我们不编数字**）。

- · **按数据边界如实标注**：例如情绪周期类方法论的判据需要「涨停池 / 炸板池」，我们目前仅有**涨跌停家数**口径（`/v1/changedist`）—— 已在 `data_needs` 中写明可用什么替代、缺什么。

- · **分类不变**（仍 12 类）：新增条目归入既有的**风险管理**与**技术择时**两类，不新起类别。

- · **属付费档**（标准版 ¥29.9 及以上）；查清单**不占用回测额度**。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-11` 数据 公告端点 `/v1/notice` 门槛下调至标准版（¥29.9）—— 资讯能力在标准版完整

- · **/v1/notice （上市公司公告）门槛由专业版下调为标准版**：现在**标准版（¥29.9）及以上**即可调用，可翻约 **16 年**历史（茅台实测 929 条，回溯到 2010 年）。

- · ⭐ **调整理由**：标准版原本只有 `news`（最新资讯），**缺「历史」这一半** —— 把「**新闻 + 公告**」作为一个完整能力放在同一档，你升级到标准版后资讯面即可齐备，不用再往上买一档。

- · **专业版（¥99）仍有的研究级能力不变**：批量回测（多票 × 多策略对比）、全市场单日 K 线（一次拿 5000+ 只）—— 这两项才是专业版「做得到 vs 做不到」的差异。

- · **已购买标准版的用户自动生效**，无需任何操作；**现有调用与计费方式不变**（公告按次计入用量，与其他数据端点一致）。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-11` 数据 策略库附「实测表现」—— 29 个策略的真实成绩，无效的也照实列出

- · **/v1/strategies 每个策略新增 performance 字段**：在 **800 只（沪深300+中证500）· 2019 年至今**上跑出的真实成绩，含**平均/中位数**收益、夏普、最大回撤、**正收益标的占比**、交易次数。组合策略（9 个）在**全市场**（A 股全部有行情标的）上回测。

- · **verdict 分级**：`effective` 实测有效 · `neutral` 一般 · `weak` 偏弱 · **avoid 实测亏损** · `baseline` 对照基准 —— 便于快速识别。

- · ⭐ **无效的策略同样列出**：⚠️ 实测发现，**多数经典技术指标策略（KDJ/CCI/威廉/突破）在计入真实成本后并不成立**（如 `wr` 正收益仅 20%）。**照实展示，便于避开常见陷阱**，而不是只挑好看的。

- · **note 字段给避坑提示**：说明每个策略的**失效机制**（如「均线交叉在震荡市反复穿越 ⇒ 8 年 1454 次交易，成本吃掉收益」），而不是笼统的「好/不好」。

- · ⭐ **组合策略附「区间一致性」体检**（`consistent` + `by_period`）：把 4 个时段（全周期 / 前半段 / 近 4 年 / 近 2 年）的收益并列，**看方向是否一致**。⚠️ 实测发现 `smallcap` 等策略**换个时段结论就翻**（前半段 -40% / 近 4 年 +175%）—— 这是「**回测过拟合**」的直接证据 ⇒ 系统**自动降级**为 `neutral`，而不是当「有效策略」推荐给你。

- · **口径显式声明**（`cost_included: true`）：佣金万三 + 印花税万五 + 滑点千一**均已计入**；样本**含退市股**（无幸存者偏差）；区间为 **2019-01-01 起**。

- · **档位**：标准版（¥29.9）及以上；**查清单不消耗回测额度**。

- · ⚠️ **历史实测不代表未来表现**，仅供研究，不构成投资建议。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-11` 新端点 龙虎榜分榜扩展为 6 类 —— 新增总榜 / 高胜率买入 / 高胜率席位

- · **/v1/lhb 的 type 参数扩展为 6 类**：新增 `all` **全市场总榜**（当日上榜股票 · 净买额 / 买入额 / 卖出额）、`winbuy` **高胜率买入**（净买额 / 胜率 / 席位明细）、`winseat` **高胜率席位**（席位胜率 + 关联个股）。原有 `institution`（机构榜）、`activeseat`（活跃席位）**不变**，**现有调用不受影响**。

- · **新增 date 参数**：`/v1/lhb?type=all&date=2026-10-08` 可取**指定交易日**的榜单；留空 = **最近交易日**。

- · **hotmoney （游资榜）数据源暂无数据** —— 调用时返回**引导文案**（提示可改用 `all` / `activeseat` / `winbuy`），而不是空结果，便于你快速切换。

- · **口径说明**：龙虎榜为**收盘后发布**的数据（一般 18:00 后更新）。非交易日查询返回**最近交易日**的榜单，符合预期。

- · **档位**：**付费档均可**（体验版 ¥9.9 起；匿名无 Key 不可用）。费用与原有龙虎榜调用一致。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-10` 新端点 资讯能力上线：/v1/news（最新资讯）· /v1/notice（公告，可回溯约 20 年）· /v1/hot 扩展 5 类榜单

- · **新增 [个股资讯](/docs/endpoints/news/)**：`/v1/news?code=sh600519` 返回该标的**财经资讯列表**（标题 + 来源 + 时间）；`/v1/news?id=SN...` 返回**该条完整正文** —— 让 AI 真正能读消息面。用户问「这股票最近有什么消息」「这条新闻讲了什么」时用这个。

- · **新增 [公告](/docs/endpoints/notice/)**：`/v1/notice?code=sh600519` 取**公告列表**，支持按类型筛选与 **offset 翻页**，**可回溯约 20 年**（如某只蓝筹可一直翻到 2006 年）；传 `id` 则取**单条公告详情**。详情有两种形态：**多数短公告直接给正文**（`text`）；**少数长报告**（半年报/年报等 100+ 页）**给 PDF 链接**（`url`，请自行下载解析；要结构化财务数字请用 `/v1/finance`）。

- · **/v1/hot 扩展为 5 类榜单**：新增 `type=` 参数。**默认 stock ，现有调用不受影响**。

- · ⚠️ **5 类的字段结构各不相同**，请按 `type` 读对应字段：`stock` 热搜股票（`code`/`name`/`zdf` 涨跌幅/`zxj` 最新价）/ `wx` 全市场热度（同上，⭐ 多 **pv 热度值**）/ `news` **热门文章**（`news_id`/`news_title`/`source`，⛔ 无 `code`）/ `sector` **热门板块**（`symbol`/`rankdelta`，⛔ 无 `code`）/ `etf` 热搜 ETF（含 `title` 涨幅说明、`tag` 标签）。

- · **「时效」与「历史」分工**：`/v1/news` 覆盖**最新**（数据源不提供翻页）；要**历史纵深**（公告/披露）请用 `/v1/notice`。

- · **档位**：`/v1/hot` 为**免费**（无需 Key）；`/v1/news`（最新资讯）为**标准版 ¥29.9 起**；`/v1/notice`（历史公告）为**专业版 ¥99 起**。

- · **查询方式**：`/v1/news?code=sh600519` 取列表 → 用返回的 `id` 调 `/v1/news?id=...` 取正文（**两段式**，因为正文是逐条获取的）。

- · **正文为 AI 友好格式**：资讯正文经清洗后返回**干净的 Markdown**（去掉 HTML 标签、图片占位与无效内链，**保留股票代码关联**如 `茅台(sh600519)`），可直接喂给大模型 —— 无标签噪音、更省 token。时间统一为 `YYYY-MM-DD HH:MM:SS`。

- · **新增 MCP 工具 ashare_news · ashare_notice**，`ashare_hot` 增加 `type` 参数（工具总数 **33 → 35**）。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-10` 新端点 新增全市场单日 K 线端点 /v1/market-kline —— 一次拿到全 A 股当日行情

- · **新增 [全市场单日 K线](/docs/endpoints/market-kline/)**：`/v1/market-kline?date=2026-09-30` **一次请求返回全部 A 股（5000+ 只）某交易日的日线**，替代以往「逐只循环 5000 多次」——每天收盘后调 **1 次**即可完成全市场增量更新。

- · **适用场景**：自建行情库、全市场扫描、每日批量更新。请求数从 5000+ 降到 **1**；单次体积约 **785 KB**。

- · **属专业版（¥99）及以上能力**：标准版及以下不可用；另有**独立日额度**（专业版 **200 次/日** · 不限量版 **1000 次/日**）。

- · **计费口径**：因一次请求动用 5000+ 只标的的数据量级，**1 次调用折算 500 次额度**（远低于逐只调用 5000 次要消耗的次数）。

- · **数据范围**：仅 A 股股票（5572 只）· **2016-08-08 起** · **不复权原始价**；不含 ETF / 可转债 / 指数 / 板块 / 港股 / 美股。数据由官方数据每日增量维护，**最新可到前一交易日**（当日盘中数据不可用）。

- · **新增 MCP 工具 ashare_market_kline**（工具总数 **32 → 33**）。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-10` 新端点 新增文档检索端点 /v1/wiki —— agent 不确定字段单位/口径时可直接查

- · **新增 [文档检索](/docs/endpoints/wiki/)**：`/v1/wiki` 提供产品文档检索 —— **字段单位、口径说明、常见误用、跨市场差异**。当 AI（agent）不确定某字段的含义或单位时，可直接查证，而不是凭记忆猜。

- · **渐进加载，省上下文**：不带参数返回**目录**（每篇一句话）；`q=关键词` 返回**摘要**（含命中片段，**不返回全文**）；`slug=xxx` 取**该篇全文**。不会一次性返回全部文档，建议「先看目录 → 再取需要的单篇」。

- · **新增 MCP 工具 ashare_wiki_search**（工具总数 **31 → 32**）。属**免费工具**（无需 Key）—— 与行情快照 / K线 / 热搜 / 市场总览 / 涨跌分布同属免费层。

 `2026-10-08` 新端点 量化能力升级：批量回测 /v1/backtest-batch · 组合权重优化 · IP 白名单 /v1/ip-whitelist

- · **新增 [批量回测](/docs/endpoints/backtest-batch/)**：`/v1/backtest-batch` 一次跑**多只标的 × 多个策略**，直接返回对比矩阵（谁表现最好），省去逐个调用。**20 只标的 × 10 条策略**以内、组合总数上限 60；每只标的的行情只加载一次供全部策略复用，**15 组合约 1 秒**返回。单只标的失败**不中断整批**（该组合标注原因，其余照跑）。属**付费档**（专业版及以上）。

- · **组合回测新增权重方案**：`/v1/backtest?mode=portfolio` 支持 `weighting=inv_vol` —— 按每只票的**波动率倒数**分配仓位（波动小的多配、波动大的少配），与默认的等权 `equal` 并列。实测同一组合、同一区间，波动率倒数加权比等权**少亏 11.85 个百分点**（最大回撤同样更浅）。属**不限量版**能力。

- · **新增 [IP 白名单](/docs/endpoints/ip-whitelist/)**：可把 API Key **锁定到固定的几个 IP**，Key 万一外泄也无法从别处调用。`POST` 设置（最多 50 个）· `GET` 查看 · `DELETE` 清空恢复。设置后从其他 IP 调用会收到 `403`；**当前 IP 始终放行**，不会把自己锁在外面。属**不限量版**能力。

- · **不限量版新增「重型请求独立配额」**：回测 / 全历史 K 线有**专属并发位**，不与其他档位争抢 —— 其他档位高峰期提交重型请求会**排队等待**，不限量版照常跑。这是它与专业版最直接的差别。

- · **量化回测日额度按档位拉开**：标准版 **30 次/日** · 专业版 **300 次/日** · 不限量版 **1000 次/日** —— 回测是 CPU 重型端点，额度随档位等比放大（越贵越划算）。

- · **组合回测支持多个区间**：不再只有一个固定区间，现有 **4 个预置区间**（全周期 / 近 4 年 / 近 2 年 / 前半段）。终点跟随最新交易日，不会随时间「落后」；固定终点的那段是**刻意留的样本外对照**。传其他区间会返回**当前可用区间清单**，不用猜。

- · **批量回测按档位限次**：专业版 **20 批/日** · 不限量版 **100 批/日**；单次最多 20 只标的 × 10 条策略。

- · **端点总数 38 → 40**。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-08` 新端点 新增量化回测 /v1/backtest · 量化策略清单 /v1/strategies · 量化因子库 /v1/factors · 量化方法论库 /v1/playbooks

- · **新增 [量化回测](/docs/endpoints/backtest/)**：`/v1/backtest` 按内置策略跑历史回测，返回总收益 / 年化 / 夏普 / 最大回撤 / 年化波动等指标，可选返回**净值曲线**。已计入**佣金、印花税、过户费、滑点**，并计入**涨跌停**与**停牌**约束（封板不可成交则顺延，停牌无行情则不成交）。属**付费档**（标准版及以上）。

- · **新增 [量化策略清单](/docs/endpoints/strategies/)**：`/v1/strategies` 列出全部内置策略与参数范围 —— **20 条单标的择时**（买入持有 / 均线 / 动量 / 反转 / 低波动 / 波动率目标 / MACD / KDJ / RSI / 布林 / WR / OBV / CCI / SAR / 海龟 / 网格 / 定投 …）+ **9 条组合选股**（动量 / 反转 / 低波动 / 均线 / 量能突破 / 小盘 / 大盘 …）。属**付费档**（Standard 及以上），查清单**不占用回测额度**。

- · **新增 [量化因子库](/docs/endpoints/factors/)**：`/v1/factors` 列出全部 **88 个选股因子**（代码 / 中文名 / 单位 / 说明 / 分类）+ **22 个预设** + **8 条使用规则**。因子直接用于 `/v1/screen` 的表达式筛选，例如 `intersect([PE_TTM > 0, PE_TTM 15])`。

- · **因子支持历史截面**：`/v1/screen?date=YYYY-MM-DD` 可取**任意历史交易日**的因子值（2016-08-08 起有数据）⇒ 可串成 **因子 → 筛选 → 回测** 的完整研究链路。

- · **新增 [量化方法论库](/docs/endpoints/playbooks/)**：`/v1/playbooks` 给出一套套「**怎么判断市场**」的可复用流程 —— 每条写明**判据**（算式 + 数据 + 阈值）、**阶段**（如情绪：冰点/启动/发酵/高潮/退潮，各阶段应对）、**能避开什么亏损**，以及**实测证据**（跑过的回测数字；标「待实测」的表示还没跑，我们不编数字）。共 **13 条**，覆盖风险管理 / 动量趋势 / 基本面 / 估值分位 / 组合再平衡 / 资金流向 / 大盘择时 / 板块轮动 / 情绪周期 / 量能结构 / 事件驱动 / 涨停接力 / ST 摘帽重整。属**付费档**（标准版及以上）。

- · **「避开 ST」与「炒 ST」并存**：「风险排雷」教怎么剔除 ST 等风险标的，「ST 摘帽与重整博弈」教怎么从中找机会 —— 同一只票，保守型看到风险、进取型看到机会，**我们两条都给**。⚠️ 其中「剔除 ST」的实测结论出乎意料：动量策略剔除 ST 后反而略差，小盘策略剔除后少赚但回撤小 —— 本质是**用收益换回撤**，是风险偏好的取舍，不是简单对错。

- · **两种回测模式**：`mode=single` 单标的**实时计算**（毫秒级）；`mode=portfolio` 组合回测查**预计算结果**（组合回测涉及全市场数据，耗时较长，故预先算好）。

- · **端点总数 34 → 38**。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-08` 新端点 MCP 工具补齐量化能力（新增 5 个工具 · 共 31 个）

- · **MCP 新增 5 个量化工具**：`ashare_backtest`（量化回测）、`ashare_backtest_batch`（批量回测）、`ashare_strategies`（策略清单）、`ashare_factors`（因子库）、`ashare_playbooks`（方法论库）—— 现在在 Claude Code / Cursor 等客户端里直接说「帮我回测一下这个策略」，AI 就能自己调用。工具总数 **26 → 31**。

- · **付费门槛**：策略 / 因子 / 方法论清单与**单标的回测**属标准版（¥29.9）及以上；**组合回测**与**批量回测**属专业版（¥69）及以上。余量可查 `ashare_usage`。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-07` 新端点 新增全历史 K 线端点 /v1/kline-full · MCP 工具 26 个

- · **新增 [全历史 K 线端点](/docs/endpoints/kline-full/)**：`/v1/kline-full` 返回**10 年日线**（2016-08-08 起，约 2465 条），并支持**可选复权口径** `fq` —— `qfq` 前复权 / `hfq` 后复权 / `nofq` 原始价。做**回测**建议用 `hfq` 或 `nofq`（前复权序列会随新的除权除息重算，不可复现）。属**付费档**（Standard 及以上）。

- · **与 [K 线](/docs/endpoints/kline/) 的分工**：`/v1/kline` 轻量（上限 1212 条、复权口径固定前复权）；`/v1/kline-full` 全历史 + 复权可选，但**仅 A 股股票**（ETF / 可转债 / 指数 / 板块 / 港美股请继续用 `/v1/kline`）。

- · **端点总数 33 → 34**：免费 7 个不变，付费 27 个。

- · **MCP 新增 ashare_kline_full 工具**，工具总数 **25 → 26**。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-07` 参考 Wiki 新增四篇：返回形态 / 字符串数值 / 批量取数 / 跨市场差异

- · **[返回形态速查](/wiki/response-shapes/)**：`data` 有四种形态（行数组 / 表列表 / 已排版文本 / 多段结构），全部 33 个端点分别属于哪一种、怎么一眼判断、程序化取数该读哪个键。

- · **[字符串数值](/wiki/string-numbers/)**：多数端点的价格、成交额返回的是字符串（`"1723.50"`）而不是数字 —— 哪些端点受影响、怎么安全转换、排序比较会踩什么坑。

- · **[批量取数](/wiki/batch-fetch/)**：哪些端点支持一次传多个代码（逗号分隔）、不支持的怎么循环取、以及循环时的限流处理。

- · **[跨市场差异速查](/wiki/market-diff/)**：同一端点在 A 股 / 港股 / 美股 / 北交所的字段差异，以及哪些端点只覆盖 A 股。

- · **中英都有**：[English wiki](/en/wiki/)。

 `2026-10-06` 新端点 新增分时端点 /v1/minute · K 线支持分钟周期

- · **新增 [分时端点](/docs/endpoints/minute/)**：`/v1/minute` 返回盘中逐笔走势（每分钟一个价格 + 累计量），`days=1` 当日、`days=5` 近 5 个交易日。属**付费档**。

- · **[K 线](/docs/endpoints/kline/) 新增分钟周期**：`period` 除日 / 周 / 月外，支持 `m1` `m5` `m15` `m30` `m60` `m120` 六档分钟线（窗口到近 1 个月），付费档可用。

- · **端点总数 32 → 33**：免费 7 个不变，付费 26 个。

- · **MCP 新增 ashare_minute 工具**（对应上述分时端点），工具总数 **24 → 25**；`ashare_kline` 的描述同步放开分钟周期与日期范围。

- · **免费档匿名频率调整**：解 PoW 挑战后的匿名配额由 60 次/分调整为 **15 次/分**（不解决时仍为 5 次/分）。免费数据总量不变。

- · **中英都有**：[English changelog](/en/changelog/)。

 `2026-10-05` 参考 新增 Wiki：字段速查与口径说明

- · **新增 [Wiki](/wiki/) 参考区**：字段速查、口径说明、常见误用 —— 比教程短，需要时随时查。

- · **[K 线返回字段速查](/wiki/kline-fields/)**：收盘价字段叫 `last` 不叫 `close`、数值都是字符串、`volume` 单位是手而不是股。

- · **[单位速查](/wiki/units/)**：`volume` 一律是手；`amount` 在 K 线里是元、在 `/v1/snapshot` 里是万元 —— 混用会差 1 万倍。

- · **[复权口径](/wiki/adjustment/)**：K 线价格固定为前复权，没有 `adjust` 参数，除权除息日不跳空。

- · **[返回信封字段](/wiki/envelope/)**：`ok` / `endpoint` / `tier` / `elapsed_ms` / `source` / `data` 六个字段各是什么，以及哪些返回不走这套结构。

- · **[代码格式速查](/wiki/code-format/)**：`sh` / `sz` / `bj` / `hk` / `us` 前缀怎么写（前缀必须小写），ETF / 可转债 / 板块代码长什么样。

- · **[数据时间口径](/wiki/freshness/)**：数据日期看 `date` 字段而不是系统时间 —— 各市场、各端点的更新节奏不一样。

- · **[空结果不等于故障](/wiki/empty-result/)**：返回空数组多半是代码格式写错，不是接口坏了；空结果不扣次数。

- · **中英都有**：[English wiki](/en/wiki/)。

 `2026-10-04` 修复 DSH 插件修复：装完之后工具不出现的问题

- · **修了 [DSH 插件](/dsh/) 装完看不到工具的问题**：0.1.0 装好后插件条目无法激活，一个工具都不出现。已发布 **0.1.1**，重新装一次即可，**配置不用改**。

- · **怎么确认自己是不是这一条**：启动时如果看到 `1 entry did not activate` 或 `TypeError: Invalid effect`，就是它。

- · **怎么重装**：桌面端 / Web UI 打开「插件」页面，输入包名 `ashareapi-dsh-plugin`（若已装过，先卸载再装）。

 `2026-10-03` 数据 匿名额度改为按「数据条数」计算：单次 250 条 / 每天 10 万条

- · **免 Key 匿名调用改为按条数计额度**：单次最多 **250 条**（K线等列表类端点），每天最多 **10 万条** —— 日常看盘、写点小脚本完全够用。

- · **带 Key 的调用不受影响**：仍是单次最多 **1212 条**、无每日上限。要批量拉历史、跑回测，用 Key 即可（[申请 API Key](/pricing/)）。

 `2026-10-02` 上线 DeepSeek Harness 插件上线：桌面端 / Web UI 输包名即装

- · **新增 [DSH 插件页](/dsh/)**：一个 [DeepSeek Harness](https://www.deepseek.com/harness/) 插件，装上之后 DSH 就能直接查 A 股数据 —— 行情 / K线 / 财务 / 资金 / 龙虎榜 / 板块 / 因子选股，共 **24 个工具**。

- · **装法**：桌面端 / Web UI 打开「插件」页面输入包名 `ashareapi-dsh-plugin`；命令行 `npx @deepseek-ai/dsh plugin --profile web add ashareapi-dsh-plugin`。不用改配置文件。

- · **免费工具无需 Key**：行情快照 / K线 / 热搜 / 市场总览 / 涨跌分布 这 5 个装上就能调；付费工具填一个 Key 即可全开。

 `2026-10-02` 上线 Pi 包上线：一条命令让 Pi 会查 A 股数据

- · **上架 [pi.dev](https://pi.dev)**（npm `ashareapi-pi`）：`pi install npm:ashareapi-pi` 一条命令装好，装完 `/reload` 即用 —— 不用配 JSON、不用写脚本。

- · **覆盖 32 个端点**：行情 / K线 / 五档盘口 / 财务 / 资金 / 龙虎榜 / 板块 / 可转债 / 因子选股 / 宏观，其中 **5 个免费、无需 Key**。

- · **与 Agent Skill 同源**：同一份端点说明书 —— Pi 知道该调哪个端点、参数怎么填、字段什么单位、出错怎么处理。

 `2026-10-01` 上线 源码开源：Python SDK / Node SDK / MCP 服务器 / Agent Skill 上 GitHub

- · **四个仓库全部开源（MIT）**：想读源码、想自己部署、想提 issue 都可以直接看 —— [Python SDK](https://github.com/ashareapi/ashareapi-python) · [Node SDK](https://github.com/ashareapi/ashareapi-node) · [MCP 服务器](https://github.com/ashareapi/ashareapi-mcp) · [Agent Skill](https://github.com/ashareapi/ashareapi-skill)。

- · **官方 SDK 更新到 0.1.9**（[PyPI](https://pypi.org/project/ashareapi/) · [npm](https://www.npmjs.com/package/ashareapi)）：新增英文 README。

 `2026-10-01` 教程 新增教程：用 /v1/quote 查实时行情与日 K 收盘价（免 Key）

- · **新增 [用 /v1/quote 查实时行情与日 K 收盘价](/docs/guides/quote-realtime-price/)**：一次 GET 拿到最新价、开高低收、成交量、成交额、换手率 —— 免 Key、免注册，含**字段单位换算**（volume 是手 / amount 是元 / turnover 是百分数）、**"实时价 vs 收盘价"的数据日期语义**、批量并发与限流（匿名 5 次/分 → 解 PoW 提到 60 次/分）、以及 quote 与 kline 的区别。

- · **数据来自线上实测**（2026-10-01：600667 返回 30 条，`data[0]` date=2026-09-30 last=17.29）。

 `2026-09-30` 修复 K线 count 参数上限为 1212；限流响应新增 Retry-After

- · **/v1/kline 的 count 参数上限为 1212**：超过该值返回 `422`；默认值 30，正常调用不受影响。

- · **限流（429）与数据源故障（502）响应新增 Retry-After 头**：客户端可据此自动退避，避免无效重试。使用官方 SDK 无需改动（SDK 已内置指数退避）。

 `2026-09-30` 教程 新增 4 篇实战教程：大宗交易 / 股东户数 / K线技术指标 / 市场温度

- · **新增 [A 股大宗交易怎么看](/docs/guides/block-trade-signals/)**：折价率、机构席位与买卖方，含恒瑞医药 2.5 亿 -8% 折价真实案例，以及扫"大额 + 深折价"的 Python 示例。

- · **新增 [股东户数怎么看](/docs/guides/shareholder-structure/)**：三张表（十大股东/流通股东/户数统计）、筹码集中度怎么读，含太极实业户数一年翻 3.5 倍的完整案例。

- · **新增 [K 线数据怎么算技术指标](/docs/guides/kline-technical-indicators/)**：MA / MACD / RSI / KDJ / BOLL 五个常用指标，纯 pandas 不依赖 TA-Lib。

- · **新增 [用涨跌分布判断市场温度](/docs/guides/market-breadth/)**：上涨占比/涨停数怎么读市场情绪，连续看几天判断拐点。

- · **全部基于线上真实数据**（2026-09-29 实测），可直接照跑。

 `2026-09-29` 教程 新增因子选股专题：4 篇教程（含数据体检方法）

- · **新增 [因子选股入门](/docs/guides/factor-screening/)**：`/v1/screen` 怎么用、结果怎么读，以及**筛完必做的 3 步数据体检**（多口径一致性 / 扣非 / 杠杆）——附一个真实案例：被筛出来的 PE 0.36 / ROE 883% 是怎么一步步被验证为"因子值不可用"的。

- · **新增 [因子表达式语法与因子字典](/docs/guides/screen-expressions/)**：`intersect([...])` 结构、6 种运算符、单位与百分数规则、**85 个已验证因子**（估值 / 盈利 / 资产负债 / 现金流 / 行情）、14 个可直接复制的组合模板、8 个必踩的坑。

- · **新增 [22 个现成的选股方案](/docs/guides/stock-screening-strategies/)**：按"估值 / 盈利质量 / 技术面 / 资金机构"四类讲清每个方案筛什么、适合谁，附 5 个方案的真实返回与踩坑提示。

- · **新增 [实战：价值筛选与异常值排查](/docs/guides/value-stock-screening/)**：四条件价值筛选 → 四步排查 → 把排查固化为可复用函数并批量跑，四步规则精准命中异常值且无误伤。

- · **所有示例数据均为线上真实返回**（2026-09-29 实测复现），可直接照跑；体检方法参考项目内因子词典（85 因子，2026-08-31 验证）。

 `2026-09-28` 修复 数据源数量口径更正：67 → 70

- · **我们聚合的数据源数量为 70 个**（此前部分页面显示 67 个）—— 67 是早先的分类估算，**70 按我们实际接入的来源逐项统计**得出。

- · **变的是显示数字，不是数据本身**：接口返回、字段、端点数（32 个）均无变化；受影响的是首页状态卡 · [服务状态页](/status/) · 定价页 · 对比页 · 页脚，现统一为 70。

- · **[服务状态页](/status/) 的分组清单按类别列出规模**：行情 / 财务 / 资金流 / 龙虎榜 / 板块 / 热榜与情绪 / 公告新闻研报 / 其他 —— 各组相加 = 70。

 `2026-09-28` 修复 K 线口径：固定为前复权（不需要自己再复权）

- · **/v1/kline 返回的是前复权价** —— 除权除息日**不跳空**；接口**没有** `adjust` 参数（口径固定、无参数可调）。⚠️ **请不要再自己复权**（二次复权会让价格与真实行情不符）；不复权 / 后复权序列不提供。

- · **与不复权数据对不上时，差异会精确出现在「跨除权除息」的窗口上**（长窗口如 MA120 更明显），短窗口（MA5 / MA10）通常一致 —— 这是**口径差异**，不是取数错误。

- · **这个口径现在写在你会看到的所有地方**：教程与问答 · 端点描述（`/openapi.json` 与端点页）· MCP 工具 `ashare_kline` · [Agent Skill](/skill) · 官方 SDK（Python / Node.js 的 `kline()` 文档与 README）。

- · **MCP 服务器地址**是 `https://api.ashareapi.com/mcp`（客户端里填这个）；`ashareapi.com/mcp` 是**配置说明页**，不是接口地址。

- · **新增对比页：[ashareapi vs BaoStock](/compare/baostock/)** —— 免费历史数据库 vs 托管服务：BaoStock 可用 `adjustflag` 切三种复权口径并提供**复权因子**、有 **5/15/30/60 分钟** K 线；我们提供**实时快照**、结构化资金面（资金流 / 龙虎榜 / 板块 / 可转债）与 AI Agent 原生接入。含"各自适合谁"与诚实边界。

 `2026-09-26` 数据 字段改名：/v1/quote 与 /v1/kline 的换手率 `exchange` → `turnover`

- · **统一字段名**：`/v1/quote` 与 `/v1/kline` 的换手率字段此前叫 `exchange` —— 那是**数据源的原始列名**，**极易被误读为「交易所」**（我们自己的端点描述就曾因此把它标成交易所并写「不含换手率」，见同日上一条修复）。现改名为 **turnover**，与 `/v1/snapshot` 的 `turnover` **同名同值**（实测 `sz000001` 两者均 `0.54`）

- · **⚠️ 破坏性变更**：读 `row["exchange"]` 的代码请改为 `row["turnover"]`。本次**直接替换、不保留 exchange 别名**（依据：该字段暂无外部客户依赖）

- · **同步范围**：HTTP 端点描述 · OpenAPI（`/openapi.json`）· MCP 工具描述（`ashare_quote` / `ashare_kline`）· 端点页 · 教程示例代码（Python / Node.js）· Agent Skill —— 全部改为 `turnover`

- · 顺带修正教程里一处错误表述：此前写「换手率在 `quote` / `snapshot`，**不在 kline**」—— 实测 `/v1/kline` **同样返回**该字段

- · 未改动的端点：`/v1/snapshot` 原本就叫 `turnover`（无需变更）；`/v1/kline` 的端点描述原先**完全没提**这个字段，已补上

 `2026-09-26` 修复 修正：/v1/quote 的换手率字段被误标为「交易所」

- · **exchange 字段就是换手率（%），不是交易所**：此前一版描述把第 8 个字段标成「交易所」并写「**不含换手率**」—— 那是**只看字段名**得出的错误结论。实测该字段的值是**数字**（`sz000001` = `0.54`、`sh600036` = `0.24`），且与 `/v1/snapshot` 的 `turnover` 字段**完全同值**（sz000001 两者都是 0.54）→ 确为**换手率**

- · 交叉验证：1,043,819 手 ÷ 19.406e9 股 = **0.538%** ≈ 实测 0.54；同日涨跌幅 −0.44% / 振幅 1.59% 均不等于 0.54（排除法）

- · 现描述已改回「轻量 8 字段：现价 / 开高低 / 成交量 / 成交额 / **换手率**」，并注明该字段名为 `exchange`（**名字反直觉，不是交易所**）

- · 同时统一 `/v1/snapshot` 的字段数口径为 **35 字段**（此前 HTTP 侧写「24+」、MCP 侧写「35」，不一致）

 `2026-09-26` 修复 Agent Skill 文档修正：返回结构说明有误（照抄会让 AI 代码 KeyError）

- · **修正「返回三件套」的错误说法**：此前 skill 称信封统一含 `structured` / `tables` —— 32 端点全量实测后确认，**只有 data 是 Markdown 文本时才附**（`market-overview` / `changedist` / `lhb` / `sector` / `sector-valuation` / `bond` / `etf` / `screen` / `macro` 共 9 个）；其余端点**没有这两个键** → AI 照抄 `body["structured"]` 会 **KeyError**（正确写法是 `body.get("structured")`）

- · **新增「 data 四种形状」速查表**：对象数组（多数端点）/ 表列表（`finance`）/ 多段结构（`shareholder` · `calendar`）/ Markdown 文本，并给出四种形状通吃的取行写法

- · 补齐返回形态说明：`finance` = 表列表 · `shareholder` / `calendar` = 多段结构（含段键）· `fund` = 扁平 dict；修正 `profile` 被误标为「返回字符串」（实测是对象数组）

- · `/v1/snapshot` 字段数口径 24+ → **35 字段**（与端点页 / MCP 侧一致）

- · Skill 版本 0.2.0 → **0.2.1**；重新打包 `/skill` 下载包与 Agent Skills 分发包（`/.well-known/agent-skills/`）

 `2026-09-25` 修复 修复：/v1/calendar 返回陈旧数据 + 用错数据通道

- · **此前返回几个月前的陈旧数据**：/v1/calendar 走的是**残废通道**——输出只有 `date` + `event.zy` 两列（后者恒为 "1"，**无任何业务字段**），且**忽略 date / limit 参数**（实测传 `date=2026-09-25` 仍返回 06-01 起的全量升序）→ 客户端取到的是**几个月前**的旧数据，与"投资日历"语义相反

- · **改走正确通道**：现按事件类型**分段返回**（财报发布 / 分红派息 / 新股发行 / 会议 / 限售解禁 / 增发），含 `symbol` / `stockName` / `registrationDate` / `exDividendDate` / `paymentDate` 等业务字段，且 `date` 生效（默认从今天起，返回约 1 个月窗口内的**未来事件**）

- · **返回结构变更**：`data` 改为「**多段结构**」—— `data.tables` = 段列表（保序），每段含 `title`（中文标题）/ `slug`（英文键）/ `rows`；另有 `data.data{slug: rows}` 便捷索引

- · 段键：`financial_report` / `dividend` / `ipo` / `meeting` / `lockup_release` / `rights_issue`（另有 `trading_halt` 停复牌）

- · ⚠️ **破坏性变更**：此前直接遍历 `data` 取行的旧代码，需改为 `data.tables` 按段取（详见端点文档示例）

- · 同时修正参数说明：`date` 是**窗口起始日**（留空=今天起）；`limit` 为数据源规模参数，各段条数不严格等于该值

 `2026-09-25` 修复 修复：/v1/shareholder 丢失股东分段 + 返回结构变更

- · **此前只返回第一段**：/v1/shareholder 数据源返回三段（A股：十大股东 / 十大流通股东 / 股东户数统计；港股：持股股东信息 / 股东分布 / 机构持仓统计），但解析只取了第一张表 —— 后两段**静默丢失**

- · **返回结构变更**：`data` 改为「**多段结构**」—— `data.tables` = 段列表（保序），每段含 `title`（中文标题）/ `slug`（英文键）/ `rows`；另有 `data.data{slug: rows}` 便捷索引

- · A股段键：`top10_holders` / `top10_float_holders` / `holder_count`（含 `totalSHNum` / `avgHoldShares`，看筹码集中度）

- · 港股段键：`shareholders` / `holder_distribution` / `institutional_holdings`（**与 A股段语义不同，勿按序号取**）

- · ⚠️ **破坏性变更**：此前直接遍历 `data` 取行的旧代码，需改为 `data.tables` 按段取（详见端点文档示例）

- · 同时修正 `ok` 语义：数据源无数据时（如指数代码）此前会返回 `ok:true` + 空列表，现正确判为 `ok:false`

- · 另外补齐 `/v1/quote` 的**返回形态**说明：`data` 是**数组**（默认 30 条日线，`data[0]` 为最新），此前未说明，按对象解析会出错 —— 现注明取现价用 `data[0].last`

 `2026-09-25` 修复 修复：/v1/finance 期次方向错误 + 返回结构变更

- · **修正期次方向**：此前 `num=N` 实际返回的是**最早 N 期**（可能不含最新披露期）—— 已改为**最近 N 期**，与参数说明一致

- · **返回结构变更**：`data` 从「期次列表」改为「**表列表**」—— `data[0]`=利润表 · `data[1]`=资产负债表 · `data[2]`=现金流量表；每张表是 `[{EndDate: …, 字段: …}]`，**期次降序（最新一期在最前）**

- · 字段数大幅增加：三表分别为 85 / 70 / 31 列（含 Tushare 式的完整财务科目），此前单表仅 36 列

- · ⚠️ **破坏性变更**：遍历 `data` 的旧代码需改为先按表索引（详见文档示例）。此前 `structured` 对 finance 恒为空，一直走 `data` 分支

- · 另外修复 /v1/block-trade：此前只返回元信息、丢失成交明细 —— 现返回完整明细（成交价 / 折溢价 / 成交量 / 买卖方营业部）

 `2026-09-23` 新端点 新增端点：全字段行情画像（/v1/snapshot）

- · 一只股票的完整画像：价格 + 盘口 + 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本 + 涨停跌停价 + 量比 + 振幅 + 涨速

- · 与 /v1/quote 分工：quote 轻（8 字段）免费；snapshot 全（24+ 字段）属 pro 档——只要现价用 quote 更轻

- · 仅支持 A 股（港股/美股字段布局不同，硬解析会出错，故不支持——用 quote 查）

- · 端点数 31 → 32；MCP 工具 23 → 24（ashare_snapshot）

 `2026-09-23` 数据 五档盘口字段改为扁平列（b1_p / a1_v …）

- · 字段命名对齐主流数据接口惯例：b1_p/b1_v ~ b5_p/b5_v（买档价格/量）、a1_p/a1_v ~ a5_p/a5_v（卖档）

- · 扁平结构（一行 30 列）而非嵌套数组 → pandas 里直接 df["b1_p"] 取用，不用 df["buy"][0][0]

- · 响应 data 统一为行数组 → 两个 SDK（Python / Node）都自动返回 DataFrame / 对象数组

- · SDK 升 0.1.2；跌停买档全 0 / 涨停卖档全 0（正常现象，已在文档标注）

 `2026-09-23` 新端点 新增端点：五档盘口（/v1/orderbook）

- · 买一~买五 / 卖一~卖五 的价格与挂单量（手）+ 现价 / 涨跌 / 数据时间

- · 秒级快照（10 秒缓存）· 盘中才有意义 · 收盘后为当日最后快照

- · 端点数 30 → 31；MCP 工具 22 → 23（ashare_orderbook）

- · 两个 SDK（Python / Node）同步加 orderbook() 方法

 `2026-09-23` 上线 Node.js / TypeScript SDK 上线 npm

- · npm install ashareapi —— 30 个端点对应 30 个方法（npmjs.com/package/ashareapi）

- · 零运行时依赖（Node 原生 fetch，要求 Node ≥ 18）；ESM 与 CommonJS 双格式 + TypeScript 类型

- · 免费端点无需 Key；返回对象数组；方法名 camelCase 与 snake_case 都认

- · 教程：/docs/guides/nodejs-ashare-quotes

 `2026-09-23` 上线 Python SDK 上线 PyPI

- · pip install ashareapi —— 官方 Python SDK，30 个端点对应 30 个方法（pypi.org/project/ashareapi）

- · 免费端点无需 Key；返回 pandas DataFrame（未装 pandas 自动降级 list[dict]）

- · 代码格式兼容：sh600667 / 600667.SH / 纯 6 位都认

- · 5 类异常分清「当前无数据」与「取数失败」（EmptyResultError / UpstreamError）

- · 教程：/docs/guides/python-sdk

 `2026-09-23` 上线 Agent Skill 上线（45+ 客户端通用）

- · 一个文件夹装进 Claude Code / Cursor / Codex / OpenCode 等 45+ 支持 Agent Skills 的客户端，AI 自动知道怎么用

- · 开放标准（agentskills.io）· 只用 6 个标准 frontmatter 字段 → 跨客户端兼容

- · 渐进式披露：SKILL.md 常驻 + 4 份 references（端点 / 字段 / 错误 / SDK）按需读取

- · 页面与下载：/skill

 `2026-09-21` 新端点 匿名提额挑战 + 端点数 29

- · 新增端点 /v1/challenge：解一次挑战，匿名配额 5 次/分 → 60 次/分

- · 端点数 28 → 29（26 个数据端点 + 3 个工具端点：健康检查 / 挑战 / 用量）

- · 热搜榜 /v1/hot 的 limit 生效（默认 30，上限 50）

- · 跨域（CORS）开放 —— 状态页与浏览器可直接调用

 `2026-09-16` 上线 服务上线

- · 28 个端点全量开放（6 免费 + 22 付费）

- · 首尔节点 · 多源自动取数（实测 100% 成功 / 862ms）

- · HTTPS 全站 · 证书自动续期

- · MCP 接入（22 工具）

- · IP 维度反倒卖保护

 `2026-09-15` 数据 数据源扩展

- · 67 个数据源 · 自动挑最快的 + 连续失败自动跳过

- · 资金流三个源互为备份（多源交叉）

- · 龙虎榜分榜（机构 / 游资 / 席位）