A股数据 API (A-Share Data API)

**异动 / 偏离值**（短线监管异动体系）：触发「严重异动」、「10日100% 偏离」、异动盯盘名单。用户问'今天有哪些异动股/偏离值/触发严重异动/被监控的票/短线风险股'用这个。`mode` 取值：`deviation` 偏离值热门榜（今日，默认）· `deviation_hist` 偏离值历史（需 date）· `deviation_plan` 偏离值（今日+明日两组，`group` 字段区分）· `abnormal` 异动频率+异动原因（需 date，每日全量）· `watch` 异动盯盘名单（今日）· `watch_hist` 盯盘历史（需 date）· `alert` **严重异动提醒**（今日，⭐ `reason` 为人读提醒原因，如「10日内3次异动个股」「10日内偏离值临近100%」）。⚠[U+FE0F] 历史类 mode 的 `date` 须为真实交易日（YYYY-MM-DD，非交易日返空）。字段：`reason` 触发规则说明 · `pct` 涨跌幅% · `board_desc` 连板 · `concepts` 概念 · `trigger_pct` 触发阈值% · `limit_price` 参考价 · `status` 异动状态 · `price` 现价 · `abn_start` 异动起始日 · `date` 数据日期。只读查询。

**歧义时向用户提问**（结构对齐 Claude Code `AskUserQuestion`）。\n⭐ **什么时候用**：用户只给了**模糊名称**（「平安」「腾讯」），你不确定指哪家公司时。\n 本工具**不会替你选**，而是返回 **1–4 个带说明的选项**（如「中国平安 · 沪市主板·保险龙头」），由你转成问题问用户。\n⚠[U+FE0F] **选项说明由模型生成**（需要语义："中国平安"和"平安银行"差在哪，规则写不出来） ⇒ 带 `X-LLM-Key` 时质量最好；不带则只返回原始候选（无说明）。\n⚠[U+FE0F] 返回 `needs_clarification=false` 表示**歧义已消**（模型判断只有一家可能），此时 `chosen_code` 就是答案，直接用它继续。\n⛔ 本工具不查数据，只做消歧。拿到 code 后再调 `ashare_agent_search` / `ashare_quote`。

**集合竞价**：个股 9:15–9:25 集合竞价数据，含**「竞价触及涨停」判定**。用户问'竞价分时 / 竞价怎么走的 / 集合竞价买了多少 / 哪些票竞价就涨停了'用这个。`mode` 取值：`stock` **当日竞价分时**（默认，分钟级逐笔）· `stock-history` **历史竞价分时**（秒级逐笔，需 `date`）· `volume` **当日竞价量 / 资金净额**（单点）。⭐ `is_limit_up` = 「竞价触及涨停」判定（竞价段最高价 ≥ 涨停价，涨停价取自行情源原始值）。另含 `up_px` 涨停价 / `down_px` 跌停价 / `open_px` 09:25 撮合价 / `preclose_px` 昨收。⚠[U+FE0F] `mode=stock` 仅当日；历史请用 `mode=stock-history` 且必传 `date`（真实交易日）。只读查询。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

**量化回测**：按策略跑历史收益（返回收益/最大回撤/交易次数/净值曲线等）。用户问'回测一下/这个策略收益如何/买卖点效果/最大回撤'用这个。⚠[U+FE0F] 两种模式：`mode=single`（默认）**单标的实时计算**，须配 `code`；`mode=portfolio` **组合**（须用 `strategies` 里的组合策略，区间受预置批次限制）。⚠[U+FE0F] `weighting=inv_vol`（按波动率倒数配仓）**仅组合模式 + 不限量版**可用。⚠[U+FE0F] 想知道有哪些策略/参数范围，先调 ashare_strategies；想一次跑多标的×多策略，用 ashare_backtest_batch。⚠[U+FE0F] **付费工具**（需 Key）：单标的 **Standard（¥29.9）起**；组合 / 批量回测为 **Pro 及以上**，且有独立日额度，余量可查 ashare_usage。

**批量回测**：一次跑 **多标的 × 多策略**，返回对比矩阵（哪个组合最好一目了然）。用户问'这几只股票用不同策略分别跑一下/批量回测/策略对比'用这个。⚠[U+FE0F] 与 ashare_backtest 的区别：本工具**一次给多标的×多策略的横向对比**，ashare_backtest 只跑**一个**策略。⚠[U+FE0F] 上限：标的 ≤20 · 策略 ≤10 · 组合 ≤60（**超限直接报错，不静默截断**）。⚠[U+FE0F] 组合策略不能用于批量回测（批量只支持单标的择时策略）。⚠[U+FE0F] 参数可传**列表**（自动转逗号）。⚠[U+FE0F] **付费工具**（需 Key）：**Pro（¥69）及以上**，有独立日额度。

**单股 L2 大单资金分时**（分钟级）：`net` = 该分钟**大单净额（元）**，正数=大单净买入、负数=净卖出。用户问'大单在买还是卖/主力资金分时/哪一分钟砸盘'用这个。⚠[U+FE0F] **仅当日**（非交易日/盘前返回最近一个交易日），日期看返回顶层 `day`。⚠[U+FE0F] 盘中末尾几分钟仍在追加：09:30–15:00 约 **242 点**，盘中调用点数会随交易时段增长。⚠[U+FE0F] 这是**大单口径**（按成交金额聚合）—— 不是逐笔委托、也不是十档盘口，别把它当'盘口深度'用。⚠[U+FE0F] **不限量版专属**：专业版及以下调用会返回明确说明 + 升级链接，不会静默失败。⚠[U+FE0F] 与 `ashare_fund` 的分工：`ashare_fund` 给**日级汇总**（主力净额 1/5/10/20 日）+ 龙虎榜/大宗/两融；本工具给**当日分钟级大单曲线** ⇒ 看趋势用本工具，看快照用 fund。

**L2 大单成交明细**（当日逐笔，成交额 ≥ 阈值）：每一笔都标**主动/被动 × 买/卖**。行字段 `time` / `direction`（1 被动卖 · 2 主动买 · 3 被动买 · 4 主动卖）/ `direction_cn` / `volume`(**手**) / `amount`(**元**) / `avg_price`。顶层 `meta` 有 `money_threshold`、`total`（当日总笔数）、`truncated`、`summary`（四方向金额合计）。用户问'这票是谁在主动买/有没有人在扫货/大单是主动还是被动成交'用这个。⭐ 与 `ashare_bigorder` 的分工：bigorder 给**每分钟净额曲线**（看节奏），本工具给**逐笔明细 + 四方向拆分**（看谁打谁）。⚠[U+FE0F] **仅当日**（非交易日/盘前返回最近交易日，日期看行里的 `time`）。⚠[U+FE0F] **单次最多约 200 笔**：`total` > `returned` 时用 `money` 抬高阈值（0=30万 …4=1000万）缩小范围。⚠[U+FE0F] 这是**成交口径**，不是逐笔委托、也不是十档盘口。⚠[U+FE0F] **不限量版专属**：其他档位返回明确说明 + 升级链接。

**L2 历史大单净额**（逐日，往回最多 **100 个交易日**）：每天一个值，行字段 `date` / `net`（当日大单净额，**元**，正=净买入负=净卖出），**倒序**（最新在前）。用户问'这票大单最近是不是一直在吸/大单资金趋势/前几个月大单怎么走的'用这个。⭐ 与 `ashare_bigorder` 的分工：那个只能看**今天**，本工具补「往回看」—— 判断是**持续吸筹**还是**只今天冲一下**，以及哪天开始转向。⚠[U+FE0F] 数据源固定返 100 个交易日，`limit` 只在本地截断（省流量不省调用）。⚠[U+FE0F] `net` 是**大单口径**（按成交金额聚合），⛔ 不是主力净额、不是龙虎榜、不是逐笔。⚠[U+FE0F] **不限量版专属**：其他档位返回明确说明 + 升级链接。

**L2 大单委托流**（当日挂单明细）：委托量或金额超过阈值的**挂单**逐笔列出，带 `is_limit_up`（涨停价挂单）和 **`is_cancel`（已撤单）**。行字段 `time` / `order_id` / `price` / `volume`(手) / `amount`(元) / `side`(1买2卖) / `side_cn` / `is_limit_up` / `is_cancel`。用户问'封单是真的吗/有没有大单挂了又撤/假封单'用这个。⭐ **与 bigorder-flow 是两件事**：queue = **挂单**（可能撤），flow = **成交**（真买了）。两个一起看才能分清「挂了没成」和「真买了」。⚠[U+FE0F] **仅当日**；`vol` ∈ {500,1000,2000,5000,10000} 手、`tur` ∈ {30,50,100,200,500,1000} 万；单次最多约 200 笔。⚠[U+FE0F] 这是**委托口径**，不是成交、也不是十档盘口。⚠[U+FE0F] **不限量版专属**。

**L2 全市场主力净额榜**（约 5568 只）：一次拿到全市场的主力买卖与净额，8 种排序、可翻页、可回看历史。`sort` 取值：`net_in` 主力净流入（默认）· `net_out` 主力净流出 · `buy` 主力买入额 · `sell` 主力卖出额 · `gain` 涨幅 · `loss` 跌幅 · `turnover` 换手率 · `mcap` 市值。行字段（金额单位**元**）：`code` / `name` / `price` / `change_pct` / `main_buy` / `main_sell`（负数） / `main_net` / `turnover_rate` / `amount` / `market_cap` / `concept`。用户问'今天主力在买什么/资金流入最多的是哪几只/谁在被砸/哪些板块主力在买'用这个。⭐ **恒等式可自检**：`main_buy + main_sell == main_net`（全市场 100% 成立）。⭐ 下钻路径：本工具选股 → `ashare_bigorder`（分钟净额）/ `ashare_bigorder_split`（四分解）看个股结构。⚠[U+FE0F] `limit` 最大 6000（可一次取全市场，约 1 MB）；翻页用 `offset`。⚠[U+FE0F] `market_cap` 为数据源原始市值字段，仅供排序/粗筛，⛔ 不要与其它工具的市值字段混用。⚠[U+FE0F] **不限量版专属**。

**L2 主力四分解**（分钟级）：把主买拆成**主动买 + 被动买**、主卖拆成**主动卖 + 被动卖**，每 1 分钟一行。行字段（金额单位**元**）：`time` / `trades` 笔数 / `net` 净额 / `main_buy` / `main_sell`（**负数**） / `active_buy` / `passive_buy` / `active_sell` / `passive_sell`。顶层字段（与 `data` 平级）有全天汇总与 **`buy_avg_price` / `sell_avg_price`**（主力买卖**加权均价**）。用户问'主力主动买多少、被动买多少/是扫货还是被砸/买卖均价多少'用这个。⭐ **和 `ashare_bigorder_flow` 的分工**：flow 是**逐笔成交明细**（看具体哪一笔，仅当日、≤200 笔）；本工具是**分钟聚合**（看节奏与均价，**可回看历史**、无条数上限）。⚠[U+FE0F] 传 `date` = 历史某交易日；不传 = 当日实时。⚠[U+FE0F] 这是**资金口径**（按成交方向拆分），⛔ 不是委托队列、不是十档盘口。⚠[U+FE0F] **不限量版专属**。

**大宗交易成交明细**：成交价 / 成交量 / 成交额 / **折溢价率** / 买方营业部 / 卖方营业部。用户问'有没有大宗交易/折价还是溢价成交/谁在接盘/机构席位'用这个。⚠[U+FE0F] **code 可留空**：留空 = 当日**全市场**大宗交易；给了 code = 该股的大宗记录。⚠[U+FE0F] `date` 留空 = 最近交易日。⚠[U+FE0F] **当日无大宗交易时返回的是行情元信息**（code/name/date/closePrice/changePct，证明标的没问题、只是没有大宗）—— 判『有没有大宗』要看返回里有没有`TurnoverPrice`/`BuySalesDepartment` 这类成交字段。⚠[U+FE0F] **与 ashare_fund 的关系**：`ashare_fund` 的大宗只是概览一行；本工具是**逐笔明细**。

可转债完整条款：溢价率/转股价值/双低值/强赎触发价/回售触发价/转股价/正股/到期日/评级。用户问'转债条款/强赎/双低/溢价'用这个。⚠[U+FE0F] 要转债**行情价**请用 ashare_quote（同样支持转债代码）。只读查询；代码形如 sh113052（沪）/ sz123138（深）。

**个股事件日历**：分红派息 / 限售解禁 / 财报披露 / 新股发行 / 会议 / 增发 等**公司事件排期**，从指定日期起约 **1 个月**窗口。用户问'下周有哪些股票解禁/最近谁要发财报/这个月有哪些分红'用这个。⚠[U+FE0F] **不是宏观数据日历** —— 宏观（GDP/CPI/LPR）请用 `ashare_macro`。⚠[U+FE0F] **返回是多段结构**：`data.tables` 是**表列表**（按事件类型分段、保序），每段 `{title 中文标题, slug 英文键, rows}`；另有 `data.data{slug: rows}` 便捷索引。slug：`financial_report` 财报发布 / `dividend` 分红派息 / `ipo` 新股发行 / `meeting` 会议 / `lockup_release` 限售解禁 / `rights_issue` 增发。⚠[U+FE0F] **某类事件当天为 0 条时该段可能整段不出现**（不是丢数据，是真的没有）⇒ 取某段前先判 `data.data` 里有没有这个 slug。⚠[U+FE0F] `limit` 只是**建议值**，数据按事件类型分段、**各段条数不严格等于该值**。

全市场涨跌家数与市场广度（**当期口径**）：上涨/下跌/平盘/停牌家数 + 上涨占比 + 涨停/跌停 + 11 档涨跌幅区间分布 + 两市成交额。用户问'今天涨跌家数/多少家涨停/市场情绪/市场广度'用这个——这是市场广度的**唯一推荐入口**。⚠[U+FE0F] 不要用 ashare_market_overview 的 updown 模式取同一数据（那是 T-1 口径，数值会与此不一致）。· 免费工具（无需 Key）

**筹码分布 / 持仓成本**（仅沪深 A 股）：获利盘比例 + 平均成本 + 90% 与 70% 集中度 + 当日收盘价。用户问'筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大/主力成本在哪'用这个。⚠[U+FE0F] **多只请用 `ashare_chip_batch`**（一次 200 只、逐只标明成功与否）—— 本工具只查一只。⚠[U+FE0F] `date` 可回看历史（`YYYY-MM-DD`，缺省=最新）；**历史仅保留约近 1 年**；非交易日/未来日期会**自动回退到最近交易日**，以返回行的 `date` 为准。⚠[U+FE0F] 代码可传 `sh600667` 或裸 6 位 `600667`。⚠[U+FE0F] **付费工具**：需 Key（体验版及以上），免费/匿名不可用。

⭐ **批量筹码分布：一次拿多只的获利盘比例 / 平均成本 / 90%·70% 集中度**，逐只标明成功与否。用户问'这几只的筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大'用这个。⚠[U+FE0F] **与 ashare_chip 的关系**：`/v1/chip` 的 `code` 虽支持逗号，但返回是**横向并排的 N×8N 对角矩阵**（第 i 行只有第 i 组有值、其余全是 `-`），pandas 一行都拼不出来，而且**无效代码的整组列会直接消失**，少了哪只算不出来 ⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠[U+FE0F] **为什么值得单开一次调用**：`/v1/chip` 问 200 只 = 200 次调用；本工具实测 **200 只 3.9 秒**。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码；`date` 对**所有代码同时生效**（非交易日自动回退到最近交易日，以返回行的 `date` 为准）。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] **仅沪深 A 股**（sh/sz/bj）—— 港股/美股/板块会标 `ok:false` 并提示改用单只查询。⚠[U+FE0F] **历史仅保留约近 1 年**。⚠[U+FE0F] **上限**：专业版单次 **200** 只，不限量版 **300** 只；按实际返回只数计费。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

脱水研报（券商研报摘要）。用户问'研报/机构观点/券商怎么说'用这个。mode=list 列表 / mode=detail 详情（detail 需给 symbol）。⚠[U+FE0F] 要**个股新闻/公告**请用 ashare_events。只读查询；按研报发布更新。

分红送转历史（每股分红/送股/除权日）。用户问'分红/股息/送转'用这个。⚠[U+FE0F] 要**分红派息日历**（哪天除权）请用 ashare_events——本工具是历史记录。只读查询；按公告披露更新。

ETF 数据。用户问'ETF'时用这个。`kind` 选子集：概览(默认·行情/规模/溢折率/资金流/回撤/估值) · 详情(基金要素/费率/份额) · 持仓(成分股及权重) · 净值(历史净值，**须同时传 start+end**) · 公司(管理人/托管人/跟踪指数) · 持有人(户数/机构个人占比) · 财务(股债商品基金占比)。⚠[U+FE0F] 返回的 `data` 是排版文本，**取字段用 `structured`（首表）或 `tables`（全部表）** —— `详情`/`公司` 是多表，只有 `tables` 拿全。⚠[U+FE0F] **仅 ETF 代码**：传个股代码不报错但字段全空。只读查询；代码形如 sh510300。

个股事件标签（42 类：大宗/龙虎榜/回购/分红/解禁等）。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠[U+FE0F] 要看**全市场**某一类事件名单，请用 ashare_lhb（龙虎榜分榜）或 ashare_dividend（分红送转）——本工具是**单只股票**的事件总览。只读查询；按披露节奏更新。

**财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `source`（cninfo/eastmoney）/ `kind`（notice 公告 / news 资讯 / report 研报）/ `title` / `url` / `date` / `code` / `name` / `media` / `authority`（1.0 官方·0.5 门户）/ `relevance`（1.0 命中实体 · 0.6 仅摘要命中 · 0.3 未能确认）/ `relevance_where`（title 标题有它 / name 主体名称有它 / snippet 只在摘要里 / unknown）/ `snippet`（正文摘要，资讯才有；公告正文在 PDF 里，此处为空）/ `also_on`（同一消息的其它转载）。每行还带**证据三件套** `cit_endpoint` / `cit_field_path` / `cit_value_hash` / `cit_retrieved_at`，拿这三样可独立复现并核对这条结果。用户问'这公司最近发了什么公告/有什么新闻/这消息哪来的/能不能核实'用这个。⭐ **与 ashare_news、ashare_flash 的分工**：`ashare_news` 是**按代码**查单个标的的资讯；`ashare_flash` 是**全市场快讯流**；本工具是**按关键词跨源检索 + 去重 + 带证据**。⭐ **`scope=report` 可一并要研报**：标题 + 券商（`media`）+ 日期 + 研报详情页链接。研报**单独算名额**，不会被资讯挤掉，也不额外计费。⚠[U+FE0F] 研报**没有摘要**，`snippet` 为空。⚠[U+FE0F] 公告给的是**PDF 链接**（巨潮原始披露），资讯给的是原文链接，研报给的是详情页链接。⭐ **排序 = 相关性 → 权威度 → 日期**：标题或主体名称里有这个词的排前面，同级时公告在资讯前面。`relevance` 只看词出现在哪个字段（可核对的客观分档），不做语义猜测；`snippet` 让你不用点开就知道是不是你要的。⚠[U+FE0F] 公告比新闻权威（`authority` 1.0 vs 0.5），名额仍按「源平分」—— 否则公告会被当日新闻挤掉。⚠[U+FE0F] 结果缓存 5 分钟。

**量化因子库**：88 个因子 + 50 个筛选入口 + 22 个预设组合，可按分类/类型筛选。用户问'有哪些因子/因子库/选股因子/因子分类'用这个。⚠[U+FE0F] 这是**清单**（静态元数据）；要用因子实际选股，用 ashare_screen。⚠[U+FE0F] `category` / `kind` **只接受中文枚举值**（category：估值/行情/盈利/成长/财务/资金…；kind：排行/标签/事件）。传英文会返回空。⚠[U+FE0F] **付费工具**（需 Key）：**Standard（¥29.9）及以上**。

财务报表（利润表/资产负债表/现金流量表，**最近 N 期**）。用户问'营收/净利润/毛利率/负债/财务数据'用这个。⚠[U+FE0F] 返回**三张表**：data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表；每表按期次**降序**（最新一期在最前）。⚠[U+FE0F] 只要估值倍数（PE/PB）请用 ashare_sector_valuation 或 ashare_quote 的估值字段。只读查询；按财报披露节奏更新（未到披露日就没有新数据，不是故障）。

⭐ **批量财务报表：一次拿多只的利润表 / 资产负债表 / 现金流量表**，逐只标明成功与否。用户问'这几只的营收/净利/ROE/负债率/经营现金流怎么样'用这个。⚠[U+FE0F] **与 ashare_finance 的关系**：`/v1/finance` 的 `code` 虽支持逗号，但返回是**扁平的 3 张表**，哪只没回来、为什么没回来**完全看不出来** ⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠[U+FE0F] **上限：专业版 10 只 / 不限量 20 只，且「只数 × 期数 ≤ 40」** —— 财报数据源的配额按「只 × 期」消耗：实测 10 只 × 4 期 4.2 秒三次全中、20 只 × 2 期 全中；但 20 只 × 4 期 只回 5 只、50 只直接限频。要更多请分批调用（每批间隔几秒）。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码；`periods` 每只取几期（默认 4，最多 12，降序最新在前）；`type` 可只取一张表（`income` / `balance` / `cashflow`，省略=三张全取）；`fields` 取 `all`（默认 186 列）或 `core`（69 列，载荷约 1/3）。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；每项内部是 `market` + `tables[{title,slug,rows}]` + `data{slug: rows}`（slug = `income` / `balance` / `cashflow`）；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] **仅 A 股**（sh/sz/bj）；港股/美股会标 `ok:false` 并提示改用单只查询。⚠[U+FE0F] **按实际返回只数计费**，失败的不计（命中限频会自动退还次数）。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

**7×24 财经快讯**（全市场电报，财联社等来源），按时间倒序。行字段 `id` / `time` / `title` / `content` / `source` / `url`。用户问'今天有什么大消息/最新财经新闻/刚才发生了什么/宏观突发事件'用这个。⭐ **与 `ashare_news` 的分工**：`ashare_news` 是**按个股**的资讯（要传 code）；本工具是**全市场快讯流**（不需要代码）—— 问大盘/宏观/突发用这个，问某只票的消息面用 news。⚠[U+FE0F] 翻页：`index` 从 0 开始，步长=上次的 `limit`（`limit=20&index=20` 是第二页）；只能往回翻，无日期参数。⚠[U+FE0F] `limit` 上限 200；**缓存 1 分钟**（同一分钟内重复请求不重复消耗）。

个股级交易面：这只股的 主力资金（当日/5/10/20 日净流入+全市场排名）+ 龙虎榜上榜明细（上榜原因/营业部）+ 大宗交易 + 融资融券。用户问'某只股票的主力资金/机构动向'用这个。⚠[U+FE0F] 全市场榜单（今天机构榜/游资榜/活跃席位）请用 ashare_lhb——本工具只针对单只股票。⚠[U+FE0F] **要一次查多只股票的资金流**（扫自选池/一个行业），用 ashare_fund_batch。

⭐ **批量资金流**：一次拿**多只股票**的资金流（主力资金 + 龙虎榜 + 大宗 + 融资融券），每只一条记录。用户问'这几只股票的资金流/扫一下我这个池子的主力资金/一个行业谁在流入'用这个。⚠[U+FE0F] 与 ashare_fund 的区别：本工具**一次给多只**，ashare_fund 只查一只。⚠[U+FE0F] **用法**：`codes` 用**逗号分隔**，如 `sh600519,sz000001,sz300750`；支持**裸 6 位码**（`000099`）也支持带前缀（`sz000099`）。⚠[U+FE0F] **返回结构**：`data` 是数组，每项含 `code` / `ok` / `data`（或 `error`），**逐只标明成功与否**；同时给 `requested` / `returned` / `failed` 计数 —— ⛔ 不要假设 `ok:true` 就等于每只都有数据，务必按 `data[i].ok` 逐只判。⚠[U+FE0F] **上限**：专业版（¥99）单次最多 **200** 只（约一个行业），不限量版（¥199）**1000** 只。⚠[U+FE0F] **计费**：按**实际返回只数**扣次数（失败的不计）。⚠[U+FE0F] **标的范围**：资金流数据仅覆盖 **A 股**（`sh`/`sz`/`bj`）；港股仅主力净流入一项，**美股无资金流数据**（该只会标 `ok:false`）。⚠[U+FE0F] **付费工具**（需 Key）：**专业版（¥99）及以上**，标准版不可用。

**关注度**排名（谁在被关注，⛔ 不是'谁在涨'）。用户问'什么股票热门/大家在看什么/热度榜/热门板块/热文'用这个。⚠[U+FE0F]⚠[U+FE0F] **5 类字段结构完全不同**，⛔ 别按同一套字段读：stock 热搜股票(code/name/zdf/zxj) · wx 全市场热度(**多 pv 热度值**) · news 热门文章(⚠[U+FE0F] **news_id/news_title/source**，⛔ 无 code) · sector 热门板块(⚠[U+FE0F] **symbol**，⛔ 无 code) · etf 热搜 ETF(含 title/tag)。⚠[U+FE0F] 当前快照（无历史）· 免费工具（无需 Key）

**A 股产业链**（**183 个产业链主题**），三种模式：`mode=list` → 主题列表；`mode=graph` + `topic=超级电容` → **产业链图谱**（关联个股 + 所属节点 + 产业链位置 上游/中游/下游）；`mode=stock` + `code=sh600667` → **个股所属产业链**（主题 / 节点 / 位置 / **关联度** / **业务描述**）。用户问'产业链/上下游/某公司处于链上什么位置/这个主题有哪些公司'用这个。⚠[U+FE0F] **参数是二选一**：`mode=graph` 必须给 `topic`，`mode=stock` 必须给 `code`；给错组合（如 mode=graph 却只给 code）拿不到数据。⚠[U+FE0F] 主题名要**中文全称**（`超级电容` / `集成电路`）—— 拿不准先 `mode=list` 搜一遍再问。

新股日历（发行/申购/中签/上市）。用户问'新股/打新/IPO'用这个。只读查询；按发行日历更新。

K线（日/周/月/季/年 + 分钟线）。用户问'走势/最近表现/历史K线/趋势'用这个。⚠[U+FE0F] 只要**当前价**用 ashare_quote；要**分时**（盘中每分钟价+累计量）用 ashare_minute ——**分钟 K 线**（OHLC 蜡烛）用本工具的 `period=m1/m5/...`，两者不是一回事。⚠[U+FE0F] 换手率字段名是 **`turnover`**（%）—— 与 ashare_quote、ashare_snapshot 同名同值。⚠[U+FE0F] 复权口径由服务端固定（无 `adjust` 参数）：日线及以上**前复权**（除权除息日不跳空），分钟线**不复权** —— **不要再自己复权**（会二次复权）。⚠[U+FE0F] **分钟线需 `standard`（¥29.9）及以上档位**（日/周/月免费），必须同时传 `start`+`end`（窗口近 1 个月），不支持 北交所 / 期货 / 外汇。只读查询；按收盘更新。⚠[U+FE0F] **免费 / 匿名档按 5 分钟刷新**；**付费档实时**（每次取此刻最新）。⭐ **要多只的 K 线（自选池 / 一个行业）—— 用 `ashare_quote_batch`**（它返回逐只状态、4 秒拿完 300 只；本工具的 code 虽接受逗号但返回混在一起、缺了哪只算不出来）。⚠[U+FE0F] **匿名单次最多 5 只标的**（付费不限）。· 免费工具（无需 Key）· 分钟线除外

⭐ **批量 K 线：一次拿多只股票的 K 线**（多只 × 同一段时间），逐只标明成功与否。用户问'这几只的走势/把我这个池子的 K 线拉下来/一个行业最近 60 天表现'用这个。⚠[U+FE0F] **与其它三个 K 线工具的分工**：`ashare_kline`=一只（code 虽接受逗号但返回混在一起、缺了哪只算不出）；`ashare_kline_full`=**一只 × 全部历史**；`ashare_market_kline`=**某一天 × 全市场**；**本工具=多只 × 同一段时间**（按代码列表驱动）。⚠[U+FE0F] **为什么值得单开一次调用**：自己循环 200 只 × 30 根 = 200 次调用 ≈ **2.3 分钟**（还会撞限频退避）；本工具实测 **3.39 秒**拿完 6,000 行，200 只全部返回。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data:[...]}`（该只的 K 线数组），**取几只回几个条目**；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] `count` 默认 **30**（每只各 30 根）；`fq` 可选 `qfq`/`hfq`/`nofq`（留空 = 服务端默认）。⚠[U+FE0F] 字段固定 8 列，换手率叫 **`turnover`**（%）。⚠[U+FE0F] **上限**：专业版 单次 **200** 只（不限量 1000）；另有**总条数 6 万**上限（标的数 × count ≤ 60,000，如 200 只 × 300 根触顶）。按实际返回只数计费。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

全历史K线（**10 年日线**，2016-08-08 起）+ **可选复权口径**。用户问'十年走势/长期回测/全历史数据/复权价/后复权/原始价'用这个。⚠[U+FE0F] 与 ashare_kline 的**三点不同**：① 数据量与范围 —— 本工具**全历史 10 年**（2465 条）；ashare_kline 上限 1212 条；② 复权可选 —— 本工具有 **`fq`** 参数（qfq 前复权 / hfq 后复权 / nofq 原始价）；ashare_kline **写死前复权、无参数**；③ 标的范围 —— 本工具**仅 A 股股票**（⛔ ETF/可转债/指数/板块/港股/美股/期货/外汇传进来会**明确报错**，请改用 ashare_kline）。⚠[U+FE0F] 做**回测**请用 `fq=hfq` 或 `fq=nofq`（前复权序列会随新的除权除息重算，不可复现）。⚠[U+FE0F] 字段固定 7 列：`time open high low close volume amount`（**无 turnover**）。⚠[U+FE0F] **付费工具**（需 Key）—— 门槛为 **Standard（¥29.9）及以上**，Trial（¥9.9）不可用；且有**独立日额度**（Standard 200 / Pro 500 / Unlimited 2000 次/天），余量可查 ashare_usage。

全市场龙虎榜分榜（6 类）：type=all 全市场总榜（净买/买卖额）/ institution 机构榜（机构买入/净买/机构数）/ activeseat 活跃席位（席位买入额+关联个股）/ winbuy 高胜率买入（净买额/胜率/席位明细）/ winseat 高胜率席位（席位胜率+关联个股）/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠[U+FE0F] hotmoney（游资榜）暂无数据，建议改用 all/activeseat/winbuy。⚠[U+FE0F] 龙虎榜为收盘后发布（一般 18:00 后）；date 留空=最近交易日。⚠[U+FE0F] 某只股票的上榜明细（上榜原因/营业部）请用 ashare_fund——本工具是市场级榜单，不针对单只股票。

**龙虎榜席位明细**：某只票某次上榜的**营业部买卖席位**（最多 10 个），带 **`is_youzi` 游资标记**。行字段 `name`（营业部）/ `total_buy` / `total_sell` / `net`（净买额）/ `is_youzi` / `log_id`，按净买额降序。用户问'今天龙虎榜是谁买的/哪个营业部/是不是游资/沪股通买了多少'用这个。⭐ 与 `ashare_lhb` 的分工：`ashare_lhb` 是**榜单**（机构榜/活跃席位等统计），本工具是**单票的具体营业部明细** —— 问「谁买的」用本工具，问「今天哪类资金活跃」用 ashare_lhb。⚠[U+FE0F] 龙虎榜是**盘后数据**：`date` 留空 = 最近一次上榜日，以返回的 `date` 为准。⚠[U+FE0F] 单次最多约 10 个席位。⚠[U+FE0F] **不限量版专属**。

**短线打板（涨停池明细）**：当日全部涨停个股，含**涨停原因**与**资金面**。用户问'今天哪些票涨停 / 涨停原因 / 封单多大 / 主力买了多少'用这个。`mode` 取值：`limit` **涨停池明细**（默认）—— 每只含 `reason` 涨停原因 / `seal_amount` 封单额 / `seal_amount_max` 最大封单 / `main_net` 主力净额 / `main_buy`·`main_sell` 主力买入·卖出 / `amount` 成交额 / `concepts` 概念 / `float_cap` 流通市值 / `turnover` 换手% / `streak` 连板数 / `pct` 涨幅%。⚠[U+FE0F] 一次返回**全量**（含各连板高度），无需翻页。⚠[U+FE0F] `date` 留空 = 实时；给 YYYY-MM-DD 取该交易日历史（须为真实交易日，非交易日返空）。⚠[U+FE0F] 要**梯队结构 / 板块主线**请用 ashare_review。只读查询。

宏观数据（GDP/CPI/PMI/LPR/国债收益率/财政）。用户问'宏观/经济数据/利率/LPR/CPI'用这个。⚠[U+FE0F] 要**指数行情**请用 ashare_quote 或 ashare_market_overview——本工具只给宏观指标。只读查询；按发布日历更新（未到发布日就没有新值）。

**个股融资融券明细**：融资余额 / 融资买入 / 融资偿还 / 融券余额 / 融券卖出 / 融券偿还。用户问'这只股票杠杆资金在加还是在撤/融资余额多少/两融数据'用这个。⚠[U+FE0F] **code 必填**（参数上不是 required，但不传只会得到一句明确说明、没有数据）。⚠[U+FE0F] **支持批量**：`code` 可传逗号分隔（`sh600667,sz000651`），返回多行 —— 但**不带逐只状态**，缺了哪只要自己算。⚠[U+FE0F] `date` 留空 = 最近**已披露**交易日（两融数据 T+1 披露，当天查不到当天的）；未披露的交易日会给出明确原因。⚠[U+FE0F] **与 ashare_fund 的关系**：`ashare_fund` 一次给『资金 + 龙虎榜 + 大宗 + 两融』四块概览；本工具只给**两融明细**、字段更全 ⇒ 只看两融用本工具。

**全市场单日K线** —— 一次请求返回某交易日**全 A 股（5000+ 只）**的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠[U+FE0F] **用途**：替代「逐只循环 5000 次」——每天收盘后调 **1 次**即可拿到全市场，适合建本地行情库/做全市场扫描/每日批量更新。⚠[U+FE0F] **两种硬限定**：① **仅 Pro（¥99）与 Unlimited（¥199）** 可用（Standard 及以下会被拒）；② **1 次调用折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）。⚠[U+FE0F] 另有**独立日额度**（Pro 200 / Unlimited 1000 次/天），余量可查 ashare_usage。⚠[U+FE0F] 数据范围：**仅 A 股股票**（5572 只）、**2016-08-08 起**、**不复权原始价**；不含 ETF/可转债/指数/板块/港股/美股。最新数据到**前一交易日**（盘中当日数据不可用）。⚠[U+FE0F] 体积约 785 KB/次。字段 8 列：`code time open high low close volume amount`。

市场级画像。type=summary 画像总评/trade 收盘/interval 多周期/technical 大盘技术/valuation 估值分位/rotation 风格轮动。用户问'今天市场怎么样/大盘环境/风格轮动/估值分位'用这个。⚠[U+FE0F] 涨跌家数（市场广度）请用 ashare_changedist：本工具的 updown 模块为 **T-1 口径**（返回里会标数据日期，可能滞后一个交易日），已不推荐用于回答'今天的涨跌家数'。· 免费工具（无需 Key）

**分时**（当日 / 近 5 日盘中走势）：盘中每分钟的价格与累计成交量。用户问'今天分时/盘中走势/日内走势/近 5 日分时'用这个。⚠[U+FE0F] 与 ashare_kline 的**分钟 K 线不是一回事**：本工具返回**分时**（每分钟一个价+累计量），K 线返回 OHLC 蜡烛 —— 要蜡烛图用 ashare_kline 的 `period=m1/m5/...`。⚠[U+FE0F] `days` **只有 1（当日）和 5（近 5 个交易日）两档**，没有 2/3/4。⚠[U+FE0F] **付费工具**（需 Key）—— 门槛 **standard（¥29.9）及以上**，trial（¥9.9）不可用。⚠[U+FE0F] **付费档实时**（每次取此刻最新）。

个股**财经资讯**。不传 `id` ⇒ 列表（标题 + 来源 + 时间）；传 `id` ⇒ ⭐ 该条**完整正文**。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ **正文是干净的 Markdown**（已清洗 HTML 标签/图片占位/无效内链，保留股票代码关联如 `茅台(sh600519)`，时间 `YYYY-MM-DD HH:MM:SS`）—— **可直接喂给大模型**。⚠[U+FE0F] 列表**只有最新 N 条**（不提供翻页/历史）—— 要**历史公告**请用 ashare_notice。⚠[U+FE0F] 列表里的 `url` 指向动态页面，**直接抓不到正文** ⇒ 要正文请用本工具的 `id` 参数。

上市公司**公告**。不传 id ⇒ 列表（code 必填，支持 type / limit / offset 翻页，可回溯约 20 年）；传 id ⇒ 该公告详情。用户问'公告/披露/半年度报告/年报在哪'用这个。⚠[U+FE0F] **详情有两种形态**（实测约 9/10 给正文）：多数短公告 ⇒ `text`=**正文**（直接读）；少数长报告（如半年报 100+ 页）⇒ `text` 空、`url`=**PDF 链接**。⇒ 判据：**先看 `text`**，空则用 `url`。⚠[U+FE0F] **长报告的 PDF 请自行获取与解析**（用你环境里的 PDF 能力）——我们只给链接，不代做解析。💡 **要财务数字请用 `ashare_finance`**（结构化，比从 100+ 页 PDF 里抠快得多）。

**五档盘口**：买一~买五 / 卖一~卖五的**价格与挂单量（手）** + 现价/涨跌/数据时间。用户问'封单多少/买盘卖盘/盘口/挂单/支撑压力位/有没有大单托着'用这个。字段：`b1_p`/`b1_v`~`b5_p`/`b5_v` 买档价格/量 · `a1_p`/`a1_v`~`a5_p`/`a5_v` 卖档。⚠[U+FE0F] 本工具是**秒级快照**（每 10 秒刷新），**盘中才有意义**（收盘后为当日最后快照）——要**实时成交价**用 ashare_quote（**免费**，字段少更轻）。⚠[U+FE0F] 量单位是**手**（×100 = 股）；**跌停买档全 0 / 涨停卖档全 0**（正常）。

**量化方法论库**：25 条「怎么判断市场」的流程（含判据 / 阶段 / 实测证据）。用户问'怎么判断/交易方法/方法论/判断流程'用这个。⚠[U+FE0F] 这是**方法论清单**（帮助判断，非投资建议）；要看可回测的策略用 ashare_strategies。⚠[U+FE0F] 可按分类或 id 取单条。⚠[U+FE0F] **付费工具**（需 Key）：**Standard（¥29.9）及以上**。

**公司简况**：上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 员工数 等。用户问'这家公司是做什么的/哪年上市/属于什么行业/董事长是谁'用这个。⚠[U+FE0F] **与 ashare_snapshot 的分工**：snapshot 给**估值/市值/股本**（数字面），本工具给**公司本身是谁**（业务面）—— 问『做什么的』用本工具，问『贵不贵』用 snapshot。⚠[U+FE0F] **一次只查一只**：本工具的 `code` 虽也支持逗号，但返回是**扁平行、无逐只状态**，无效码会被**直接忽略**（`sh600519,sz999999` 只会回 1 行，没有任何提示）⇒ **多只请用 `ashare_profile_batch`**（专业版 100 只 / 不限量 150 只，逐只标明成功与否）。⚠[U+FE0F] 代码可传 `sh600667` 或裸 6 位 `600667`（内部会补前缀）。⚠[U+FE0F] **港股**（`hk00700`）与**板块**（`pt01801081`）也能查，但**字段会缺**（港股无 `listedDate`；两通道口径不同）⇒ 以返回为准。⚠[U+FE0F] 数据是**静态档案**，缓存 24 小时 —— 同一天重复问不会重复消耗配额。

⭐ **批量公司简况：一次拿多只的上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 注册地址 / 联系方式**，逐只标明成功与否。用户问'这几只都是做什么的/帮我按行业归类/筛出来的池子逐个看基本面/什么时候上市的'用这个。⚠[U+FE0F] 与 ashare_profile 的区别：本工具**一次给多只**，ashare_profile 只查一只。⚠[U+FE0F] **为什么值得单开一次调用**：`ashare_profile` 问 100 只 = 100 次调用；本工具实测 **100 只 6.8 秒**拿完，且缺了哪只一眼可见。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] **仅 A 股**（sh/sz/bj，含指数与 ETF）—— 港股/美股/板块会标 `ok:false` 并提示改用 ashare_profile 单只查询（批量里不稳定，⛔ 宁可不给也不返回错数据）。⚠[U+FE0F] 指数与 ETF 的 `industry` / `listedDate` 可能是 `-`（数据源没有该字段），不算取数失败。⚠[U+FE0F] **上限**：专业版单次 **100** 只，不限量版 **150** 只；按实际返回只数计费。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

A股/港股/美股实时行情快照（**轻量 8 字段**：现价/开高低/成交量/成交额/换手率）。用户问'某股票现在多少钱/什么价'用这个。⚠[U+FE0F] `data` 是**数组**（默认 30 条日线，`data[0]` 为最新）—— 取现价用 `data[0].last`。⚠[U+FE0F] 换手率的字段名是 **`turnover`**（%）—— 与 /v1/snapshot **同名同值**。⚠[U+FE0F] **不含**估值/市值 —— 用 ashare_snapshot（35 字段，付费）。要**历史走势**请用 ashare_kline；要**五档盘口（order book）**请用 ashare_orderbook。 ⭐ **要查多只股票（自选池 / 一个行业 / 全市场切片）—— 用 `ashare_quote_batch`，不要循环调用本工具。**自己循环 300 只 = 300 次调用 × 约 0.7 秒 ≈ **3.5 分钟**（还会撞限频退避）；`ashare_quote_batch` 一次调用 **4 秒左右拿完**，且**逐只标明成功与否**（缺了哪只一眼可见）。 ⚠[U+FE0F] 本工具的 `code` **虽然也接受逗号**（付费不限只数），但返回是**扁平行且不带逐只状态**——混在一起、缺了哪只要自己算 ⇒ **多只场景请用 `ashare_quote_batch`**（专业版 ¥99 及以上）。 只读查询；数据为**当日盘中滚动更新**（约每分钟刷新）。⚠[U+FE0F] **免费 / 匿名档按 5 分钟刷新**（保障服务稳定性）；**付费档实时**（每次取此刻最新）。⚠[U+FE0F] **匿名单次最多 5 只标的**（付费不限）。· 免费工具（无需 Key）

⭐ **批量行情：一次拿多只股票的行情**，逐只标明成功与否。用户问'这几只现在什么价/扫一下我这个池子/一个行业现在的行情'用这个。⚠[U+FE0F] 与 ashare_quote 的区别：本工具**一次给多只**，且返回**逐只状态**（`{code, ok, data}`）—— 缺了哪只一眼可见；ashare_quote 只查一只，虽然它的 code 也接受逗号，但返回混在一起、缺了哪只要自己算。⚠[U+FE0F] **为什么值得单开一次调用**：自己循环 300 只 = 300 次调用 × 约 0.7 秒 ≈ **3.5 分钟**（还会撞限频退避）；本工具实测 **4 秒左右拿完** 300 只。⚠[U+FE0F] **用法**：`codes` 逗号分隔，如 `sh600519,sz000001,sz300750`；支持裸 6 位码（`600519`）也支持带前缀。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只就回几个条目**；同时给 `requested` / `returned` / `failed`。`count` 默认 **1**（只取最新一条）；要 N 天历史传 `count=N`（**每只各 N 条**）。⚠[U+FE0F] 换手率字段名是 **`turnover`**（%，与 ashare_quote 同名同值）。⚠[U+FE0F] **上限**：专业版（¥99）单次 **200** 只，不限量版 **1000** 只；按实际返回只数计费。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

**短线复盘（涨停结构）**：看今天钱在哪些题材、梯队结构长什么样。用户问'今天什么题材最强 / 板块主线 / 连板梯队 / 几板几只 / 谁是反包'用这个。`mode` 取值：`board` **板块主线**（默认）—— 题材板块 + `limit_count` 涨停数 + `amount` 板块成交额 + `stocks` 成分股代码；`ladder` **连板梯队** —— 按连板高度分组的涨停个股，含 `board_name` 所属板块 / `market_cap` 总市值 / `tips`（如「7天4板」）/ `max_streak` 区间最高连板 / `limit_days` 区间涨停天数 / `is_repack` 反包标记。⚠[U+FE0F] `date` 留空 = 实时；给 YYYY-MM-DD 取该交易日历史（须为真实交易日，非交易日返空）。⚠[U+FE0F] 要**涨停原因 / 封单 / 主力资金**请用 ashare_limit_up。只读查询。

因子选股（量化筛股）。expression 是多因子交集表达式，例：intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])；常用字段：PE_TTM/PB/PS_TTM/ROE/ROETTM/ROIC/DividendRatioTTM/OperatingRevenueGrowRate/DebtAssetsRatio。用户问'筛选/选股/符合条件的股票'用这个。

板块行情榜（行业/概念/地域涨幅 + 领涨股 + 涨跌家数）。用户问'哪些板块在涨/板块轮动/行业热度'用这个。⚠[U+FE0F] 要板块**估值分位**请用 ashare_sector_valuation；要**产业链上下游**请用对应工具。只读查询；交易时段内更新。

板块估值（PE/PB/PS/PCF + 股息率 + 历史百分位）。用户问'某板块贵不贵/估值分位'用这个。⚠[U+FE0F] 要看板块**涨跌幅与领涨股**请用 ashare_sector——本工具只给估值指标。只读查询；板块代码形如 pt01801780（pt 前缀 + 8 位）。

股东研究：十大股东/股东户数（筹码集中度）/机构持仓。用户问'谁在持有/股东变化/筹码集中/机构持仓'用这个。⚠[U+FE0F] 要看机构**整体**在全市场买什么，请用 ashare_lhb 的机构榜。只读查询；股东户数按定期报告披露（季度级）。

⭐ **批量股东研究：一次拿多只的十大股东 / 十大流通股东 / 股东户数统计**，逐只标明成功与否。用户问'这几只谁在持有/股东户数变少了吗/股权集中不集中/机构在不在里面'用这个。⚠[U+FE0F] **与 ashare_shareholder 的关系**：`/v1/shareholder` 的 `code` 虽支持逗号，但返回是**一大坨 markdown**、没有逐只状态，无效代码会**静默消失**（少了哪只算不出来）⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠[U+FE0F] **为什么值得单开一次调用**：`/v1/shareholder` 问 200 只 = 200 次调用（约 3 分钟，还会撞限频退避）；本工具实测 **200 只 4.1 秒 / 300 只 5.6 秒**。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码，港股 `hk00700` 可混传。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；每项内部结构与 `/v1/shareholder` **完全一致**（`market` + `tables[{title,slug,rows}]` + `data{slug: rows}`）；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] **A 股与港股段语义不同**（都 3 段但完全不同）：A 股 = 十大股东 / 十大流通股东 / 股东户数统计；港股 = 持股股东信息 / 股东分布 / 机构持仓统计 ⇒ **按 `market` 和 `slug` 取，⛔ 别按序号**。⚠[U+FE0F] **支持沪深 A 股 + 港股**；北交所/ETF/指数/美股会标 `ok:false` 并提示改用单只查询。⚠[U+FE0F] **上限**：专业版单次 **200** 只，不限量版 **300** 只；按实际返回只数计费。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

**全字段行情画像**：价格 + 盘口（买五卖五+委差）+ 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本（流通/总）+ 打板（涨停/跌停价 + 量比 + 振幅 + 涨速）+ 标识（证券类型/股票状态/币种）+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠[U+FE0F] **与 ashare_quote 的分工**：quote 轻（8 字段）**免费**；本工具**全（35 字段）· 付费**——**只要现价/涨跌用 ashare_quote 更轻**（字段少、省上下文）。✅ **计费 = 次数**：本工具 1 次拿全——要估值+市值+股本+涨停价**多项**时，比分别调 quote/valuation/orderbook **更省次数**（3 次 → 1 次）。⚠[U+FE0F] **仅 A 股**（港股/美股字段布局不同，用 ashare_quote）——**传其他市场返回空，不返回错数据**。⚠[U+FE0F] 单位：量=手 · 成交额=万元 · 市值=亿元 · 股本=股 · 比率=百分数。

**量化策略清单**：返回可回测的全部策略（20 条单标的择时 + 9 条组合），含各自参数范围与说明，⭐ **并附「实测表现」**（`performance` 字段）—— 在 800 只（沪深300+中证500）· 2019 年至今、**含真实交易成本**上跑出的真实成绩。`verdict` 分级：`effective` 实测有效 / `neutral` 一般 / `weak` 偏弱 / **`avoid` 实测亏损**；`note` 字段给避坑提示。⚠[U+FE0F] **无效的策略同样列出**（便于避开常见陷阱，如高换手被成本吃光）。用户问'有哪些策略/哪些策略能赚/哪个策略坑/策略参数是什么'用这个。⚠[U+FE0F] 这是**清单 + 实测摘要**（不跑新计算）；要真跑回测用 ashare_backtest。⚠[U+FE0F] **付费工具**（需 Key）：**Standard（¥29.9）及以上**。

技术指标 MA/MACD/KDJ/RSI/BOLL。用户问'技术面/指标/金叉死叉/超买超卖'用这个。⚠[U+FE0F] 只要原始 K 线（不算指标）请用 ashare_kline——本工具返回已算好的指标值。只读查询；按日线收盘更新。

⭐ **批量技术指标：一次拿多只的 MA / EMA / MACD / KDJ / RSI / BOLL / BIAS / WR / DMI / OBV / VR / BBI / TRIX / DPO / PSY / ENE / CCI 等共 55 项**，逐只标明成功与否。用户问'这批股票的技术面怎么样/哪些金叉了/哪些超买了/哪些在均线之上'用这个。⚠[U+FE0F] **与 ashare_technical 的关系**：`/v1/technical` 的 `code` 虽支持逗号，但返回是**一整张宽表**、没有逐只状态，无效码会**静默消失**（少了哪只你算不出来）⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠[U+FE0F] **上限：专业版 500 只 / 不限量 1000 只** —— 这是**目前唯一不受单次只数限制**的批量命令：实测 200 只 0.9 秒、500 只 1.2 秒、1000 只 1.8 秒、**3000 只 2.8 秒且 100% 返回**（自己循环 500 次要 500 次请求、约 8 分钟，还会撞限频退避）。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码；A 股（**含北交所**）/ 港股 / 美股**可混传**，**指数也能取**（`sh000001`）；`date` 取指定交易日（`YYYY-MM-DD`，对所有代码同时生效，非交易日自动回退）。⚠[U+FE0F] **只有日线口径** —— 没有周期参数（传 week/month/m30 得到的仍是日线数值），本工具因此**不提供周期参数**（⛔ 别以为拿到的是周线 MA5）。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；每项内部与 `/v1/technical` 的单行**完全一致**（`code`/`name`/`date`/`closePrice`/`ma_MA_5`/`macd_DIF`/`rsi_RSI_6`…，共 55 列）；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] **按实际返回只数计费**，失败的不计。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

查自己的 API 用量与剩余额度（今日调用次数/剩余总量/到期时间/限流额度）。用户问'我的额度还剩多少/今天调了多少次'用这个。只读查询；需 API Key。

**一句话取数 + 证据链**：把「宁德时代最近资金流入怎么样」这种自然语言问题，直接映射到**我们自己的数据端点**，返回**一行结构化数据 + 完整证据**（`value_hash` / `source_endpoint` / `params` / `as_of`），并可核验。 ⭐ **与 `ashare_evidence` 的分工**：`ashare_evidence` 是**公告/资讯/研报原文检索**（关键词搜）；本工具是**把问句变成数据查询**（资金流 / 行情 / 公告）。问'多少/怎么样/是什么'用这个；问'发了什么公告/有什么新闻'用 evidence。 ⭐ **返回 = 行数组（`data`）+ 顶部 `citations[]` + `verification[]`**： · `data[]` 是**扁平表**，一行 = 一条证据（`rank` / `source_endpoint` / `field_path` / `value` / `value_hash` / `as_of` / `authority_score`） · `citations[]` 是**完整引用**（含 `params` 原对象，可拿它 + `field_path` 重新取值核对） · `verification.claims[]` 是**逐条裁决**（`supported` / `unverified` 等）—— ⭐ 这是本产品与同类最大的差别：**明确告诉你哪些已验、哪些没验** ⚠[U+FE0F] **`interpreted.intent_source` 必须看**：`llm` = 模型理解；`rules_fallback` / `local_rules` = 退回规则（此时能力受词表限制，复杂问法可能判不出）。 ⭐ **`readable`（可读值）**：资金流/成交额/成交量这类大数值，每行额外给 `readable`（如 `-14.26 亿元`）+ `unit` + `rule`（换算规则，可反算回原值）—— **直接引用它，别自己换算**（实测 LLM 换算 5 次错 1 次，`-1524347183` 会算成 1.52 亿）。⚠[U+FE0F] `value` 仍是**数据源原值、一字不改**；价格/点位类不换算（`readable=null`）。 ⭐ **`number_gate`（数字自查）**：你要据此写一段话时，按其中 `rules` 自查 —— `verbatim`（原值）/ `unit_convert`（换单位）可；`derived`（涨跌幅/同比/占比这类**自行计算的派生量**）**不可**，派生量必须来自数据源。 ⚠[U+FE0F] **覆盖边界（如实告知用户，别乱承诺）**：支持 **A股/港股/美股** 的**资金流（含 5/10/20 日累计）/ 行情价格 / 公告资讯 / 研报观点 / 龙虎榜 / 大宗交易 / 融资融券**，以及**多标的对比**（「宁德时代和比亚迪哪个资金流入更多」）。⛔ 不支持：板块、大盘统计、技术面（K线/指标/支撑位）、基本面（市盈率/ROE/分红/股东人数）、**归因分析**（「为什么跌」）、预测与荐股 —— 这些会**明确拒答**（`ok:false` + 原因），⛔ 不会拿别的字段凑数。 ⚠[U+FE0F] 取不到对应字段时**直接拒答并说明**，⛔ 绝不返回'看起来像'的其它指标。

股票/基金/板块搜索（模糊词消歧）。用户只给名称时**先用这个确认代码**。⚠[U+FE0F] 本工具只返回代码与名称，不含行情——拿到代码后再调 ashare_quote / ashare_kline。只读查询。

⭐ **批量全字段画像：一次拿多只股票的完整画像**（35+ 字段：价格/盘口五档/PE·PB/市值/股本/涨停跌停价/量比/振幅/涨速/外盘内盘），逐只标明成功与否。用户问'这几只的估值/市值/市盈率/是不是涨停/扫一下我这个池子的基本面'用这个。⚠[U+FE0F] 与 ashare_snapshot 的区别：本工具**一次给多只**，ashare_snapshot 只查一只。⚠[U+FE0F] **为什么值得单开一次调用**：`ashare_snapshot` 扫 100 只 = 100 次调用 ≈ 30 秒；本工具实测 **300 只 0.40 秒**（比 ashare_quote_batch 还快 10 倍）。⚠[U+FE0F] **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码。⚠[U+FE0F] **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；同时给 `requested` / `returned` / `failed`。⚠[U+FE0F] **仅 A 股**（sh/sz/bj）—— 港股/美股会标 `ok:false` 并提示改用 ashare_quote（字段布局不同，⛔ 宁可不给也不返回错数据）。⚠[U+FE0F] **单位**：`volume` 手 · `amount` 万元 · 市值 亿元 · 股本 股 · 比率/涨幅 百分数。⚠[U+FE0F] **上限**：专业版单次 **200** 只，不限量版 **250** 只；按实际返回只数计费。⚠[U+FE0F] **付费工具**：**专业版（¥99）及以上**，标准版不可用。

**产品文档检索**：字段单位 / 口径说明 / 常见误用 / 跨市场差异。⚠[U+FE0F] **不确定某字段的含义、单位、口径时先用这个查**，比凭记忆回答准。渐进加载（省上下文）：不带参返回**目录**；`q=关键词` 返回**摘要**（不含全文）；`slug=xxx` 取**该篇全文**。建议路径：先看目录 → 再取需要的那一篇。免费工具（无需 Key），但每次调用仍计入用量与限流。