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

> A-share data over MCP: quotes, profile, order book, K-line, financials, money flow, boards. 31 tools

- name: com.ashareapi/ashare-data-api
- version: 2026.10.8
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 60/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.ashareapi%2Fashare-data-api
- tools: https://api.protogrid.dev/v1/servers/com.ashareapi%2Fashare-data-api/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "ashare-data-api": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ASHARE_DATA_API_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${ASHARE_DATA_API_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-12d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 60/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 64 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: ashare_snapshot_batch (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); ashare_strategies (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); ashare_dividend (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- warn `tools.token_cost`: about 10,816 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 66 tool changes in 30 days
- fail `stability.rug_pull`: 6 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 60, about 10,816 tokens to load them all
- tool set hash: 49cf5bfd52c272900ecaa79088584d87
- tools last changed: 2026-10-18T20:24:53.815Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.ashareapi/ashare-data-api.svg)](https://protogrid.dev/servers/com.ashareapi/ashare-data-api)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-18 `ashare_evidence` changed (description)
  - before: **财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `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 分钟。
  - after: **财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `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 分钟。
- 2026-10-18 `ashare_evidence` changed (description)
  - before: **财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `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 分钟。
  - after: **财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `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 分钟。
- 2026-10-18 `ashare_calendar` added
  - **个股事件日历**：分红派息 / 限售解禁 / 财报披露 / 新股发行 / 会议 / 增发 等**公司事件排期**，从指定日期起约 **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` 只是**建议值**，数据按事件类型分段、**各段条数不严格等于该值**。
- 2026-10-18 `ashare_news` changed (description)
  - before: 个股**财经资讯**。不传 `id` ⇒ 列表（标题 + 来源 + 时间）；传 `id` ⇒ ⭐ 该条**完整正文**。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ **正文是干净的 Markdown**（已清洗 HTML 标签/图片占位/无效内链，保留股票代码关联如 `茅台(sh600519)`，时间 `YYYY-MM-DD HH:MM:SS`）—— **可直接喂给大模型**。⚠️ 列表**只有最新 N 条**（上游不提供翻页/历史）—— 要**历史公告**请用 ashare_notice。⚠️ 列表里的 `url` 指向动态页面，**直接抓不到正文** ⇒ 要正文请用本工具的 `id` 参数。
  - after: 个股**财经资讯**。不传 `id` ⇒ 列表（标题 + 来源 + 时间）；传 `id` ⇒ ⭐ 该条**完整正文**。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ **正文是干净的 Markdown**（已清洗 HTML 标签/图片占位/无效内链，保留股票代码关联如 `茅台(sh600519)`，时间 `YYYY-MM-DD HH:MM:SS`）—— **可直接喂给大模型**。⚠️ 列表**只有最新 N 条**（不提供翻页/历史）—— 要**历史公告**请用 ashare_notice。⚠️ 列表里的 `url` 指向动态页面，**直接抓不到正文** ⇒ 要正文请用本工具的 `id` 参数。
- 2026-10-18 `ashare_industry_chain` added
  - **A 股产业链**（**183 个产业链主题**），三种模式：`mode=list` → 主题列表；`mode=graph` + `topic=超级电容` → **产业链图谱**（关联个股 + 所属节点 + 产业链位置 上游/中游/下游）；`mode=stock` + `code=sh600667` → **个股所属产业链**（主题 / 节点 / 位置 / **关联度** / **业务描述**）。用户问'产业链/上下游/某公司处于链上什么位置/这个主题有哪些公司'用这个。⚠️ **参数是二选一**：`mode=graph` 必须给 `topic`，`mode=stock` 必须给 `code`；给错组合（如 mode=graph 却只给 code）拿不到数据。⚠️ 主题名要**中文全称**（`超级电容` / `集成电路`）—— 拿不准先 `mode=list` 搜一遍再问。
- 2026-10-18 `ashare_profile` added
  - **公司简况**：上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 员工数 等。用户问'这家公司是做什么的/哪年上市/属于什么行业/董事长是谁'用这个。⚠️ **与 ashare_snapshot 的分工**：snapshot 给**估值/市值/股本**（数字面），本工具给**公司本身是谁**（业务面）—— 问『做什么的』用本工具，问『贵不贵』用 snapshot。⚠️ **一次只查一只**：本工具的 `code` 虽也支持逗号，但返回是**扁平行、无逐只状态**，无效码会被**直接忽略**（`sh600519,sz999999` 只会回 1 行，没有任何提示）⇒ **多只请用 `ashare_profile_batch`**（专业版 100 只 / 不限量 150 只，逐只标明成功与否）。⚠️ 代码可传 `sh600667` 或裸 6 位 `600667`（内部会补前缀）。⚠️ **港股**（`hk00700`）与**板块**（`pt01801081`）也能查，但**字段会缺**（港股无 `listedDate`；两通道口径不同）⇒ 以返回为准。⚠️ 数据是**静态档案**，缓存 24 小时 —— 同一天重复问不会重复消耗配额。
- 2026-10-18 `ashare_lhb` changed (description)
  - before: 全市场龙虎榜分榜（6 类）：type=all 全市场总榜（净买/买卖额）/ institution 机构榜（机构买入/净买/机构数）/ activeseat 活跃席位（席位买入额+关联个股）/ winbuy 高胜率买入（净买额/胜率/席位明细）/ winseat 高胜率席位（席位胜率+关联个股）/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠️ hotmoney（游资榜）上游暂无数据，建议改用 all/activeseat/winbuy。⚠️ 龙虎榜为收盘后发布（一般 18:00 后）；date 留空=最近交易日。⚠️ 某只股票的上榜明细（上榜原因/营业部）请用 ashare_fund——本工具是市场级榜单，不针对单只股票。
  - after: 全市场龙虎榜分榜（6 类）：type=all 全市场总榜（净买/买卖额）/ institution 机构榜（机构买入/净买/机构数）/ activeseat 活跃席位（席位买入额+关联个股）/ winbuy 高胜率买入（净买额/胜率/席位明细）/ winseat 高胜率席位（席位胜率+关联个股）/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠️ hotmoney（游资榜）暂无数据，建议改用 all/activeseat/winbuy。⚠️ 龙虎榜为收盘后发布（一般 18:00 后）；date 留空=最近交易日。⚠️ 某只股票的上榜明细（上榜原因/营业部）请用 ashare_fund——本工具是市场级榜单，不针对单只股票。
- 2026-10-18 `ashare_bigorder` added
  - **单股 L2 大单资金分时**（分钟级）：`net` = 该分钟**大单净额（元）**，正数=大单净买入、负数=净卖出。用户问'大单在买还是卖/主力资金分时/哪一分钟砸盘'用这个。⚠️ **仅当日**（非交易日/盘前返回最近一个交易日），日期看返回顶层 `day`。⚠️ 盘中末尾几分钟仍在追加：09:30–15:00 约 **242 点**，盘中调用点数会随交易时段增长。⚠️ 这是**大单口径**（按成交金额聚合）—— 不是逐笔委托、也不是十档盘口，别把它当'盘口深度'用。⚠️ **不限量版专属**：专业版及以下调用会返回明确说明 + 升级链接，不会静默失败。⚠️ 与 `ashare_fund` 的分工：`ashare_fund` 给**日级汇总**（主力净额 1/5/10/20 日）+ 龙虎榜/大宗/两融；本工具给**当日分钟级大单曲线** ⇒ 看趋势用本工具，看快照用 fund。
- 2026-10-18 `ashare_bigorder_flow` added
  - **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` 时用 `money` 抬高阈值（0=30万 …4=1000万）缩小范围。⚠️ 这是**成交口径**，不是逐笔委托、也不是十档盘口。⚠️ **不限量版专属**：其他档位返回明确说明 + 升级链接。
- 2026-10-18 `ashare_lhb_seats` added
  - **龙虎榜席位明细**：某只票某次上榜的**营业部买卖席位**（最多 10 个），带 **`is_youzi` 游资标记**。行字段 `name`（营业部）/ `total_buy` / `total_sell` / `net`（净买额）/ `is_youzi` / `log_id`，按净买额降序。用户问'今天龙虎榜是谁买的/哪个营业部/是不是游资/沪股通买了多少'用这个。⭐ 与 `ashare_lhb` 的分工：`ashare_lhb` 是**榜单**（机构榜/活跃席位等统计），本工具是**单票的具体营业部明细** —— 问「谁买的」用本工具，问「今天哪类资金活跃」用 ashare_lhb。⚠️ 龙虎榜是**盘后数据**：`date` 留空 = 最近一次上榜日，以返回的 `date` 为准。⚠️ 单次最多约 10 个席位。⚠️ **不限量版专属**。

Full history: https://api.protogrid.dev/v1/servers/com.ashareapi%2Fashare-data-api/changes

## Remotes

- https://api.ashareapi.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (60)

- `ashare_abnormal`: **异动 / 偏离值**（短线监管异动体系）：触发「严重异动」、「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` 数据日期。只读查询。
- `ashare_auction`: **集合竞价**：个股 9:15–9:25 集合竞价数据，含**「竞价触及涨停」判定**。用户问'竞价分时 / 竞价怎么走的 / 集合竞价买了多少 / 哪些票竞价就涨停了'用这个。`mode` 取值：`stock` **当日竞价分时**（默认，分钟级逐笔）· `stock-history` **历史竞价分时**（秒级逐笔，需 `date`）· `volume` **当日竞价量 / 资金净额**（单点）。⭐ `is_limit_up` = 「竞价触及涨停」判定（竞价段最高价 ≥ 涨停价，涨停价取自行情源原始值）。另含 `up_px` 涨停价 / `down_px` 跌停价 / `open_px` 09:25 撮合价 / `preclose_px` 昨收。⚠️ `mode=stock` 仅当日；历史请用 `mode=stock-history` 且必传 `date`（真实交易日）。只读查询。
- `ashare_backtest`: **量化回测**：按策略跑历史收益（返回收益/最大回撤/交易次数/净值曲线等）。用户问'回测一下/这个策略收益如何/买卖点效果/最大回撤'用这个。⚠️ 两种模式：`mode=single`（默认）**单标的实时计算**，须配 `code`；`mode=portfolio` **组合**（须用 `strategies` 里的组合策略，区间受预置批次限制）。⚠️ `weighting=inv_vol`（按波动率倒数配仓）**仅组合模式 + 不限量版**可用。⚠️ 想知道有哪些策略/参数范围，先调 ashare_strategies；想一次跑多标的×多策略，用 ashare_backtest_batch。⚠️ **付费工具**（需 Key）：单标的 **Standard（¥29.9）起**；组合 / 批量回测为 **Pro 及以上**，且有独立日额度，余量可查 ashare_usage。
- `ashare_backtest_batch`: **批量回测**：一次跑 **多标的 × 多策略**，返回对比矩阵（哪个组合最好一目了然）。用户问'这几只股票用不同策略分别跑一下/批量回测/策略对比'用这个。⚠️ 与 ashare_backtest 的区别：本工具**一次给多标的×多策略的横向对比**，ashare_backtest 只跑**一个**策略。⚠️ 上限：标的 ≤20 · 策略 ≤10 · 组合 ≤60（**超限直接报错，不静默截断**）。⚠️ 组合策略不能用于批量回测（批量只支持单标的择时策略）。⚠️ 参数可传**列表**（自动转逗号）。⚠️ **付费工具**（需 Key）：**Pro（¥69）及以上**，有独立日额度。
- `ashare_bigorder`: **单股 L2 大单资金分时**（分钟级）：`net` = 该分钟**大单净额（元）**，正数=大单净买入、负数=净卖出。用户问'大单在买还是卖/主力资金分时/哪一分钟砸盘'用这个。⚠️ **仅当日**（非交易日/盘前返回最近一个交易日），日期看返回顶层 `day`。⚠️ 盘中末尾几分钟仍在追加：09:30–15:00 约 **242 点**，盘中调用点数会随交易时段增长。⚠️ 这是**大单口径**（按成交金额聚合）—— 不是逐笔委托、也不是十档盘口，别把它当'盘口深度'用。⚠️ **不限量版专属**：专业版及以下调用会返回明确说明 + 升级链接，不会静默失败。⚠️ 与 `ashare_fund` 的分工：`ashare_fund` 给**日级汇总**（主力净额 1/5/10/20 日）+ 龙虎榜/大宗/两融；本工具给**当日分钟级大单曲线** ⇒ 看趋势用本工具，看快照用 fund。
- `ashare_bigorder_flow`: **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` 时用 `money` 抬高阈值（0=30万 …4=1000万）缩小范围。⚠️ 这是**成交口径**，不是逐笔委托、也不是十档盘口。⚠️ **不限量版专属**：其他档位返回明确说明 + 升级链接。
- `ashare_bigorder_queue`: **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 = **成交**（真买了）。两个一起看才能分清「挂了没成」和「真买了」。⚠️ **仅当日**；`vol` ∈ {500,1000,2000,5000,10000} 手、`tur` ∈ {30,50,100,200,500,1000} 万；单次最多约 200 笔。⚠️ 这是**委托口径**，不是成交、也不是十档盘口。⚠️ **不限量版专属**。
- `ashare_block_trade`: **大宗交易成交明细**：成交价 / 成交量 / 成交额 / **折溢价率** / 买方营业部 / 卖方营业部。用户问'有没有大宗交易/折价还是溢价成交/谁在接盘/机构席位'用这个。⚠️ **code 可留空**：留空 = 当日**全市场**大宗交易；给了 code = 该股的大宗记录。⚠️ `date` 留空 = 最近交易日。⚠️ **当日无大宗交易时返回的是行情元信息**（code/name/date/closePrice/changePct，证明标的没问题、只是没有大宗）—— 判『有没有大宗』要看返回里有没有`TurnoverPrice`/`BuySalesDepartment` 这类成交字段。⚠️ **与 ashare_fund 的关系**：`ashare_fund` 的大宗只是概览一行；本工具是**逐笔明细**。
- `ashare_bond`: 可转债完整条款：溢价率/转股价值/双低值/强赎触发价/回售触发价/转股价/正股/到期日/评级。用户问'转债条款/强赎/双低/溢价'用这个。⚠️ 要转债**行情价**请用 ashare_quote（同样支持转债代码）。只读查询；代码形如 sh113052（沪）/ sz123138（深）。
- `ashare_calendar`: **个股事件日历**：分红派息 / 限售解禁 / 财报披露 / 新股发行 / 会议 / 增发 等**公司事件排期**，从指定日期起约 **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` 只是**建议值**，数据按事件类型分段、**各段条数不严格等于该值**。
- `ashare_changedist`: 全市场涨跌家数与市场广度（**当期口径**）：上涨/下跌/平盘/停牌家数 + 上涨占比 + 涨停/跌停 + 11 档涨跌幅区间分布 + 两市成交额。用户问'今天涨跌家数/多少家涨停/市场情绪/市场广度'用这个——这是市场广度的**唯一推荐入口**。⚠️ 不要用 ashare_market_overview 的 updown 模式取同一数据（那是 T-1 口径，数值会与此不一致）。· 免费工具（无需 Key）
- `ashare_chip`: **筹码分布 / 持仓成本**（仅沪深 A 股）：获利盘比例 + 平均成本 + 90% 与 70% 集中度 + 当日收盘价。用户问'筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大/主力成本在哪'用这个。⚠️ **多只请用 `ashare_chip_batch`**（一次 200 只、逐只标明成功与否）—— 本工具只查一只。⚠️ `date` 可回看历史（`YYYY-MM-DD`，缺省=最新）；**历史仅保留约近 1 年**；非交易日/未来日期会**自动回退到最近交易日**，以返回行的 `date` 为准。⚠️ 代码可传 `sh600667` 或裸 6 位 `600667`。⚠️ **付费工具**：需 Key（体验版及以上），免费/匿名不可用。
- `ashare_chip_batch`: ⭐ **批量筹码分布：一次拿多只的获利盘比例 / 平均成本 / 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）及以上**，标准版不可用。
- `ashare_dehydrated`: 脱水研报（券商研报摘要）。用户问'研报/机构观点/券商怎么说'用这个。mode=list 列表 / mode=detail 详情（detail 需给 symbol）。⚠️ 要**个股新闻/公告**请用 ashare_events。只读查询；按研报发布更新。
- `ashare_dividend`: 分红送转历史（每股分红/送股/除权日）。用户问'分红/股息/送转'用这个。⚠️ 要**分红派息日历**（哪天除权）请用 ashare_events——本工具是历史记录。只读查询；按公告披露更新。
- `ashare_etf`: ETF 数据。用户问'ETF'时用这个。`kind` 选子集：概览(默认·行情/规模/溢折率/资金流/回撤/估值) · 详情(基金要素/费率/份额) · 持仓(成分股及权重) · 净值(历史净值，**须同时传 start+end**) · 公司(管理人/托管人/跟踪指数) · 持有人(户数/机构个人占比) · 财务(股债商品基金占比)。⚠️ 返回的 `data` 是排版文本，**取字段用 `structured`（首表）或 `tables`（全部表）** —— `详情`/`公司` 是多表，只有 `tables` 拿全。⚠️ **仅 ETF 代码**：传个股代码不报错但字段全空。只读查询；代码形如 sh510300。
- `ashare_events`: 个股事件标签（42 类：大宗/龙虎榜/回购/分红/解禁等）。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠️ 要看**全市场**某一类事件名单，请用 ashare_lhb（龙虎榜分榜）或 ashare_dividend（分红送转）——本工具是**单只股票**的事件总览。只读查询；按披露节奏更新。
- `ashare_evidence`: **财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `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 分钟。
- `ashare_factors`: **量化因子库**：88 个因子 + 50 个筛选入口 + 22 个预设组合，可按分类/类型筛选。用户问'有哪些因子/因子库/选股因子/因子分类'用这个。⚠️ 这是**清单**（静态元数据）；要用因子实际选股，用 ashare_screen。⚠️ `category` / `kind` **只接受中文枚举值**（category：估值/行情/盈利/成长/财务/资金…；kind：排行/标签/事件）。传英文会返回空。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。
- `ashare_finance`: 财务报表（利润表/资产负债表/现金流量表，**最近 N 期**）。用户问'营收/净利润/毛利率/负债/财务数据'用这个。⚠️ 返回**三张表**：data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表；每表按期次**降序**（最新一期在最前）。⚠️ 只要估值倍数（PE/PB）请用 ashare_sector_valuation 或 ashare_quote 的估值字段。只读查询；按财报披露节奏更新（未到披露日就没有新数据，不是故障）。
- `ashare_finance_batch`: ⭐ **批量财务报表：一次拿多只的利润表 / 资产负债表 / 现金流量表**，逐只标明成功与否。用户问'这几只的营收/净利/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）及以上**，标准版不可用。
- `ashare_flash`: **7×24 财经快讯**（全市场电报，财联社等来源），按时间倒序。行字段 `id` / `time` / `title` / `content` / `source` / `url`。用户问'今天有什么大消息/最新财经新闻/刚才发生了什么/宏观突发事件'用这个。⭐ **与 `ashare_news` 的分工**：`ashare_news` 是**按个股**的资讯（要传 code）；本工具是**全市场快讯流**（不需要代码）—— 问大盘/宏观/突发用这个，问某只票的消息面用 news。⚠️ 翻页：`index` 从 0 开始，步长=上次的 `limit`（`limit=20&index=20` 是第二页）；只能往回翻，无日期参数。⚠️ `limit` 上限 200；**缓存 1 分钟**（同一分钟内重复请求不重复消耗）。
- `ashare_fund`: 个股级交易面：这只股的 主力资金（当日/5/10/20 日净流入+全市场排名）+ 龙虎榜上榜明细（上榜原因/营业部）+ 大宗交易 + 融资融券。用户问'某只股票的主力资金/机构动向'用这个。⚠️ 全市场榜单（今天机构榜/游资榜/活跃席位）请用 ashare_lhb——本工具只针对单只股票。⚠️ **要一次查多只股票的资金流**（扫自选池/一个行业），用 ashare_fund_batch。
- `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）及以上**，标准版不可用。
- `ashare_hot`: **关注度**排名（谁在被关注，⛔ 不是'谁在涨'）。用户问'什么股票热门/大家在看什么/热度榜/热门板块/热文'用这个。⚠️⚠️ **5 类字段结构完全不同**，⛔ 别按同一套字段读：stock 热搜股票(code/name/zdf/zxj) · wx 全市场热度(**多 pv 热度值**) · news 热门文章(⚠️ **news_id/news_title/source**，⛔ 无 code) · sector 热门板块(⚠️ **symbol**，⛔ 无 code) · etf 热搜 ETF(含 title/tag)。⚠️ 当前快照（无历史）· 免费工具（无需 Key）
- `ashare_industry_chain`: **A 股产业链**（**183 个产业链主题**），三种模式：`mode=list` → 主题列表；`mode=graph` + `topic=超级电容` → **产业链图谱**（关联个股 + 所属节点 + 产业链位置 上游/中游/下游）；`mode=stock` + `code=sh600667` → **个股所属产业链**（主题 / 节点 / 位置 / **关联度** / **业务描述**）。用户问'产业链/上下游/某公司处于链上什么位置/这个主题有哪些公司'用这个。⚠️ **参数是二选一**：`mode=graph` 必须给 `topic`，`mode=stock` 必须给 `code`；给错组合（如 mode=graph 却只给 code）拿不到数据。⚠️ 主题名要**中文全称**（`超级电容` / `集成电路`）—— 拿不准先 `mode=list` 搜一遍再问。
- `ashare_ipo`: 新股日历（发行/申购/中签/上市）。用户问'新股/打新/IPO'用这个。只读查询；按发行日历更新。
- `ashare_kline`: K线（日/周/月/季/年 + 分钟线）。用户问'走势/最近表现/历史K线/趋势'用这个。⚠️ 只要**当前价**用 ashare_quote；要**分时**（盘中每分钟价+累计量）用 ashare_minute ——**分钟 K 线**（OHLC 蜡烛）用本工具的 `period=m1/m5/...`，两者不是一回事。⚠️ 换手率字段名是 **`turnover`**（%）—— 与 ashare_quote、ashare_snapshot 同名同值。⚠️ 复权口径由服务端固定（无 `adjust` 参数）：日线及以上**前复权**（除权除息日不跳空），分钟线**不复权** —— **不要再自己复权**（会二次复权）。⚠️ **分钟线需 `standard`（¥29.9）及以上档位**（日/周/月免费），必须同时传 `start`+`end`（窗口近 1 个月），不支持 北交所 / 期货 / 外汇。只读查询；按收盘更新。⚠️ **免费 / 匿名档按 5 分钟刷新**；**付费档实时**（每次取此刻最新）。⭐ **要多只的 K 线（自选池 / 一个行业）—— 用 `ashare_quote_batch`**（它返回逐只状态、4 秒拿完 300 只；本工具的 code 虽接受逗号但返回混在一起、缺了哪只算不出来）。⚠️ **匿名单次最多 5 只标的**（付费不限）。· 免费工具（无需 Key）· 分钟线除外
- `ashare_kline_batch`: ⭐ **批量 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）及以上**，标准版不可用。
- `ashare_kline_full`: 全历史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）不可用；且有**独立日额度**（Standard 200 / Pro 500 / Unlimited 2000 次/天），余量可查 ashare_usage。
- `ashare_lhb`: 全市场龙虎榜分榜（6 类）：type=all 全市场总榜（净买/买卖额）/ institution 机构榜（机构买入/净买/机构数）/ activeseat 活跃席位（席位买入额+关联个股）/ winbuy 高胜率买入（净买额/胜率/席位明细）/ winseat 高胜率席位（席位胜率+关联个股）/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠️ hotmoney（游资榜）暂无数据，建议改用 all/activeseat/winbuy。⚠️ 龙虎榜为收盘后发布（一般 18:00 后）；date 留空=最近交易日。⚠️ 某只股票的上榜明细（上榜原因/营业部）请用 ashare_fund——本工具是市场级榜单，不针对单只股票。
- `ashare_lhb_seats`: **龙虎榜席位明细**：某只票某次上榜的**营业部买卖席位**（最多 10 个），带 **`is_youzi` 游资标记**。行字段 `name`（营业部）/ `total_buy` / `total_sell` / `net`（净买额）/ `is_youzi` / `log_id`，按净买额降序。用户问'今天龙虎榜是谁买的/哪个营业部/是不是游资/沪股通买了多少'用这个。⭐ 与 `ashare_lhb` 的分工：`ashare_lhb` 是**榜单**（机构榜/活跃席位等统计），本工具是**单票的具体营业部明细** —— 问「谁买的」用本工具，问「今天哪类资金活跃」用 ashare_lhb。⚠️ 龙虎榜是**盘后数据**：`date` 留空 = 最近一次上榜日，以返回的 `date` 为准。⚠️ 单次最多约 10 个席位。⚠️ **不限量版专属**。
- `ashare_limit_up`: **短线打板（涨停池明细）**：当日全部涨停个股，含**涨停原因**与**资金面**。用户问'今天哪些票涨停 / 涨停原因 / 封单多大 / 主力买了多少'用这个。`mode` 取值：`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。只读查询。
- `ashare_macro`: 宏观数据（GDP/CPI/PMI/LPR/国债收益率/财政）。用户问'宏观/经济数据/利率/LPR/CPI'用这个。⚠️ 要**指数行情**请用 ashare_quote 或 ashare_market_overview——本工具只给宏观指标。只读查询；按发布日历更新（未到发布日就没有新值）。
- `ashare_margin_trade`: **个股融资融券明细**：融资余额 / 融资买入 / 融资偿还 / 融券余额 / 融券卖出 / 融券偿还。用户问'这只股票杠杆资金在加还是在撤/融资余额多少/两融数据'用这个。⚠️ **code 必填**（参数上不是 required，但不传只会得到一句明确说明、没有数据）。⚠️ **支持批量**：`code` 可传逗号分隔（`sh600667,sz000651`），返回多行 —— 但**不带逐只状态**，缺了哪只要自己算。⚠️ `date` 留空 = 最近**已披露**交易日（两融数据 T+1 披露，当天查不到当天的）；未披露的交易日会给出明确原因。⚠️ **与 ashare_fund 的关系**：`ashare_fund` 一次给『资金 + 龙虎榜 + 大宗 + 两融』四块概览；本工具只给**两融明细**、字段更全 ⇒ 只看两融用本工具。
- `ashare_market_kline`: **全市场单日K线** —— 一次请求返回某交易日**全 A 股（5000+ 只）**的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠️ **用途**：替代「逐只循环 5000 次」——每天收盘后调 **1 次**即可拿到全市场，适合建本地行情库/做全市场扫描/每日批量更新。⚠️ **两种硬限定**：① **仅 Pro（¥99）与 Unlimited（¥199）** 可用（Standard 及以下会被拒）；② **1 次调用折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）。⚠️ 另有**独立日额度**（Pro 200 / Unlimited 1000 次/天），余量可查 ashare_usage。⚠️ 数据范围：**仅 A 股股票**（5572 只）、**2016-08-08 起**、**不复权原始价**；不含 ETF/可转债/指数/板块/港股/美股。最新数据到**前一交易日**（盘中当日数据不可用）。⚠️ 体积约 785 KB/次。字段 8 列：`code time open high low close volume amount`。
- `ashare_market_overview`: 市场级画像。type=summary 画像总评/trade 收盘/interval 多周期/technical 大盘技术/valuation 估值分位/rotation 风格轮动。用户问'今天市场怎么样/大盘环境/风格轮动/估值分位'用这个。⚠️ 涨跌家数（市场广度）请用 ashare_changedist：本工具的 updown 模块为 **T-1 口径**（返回里会标数据日期，可能滞后一个交易日），已不推荐用于回答'今天的涨跌家数'。· 免费工具（无需 Key）
- `ashare_minute`: **分时**（当日 / 近 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）不可用。⚠️ **付费档实时**（每次取此刻最新）。
- `ashare_news`: 个股**财经资讯**。不传 `id` ⇒ 列表（标题 + 来源 + 时间）；传 `id` ⇒ ⭐ 该条**完整正文**。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ **正文是干净的 Markdown**（已清洗 HTML 标签/图片占位/无效内链，保留股票代码关联如 `茅台(sh600519)`，时间 `YYYY-MM-DD HH:MM:SS`）—— **可直接喂给大模型**。⚠️ 列表**只有最新 N 条**（不提供翻页/历史）—— 要**历史公告**请用 ashare_notice。⚠️ 列表里的 `url` 指向动态页面，**直接抓不到正文** ⇒ 要正文请用本工具的 `id` 参数。
- `ashare_notice`: 上市公司**公告**。不传 id ⇒ 列表（code 必填，支持 type / limit / offset 翻页，可回溯约 20 年）；传 id ⇒ 该公告详情。用户问'公告/披露/半年度报告/年报在哪'用这个。⚠️ **详情有两种形态**（实测约 9/10 给正文）：多数短公告 ⇒ `text`=**正文**（直接读）；少数长报告（如半年报 100+ 页）⇒ `text` 空、`url`=**PDF 链接**。⇒ 判据：**先看 `text`**，空则用 `url`。⚠️ **长报告的 PDF 请自行获取与解析**（用你环境里的 PDF 能力）——我们只给链接，不代做解析。💡 **要财务数字请用 `ashare_finance`**（结构化，比从 100+ 页 PDF 里抠快得多）。
- `ashare_orderbook`: **五档盘口**：买一~买五 / 卖一~卖五的**价格与挂单量（手）** + 现价/涨跌/数据时间。用户问'封单多少/买盘卖盘/盘口/挂单/支撑压力位/有没有大单托着'用这个。字段：`b1_p`/`b1_v`~`b5_p`/`b5_v` 买档价格/量 · `a1_p`/`a1_v`~`a5_p`/`a5_v` 卖档。⚠️ 本工具是**秒级快照**（每 10 秒刷新），**盘中才有意义**（收盘后为当日最后快照）——要**实时成交价**用 ashare_quote（**免费**，字段少更轻）。⚠️ 量单位是**手**（×100 = 股）；**跌停买档全 0 / 涨停卖档全 0**（正常）。
- `ashare_playbooks`: **量化方法论库**：25 条「怎么判断市场」的流程（含判据 / 阶段 / 实测证据）。用户问'怎么判断/交易方法/方法论/判断流程'用这个。⚠️ 这是**方法论清单**（帮助判断，非投资建议）；要看可回测的策略用 ashare_strategies。⚠️ 可按分类或 id 取单条。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。
- `ashare_profile`: **公司简况**：上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 员工数 等。用户问'这家公司是做什么的/哪年上市/属于什么行业/董事长是谁'用这个。⚠️ **与 ashare_snapshot 的分工**：snapshot 给**估值/市值/股本**（数字面），本工具给**公司本身是谁**（业务面）—— 问『做什么的』用本工具，问『贵不贵』用 snapshot。⚠️ **一次只查一只**：本工具的 `code` 虽也支持逗号，但返回是**扁平行、无逐只状态**，无效码会被**直接忽略**（`sh600519,sz999999` 只会回 1 行，没有任何提示）⇒ **多只请用 `ashare_profile_batch`**（专业版 100 只 / 不限量 150 只，逐只标明成功与否）。⚠️ 代码可传 `sh600667` 或裸 6 位 `600667`（内部会补前缀）。⚠️ **港股**（`hk00700`）与**板块**（`pt01801081`）也能查，但**字段会缺**（港股无 `listedDate`；两通道口径不同）⇒ 以返回为准。⚠️ 数据是**静态档案**，缓存 24 小时 —— 同一天重复问不会重复消耗配额。
- `ashare_profile_batch`: ⭐ **批量公司简况：一次拿多只的上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 注册地址 / 联系方式**，逐只标明成功与否。用户问'这几只都是做什么的/帮我按行业归类/筛出来的池子逐个看基本面/什么时候上市的'用这个。⚠️ 与 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）及以上**，标准版不可用。
- `ashare_quote`: 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）
- `ashare_quote_batch`: ⭐ **批量行情：一次拿多只股票的行情**，逐只标明成功与否。用户问'这几只现在什么价/扫一下我这个池子/一个行业现在的行情'用这个。⚠️ 与 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）及以上**，标准版不可用。
- `ashare_review`: **短线复盘（涨停结构）**：看今天钱在哪些题材、梯队结构长什么样。用户问'今天什么题材最强 / 板块主线 / 连板梯队 / 几板几只 / 谁是反包'用这个。`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。只读查询。
- `ashare_screen`: 因子选股（量化筛股）。expression 是多因子交集表达式，例：intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])；常用字段：PE_TTM/PB/PS_TTM/ROE/ROETTM/ROIC/DividendRatioTTM/OperatingRevenueGrowRate/DebtAssetsRatio。用户问'筛选/选股/符合条件的股票'用这个。
- `ashare_search`: 股票/基金/板块搜索（模糊词消歧）。用户只给名称时**先用这个确认代码**。⚠️ 本工具只返回代码与名称，不含行情——拿到代码后再调 ashare_quote / ashare_kline。只读查询。
- `ashare_sector`: 板块行情榜（行业/概念/地域涨幅 + 领涨股 + 涨跌家数）。用户问'哪些板块在涨/板块轮动/行业热度'用这个。⚠️ 要板块**估值分位**请用 ashare_sector_valuation；要**产业链上下游**请用对应工具。只读查询；交易时段内更新。
- `ashare_sector_valuation`: 板块估值（PE/PB/PS/PCF + 股息率 + 历史百分位）。用户问'某板块贵不贵/估值分位'用这个。⚠️ 要看板块**涨跌幅与领涨股**请用 ashare_sector——本工具只给估值指标。只读查询；板块代码形如 pt01801780（pt 前缀 + 8 位）。
- `ashare_shareholder`: 股东研究：十大股东/股东户数（筹码集中度）/机构持仓。用户问'谁在持有/股东变化/筹码集中/机构持仓'用这个。⚠️ 要看机构**整体**在全市场买什么，请用 ashare_lhb 的机构榜。只读查询；股东户数按定期报告披露（季度级）。
- `ashare_shareholder_batch`: ⭐ **批量股东研究：一次拿多只的十大股东 / 十大流通股东 / 股东户数统计**，逐只标明成功与否。用户问'这几只谁在持有/股东户数变少了吗/股权集中不集中/机构在不在里面'用这个。⚠️ **与 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）及以上**，标准版不可用。
- `ashare_snapshot`: **全字段行情画像**：价格 + 盘口（买五卖五+委差）+ 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本（流通/总）+ 打板（涨停/跌停价 + 量比 + 振幅 + 涨速）+ 标识（证券类型/股票状态/币种）+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠️ **与 ashare_quote 的分工**：quote 轻（8 字段）**免费**；本工具**全（35 字段）· 付费**——**只要现价/涨跌用 ashare_quote 更轻**（字段少、省上下文）。✅ **计费 = 次数**：本工具 1 次拿全——要估值+市值+股本+涨停价**多项**时，比分别调 quote/valuation/orderbook **更省次数**（3 次 → 1 次）。⚠️ **仅 A 股**（港股/美股字段布局不同，用 ashare_quote）——**传其他市场返回空，不返回错数据**。⚠️ 单位：量=手 · 成交额=万元 · 市值=亿元 · 股本=股 · 比率=百分数。
- `ashare_snapshot_batch`: ⭐ **批量全字段画像：一次拿多只股票的完整画像**（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）及以上**，标准版不可用。
- `ashare_strategies`: **量化策略清单**：返回可回测的全部策略（20 条单标的择时 + 9 条组合），含各自参数范围与说明，⭐ **并附「实测表现」**（`performance` 字段）—— 在 800 只（沪深300+中证500）· 2019 年至今、**含真实交易成本**上跑出的真实成绩。`verdict` 分级：`effective` 实测有效 / `neutral` 一般 / `weak` 偏弱 / **`avoid` 实测亏损**；`note` 字段给避坑提示。⚠️ **无效的策略同样列出**（便于避开常见陷阱，如高换手被成本吃光）。用户问'有哪些策略/哪些策略能赚/哪个策略坑/策略参数是什么'用这个。⚠️ 这是**清单 + 实测摘要**（不跑新计算）；要真跑回测用 ashare_backtest。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。
- `ashare_technical`: 技术指标 MA/MACD/KDJ/RSI/BOLL。用户问'技术面/指标/金叉死叉/超买超卖'用这个。⚠️ 只要原始 K 线（不算指标）请用 ashare_kline——本工具返回已算好的指标值。只读查询；按日线收盘更新。
- `ashare_technical_batch`: ⭐ **批量技术指标：一次拿多只的 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）及以上**，标准版不可用。
- `ashare_usage`: 查自己的 API 用量与剩余额度（今日调用次数/剩余总量/到期时间/限流额度）。用户问'我的额度还剩多少/今天调了多少次'用这个。只读查询；需 API Key。
- `ashare_wiki_search`: **产品文档检索**：字段单位 / 口径说明 / 常见误用 / 跨市场差异。⚠️ **不确定某字段的含义、单位、口径时先用这个查**，比凭记忆回答准。渐进加载（省上下文）：不带参返回**目录**；`q=关键词` 返回**摘要**（不含全文）；`slug=xxx` 取**该篇全文**。建议路径：先看目录 → 再取需要的那一篇。免费工具（无需 Key），但每次调用仍计入用量与限流。