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

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

**一句话取数 + 证据链**：把「宁德时代最近资金流入怎么样」这种自然语言问题，直接映射到**我们自己的数据端点**，返回**一行结构化数据 + 完整证据**（`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` 等）—— ⭐ 这是本产品与同类最大的差别：**明确告诉你哪些已验、哪些没验** ⚠️ **`interpreted.intent_source` 必须看**：`llm` = 模型理解；`rules_fallback` / `local_rules` = 退回规则（此时能力受词表限制，复杂问法可能判不出）。 ⭐ **`readable`（可读值）**：资金流/成交额/成交量这类大数值，每行额外给 `readable`（如 `-14.26 亿元`）+ `unit` + `rule`（换算规则，可反算回原值）—— **直接引用它，别自己换算**（实测 LLM 换算 5 次错 1 次，`-1524347183` 会算成 1.52 亿）。⚠️ `value` 仍是**数据源原值、一字不改**；价格/点位类不换算（`readable=null`）。 ⭐ **`number_gate`（数字自查）**：你要据此写一段话时，按其中 `rules` 自查 —— `verbatim`（原值）/ `unit_convert`（换单位）可；`derived`（涨跌幅/同比/占比这类**自行计算的派生量**）**不可**，派生量必须来自数据源。 ⚠️ **覆盖边界（如实告知用户，别乱承诺）**：支持 **A股/港股/美股** 的**资金流（含 5/10/20 日累计）/ 行情价格 / 公告资讯 / 研报观点 / 龙虎榜 / 大宗交易 / 融资融券**，以及**多标的对比**（「宁德时代和比亚迪哪个资金流入更多」）。⛔ 不支持：板块、大盘统计、技术面（K线/指标/支撑位）、基本面（市盈率/ROE/分红/股东人数）、**归因分析**（「为什么跌」）、预测与荐股 —— 这些会**明确拒答**（`ok:false` + 原因），⛔ 不会拿别的字段凑数。 ⚠️ 取不到对应字段时**直接拒答并说明**，⛔ 绝不返回'看起来像'的其它指标。 ⭐ **`scope`（数据源范围，可选）**：`ashare`（自有数据）· `notice,news,report`（公告/资讯/研报）· `web`（网页检索，需 `X-LLM-Key`）· `wechat`（微信公众号，同 `web` + 限定公众号）。网页/微信检索可覆盖我们数据库之外的内容（行业政策、宏观解读、非 A 股公司等），⚠️ 但要客户自己的模型 key（费用由客户承担）。⚠️ 显式传 `web`/`wechat` 时**只在该通道内找**，取不到会如实 `ok:false`（⛔ 不会退回别的通道凑答案）；⛔ 暂不支持 `a2b`（浏览器渲染）/ `xhs` / `local`。 ⭐ **网页/微信检索的行**（`source_type=web_search`）：除通用字段外还给 `rerank_score`（相关性 0~3，**≥1.5 为优质**）+ `quality`（`good` / `fair`）—— 用它判断这批结果够不够好，**别只看条数**。 ⭐ **句级定位**：网页正文类证据带 `start_char` / `end_char`（字符区间），可精确回答'哪一句、第几个字符'；`end_char` 与 `value` 长度一致，**可对账**。 ⭐ **`replay=true`（重放对账，可选）**：额外调一次模型比对输出，结果标 `match` / `non_deterministic` / `not_replayable` / `skipped_no_client`。⚠️ 模型路径下通常为 `non_deterministic`（同一输入、输出字节可能不同）—— **这不代表结论不可靠**（确定性 ≠ 判断质量）。默认关闭。

**复盘分析师（analyst Agent）**：输入 scanner 快照 ID，读取快照与 T+1/T+5/T+20 评估，输出收益/基准/超额/命中率、赢家输家、数据缺口和复盘报告。只读、不选股、不预测、不推荐买卖。 ⚠️ 可选 BYOK：带 `X-LLM-Key` 用模型润色；不带返回确定性复盘。

**歧义时向用户提问**（结构对齐 Claude Code `AskUserQuestion`）。\n⭐ **什么时候用**：用户只给了**模糊名称**（「平安」「腾讯」），你不确定指哪家公司时。\n 本工具**不会替你选**，而是返回 **1–4 个带说明的选项**（如「中国平安 · 沪市主板·保险龙头」），由你转成问题问用户。\n⚠️ **选项说明由模型生成**（需要语义："中国平安"和"平安银行"差在哪，规则写不出来） ⇒ 带 `X-LLM-Key` 时质量最好；不带则只返回原始候选（无说明）。\n⚠️ 返回 `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` = 「竞价触及涨停」判定（竞价段最高价 ≥ 涨停价，涨停价取自行情源原始值）；⭐ `is_limit_down` = 「竞价触及跌停」判定（竞价段最低价 ≤ 跌停价，跌停价同样取自行情源原始值）。另含 `up_px` 涨停价 / `down_px` 跌停价 / `hprice` 竞价段最高价 / `lprice` 竞价段最低价 / `open_px` 09:25 撮合价 / `preclose_px` 昨收。⚠️ `mode=stock` 仅当日；历史请用 `mode=stock-history` 且必传 `date`（真实交易日）。只读查询。⚠️ **付费工具**：**专业版（¥99）及以上**，标准版不可用。

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

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

**单股 L2 大单资金分时**（分钟级）：`net` = 该分钟**大单净额（元）**，正数=大单净买入、负数=净卖出。用户问'大单在买还是卖/主力资金分时/哪一分钟砸盘'用这个。⚠️ **仅当日**（非交易日/盘前返回最近一个交易日），日期看返回顶层 `day`。⚠️ 盘中末尾几分钟仍在追加：09:30–15:00 约 **242 点**，盘中调用点数会随交易时段增长。⚠️ 这是**大单口径**（按成交金额聚合）—— 不是逐笔委托、也不是十档盘口，别把它当'盘口深度'用。⚠️ **机构版专属**：专业版及以下调用会返回明确说明 + 升级链接，不会静默失败。⚠️ 与 `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 给**每分钟净额曲线**（看节奏），本工具给**逐笔明细 + 四方向拆分**（看谁打谁）。⚠️ **仅当日**（非交易日/盘前返回最近交易日，日期看行里的 `time`）。⚠️ **单次最多约 200 笔**（`total` > `returned` = 被截断）：要**全天全量**（算金额、算净流入）请用 `ashare_bigorder_flow_full`；只要最新一段（看方向）用本工具，配合 `money` 抬高阈值缩小范围。⚠️ 这是**成交口径**，不是逐笔委托、也不是十档盘口。⚠️ **机构版专属**：其他档位返回明确说明 + 升级链接。

**L2 大单成交·全天完整**：把当日**全部**成交额 ≥ 阈值的大单一次拿全，不受「单次最多 200 笔」限制。用于**算全天金额**（主力净流入多少、四方向各多少）。行字段与 `ashare_bigorder_flow` 完全一致；顶层 `meta` 有 `total`（当日总笔数）/ `returned` / `deduped`（合并掉的重复条数）/ `pages` / `complete`（是否已拿全）/ `summary`（四方向金额合计，`summary_scope=all_rows`，拿全时即当日全量）。用户问'今天主力净流入多少 / 主动买和主动卖各多少 / 大单金额合计'用这个。⭐ 与 `ashare_bigorder_flow` 的分工：flow 只给最新 200 笔（快，看方向）；本工具给全天全量（慢，算金额）。**只拿 200 笔去算全天金额会算错。**⚠️ **比 flow 慢**（内部逐页取，每页约 0.8 秒）：30 万档活跃票约 20~30 秒，100 万档约 10 秒，300 万档约 2 秒 ⇒ 只要结论时建议 `money=2`（100 万）以上。⚠️ 返回量大（5000 行约 600 KB）：只要方向不要金额时，用 `ashare_bigorder_flow` 更省；确实需要全量但上下文紧张时，可用 `max_rows` 调小。⚠️ **仅当日**。⚠️ 这是**成交口径**，不是逐笔委托、也不是十档盘口。⚠️ **机构版专属**：其他档位返回明确说明 + 升级链接。

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

**L2 大单委托流**（当日挂单明细）：委托量或金额超过阈值的**挂单**逐笔列出，带 `is_limit_up`（涨停价挂单）和 **`is_cancel`（已撤单）**。行字段 `time` / `order_id` / `price` / `volume`(手) / `amount`(元) / `side`(1买2卖) / `side_cn` / `is_limit_up` / `is_cancel`。顶层 `meta` 另给本次返回样本的 `cancel_count` / `cancel_ratio`（0–1）/ `cancel_volume`（手）/ `cancel_amount`（元），`cancel_stats_scope="returned_rows"` 表示只统计返回的样本，不是当日全量。用户问'封单是真的吗/有没有大单挂了又撤/假封单'用这个。⭐ **与 bigorder-flow 是两件事**：queue = **挂单**（可能撤），flow = **成交**（真买了）。两个一起看才能分清「挂了没成」和「真买了」。⚠️ **仅当日**；`vol` ∈ {500,1000,2000,5000,10000} 手、`tur` ∈ {30,50,100,200,500,1000} 万；单次最多约 200 笔。⚠️ 这是**委托口径**，不是成交、也不是十档盘口。⚠️ **机构版专属**。

**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`（四分解）看个股结构。⚠️ `limit` 最大 6000（可一次取全市场，约 1 MB）；翻页用 `offset`。⚠️ `market_cap` 为数据源原始市值字段，仅供排序/粗筛，⛔ 不要与其它工具的市值字段混用。⚠️ **机构版专属**。

**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 笔）；本工具是**分钟聚合**（看节奏与均价，**可回看历史**、无条数上限）。⚠️ 传 `date` = 历史某交易日；不传 = 当日实时。⚠️ 这是**资金口径**（按成交方向拆分），⛔ 不是委托队列、不是十档盘口。⚠️ **机构版专属**。

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

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

**炸板历史（某日涨停被砸开的票）**：行字段 `code` / `name` / `change_pct` 涨幅% / `main_net` 主力净额（元）/ `amount` 成交额（元）/ `turnover_rate` 换手% / `concepts` 所属概念（如「金融科技、金融概念」）/ `raw` 原始行。用户问'今天有哪些票炸板/封板质量怎么样/哪些涨停被砸开'用这个。⭐ 与 `ashare_limit_up` 互补：涨停池是**封住的**，本工具是**没封住的**，两者一比就是当天封板质量。⚠️ `date` 留空 = 最近工作日（周末回退到上周五）；法定节假日请显式传。⚠️ `is_fallback=true` 表示没拿到你指定的那天，以 `date` 为准。⚠️ **机构版专属**。

**公司股份回购记录**。用户问'这家公司在回购吗/回购了多少/回购价多少'时用。⚠️⚠️ **返回结构按市场不同，⛔ 不能按同一套列名解析**：**A 股** ⇒ 事件概要 `code`/`name`/`market`；**港股** ⇒ 逐日明细 `date`/`BuybackMoney`/`BuybackPrice`/`BuybackShares`/`BuybackCumMoney`/`closePrice`。⚠️ 与 `ashare_shareholder`（谁持有）不同：本工具看的是**公司自己买自己**。只读查询；**标准版（¥29.9）及以上**。

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

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

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

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

**卖方一致预期**：分析师**目标价** + 未来预测（EPS/营收/净利润/预测 PE·PB·PS/机构覆盖数）。用户问'机构怎么看/目标价多少/明年利润预测/一致预期'时用。⚠️ **`codes` 逗号多只、逐只回 `ok`**，单次 **≤15 只**（数据源 >15 只**静默丢数据**：20 只只回 6 只）。⚠️ **字段按市场不同**：A 股有 `targetPrice`；**港股没有目标价**，字段是 `*Forecast` 一套。只读查询；**专业版（¥99）及以上**。

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

**业绩预约披露日**：哪天披露财报（`disclosureDate`）+ 报告期（`reportEndDate`）+ 说明文案。用户问'什么时候出财报/几号披露/三季报什么时候发'时用。三市场：A 股 / 港股 / 美股。⚠️ 与 `ashare_calendar`（分红/解禁/会议）**不是一回事**。⚠️ **港股 `disclosureDate` 常为空**，日期写在 `disclosureDesc` 文案里（如「将于2026-11-18发布财报」）。只读查询；**标准版（¥29.9）及以上**。

分红送转历史（每股分红/送股/除权日）。用户问'分红/股息/送转'用这个。⚠️ 要**分红派息日历**（哪天除权）请用 ashare_events——本工具是历史记录。只读查询；按公告披露更新。⚠️ **支持港股**（代码 5 位 `hk00700`）。ETF 没有分红明细（只有 `ashare_etf(kind='概览')` 的 `divTtm`）。

ETF 数据。用户问'ETF'时用这个。`kind` 选子集：概览(默认·行情/规模/溢折率/资金流/回撤/估值) · 详情(基金要素/费率/份额/基金经理/持仓Top20) · 持仓(成分股及权重) · 净值(历史净值，**须同时传 start+end**) · 公司(管理人/托管人/跟踪指数) · 持有人(户数/机构个人占比) · 财务(股债商品基金占比)。⚠️ 返回的 `data` 是排版文本，**取字段用 `structured`（首表）或 `tables`（全部表）** —— `详情`/`公司` 是多表，只有 `tables` 拿全。⚠️ **查历史快照**：`kind=概览`/`持仓` + `date=YYYY-MM-DD`。传了 `date` 与不传**返回形态可能不同**（持仓：传 date＝重仓股涨跌 + 申赎清单前 10 两段、`code` 带市场前缀；不传＝单表 **Top20** 持仓、`code` 为裸 6 位）⇒ 按段名/列名取，⛔ 别按位置取。⚠️ 历史快照两个数据源边界：**未来日期按最近交易日返回**（看 `date` 列自证）；**上市前日期回全 0**（会被拦成 ok:false）。⚠️ **要『全市场有哪些 ETF / 规模排行 / 主题池（千亿·百亿·金牛奖·科创占比高…）』不在这里** —— 用 `ashare_screen(asset='etf')`：`mode=ranking` 有 9 类横截面指标（规模/估值/历史百分位/单日/区间涨跌/换手/成交额/溢折率），`mode=label` 有 48 个 ETF 主题池；`list=true` 先列合法取值。⚠️ **仅 ETF 代码**：传个股代码返回 `ok:false`（不扣次数）。⚠️ **`code` 单次只查 1 只**：传逗号会 422（本端点没有批量价）；多只请分别调用，每只独立计次。只读查询；代码形如 sh510300 或裸 6 位 510300。

个股事件标签（42 类：大宗/龙虎榜/回购/分红/解禁等）。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠️ 要看**全市场**某一类事件名单，请用 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`）+ 日期 + 研报详情页链接。研报**单独算名额**，不会被资讯挤掉，也不额外计费。⚠️ 研报**没有摘要**，`snippet` 为空。⚠️ 公告给的是**PDF 链接**（巨潮原始披露），资讯给的是原文链接，研报给的是详情页链接。⭐ **排序 = 相关性 → 权威度 → 日期**：标题或主体名称里有这个词的排前面，同级时公告在资讯前面。`relevance` 只看词出现在哪个字段（可核对的客观分档），不做语义猜测；`snippet` 让你不用点开就知道是不是你要的。⚠️ 公告比新闻权威（`authority` 1.0 vs 0.5），名额仍按「源平分」—— 否则公告会被当日新闻挤掉。⚠️ 结果缓存 5 分钟。

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

财务报表（利润表/资产负债表/现金流量表，**最近 N 期**）。用户问'营收/净利润/毛利率/负债/财务数据'用这个。⚠️ 返回**三张表**：data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表；每表按期次**降序**（最新一期在最前）。⚠️ 只要估值倍数（PE/PB）请用 ashare_sector_valuation 或 ashare_quote 的估值字段。只读查询；按财报披露节奏更新（未到披露日就没有新数据，不是故障）。⚠️ **支持港股**（代码 5 位 `hk00700`）。港股的报表期次/字段口径以返回为准，⛔ 别按 A 股列名硬解析。

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

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

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

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

**个股资金流向**（A 股 / 港股）：主力与散户的买入/卖出/净额 + 均价、收盘价。用户问'主力在进还是出/资金流多少'时用。⚠️ 与 `ashare_fund`（综合：龙虎榜+大宗+两融，**仅 A 股**）不是一回事 —— 港股只能用本工具。⚠️ 金额单位是**元**。只读查询；**专业版（¥99）及以上**。

**卖空数据**（港股 / 美股）：卖空股数/金额/比率（`ShortShares`/`ShortAmount`/`ShortRatio`）。用户问'被做空多少/卖空比率'时用。⚠️ **请传 `date`** —— 不传且当日数据未发布时，只回标识字段、没有卖空数值。⚠️ 仅港股 / 美股；**A 股没有卖空数据**（融券请用 `ashare_margin_trade`）。只读查询；**专业版（¥99）及以上**。

**港股通南下资金持仓**（季度）：持股数/持股比例/持股市值。用户问'南下资金持有多少/港股通占比'时用。**仅港股**。⚠️ 是**季度持仓**不是逐日流水 —— 逐日净流入用 `ashare_fund_flow`。⚠️ `codes` 可逗号多只。只读查询；**专业版（¥99）及以上**。

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

**指数成分股全量清单**（沪深300 / 上证50 / 中证500 / 中证1000 / 科创50 / 创业板指 / 恒生…）。用户问'沪深300有哪些成分股/这个指数包含哪些股票/ETF 底层持有什么'用这个。⚠️ **只有名单（`code` / `name` / `IndexName`），没有权重** —— 权重请用 `ashare_etf(kind='持仓')`（Top20 带权重）与 `kind=详情` 的 `top20Ratio`。⚠️ **不是 ETF 申赎清单**：申赎清单（PCG）含权重与现金替代标志，本工具给的是指数编制方的成分名单。⚠️ **只接受指数代码**（`sh000xxx` / `sz399xxx` / `hk*`）；个股 / ETF 请用 `ashare_etf(kind='持仓')`。⚠️ **支持港股指数**：`hkHSI` 恒生 / `hkHSCEI` 国企 / `hkHSTECH` 恒生科技。⚠️ **一次只查 1 个**（逗号多只返回空）。⚠️⚠️ **字段按市场不同，⛔ 不能按同一套键名解析**：A 股是 `code`/`name`/`IndexName`；**港股是中文键** `代码`/`名称`/`涨跌幅`/`成交额`（比 A 股多两列）。⚠️ 静态档案（随调仓变化），缓存 1 小时；**标准版（¥29.9）及以上**。

**指数全量清单**（1223 个）：code/name。用户问'有哪些指数/指数代码是什么'时用；拿到代码后用 `ashare_index_constituent` 取成分股。⚠️ 分页 limit(≤500)+offset；A股与港股指数混在一起（sh/sz/cs/hk 前缀）。只读查询；**专业版（¥99）及以上**。

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

新股日历（发行/申购/中签/上市）。用户问'新股/打新/IPO'用这个。只读查询；按发行日历更新。⚠️ **三市场覆盖**：A 股 / **港股** / 美股。

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

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

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

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

**龙虎榜机构参与个股榜**（全市场）：某个交易日**机构席位在龙虎榜上参与过的所有个股**，一次拿完（实测单日约 51 只）。行字段 `code` / `name` / **`net_buy` 机构净买入额（元，⚠️ 负值 = 机构净卖出）** / `join_num` 参与机构家数 / `change_pct` 涨幅% / `turnover` 成交额 / `amplitude` 振幅% / `turnover_rate` 换手% / `float_cap` 流通市值 / `market_cap` 总市值 / `fengkou_plates` 所属风口板块代码。用户问'今天机构买了哪些票/机构在龙虎榜买了什么/哪些票有机构参与'用这个。⭐ 与 `ashare_lhb_seats` 的分工：`ashare_lhb_seats` 是**单票往下看营业部**，本工具是**全市场往上筛票** —— 问「今天机构买什么」用本工具，问「这只票是谁买的」用 ashare_lhb_seats。⚠️ `net_buy` 是**净额**（买入−卖出），**可为负**，别取绝对值当买入额。⚠️ 龙虎榜是**盘后数据**：`date` 留空 = 最近交易日。`requested_date` 是你传入的、`date` 是实际日期，`is_fallback=true` 表示没拿到你指定的那天，以 `date` 为准。⚠️ **机构版专属**。

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

**涨停原因（单只票的历史涨停记录 + 完整原因文案）**：每次涨停的**完整原因** + 所属板块 + 当日「日内龙几」。行字段 `date` / `dragon_rank`（如「日内龙一」，空 = 非龙头）/ `plates` 板块代码数组 / **`reason` 完整涨停原因** / `concept` 概念说明。用户问'这只票为什么涨停/上次涨停什么原因/它靠什么题材涨停'用这个。⭐ 与 `ashare_limit_up` 的分工：涨停池给**今天全市场**涨停股；本工具给**单只票的历史**涨停原因。⚠️ 返回该股票历次涨停的全部记录，`date` 不用于筛选（`is_fallback=true` 即表示未按日期筛）。⚠️ `code` 必须 A 股（6 位或带 sh/sz/bj 前缀）。⚠️ **机构版专属**。

**短线打板**：当日涨停个股，含**涨停原因**与**资金面**。用户问'今天哪些票涨停 / 涨停原因 / 封单多大 / 主力买了多少'用这个。`mode` 取值：`auction` **竞价涨停** —— 只留「09:25 定盘即封涨停」的票（一字板 / 竞价抢筹），打板族盘前最常看的一张表（竞价中摸过涨停但定盘前被砸开的**不算**）；`limit` **涨停池明细**（默认）—— 每只含 `reason` 涨停原因 / `seal_amount` 封单额 / `seal_amount_max` 最大封单 / `main_net` 主力净额 / `main_buy`·`main_sell` 主力买入·卖出 / `amount` 成交额 / `concepts` 概念 / `float_cap` 流通市值 / `turnover` 换手% / `streak` 连板数 / `pct` 涨幅%。⚠️ 一次返回**全量**（含各连板高度），无需翻页。⚠️ `date` 留空 = 实时；给 YYYY-MM-DD 取该交易日历史（须为真实交易日，非交易日返空）。⚠️ 要**梯队结构 / 板块主线**请用 ashare_review。只读查询。

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

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

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

**市场情绪（破板率 + 赚钱效应 9 日趋势）**：一眼看今天短线情绪冷不冷。顶层 `break_count` 破板家数 / `break_rate` 破板率%；`data` 行（9 个交易日，新→旧）`date` / `success_rate` 成功率% / `profit_rate` 盈利概率%（**可为负**）。用户问'今天情绪怎么样/赚钱效应如何/破板率高不高/市场冷不冷'用这个。⭐ `success_rate` 连跌 = 情绪转冷；`profit_rate` 由负转正 = 赚钱效应回来。⭐ `break_rate` = 破板家数 ÷（破板家数 + 涨停家数）× 100。⚠️ `data` 的 9 日序列是最近 9 个交易日，不随 `date` 变；`is_fallback=true` 表示破板率没拿到你指定的那天。⚠️ 盘中会变（缓存 5 分钟）。⚠️ **机构版专属**。

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

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

**百日新高（按题材汇总）**：哪些题材今天在创百日新高。行字段 `theme` 题材名 / `plate_code` 板块代码 / `raw` 原始行（含家数）；顶层 `date` / `requested_date` / `is_fallback`。用户问'今天哪些题材创新高/新高最多的是什么板块'用这个。⭐ 新高集中的题材 = 资金在做的主线；可与 `ashare_sector`（涨幅榜）对照。⚠️ **机构版专属**。

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

**A 股北向资金分板块持仓（季度）**：外资在 A 股各板块的持仓。行字段 `plate_code` / `plate_name` / `raw`；顶层 `date` 报告期 / `total_net` 区间净额（元，**可为负**）/ `total_hold` 总持仓（元）/ `available_dates`。用户问'外资在买什么板块/北向持仓多少/北向资金流向'用这个。🔴 **必须传季度末**（如 2026-09-30）；留空自动取最近季度末，传非季度末返空（不是故障）。`available_dates` 给出可选报告期；`is_fallback=true` 表示没拿到你指定的日期。⚠️ 这是**板块维度**，不是个股持仓。⚠️ 与 `ashare_fund_south`（**港股通**南下资金）不是一回事。⚠️ **机构版专属**。

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

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

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

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

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

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

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

**卖方机构评级**：目标价（均值/最高/最低）+ 评级分布（买入/增持/中性/减持/卖出 + 覆盖机构数）+ **评级月度趋势**。用户问'机构目标价多少/评级怎么样/多少家覆盖'时用（**港股 / 美股**）。⚠️ **只支持港股 / 美股**（`hk00700` / `usAAPL`）；**A 股请用 `ashare_consensus`**（A 股没有卖方评级）。⚠️ `codes` 逗号多只，每只一段（用 `tables` 取全部段）。只读查询；**专业版（¥99）及以上**。

**卖方研报**：不传 `id` ⇒ 列表（标题+机构+评级+类型）；传 `id` ⇒ **研报全文**（Markdown，含财务点评）。用户问'有没有研报/机构怎么说/这篇讲了什么'时用。**A 股 / 港股**都覆盖。⚠️ **列表单次最多 20 条**（`limit`>20 会 422），翻页用 `offset`；「共 N 条」是历史总数；实测条数会有 +1 余量，⛔ 别按条数严格校验。⚠️ 没有时间范围参数；与 `ashare_dehydrated`（脱水摘要）互补。只读查询；**专业版（¥99）及以上**。

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

**选股员（scanner Agent）**：把自然语言条件交给只读取数工具，返回候选池 + 证据引用 + 工具轨迹。适合『高ROE + 央企 + 近5日主力净流入』这类条件选股。 ⚠️ **BYOK**：除 `ASHARE_KEY` 外还要设 `ASHARE_LLM_KEY`（模型 Key），模型 token 由客户自己付。 ⚠️ **专业版（¥99）起**；scanner 额度独立（2,000 次），不占数据 API 的 500k 总池。 ⚠️ 只做条件选股，不做涨跌预测、不推荐买卖、不自动交易。

**股票评分**（仅 A 股）：基本面 / 技术 / 综合 / 资金 / 风险 五维，每维带周/月/季变动（0~100，越高越好）。用户问'这票几分/基本面评分/技术评分'时用。⭐ 返回已**结构化**：每维 `value` + `chg_week`/`chg_month`/`chg_quarter`，⛔ 不需要自己解析字符串。⚠️ `chg_quarter` 是**本季累计**（评分每季重置，通常等于 `value`），不是 0。⚠️ `codes` 逗号多只；`date` 可查历史但**最早到 2026-04 下旬**；**仅 A 股**。只读查询；**专业版（¥99）及以上**。

选股（量化筛股），**五种模式**用 `mode` 选（默认 condition）：`condition` 因子表达式（如 intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])）· `label` 属性标签（央企/ST/破净/次新/市值档位… 108 个）· `ranking` 全市场排行（综合/资金/基本面/风险/技术评分，type 默认 CompScore）· `strategy` 策略选股（MACD 金叉/突破年线/高股息/大师策略… 98 个）· `event` 事件选股（分红/业绩预告/定增/解禁/董监高… 42 个）。用户问'筛选/选股/符合条件的股票/哪些票…'用这个。⚠️ **不知道 `type` 有哪些取值 ⇒ 先传 `list=true`**（返回该模式全部合法取值，带中文名与分组），⛔ 不要凭猜填 type（非法值会报错）。⚠️ 返回是排版好的表格；多标签/多策略会**分多段**返回 ⇒ 用 `tables` 取全部段。⭐ **要覆盖全市场**：把 `limit` 设大即可一次取全（如 `limit=9999`，实测返回 **5000+ 只**），结果直接读，不需要分批。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。

股票/基金/板块搜索（模糊词消歧）。用户只给名称时**先用这个确认代码**。⚠️ 本工具只返回代码与名称，不含行情——拿到代码后再调 ashare_quote / ashare_kline。⚠️ **覆盖 A 股 / 港股 / 美股**（`hk00700` 港股 5 位、`usAAPL` 美股）。只读查询。

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

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

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

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

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

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

**全市场股票清单**（一次拿全 A 股约 5576 只）：代码 / 名称 / 市场 / 上市日期 / 行业 / 板块 / 发行价 / 注册资本。用户问『所有上市公司有哪些 / 全部股票代码 / 某行业有哪些公司』或需要建标的池时用这个。⚠️ 与 `ashare_search` 的分工：search 必须给关键词（查单只），本工具**不需要关键词**、直接给全量。⚠️ **务必带 `limit`**：全量约 1 MB，会吃掉大量上下文；只要代码清单时用 `market` 收窄 + `limit` 分页。⚠️ 字段值为 `'-'` 表示数据源对该标的没有这项，不是取数失败。

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

**停复牌清单**（沪深 / 港股 / 美股）：哪些票停牌、哪些复牌、停牌原因。用户问'今天哪些票停牌/复牌'时用。⚠️ **选股里过滤停牌股**用这个 —— 因子/策略筛选**不剔除停牌**，拿到候选后与本清单交叉核对。⚠️ `market` 传中文（沪深/港股/美股）或 hs/hk/us。只读查询；**标准版（¥29.9）及以上**。

**尾盘抢筹（全市场抢筹金额榜）**：尾盘资金在抢哪些票，约 292 只。行字段 `code` / `name` / `fund_tag` 标记（如「基金」）/ `theme` 所属题材 / `change_pct` 涨幅% / **`chase_amount` 抢筹金额（元）** / `masked` 代码与名称是否不显示 / `raw` 原始行。用户问'尾盘谁在被抢筹/尾盘资金流入哪些票'用这个。⚠️ 返回结果前 4 行代码与名称不显示（金额仍完整），带 `masked=true` 的行不代表可交易标的。⭐ 结果已按 `sort` 重排（默认 `chase_amount` 降序），第一条即当日抢筹最大。⚠️ 只提供最近交易日，不支持按日期回看。⚠️ **机构版专属**。

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

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

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

**加自选股**：把股票加入自选；`code` 可逗号分隔批量；重复添加幂等。

**查自选股**：按 API Key 隔离，返回列表和标的；CRUD 不扣数据次数。

**自选股批量行情**：一次返回自选股最新行情。

**删自选股**：从自选列表删除标的；`code` 可逗号分隔批量。

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