产品在维护

更新日志

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

变更政策
加新端点不另行收费（按调用次数计，端点数不影响价格）
改返回结构会提前公告；字段只增不删（除非有明确缺陷）
下线功能提前 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 <你的 ashareapi Key>。
  • 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新端点选股能力扩充：一个端点五种选股方式（标签 / 排行 / 策略 / 事件）
  • 选股 现在用 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新端点新增交易日历（开市/休市 · 年末最后交易日）—— 免费
  • 新增 交易日历：逐个日期给出是否开市，以及该日是不是本周/本月/本季/本年的最后一个交易日 —— 做结算日、到期日、调仓日的时候直接查。
  • 三种查法：不传参数 = 当月 · date=2026-10-16 = 单日 · start+end = 任意区间，或 year=2026 = 整年。加 trading_only=true 只返回开市日（整年约 242 行）。
  • ⚠️ 和 /v1/calendar 不是一回事：那个是个股事件日历（分红/解禁/财报披露），这个只讲市场开不开市。
  • 本端点免费（不需要 API Key）。
2026-10-19参考空结果文档：补充「数据源临时不可用」怎么识别（degraded 字段）
  • 空结果不等于故障 多了一条判据：响应里出现 degraded: true，表示这次是数据源临时不可用（例如一时请求过于频繁），不是这个标的没有数据。
  • 同时会给出 reason 和 retry_after_s（还有多少秒可以重试）—— 稍后重试通常就有，别把它当成"没数据"跳过。
  • 没带 degraded 的 ok:false 才是"这个标的确实没有这项数据"，这个语义没有变；正常请求的返回结构也完全不变。
2026-10-18新端点新增财经多源取证（公告 + 资讯 · 跨源去重 · 带证据指纹）
  • 新增 财经多源取证：一次查询同时检索巨潮公告（沪深两市·官方一手）与东方财富资讯，归一成同一张表。
  • 转载去重：同一条消息被多家转时只出现一次，其余收在 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 财经快讯（全市场电报）
  • 新增 财经快讯：全市场快讯流（财联社等来源），按时间倒序，每条含 time / title / content / source / url。
  • 和「个股资讯」的区别：那个要传股票代码、只给某只票的消息；这个是全市场电报，问「今天有什么大消息 / 刚才发生了什么」用这个。
  • 翻页：index 从 0 开始，步长 = 上次的 limit（limit=20&index=20 是第二页），只能往回翻。
  • ⚠️ limit 上限 200；缓存 1 分钟（同一分钟内重复请求不重复消耗）。
  • 谁能用：标准版（¥29.9）起；免费额度不含。
2026-10-18新端点新增 L2 大单委托流 + 龙虎榜席位明细（不限量版专属）
  • 新增 L2 大单委托流：当日挂单明细（委托量 ≥ 500 手或金额 ≥ 30 万），每笔带涨停价挂单与已撤单标记。⭐ 它回答「封单是真的还是演的」—— 大额买单挂上去又撤，就是典型假封单。
  • 新增 龙虎榜席位明细：某只票某次上榜的营业部买卖席位（最多 10 个），含买入额 / 卖出额 / 净买额 / 游资标记。比「机构榜统计」更具体：能看到是「沪股通专用」、某证券营业部，还是游资席位。
  • 配合用法：bigorder-queue 看挂单（可能撤）、bigorder-flow 看成交（真买了）—— 两个一起看才能分清「挂了没成」和「真买了」。
  • ⚠️ 委托流仅当日；龙虎榜是盘后数据，date 留空 = 最近一次上榜日（以返回 date 为准）。
  • ⚠️ 委托是挂单口径不是成交；席位最多 10 行（数据源限制）。
  • 谁能用：不限量版（¥199/月）专属；其他档位返回明确说明与升级链接。
2026-10-18新端点新增 L2 大单成交明细（主动/被动拆分 · 不限量版专属）
  • 新增 L2 大单成交明细：单只股票当日每一笔成交额 ≥ 阈值的大单，每笔标出主动/被动 × 买/卖四种方向（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 大单资金分时：单只股票的当日分钟级大单净额曲线（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：个股 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 选股的落地面 —— 讲清用我们的 API 怎么选股：88 个因子 → 表达式筛选 → 29 个策略回测，一套 API 走完全链路。
  • ⭐ 三步各对应端点：/v1/factors 定因子 · /v1/screen 写条件 · /v1/backtest 验结果（含真实交易成本）。附一条可直接跑的筛选表达式。
  • ⚠️ 先把边界说清：不推荐股票 · 不承诺收益 · 不碰自动交易 —— 给的是选股能力（可复算），不是选股结果。
  • 同族页面：Agent 量化（品类定义 · 数据可核对）。
  • 中英都有：English page。
2026-10-13新端点新增 /v1/abnormal —— 异动 / 偏离值（短线监管异动）
  • 新增端点 /v1/abnormal：短线监管异动 / 偏离值体系 —— 触发「严重异动」、「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」章节（开发者页）：两个终端的内置 Python 版本较旧（QMT 3.6 · Ptrade 3.5），且有券商库白名单与沙箱限制，第三方包默认装不进去。
  • ⭐ 给出可行做法：「外部取数、终端读文件」 —— 在终端之外用 SDK 拉数落 CSV，策略内只用终端自带的 pandas 读本地文件（不装包、不联网）。附两段可直接复制的示例。
  • ⚙️ 同步：文档页与开发者页的 Python / Node 安装命令改为切换式（此前两块并排显示）。
2026-10-13教程新增开发者入口 —— SDK 快速上手、常用方法与接入场景
  • 新增 /developers/ 开发者页面：Python 与 Node.js 两条可直接复制的上手示例、常用方法表、以及"能接进什么"（本地研究 / 自建看板 / 策略脚本 / 批量扫描）。
  • ⭐ 导航新增「开发者」入口，首页与定价页各加 SDK 区块 —— 此前 SDK 只出现在功能清单里，没有独立入口。
  • ⚙️ 文档页同步：/docs/ 的快速开始现在同时讲 curl 与 SDK（此前只讲 curl）。
  • 官方 SDK：pip install ashareapi · npm install ashareapi —— 免费端点装上就能跑，无需 Key。
2026-10-13教程文档页「快速开始」改为 curl + 官方 SDK 双轨 —— 两行代码拿到 DataFrame
  • 新增官方 SDK 接入区块（文档页）：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：批量资金流端点 —— 一次调用拿多只股票的资金流（主力资金 + 龙虎榜 + 大宗 + 融资融券），用 codes=sh600519,sz000001,sz300750 逗号分隔。给做量化的用户扫池子用，不必一只一只调 /v1/fund。
  • ⭐ 单次上限：专业版 200 只（约一个行业）· 不限量版 1000 只。按实际返回只数计费，失败的不计。
  • 逐只标明结果：返回带 requested / returned / failed 计数，data 里每只标 ok —— 哪只拿到了、哪只没有，一眼看清（资金流仅覆盖 A 股；港股只有主力净流入，美股无此数据）。
  • 独立端口：与单只的 /v1/fund 完全分开，原有接口一行不动。
  • 中英都有：English changelog。
2026-10-12参考新增「Agent 量化」品类定义页 —— 讲清与传统量化的区别，以及数据为什么必须可核对
  • 新增 /agent-quant/：Agent 量化的品类定义页 —— 讲清什么是 Agent 量化、跟传统量化（聚宽 / 米筐 / 优矿 / 掘金）的区别，以及「Agent 会不会编」为什么是这个品类真正的瓶颈。
  • ⭐ 核心主张：传统量化出错能 debug，Agent 量化出错分不清「算出来的」和「编出来的」 ⇒ 所以 Agent 量化要的不是「数据多」，是「数据可核对」（固定前复权 / 单位统一 / 空结果≠故障 / 固定信封）。
  • ⚠️ 先说边界：不承诺收益 · 不碰自动交易 · 不跟竞品比「AI 选股准不准」。
  • 怎么做在 /docs/ai-quant/（四条数据路径对比 · REST 与 MCP · 回测最容易骗自己的四个坑），本页只负责定义品类。
  • 中英都有：English changelog。
2026-10-12教程国内平台接入新增「单平台详情页」—— 豆包打头，后续平台逐个补齐
  • 新增 /docs/mcp-china/doubao/：豆包接入独立详情页 —— 把安装步骤、Key 填法、可问示例、常见问题收在一页，比总览页的一行摘要更好照着做。
  • 总览页 /docs/mcp-china/ 每个平台卡片新增「查看详情 →」入口，从对照表直达单平台步骤。
  • ⭐ 逐平台一页：后续百炼 / 扣子 / 元器 / 腾讯云 / 火山方舟按同一模板补齐，地址规律 /docs/mcp-china/<平台>/。
  • 中英都有：English changelog。
2026-10-12教程国内平台接入教程新增「豆包工作」—— 官方支持自定义 Headers，付费工具可用
  • /docs/mcp-china/ 新增豆包工作的接入步骤：左侧「插件·技能·伙伴」→「插件」页右上角 + 添加 → 新建自定义插件 → 传输类型选 HTTP、服务器 URL 填 https://api.ashareapi.com/mcp → 在「自定义 Headers」加一条（名称 Authorization、值 Bearer <你的 Key>）→ 保存后在对话框输入 / 或 @ 搜 ashareapi 使用。
  • ⭐ 豆包支持自定义请求头（官方《在豆包工作中使用插件》明确「HTTP 类型 + 自定义 Headers」）⇒ 付费工具也能用，不是百炼 / 扣子那种只能用免费工具。
  • ⚠️ 豆包官方现称「插件」（入口「插件·技能·伙伴」），早期第三方教程里的"连接器"是同一功能旧称；首次可能提示「运行失败」，到插件列表点「重新启动」即可。
  • 中英都有：English changelog。
2026-10-12参考快速开始与定价页新增「代码格式速查」入口 —— 股票代码必须带小写市场前缀
  • /docs/ 与 /pricing/ 各新增一个「代码格式」入口，直达代码格式速查：sh600519（沪）· sz000001（深）· bj920002（北交所）· hk00700（港股）· usAAPL（美股）。
  • ⭐ 为什么加：行情端点只认「小写前缀 + 代码」。实测（2026-10-12）：上面五种规范写法均正常返回；而 600519（不带前缀）· 600519.SH（点号写法）· SH600519（大写前缀）· sh60051（位数不对）全部返回空（ok:false + 空数组）—— 看着像「没有这只票」，其实是格式问题。
  • 一律带前缀是最省事的做法；代码不确定时，用 /v1/search 按名称搜出规范代码再调。
  • 中英都有：English 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。
2026-10-11数据公告端点 /v1/notice 门槛下调至标准版（¥29.9）—— 资讯能力在标准版完整
  • /v1/notice（上市公司公告）门槛由专业版下调为标准版：现在标准版（¥29.9）及以上即可调用，可翻约 16 年历史（茅台实测 929 条，回溯到 2010 年）。
  • ⭐ 调整理由：标准版原本只有 news（最新资讯），缺「历史」这一半 —— 把「新闻 + 公告」作为一个完整能力放在同一档，你升级到标准版后资讯面即可齐备，不用再往上买一档。
  • 专业版（¥99）仍有的研究级能力不变：批量回测（多票 × 多策略对比）、全市场单日 K 线（一次拿 5000+ 只）—— 这两项才是专业版「做得到 vs 做不到」的差异。
  • 已购买标准版的用户自动生效，无需任何操作；现有调用与计费方式不变（公告按次计入用量，与其他数据端点一致）。
  • 中英都有：English 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。
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。
2026-10-10新端点资讯能力上线：/v1/news（最新资讯）· /v1/notice（公告，可回溯约 20 年）· /v1/hot 扩展 5 类榜单
  • 新增 个股资讯：/v1/news?code=sh600519 返回该标的财经资讯列表（标题 + 来源 + 时间）；/v1/news?id=SN... 返回该条完整正文 —— 让 AI 真正能读消息面。用户问「这股票最近有什么消息」「这条新闻讲了什么」时用这个。
  • 新增 公告：/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。
2026-10-10新端点新增全市场单日 K 线端点 /v1/market-kline —— 一次拿到全 A 股当日行情
  • 新增 全市场单日 K线：/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。
2026-10-10新端点新增文档检索端点 /v1/wiki —— agent 不确定字段单位/口径时可直接查
  • 新增 文档检索：/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
  • 新增 批量回测：/v1/backtest-batch 一次跑多只标的 × 多个策略，直接返回对比矩阵（谁表现最好），省去逐个调用。20 只标的 × 10 条策略以内、组合总数上限 60；每只标的的行情只加载一次供全部策略复用，15 组合约 1 秒返回。单只标的失败不中断整批（该组合标注原因，其余照跑）。属付费档（专业版及以上）。
  • 组合回测新增权重方案：/v1/backtest?mode=portfolio 支持 weighting=inv_vol —— 按每只票的波动率倒数分配仓位（波动小的多配、波动大的少配），与默认的等权 equal 并列。实测同一组合、同一区间，波动率倒数加权比等权少亏 11.85 个百分点（最大回撤同样更浅）。属不限量版能力。
  • 新增 IP 白名单：可把 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。
2026-10-08新端点新增量化回测 /v1/backtest · 量化策略清单 /v1/strategies · 量化因子库 /v1/factors · 量化方法论库 /v1/playbooks
  • 新增 量化回测：/v1/backtest 按内置策略跑历史回测，返回总收益 / 年化 / 夏普 / 最大回撤 / 年化波动等指标，可选返回净值曲线。已计入佣金、印花税、过户费、滑点，并计入涨跌停与停牌约束（封板不可成交则顺延，停牌无行情则不成交）。属付费档（标准版及以上）。
  • 新增 量化策略清单：/v1/strategies 列出全部内置策略与参数范围 —— 20 条单标的择时（买入持有 / 均线 / 动量 / 反转 / 低波动 / 波动率目标 / MACD / KDJ / RSI / 布林 / WR / OBV / CCI / SAR / 海龟 / 网格 / 定投 …）+ 9 条组合选股（动量 / 反转 / 低波动 / 均线 / 量能突破 / 小盘 / 大盘 …）。属付费档（Standard 及以上），查清单不占用回测额度。
  • 新增 量化因子库：/v1/factors 列出全部 88 个选股因子（代码 / 中文名 / 单位 / 说明 / 分类）+ 22 个预设 + 8 条使用规则。因子直接用于 /v1/screen 的表达式筛选，例如 intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])。
  • 因子支持历史截面：/v1/screen?date=YYYY-MM-DD 可取任意历史交易日的因子值（2016-08-08 起有数据）⇒ 可串成 因子 → 筛选 → 回测 的完整研究链路。
  • 新增 量化方法论库：/v1/playbooks 给出一套套「怎么判断市场」的可复用流程 —— 每条写明判据（算式 + 数据 + 阈值）、阶段（如情绪：冰点/启动/发酵/高潮/退潮，各阶段应对）、能避开什么亏损，以及实测证据（跑过的回测数字；标「待实测」的表示还没跑，我们不编数字）。共 13 条，覆盖风险管理 / 动量趋势 / 基本面 / 估值分位 / 组合再平衡 / 资金流向 / 大盘择时 / 板块轮动 / 情绪周期 / 量能结构 / 事件驱动 / 涨停接力 / ST 摘帽重整。属付费档（标准版及以上）。
  • 「避开 ST」与「炒 ST」并存：「风险排雷」教怎么剔除 ST 等风险标的，「ST 摘帽与重整博弈」教怎么从中找机会 —— 同一只票，保守型看到风险、进取型看到机会，我们两条都给。⚠️ 其中「剔除 ST」的实测结论出乎意料：动量策略剔除 ST 后反而略差，小盘策略剔除后少赚但回撤小 —— 本质是用收益换回撤，是风险偏好的取舍，不是简单对错。
  • 两种回测模式：mode=single 单标的实时计算（毫秒级）；mode=portfolio 组合回测查预计算结果（组合回测涉及全市场数据，耗时较长，故预先算好）。
  • 端点总数 34 → 38。
  • 中英都有：English 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。
2026-10-07新端点新增全历史 K 线端点 /v1/kline-full · MCP 工具 26 个
  • 新增 全历史 K 线端点：/v1/kline-full 返回10 年日线（2016-08-08 起，约 2465 条），并支持可选复权口径 fq —— qfq 前复权 / hfq 后复权 / nofq 原始价。做回测建议用 hfq 或 nofq（前复权序列会随新的除权除息重算，不可复现）。属付费档（Standard 及以上）。
  • 与 K 线 的分工：/v1/kline 轻量（上限 1212 条、复权口径固定前复权）；/v1/kline-full 全历史 + 复权可选，但仅 A 股股票（ETF / 可转债 / 指数 / 板块 / 港美股请继续用 /v1/kline）。
  • 端点总数 33 → 34：免费 7 个不变，付费 27 个。
  • MCP 新增 ashare_kline_full 工具，工具总数 25 → 26。
  • 中英都有：English changelog。
2026-10-07参考Wiki 新增四篇：返回形态 / 字符串数值 / 批量取数 / 跨市场差异
  • 返回形态速查：data 有四种形态（行数组 / 表列表 / 已排版文本 / 多段结构），全部 33 个端点分别属于哪一种、怎么一眼判断、程序化取数该读哪个键。
  • 字符串数值：多数端点的价格、成交额返回的是字符串（"1723.50"）而不是数字 —— 哪些端点受影响、怎么安全转换、排序比较会踩什么坑。
  • 批量取数：哪些端点支持一次传多个代码（逗号分隔）、不支持的怎么循环取、以及循环时的限流处理。
  • 跨市场差异速查：同一端点在 A 股 / 港股 / 美股 / 北交所的字段差异，以及哪些端点只覆盖 A 股。
  • 中英都有：English wiki。
2026-10-06新端点新增分时端点 /v1/minute · K 线支持分钟周期
  • 新增 分时端点：/v1/minute 返回盘中逐笔走势（每分钟一个价格 + 累计量），days=1 当日、days=5 近 5 个交易日。属付费档。
  • K 线 新增分钟周期：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。
2026-10-05参考新增 Wiki：字段速查与口径说明
  • 新增 Wiki 参考区：字段速查、口径说明、常见误用 —— 比教程短，需要时随时查。
  • K 线返回字段速查：收盘价字段叫 last 不叫 close、数值都是字符串、volume 单位是手而不是股。
  • 单位速查：volume 一律是手；amount 在 K 线里是元、在 /v1/snapshot 里是万元 —— 混用会差 1 万倍。
  • 复权口径：K 线价格固定为前复权，没有 adjust 参数，除权除息日不跳空。
  • 返回信封字段：ok / endpoint / tier / elapsed_ms / source / data 六个字段各是什么，以及哪些返回不走这套结构。
  • 代码格式速查：sh / sz / bj / hk / us 前缀怎么写（前缀必须小写），ETF / 可转债 / 板块代码长什么样。
  • 数据时间口径：数据日期看 date 字段而不是系统时间 —— 各市场、各端点的更新节奏不一样。
  • 空结果不等于故障：返回空数组多半是代码格式写错，不是接口坏了；空结果不扣次数。
  • 中英都有：English wiki。
2026-10-04修复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）。
2026-10-02上线DeepSeek Harness 插件上线：桌面端 / Web UI 输包名即装
  • 新增 DSH 插件页：一个 DeepSeek 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（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
2026-10-01教程新增教程：用 /v1/quote 查实时行情与日 K 收盘价（免 Key）
  • 新增 用 /v1/quote 查实时行情与日 K 收盘价：一次 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 股大宗交易怎么看：折价率、机构席位与买卖方，含恒瑞医药 2.5 亿 -8% 折价真实案例，以及扫"大额 + 深折价"的 Python 示例。
  • 新增 股东户数怎么看：三张表（十大股东/流通股东/户数统计）、筹码集中度怎么读，含太极实业户数一年翻 3.5 倍的完整案例。
  • 新增 K 线数据怎么算技术指标：MA / MACD / RSI / KDJ / BOLL 五个常用指标，纯 pandas 不依赖 TA-Lib。
  • 新增 用涨跌分布判断市场温度：上涨占比/涨停数怎么读市场情绪，连续看几天判断拐点。
  • 全部基于线上真实数据（2026-09-29 实测），可直接照跑。
2026-09-29教程新增因子选股专题：4 篇教程（含数据体检方法）
  • 新增 因子选股入门：/v1/screen 怎么用、结果怎么读，以及筛完必做的 3 步数据体检（多口径一致性 / 扣非 / 杠杆）——附一个真实案例：被筛出来的 PE 0.36 / ROE 883% 是怎么一步步被验证为"因子值不可用"的。
  • 新增 因子表达式语法与因子字典：intersect([...]) 结构、6 种运算符、单位与百分数规则、85 个已验证因子（估值 / 盈利 / 资产负债 / 现金流 / 行情）、14 个可直接复制的组合模板、8 个必踩的坑。
  • 新增 22 个现成的选股方案：按"估值 / 盈利质量 / 技术面 / 资金机构"四类讲清每个方案筛什么、适合谁，附 5 个方案的真实返回与踩坑提示。
  • 新增 实战：价值筛选与异常值排查：四条件价值筛选 → 四步排查 → 把排查固化为可复用函数并批量跑，四步规则精准命中异常值且无误伤。
  • 所有示例数据均为线上真实返回（2026-09-29 实测复现），可直接照跑；体检方法参考项目内因子词典（85 因子，2026-08-31 验证）。
2026-09-28修复数据源数量口径更正：67 → 70
  • 我们聚合的数据源数量为 70 个（此前部分页面显示 67 个）—— 67 是早先的分类估算，70 按我们实际接入的来源逐项统计得出。
  • 变的是显示数字，不是数据本身：接口返回、字段、端点数（32 个）均无变化；受影响的是首页状态卡 · 服务状态页 · 定价页 · 对比页 · 页脚，现统一为 70。
  • 服务状态页 的分组清单按类别列出规模：行情 / 财务 / 资金流 / 龙虎榜 / 板块 / 热榜与情绪 / 公告新闻研报 / 其他 —— 各组相加 = 70。
2026-09-28修复K 线口径：固定为前复权（不需要自己再复权）
  • /v1/kline 返回的是前复权价 —— 除权除息日不跳空；接口没有 adjust 参数（口径固定、无参数可调）。⚠️ 请不要再自己复权（二次复权会让价格与真实行情不符）；不复权 / 后复权序列不提供。
  • 与不复权数据对不上时，差异会精确出现在「跨除权除息」的窗口上（长窗口如 MA120 更明显），短窗口（MA5 / MA10）通常一致 —— 这是口径差异，不是取数错误。
  • 这个口径现在写在你会看到的所有地方：教程与问答 · 端点描述（/openapi.json 与端点页）· MCP 工具 ashare_kline · Agent Skill · 官方 SDK（Python / Node.js 的 kline() 文档与 README）。
  • MCP 服务器地址是 https://api.ashareapi.com/mcp（客户端里填这个）；ashareapi.com/mcp 是配置说明页，不是接口地址。
  • 新增对比页：ashareapi vs 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 个数据源 · 自动挑最快的 + 连续失败自动跳过
  • 资金流三个源互为备份（多源交叉）
  • 龙虎榜分榜（机构 / 游资 / 席位）