{"id":"com.ashareapi/ashare-data-api","slug":"com-ashareapi-ashare-data-api","title":"A股数据 API (A-Share Data API)","description":"A-share data over MCP: quotes, profile, order book, K-line, financials, money flow, boards. 31 tools","version":"2026.10.8","publisher":{"kind":"domain","id":"ashareapi.com","label":"ashareapi.com","url":"https://ashareapi.com"},"website":"https://ashareapi.com","repository":"","remotes":[{"type":"streamable-http","url":"https://api.ashareapi.com/mcp","headers":[{"description":"Optional API key as 'Bearer <key>'. Free tools work without it; paid tools require a key (from ¥9.9).","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-08","updated":"2026-10-08","status":"online","auth":"","latency_ms":1705,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"ashare_quote","title":"","description":"A股/港股/美股实时行情快照（**轻量 8 字段**：现价/开高低/成交量/成交额/换手率）。用户问'某股票现在多少钱/什么价'用这个。⚠️ `data` 是**数组**（默认 30 条日线，`data[0]` 为最新）—— 取现价用 `data[0].last`。⚠️ 换手率的字段名是 **`turnover`**（%）—— 与 /v1/snapshot **同名同值**。⚠️ **不含**估值/市值 —— 用 ashare_snapshot（35 字段，付费）。要**历史走势**请用 ashare_kline；要**五档盘口（order book）**请用 ashare_orderbook。\n\n⭐ **要查多只股票（自选池 / 一个行业 / 全市场切片）—— 用 `ashare_quote_batch`，不要循环调用本工具。**自己循环 300 只 = 300 次调用 × 约 0.7 ","read_only":false},{"name":"ashare_quote_batch","title":"","description":"⭐ **批量行情：一次拿多只股票的行情**，逐只标明成功与否。用户问'这几只现在什么价/扫一下我这个池子/一个行业现在的行情'用这个。⚠️ 与 ashare_quote 的区别：本工具**一次给多只**，且返回**逐只状态**（`{code, ok, data}`）—— 缺了哪只一眼可见；ashare_quote 只查一只，虽然它的 code 也接受逗号，但返回混在一起、缺了哪只要自己算。⚠️ **为什么值得单开一次调用**：自己循环 300 只 = 300 次调用 × 约 0.7 秒 ≈ **3.5 分钟**（还会撞限频退避）；本工具实测 **4 秒左右拿完** 300 只。⚠️ **用法**：`codes` 逗号分隔，如 `sh600519,sz000001,sz300750`；支持裸 6 位码（`600519`）也支持带前缀。⚠️ **返回**：`data` 数组，每项 `{code","read_only":false},{"name":"ashare_kline_batch","title":"","description":"⭐ **批量 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,sz000","read_only":false},{"name":"ashare_snapshot_batch","title":"","description":"⭐ **批量全字段画像：一次拿多只股票的完整画像**（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}`（或 `err","read_only":false},{"name":"ashare_profile_batch","title":"","description":"⭐ **批量公司简况：一次拿多只的上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 注册地址 / 联系方式**，逐只标明成功与否。用户问'这几只都是做什么的/帮我按行业归类/筛出来的池子逐个看基本面/什么时候上市的'用这个。⚠️ 与 ashare_profile 的区别：本工具**一次给多只**，ashare_profile 只查一只。⚠️ **为什么值得单开一次调用**：`ashare_profile` 问 100 只 = 100 次调用；本工具实测 **100 只 6.8 秒**拿完，且缺了哪只一眼可见。⚠️ **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码。⚠️ **返回**：`data` 数组，每项 `{code, ok, data}`（或 `error`），**取几只回几个条目**；同时给 `reque","read_only":false},{"name":"ashare_chip","title":"","description":"**筹码分布 / 持仓成本**（沪深 A 股 + **ETF**）：获利盘比例 + 平均成本 + 90% 与 70% 集中度 + 当日收盘价。用户问'筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大/主力成本在哪'用这个。⚠️ **多只请用 `ashare_chip_batch`**（一次 200 只、逐只标明成功与否）—— 本工具只查一只。⚠️ `date` 可回看历史（`YYYY-MM-DD`，缺省=最新）；**历史仅保留约近 1 年**；非交易日/未来日期会**自动回退到最近交易日**，以返回行的 `date` 为准。⚠️ 代码可传 `sh600667` 或裸 6 位 `600667`。⚠️ **ETF 也能查**（实测 `sh510300`：平均成本 4.39 / 获利 13.47%），口径与个股相同；**港美股不支持**。⚠️ **付费工具**：需 Key（体验版及以上），免费","read_only":false},{"name":"ashare_chip_batch","title":"","description":"⭐ **批量筹码分布：一次拿多只的获利盘比例 / 平均成本 / 90%·70% 集中度**，逐只标明成功与否。用户问'这几只的筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大'用这个。⚠️ **与 ashare_chip 的关系**：`/v1/chip` 的 `code` 虽支持逗号，但返回是**横向并排的 N×8N 对角矩阵**（第 i 行只有第 i 组有值、其余全是 `-`），pandas 一行都拼不出来，而且**无效代码的整组列会直接消失**，少了哪只算不出来 ⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠️ **为什么值得单开一次调用**：`/v1/chip` 问 200 只 = 200 次调用；本工具实测 **200 只 3.9 秒**。⚠️ **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 6 位码；`da","read_only":false},{"name":"ashare_shareholder_batch","title":"","description":"⭐ **批量股东研究：一次拿多只的十大股东 / 十大流通股东 / 股东户数统计**，逐只标明成功与否。用户问'这几只谁在持有/股东户数变少了吗/股权集中不集中/机构在不在里面'用这个。⚠️ **与 ashare_shareholder 的关系**：`/v1/shareholder` 的 `code` 虽支持逗号，但返回是**一大坨 markdown**、没有逐只状态，无效代码会**静默消失**（少了哪只算不出来）⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠️ **为什么值得单开一次调用**：`/v1/shareholder` 问 200 只 = 200 次调用（约 3 分钟，还会撞限频退避）；本工具实测 **200 只 4.1 秒 / 300 只 5.6 秒**。⚠️ **用法**：`codes` 逗号分隔（`sh600519,sz000001`），支持裸 ","read_only":false},{"name":"ashare_finance_batch","title":"","description":"⭐ **批量财务报表：一次拿多只的利润表 / 资产负债表 / 现金流量表**，逐只标明成功与否。用户问'这几只的营收/净利/ROE/负债率/经营现金流怎么样'用这个。⚠️ **与 ashare_finance 的关系**：`/v1/finance` 的 `code` 虽支持逗号，但返回是**扁平的 3 张表**，哪只没回来、为什么没回来**完全看不出来** ⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠️ **上限：专业版 10 只 / 不限量 20 只，且「只数 × 期数 ≤ 40」** —— 财报数据源的配额按「只 × 期」消耗：实测 10 只 × 4 期 4.2 秒三次全中、20 只 × 2 期 全中；但 20 只 × 4 期 只回 5 只、50 只直接限频。要更多请分批调用（每批间隔几秒）。⚠️ **用法**：`codes` 逗号分隔（`sh60051","read_only":false},{"name":"ashare_technical_batch","title":"","description":"⭐ **批量技术指标：一次拿多只的 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 只","read_only":false},{"name":"ashare_orderbook","title":"","description":"**五档盘口**：买一~买五 / 卖一~卖五的**价格与挂单量（手）** + 现价/涨跌/数据时间。用户问'封单多少/买盘卖盘/盘口/挂单/支撑压力位/有没有大单托着'用这个。字段：`b1_p`/`b1_v`~`b5_p`/`b5_v` 买档价格/量 · `a1_p`/`a1_v`~`a5_p`/`a5_v` 卖档。⚠️ 本工具是**秒级快照**（每 10 秒刷新），**盘中才有意义**（收盘后为当日最后快照）——要**实时成交价**用 ashare_quote（**免费**，字段少更轻）。⚠️ 量单位是**手**（×100 = 股）；**跌停买档全 0 / 涨停卖档全 0**（正常）。","read_only":false},{"name":"ashare_snapshot","title":"","description":"**全字段行情画像**：价格 + 盘口（买五卖五+委差）+ 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本（流通/总）+ 打板（涨停/跌停价 + 量比 + 振幅 + 涨速）+ 标识（证券类型/股票状态/币种）+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠️ **与 ashare_quote 的分工**：quote 轻（8 字段）**免费**；本工具**全（35 字段）· 付费**——**只要现价/涨跌用 ashare_quote 更轻**（字段少、省上下文）。✅ **计费 = 次数**：本工具 1 次拿全——要估值+市值+股本+涨停价**多项**时，比分别调 quote/valuation/orderbook **更省次数**（3 次 → 1 次）。⚠️ **仅 A 股**（港股/美股字段布局不同，","read_only":false},{"name":"ashare_kline","title":"","description":"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","read_only":false},{"name":"ashare_minute","title":"","description":"**分时**（当日 / 近 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）不可用。⚠️ **付费档实时**（每次取此刻最新）。","read_only":false},{"name":"ashare_kline_full","title":"","description":"全历史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 列","read_only":false},{"name":"ashare_market_kline","title":"","description":"**全市场单日K线** —— 一次请求返回某交易日**全 A 股（5000+ 只）**的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠️ **用途**：替代「逐只循环 5000 次」——每天收盘后调 **1 次**即可拿到全市场，适合建本地行情库/做全市场扫描/每日批量更新。⚠️ **两种硬限定**：① **仅专业版（¥99）与机构版（¥199）** 可用（Standard 及以下会被拒）；② **1 次调用折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）。⚠️ 另有**独立日额度**（专业版 200 / 机构版 1000 次/天），余量可查 ashare_usage。⚠️ 数据范围：**仅 A 股股票**（5572 只）、**2016-08-08 起**、**不复权原始价**；不含 ETF/可转债/指数/板块/港股/美股。最新数","read_only":false},{"name":"ashare_backtest","title":"","description":"**量化回测**：按策略跑历史收益（返回收益/最大回撤/交易次数/净值曲线等）。用户问'回测一下/这个策略收益如何/买卖点效果/最大回撤'用这个。⚠️ 两种模式：`mode=single`（默认）**单标的实时计算**，须配 `code`；`mode=portfolio` **组合**（须用 `strategies` 里的组合策略，区间受预置批次限制）。⚠️ `weighting=inv_vol`（按波动率倒数配仓）**仅组合模式 + 机构版**可用。⚠️ 想知道有哪些策略/参数范围，先调 ashare_strategies；想一次跑多标的×多策略，用 ashare_backtest_batch。⚠️ **付费工具**（需 Key）：单标的 **Standard（¥29.9）起**；组合 / 批量回测为 **Pro 及以上**，且有独立日额度，余量可查 ashare_usage。","read_only":false},{"name":"ashare_backtest_batch","title":"","description":"**批量回测**：一次跑 **多标的 × 多策略**，返回对比矩阵（哪个组合最好一目了然）。用户问'这几只股票用不同策略分别跑一下/批量回测/策略对比'用这个。⚠️ 与 ashare_backtest 的区别：本工具**一次给多标的×多策略的横向对比**，ashare_backtest 只跑**一个**策略。⚠️ 上限：标的 ≤20 · 策略 ≤10 · 组合 ≤60（**超限直接报错，不静默截断**）。⚠️ 组合策略不能用于批量回测（批量只支持单标的择时策略）。⚠️ 参数可传**列表**（自动转逗号）。⚠️ **付费工具**（需 Key）：**Pro（¥69）及以上**，有独立日额度。","read_only":false},{"name":"ashare_strategies","title":"","description":"**量化策略清单**：返回可回测的全部策略（20 条单标的择时 + 9 条组合），含各自参数范围与说明，⭐ **并附「实测表现」**（`performance` 字段）—— 在 800 只（沪深300+中证500）· 2019 年至今、**含真实交易成本**上跑出的真实成绩。`verdict` 分级：`effective` 实测有效 / `neutral` 一般 / `weak` 偏弱 / **`avoid` 实测亏损**；`note` 字段给避坑提示。⚠️ **无效的策略同样列出**（便于避开常见陷阱，如高换手被成本吃光）。用户问'有哪些策略/哪些策略能赚/哪个策略坑/策略参数是什么'用这个。⚠️ 这是**清单 + 实测摘要**（不跑新计算）；要真跑回测用 ashare_backtest。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。","read_only":false},{"name":"ashare_factors","title":"","description":"**量化因子库**：87 个因子 + 50 个筛选入口 + 22 个预设组合，可按分类/类型筛选。用户问'有哪些因子/因子库/选股因子/因子分类'用这个。⚠️ 这是**清单**（静态元数据）；要用因子实际选股，用 ashare_screen。⚠️ `category` / `kind` **只接受中文枚举值**（category：估值/行情/盈利/成长/财务/资金…；kind：排行/标签/事件）。传英文会返回空。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。","read_only":false},{"name":"ashare_playbooks","title":"","description":"**量化方法论库**：25 条「怎么判断市场」的流程（含判据 / 阶段 / 实测证据）。用户问'怎么判断/交易方法/方法论/判断流程'用这个。⚠️ 这是**方法论清单**（帮助判断，非投资建议）；要看可回测的策略用 ashare_strategies。⚠️ 可按分类或 id 取单条。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。","read_only":false},{"name":"ashare_finance","title":"","description":"财务报表（利润表/资产负债表/现金流量表，**最近 N 期**）。用户问'营收/净利润/毛利率/负债/财务数据'用这个。⚠️ 返回**三张表**：data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表；每表按期次**降序**（最新一期在最前）。⚠️ 只要估值倍数（PE/PB）请用 ashare_sector_valuation 或 ashare_quote 的估值字段。只读查询；按财报披露节奏更新（未到披露日就没有新数据，不是故障）。⚠️ **支持港股**（代码 5 位 `hk00700`）。港股的报表期次/字段口径以返回为准，⛔ 别按 A 股列名硬解析。","read_only":false},{"name":"ashare_fund","title":"","description":"个股级交易面：这只股的 主力资金（当日/5/10/20 日净流入+全市场排名）+ 龙虎榜上榜明细（上榜原因/营业部）+ 大宗交易 + 融资融券。用户问'某只股票的主力资金/机构动向'用这个。⚠️ 全市场榜单（今天机构榜/游资榜/活跃席位）请用 ashare_lhb——本工具只针对单只股票。⚠️ **要一次查多只股票的资金流**（扫自选池/一个行业），用 ashare_fund_batch。","read_only":false},{"name":"ashare_fund_batch","title":"","description":"⭐ **批量资金流**：一次拿**多只股票**的资金流（主力资金 + 龙虎榜 + 大宗 + 融资融券），每只一条记录。用户问'这几只股票的资金流/扫一下我这个池子的主力资金/一个行业谁在流入'用这个。⚠️ 与 ashare_fund 的区别：本工具**一次给多只**，ashare_fund 只查一只。⚠️ **用法**：`codes` 用**逗号分隔**，如 `sh600519,sz000001,sz300750`；支持**裸 6 位码**（`000099`）也支持带前缀（`sz000099`）。⚠️ **返回结构**：`data` 是数组，每项含 `code` / `ok` / `data`（或 `error`），**逐只标明成功与否**；同时给 `requested` / `returned` / `failed` 计数 —— ⛔ 不要假设 `ok:true` 就等于每只都有数据，务必","read_only":false},{"name":"ashare_technical","title":"","description":"技术指标 MA/MACD/KDJ/RSI/BOLL。用户问'技术面/指标/金叉死叉/超买超卖'用这个。⚠️ 只要原始 K 线（不算指标）请用 ashare_kline——本工具返回已算好的指标值。只读查询；按日线收盘更新。","read_only":false},{"name":"ashare_shareholder","title":"","description":"股东研究：十大股东/股东户数（筹码集中度）/机构持仓。用户问'谁在持有/股东变化/筹码集中/机构持仓'用这个。⚠️ 要看机构**整体**在全市场买什么，请用 ashare_lhb 的机构榜。只读查询；股东户数按定期报告披露（季度级）。","read_only":false},{"name":"ashare_events","title":"","description":"个股事件标签（42 类：大宗/龙虎榜/回购/分红/解禁等）。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠️ 要看**全市场**某一类事件名单，请用 ashare_lhb（龙虎榜分榜）或 ashare_dividend（分红送转）——本工具是**单只股票**的事件总览。只读查询；按披露节奏更新。","read_only":false},{"name":"ashare_margin_trade","title":"","description":"**个股融资融券明细**：融资余额 / 融资买入 / 融资偿还 / 融券余额 / 融券卖出 / 融券偿还。用户问'这只股票杠杆资金在加还是在撤/融资余额多少/两融数据'用这个。⚠️ **code 必填**（参数上不是 required，但不传只会得到一句明确说明、没有数据）。⚠️ **支持批量**：`code` 可传逗号分隔（`sh600667,sz000651`），返回多行 —— 但**不带逐只状态**，缺了哪只要自己算。⚠️ `date` 留空 = 最近**已披露**交易日（两融数据 T+1 披露，当天查不到当天的）；未披露的交易日会给出明确原因。⚠️ **与 ashare_fund 的关系**：`ashare_fund` 一次给『资金 + 龙虎榜 + 大宗 + 两融』四块概览；本工具只给**两融明细**、字段更全 ⇒ 只看两融用本工具。⚠️ **ETF 不在两融名单** —— 实测 ","read_only":false},{"name":"ashare_block_trade","title":"","description":"**大宗交易成交明细**：成交价 / 成交量 / 成交额 / **折溢价率** / 买方营业部 / 卖方营业部。用户问'有没有大宗交易/折价还是溢价成交/谁在接盘/机构席位'用这个。⚠️ **code 可留空**：留空 = 当日**全市场**大宗交易；给了 code = 该股的大宗记录。⚠️ `date` 留空 = 最近交易日。⚠️ **当日无大宗交易时返回的是行情元信息**（code/name/date/closePrice/changePct，证明标的没问题、只是没有大宗）—— 判『有没有大宗』要看返回里有没有`TurnoverPrice`/`BuySalesDepartment` 这类成交字段。⚠️ **与 ashare_fund 的关系**：`ashare_fund` 的大宗只是概览一行；本工具是**逐笔明细**。","read_only":false},{"name":"ashare_bigorder_queue","title":"","description":"**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\"` 表示只统计返回的样本，不是当日全量。用户问'封单是真的吗/有没有大单挂了又撤/假封单'用这个。⭐ **与 bigord","read_only":false},{"name":"ashare_evidence","title":"","description":"**财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `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`（同一消息的其它转载）。","read_only":false},{"name":"ashare_ask_user","title":"","description":"**歧义时向用户提问**（结构对齐 Claude Code `AskUserQuestion`）。\\n⭐ **什么时候用**：用户只给了**模糊名称**（「平安」「腾讯」），你不确定指哪家公司时。\\n   本工具**不会替你选**，而是返回 **1–4 个带说明的选项**（如「中国平安 · 沪市主板·保险龙头」），由你转成问题问用户。\\n⚠️ **选项说明由模型生成**（需要语义：\"中国平安\"和\"平安银行\"差在哪，规则写不出来） ⇒ 带 `X-LLM-Key` 时质量最好；不带则只返回原始候选（无说明）。\\n⚠️ 返回 `needs_clarification=false` 表示**歧义已消**（模型判断只有一家可能），此时 `chosen_code` 就是答案，直接用它继续。\\n⛔ 本工具不查数据，只做消歧。拿到 code 后再调 `ashare_agent_search` / `ash","read_only":false},{"name":"ashare_agent_search","title":"","description":"**一句话取数 + 证据链**：把「宁德时代最近资金流入怎么样」这种自然语言问题，直接映射到**我们自己的数据端点**，返回**一行结构化数据 + 完整证据**（`value_hash` / `source_endpoint` / `params` / `as_of`），并可核验。\n⭐ **与 `ashare_evidence` 的分工**：`ashare_evidence` 是**公告/资讯/研报原文检索**（关键词搜）；本工具是**把问句变成数据查询**（资金流 / 行情 / 公告）。问'多少/怎么样/是什么'用这个；问'发了什么公告/有什么新闻'用 evidence。\n⭐ **返回 = 行数组（`data`）+ 顶部 `citations[]` + `verification[]`**：\n· `data[]` 是**扁平表**，一行 = 一条证据（`rank` / `source_e","read_only":false},{"name":"ashare_watchlist_list","title":"","description":"**查自选股**：按 API Key 隔离，返回列表和标的；CRUD 不扣数据次数。","read_only":false},{"name":"ashare_watchlist_add","title":"","description":"**加自选股**：把股票加入自选；`code` 可逗号分隔批量；重复添加幂等。","read_only":false},{"name":"ashare_watchlist_remove","title":"","description":"**删自选股**：从自选列表删除标的；`code` 可逗号分隔批量。","read_only":false},{"name":"ashare_watchlist_quotes","title":"","description":"**自选股批量行情**：一次返回自选股最新行情。","read_only":false},{"name":"ashare_scanner","title":"","description":"**选股员（scanner Agent）**：把自然语言条件交给只读取数工具，返回候选池 + 证据引用 + 工具轨迹。适合『高ROE + 央企 + 近5日主力净流入』这类条件选股。\n⚠️ **BYOK**：除 `ASHARE_KEY` 外还要设 `ASHARE_LLM_KEY`（模型 Key），模型 token 由客户自己付。\n⚠️ **专业版（¥99）起**；scanner 额度独立（2,000 次），不占数据 API 的 500k 总池。\n⚠️ 只做条件选股，不做涨跌预测、不推荐买卖、不自动交易。","read_only":false},{"name":"ashare_analyst","title":"","description":"**复盘分析师（analyst Agent）**：输入 scanner 快照 ID，读取快照与 T+1/T+5/T+20 评估，输出收益/基准/超额/命中率、赢家输家、数据缺口和复盘报告。只读、不选股、不预测、不推荐买卖。\n⚠️ 可选 BYOK：带 `X-LLM-Key` 用模型润色；不带返回确定性复盘。","read_only":false},{"name":"ashare_flash","title":"","description":"**7×24 财经快讯**（全市场电报，财联社等来源），按时间倒序。行字段 `id` / `time` / `title` / `content` / `source` / `url`。用户问'今天有什么大消息/最新财经新闻/刚才发生了什么/宏观突发事件'用这个。⭐ **与 `ashare_news` 的分工**：`ashare_news` 是**按个股**的资讯（要传 code）；本工具是**全市场快讯流**（不需要代码）—— 问大盘/宏观/突发用这个，问某只票的消息面用 news。⚠️ 翻页：`index` 从 0 开始，步长=上次的 `limit`（`limit=20&index=20` 是第二页）；只能往回翻，无日期参数。⚠️ `limit` 上限 200；**缓存 1 分钟**（同一分钟内重复请求不重复消耗）。","read_only":false},{"name":"ashare_lhb_seats","title":"","description":"**龙虎榜席位明细**：某只票某次上榜的**营业部买卖席位**（最多 10 个），带 **`is_youzi` 游资标记**。行字段 `name`（营业部）/ `total_buy` / `total_sell` / `net`（净买额）/ `is_youzi` / `log_id`，按净买额降序。用户问'今天龙虎榜是谁买的/哪个营业部/是不是游资/沪股通买了多少'用这个。⭐ 与 `ashare_lhb` 的分工：`ashare_lhb` 是**榜单**（机构榜/活跃席位等统计），本工具是**单票的具体营业部明细** —— 问「谁买的」用本工具，问「今天哪类资金活跃」用 ashare_lhb。⚠️ 龙虎榜是**盘后数据**：`date` 留空 = 最近一次上榜日，以返回的 `date` 为准。⚠️ 单次最多约 10 个席位。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_lhb_agency","title":"","description":"**龙虎榜机构参与个股榜**（全市场）：某个交易日**机构席位在龙虎榜上参与过的所有个股**，一次拿完（实测单日约 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` 是**单票往下看营业部**，本工具是**全市场往上筛票** ","read_only":false},{"name":"ashare_market_mood","title":"","description":"**市场情绪（破板率 + 赚钱效应 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 分钟）。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_limit_reason","title":"","description":"**涨停原因（单只票的历史涨停记录 + 完整原因文案）**：每次涨停的**完整原因** + 所属板块 + 当日「日内龙几」。行字段 `date` / `dragon_rank`（如「日内龙一」，空 = 非龙头）/ `plates` 板块代码数组 / **`reason` 完整涨停原因** / `concept` 概念说明。用户问'这只票为什么涨停/上次涨停什么原因/它靠什么题材涨停'用这个。⭐ 与 `ashare_limit_up` 的分工：涨停池给**今天全市场**涨停股；本工具给**单只票的历史**涨停原因。⚠️ 返回该股票历次涨停的全部记录，`date` 不用于筛选（`is_fallback=true` 即表示未按日期筛）。⚠️ `code` 必须 A 股（6 位或带 sh/sz/bj 前缀）。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_broken_board","title":"","description":"**炸板历史（某日涨停被砸开的票）**：行字段 `code` / `name` / `change_pct` 涨幅% / `main_net` 主力净额（元）/ `amount` 成交额（元）/ `turnover_rate` 换手% / `concepts` 所属概念（如「金融科技、金融概念」）/ `raw` 原始行。用户问'今天有哪些票炸板/封板质量怎么样/哪些涨停被砸开'用这个。⭐ 与 `ashare_limit_up` 互补：涨停池是**封住的**，本工具是**没封住的**，两者一比就是当天封板质量。⚠️ `date` 留空 = 最近工作日（周末回退到上周五）；法定节假日请显式传。⚠️ `is_fallback=true` 表示没拿到你指定的那天，以 `date` 为准。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_tail_chase","title":"","description":"**尾盘抢筹（全市场抢筹金额榜）**：尾盘资金在抢哪些票，约 292 只。行字段 `code` / `name` / `fund_tag` 标记（如「基金」）/ `theme` 所属题材 / `change_pct` 涨幅% / **`chase_amount` 抢筹金额（元）** / `masked` 代码与名称是否不显示 / `raw` 原始行。用户问'尾盘谁在被抢筹/尾盘资金流入哪些票'用这个。⚠️ 返回结果前 4 行代码与名称不显示（金额仍完整），带 `masked=true` 的行不代表可交易标的。⭐ 结果已按 `sort` 重排（默认 `chase_amount` 降序），第一条即当日抢筹最大。⚠️ 只提供最近交易日，不支持按日期回看。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_northbound","title":"","description":"**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`（**港股通**南下资金）不是一回事。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_new_high","title":"","description":"**百日新高（按题材汇总）**：哪些题材今天在创百日新高。行字段 `theme` 题材名 / `plate_code` 板块代码 / `raw` 原始行（含家数）；顶层 `date` / `requested_date` / `is_fallback`。用户问'今天哪些题材创新高/新高最多的是什么板块'用这个。⭐ 新高集中的题材 = 资金在做的主线；可与 `ashare_sector`（涨幅榜）对照。⚠️ **机构版专属**。","read_only":false},{"name":"ashare_bigorder_flow","title":"","description":"**L2 大单成交明细**（当日逐笔，成交额 ≥ 阈值）：每一笔都标**主动/被动 × 买/卖**。行字段 `time` / `direction`（1 被动卖 · 2 主动买 · 3 被动买 · 4 主动卖）/ `direction_cn` / `volume`(**手**) / `amount`(**元**) / `avg_price`。顶层 `meta` 有 `money_threshold`、`total`（当日总笔数）、`truncated`、`summary`（四方向金额合计）。用户问'这票是谁在主动买/有没有人在扫货/大单是主动还是被动成交'用这个。⭐ 与 `ashare_bigorder` 的分工：bigorder 给**每分钟净额曲线**（看节奏），本工具给**逐笔明细 + 四方向拆分**（看谁打谁）。⚠️ **仅当日**（非交易日/盘前返回最近交易日，日期看行里的 `t","read_only":false},{"name":"ashare_bigorder_flow_full","title":"","description":"**L2 大单成交·全天完整**：把当日**全部**成交额 ≥ 阈值的大单一次拿全，不受「单次最多 200 笔」限制。用于**算全天金额**（主力净流入多少、四方向各多少）。行字段与 `ashare_bigorder_flow` 完全一致；顶层 `meta` 有 `total`（当日总笔数）/ `returned` / `deduped`（合并掉的重复条数）/ `pages` / `complete`（是否已拿全）/ `summary`（四方向金额合计，`summary_scope=all_rows`，拿全时即当日全量）。用户问'今天主力净流入多少 / 主动买和主动卖各多少 / 大单金额合计'用这个。⭐ 与 `ashare_bigorder_flow` 的分工：flow 只给最新 200 笔（快，看方向）；本工具给全天全量（慢，算金额）。**只拿 200 笔去算全天金额会算错。**⚠️ *","read_only":false},{"name":"ashare_bigorder","title":"","description":"**单股 L2 大单资金分时**（分钟级）：`net` = 该分钟**大单净额（元）**，正数=大单净买入、负数=净卖出。用户问'大单在买还是卖/主力资金分时/哪一分钟砸盘'用这个。⚠️ **仅当日**（非交易日/盘前返回最近一个交易日），日期看返回顶层 `day`。⚠️ 盘中末尾几分钟仍在追加：09:30–15:00 约 **242 点**，盘中调用点数会随交易时段增长。⚠️ 这是**大单口径**（按成交金额聚合）—— 不是逐笔委托、也不是十档盘口，别把它当'盘口深度'用。⚠️ **机构版专属**：专业版及以下调用会返回明确说明 + 升级链接，不会静默失败。⚠️ 与 `ashare_fund` 的分工：`ashare_fund` 给**日级汇总**（主力净额 1/5/10/20 日）+ 龙虎榜/大宗/两融；本工具给**当日分钟级大单曲线** ⇒ 看趋势用本工具，看快照用 fund。","read_only":false},{"name":"ashare_bigorder_history","title":"","description":"**L2 历史大单净额**（逐日，往回最多 **100 个交易日**）：每天一个值，行字段 `date` / `net`（当日大单净额，**元**，正=净买入负=净卖出），**倒序**（最新在前）。用户问'这票大单最近是不是一直在吸/大单资金趋势/前几个月大单怎么走的'用这个。⭐ 与 `ashare_bigorder` 的分工：那个只能看**今天**，本工具补「往回看」—— 判断是**持续吸筹**还是**只今天冲一下**，以及哪天开始转向。⚠️ 数据源固定返 100 个交易日，`limit` 只在本地截断（省流量不省调用）。⚠️ `net` 是**大单口径**（按成交金额聚合），⛔ 不是主力净额、不是龙虎榜、不是逐笔。⚠️ **机构版专属**：其他档位返回明确说明 + 升级链接。","read_only":false},{"name":"ashare_bigorder_split","title":"","description":"**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 笔）；本工具是*","read_only":false},{"name":"ashare_bigorder_rank","title":"","description":"**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`。用户问'今天主力在买什么/资金流入最多的是哪几只/谁在被砸/哪些板块主力在买'用这个。⭐ **恒等式可自检**：`m","read_only":false},{"name":"ashare_lhb","title":"","description":"全市场龙虎榜分榜（6 类）：type=all 全市场总榜（净买/买卖额）/ institution 机构榜（机构买入/净买/机构数）/ activeseat 活跃席位（席位买入额+关联个股）/ winbuy 高胜率买入（净买额/胜率/席位明细）/ winseat 高胜率席位（席位胜率+关联个股）/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠️ hotmoney（游资榜）暂无数据，建议改用 all/activeseat/winbuy。⚠️ 龙虎榜为收盘后发布（一般 18:00 后）；date 留空=最近交易日。⚠️ 某只股票的上榜明细（上榜原因/营业部）请用 ashare_fund——本工具是市场级榜单，不针对单只股票。","read_only":false},{"name":"ashare_profile","title":"","description":"**公司简况**：上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 员工数 等。用户问'这家公司是做什么的/哪年上市/属于什么行业/董事长是谁'用这个。⚠️ **与 ashare_snapshot 的分工**：snapshot 给**估值/市值/股本**（数字面），本工具给**公司本身是谁**（业务面）—— 问『做什么的』用本工具，问『贵不贵』用 snapshot。⚠️ **一次只查一只**：本工具的 `code` 虽也支持逗号，但返回是**扁平行、无逐只状态**，无效码会被**直接忽略**（`sh600519,sz999999` 只会回 1 行，没有任何提示）⇒ **多只请用 `ashare_profile_batch`**（专业版 100 只 / 不限量 150 只，逐只标明成功与否）。⚠️ 代码可传 `sh600667` 或裸 6 位 `600667`（内","read_only":false},{"name":"ashare_screen","title":"","description":"选股（量化筛股），**五种模式**用 `mode` 选（默认 `filter`）：`filter` 条件筛选（`filters=pe_ttm:0..20,roe_ttm:>=15`）· `pool` 主题池/属性标签（央企/ST/破净/次新/市值档位… 108 个）· `rank` 全市场排行（`metric=overall|capital|fundamental|risk|technical`）· `strategy` 策略选股（MACD 金叉/突破年线/高股息/大师策略… 98 个）· `event` 事件选股（分红/业绩预告/定增/解禁/董监高… 42 个）。用户问'筛选/选股/符合条件的股票/哪些票…'用这个。⭐ **`filters` 语法**：逗号分隔＝AND；区间 `0..20`（含两端），比较 `>=15` / `<=30` / `>0` / `<0` / `=5`。⭐ *","read_only":false},{"name":"ashare_industry_chain","title":"","description":"**A 股产业链**（**183 个产业链主题**），三种模式：`mode=list` → 主题列表；`mode=graph` + `topic=超级电容` → **产业链图谱**（关联个股 + 所属节点 + 产业链位置 上游/中游/下游）；`mode=stock` + `code=sh600667` → **个股所属产业链**（主题 / 节点 / 位置 / **关联度** / **业务描述**）。用户问'产业链/上下游/某公司处于链上什么位置/这个主题有哪些公司'用这个。⚠️ **参数是二选一**：`mode=graph` 必须给 `topic`，`mode=stock` 必须给 `code`；给错组合（如 mode=graph 却只给 code）拿不到数据。⚠️ 主题名要**中文全称**（`超级电容` / `集成电路`）—— 拿不准先 `mode=list` 搜一遍再问。","read_only":false},{"name":"ashare_sector","title":"","description":"板块行情榜（行业/概念/地域涨幅 + 领涨股 + 涨跌家数）。用户问'哪些板块在涨/板块轮动/行业热度'用这个。⚠️ 要板块**估值分位**请用 ashare_sector_valuation；要**产业链上下游**请用对应工具。只读查询；交易时段内更新。","read_only":false},{"name":"ashare_sector_valuation","title":"","description":"板块估值（PE/PB/PS/PCF + 股息率 + 历史百分位）。用户问'某板块贵不贵/估值分位'用这个。⚠️ 要看板块**涨跌幅与领涨股**请用 ashare_sector——本工具只给估值指标。只读查询；板块代码形如 pt01801780（pt 前缀 + 8 位）。","read_only":false},{"name":"ashare_index_constituent","title":"","description":"**指数成分股全量清单**（沪深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`","read_only":false},{"name":"ashare_suspension","title":"","description":"**停复牌清单**（沪深 / 港股 / 美股）：哪些票停牌、哪些复牌、停牌原因。用户问'今天哪些票停牌/复牌'时用。⚠️ **选股里过滤停牌股**用这个 —— 因子/策略筛选**不剔除停牌**，拿到候选后与本清单交叉核对。⚠️ `market` 传中文（沪深/港股/美股）或 hs/hk/us。只读查询；**标准版（¥29.9）及以上**。","read_only":false},{"name":"ashare_buyback","title":"","description":"**公司股份回购记录**。用户问'这家公司在回购吗/回购了多少/回购价多少'时用。⚠️⚠️ **返回结构按市场不同，⛔ 不能按同一套列名解析**：**A 股** ⇒ 事件概要 `code`/`name`/`market`；**港股** ⇒ 逐日明细 `date`/`BuybackMoney`/`BuybackPrice`/`BuybackShares`/`BuybackCumMoney`/`closePrice`。⚠️ 与 `ashare_shareholder`（谁持有）不同：本工具看的是**公司自己买自己**。只读查询；**标准版（¥29.9）及以上**。","read_only":false},{"name":"ashare_consensus","title":"","description":"**卖方一致预期**：分析师**目标价** + 未来预测（EPS/营收/净利润/预测 PE·PB·PS/机构覆盖数）。用户问'机构怎么看/目标价多少/明年利润预测/一致预期'时用。⚠️ **`codes` 逗号多只、逐只回 `ok`**，单次 **≤15 只**（数据源 >15 只**静默丢数据**：20 只只回 6 只）。⚠️ **字段按市场不同**：A 股有 `targetPrice`；**港股没有目标价**，字段是 `*Forecast` 一套。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_rating","title":"","description":"**卖方机构评级**：目标价（均值/最高/最低）+ 评级分布（买入/增持/中性/减持/卖出 + 覆盖机构数）+ **评级月度趋势**。用户问'机构目标价多少/评级怎么样/多少家覆盖'时用（**港股 / 美股**）。⚠️ **只支持港股 / 美股**（`hk00700` / `usAAPL`）；**A 股请用 `ashare_consensus`**（A 股没有卖方评级）。⚠️ `codes` 逗号多只，每只一段（用 `tables` 取全部段）。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_disclosure","title":"","description":"**业绩预约披露日**：哪天披露财报（`disclosureDate`）+ 报告期（`reportEndDate`）+ 说明文案。用户问'什么时候出财报/几号披露/三季报什么时候发'时用。三市场：A 股 / 港股 / 美股。⚠️ 与 `ashare_calendar`（分红/解禁/会议）**不是一回事**。⚠️ **港股 `disclosureDate` 常为空**，日期写在 `disclosureDesc` 文案里（如「将于2026-11-18发布财报」）。只读查询；**标准版（¥29.9）及以上**。","read_only":false},{"name":"ashare_fund_flow","title":"","description":"**个股资金流向**（A 股 / 港股）：主力与散户的买入/卖出/净额 + 均价、收盘价。用户问'主力在进还是出/资金流多少'时用。⚠️ 与 `ashare_fund`（综合：龙虎榜+大宗+两融，**仅 A 股**）不是一回事 —— 港股只能用本工具。⚠️ 金额单位是**元**。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_fund_short","title":"","description":"**卖空数据**（港股 / 美股）：卖空股数/金额/比率（`ShortShares`/`ShortAmount`/`ShortRatio`）。用户问'被做空多少/卖空比率'时用。⚠️ **请传 `date`** —— 不传且当日数据未发布时，只回标识字段、没有卖空数值。⚠️ 仅港股 / 美股；**A 股没有卖空数据**（融券请用 `ashare_margin_trade`）。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_fund_south","title":"","description":"**港股通南下资金持仓**（季度）：持股数/持股比例/持股市值。用户问'南下资金持有多少/港股通占比'时用。**仅港股**。⚠️ 是**季度持仓**不是逐日流水 —— 逐日净流入用 `ashare_fund_flow`。⚠️ `codes` 可逗号多只。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_index_list","title":"","description":"**指数全量清单**（1223 个）：code/name。用户问'有哪些指数/指数代码是什么'时用；拿到代码后用 `ashare_index_constituent` 取成分股。⚠️ 分页 limit(≤500)+offset；A股与港股指数混在一起（sh/sz/cs/hk 前缀）。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_score","title":"","description":"**股票评分**（仅 A 股）：基本面 / 技术 / 综合 / 资金 / 风险 五维，每维带周/月/季变动（0~100，越高越好）。用户问'这票几分/基本面评分/技术评分'时用。⭐ 返回已**结构化**：每维 `value` + `chg_week`/`chg_month`/`chg_quarter`，⛔ 不需要自己解析字符串。⚠️ `chg_quarter` 是**本季累计**（评分每季重置，通常等于 `value`），不是 0。⚠️ `codes` 逗号多只；`date` 可查历史但**最早到 2026-04 下旬**；**仅 A 股**。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_report","title":"","description":"**卖方研报**：不传 `id` ⇒ 列表（标题+机构+评级+类型）；传 `id` ⇒ **研报全文**（Markdown，含财务点评）。用户问'有没有研报/机构怎么说/这篇讲了什么'时用。**A 股 / 港股**都覆盖。⚠️ **列表单次最多 20 条**（`limit`>20 会 422），翻页用 `offset`；「共 N 条」是历史总数；实测条数会有 +1 余量，⛔ 别按条数严格校验。⚠️ 没有时间范围参数；与 `ashare_dehydrated`（脱水摘要）互补。只读查询；**专业版（¥99）及以上**。","read_only":false},{"name":"ashare_market_overview","title":"","description":"市场级画像。type=summary 画像总评/trade 收盘/interval 多周期/technical 大盘技术/valuation 估值分位/rotation 风格轮动。用户问'今天市场怎么样/大盘环境/风格轮动/估值分位'用这个。⚠️ 涨跌家数（市场广度）请用 ashare_changedist：本工具的 updown 模块为 **T-1 口径**（返回里会标数据日期，可能滞后一个交易日），已不推荐用于回答'今天的涨跌家数'。· 免费工具（无需 Key）","read_only":false},{"name":"ashare_changedist","title":"","description":"全市场涨跌家数与市场广度（**当期口径**）：上涨/下跌/平盘/停牌家数 + 上涨占比 + 涨停/跌停 + 11 档涨跌幅区间分布 + 两市成交额。用户问'今天涨跌家数/多少家涨停/市场情绪/市场广度'用这个——这是市场广度的**唯一推荐入口**。⚠️ 不要用 ashare_market_overview 的 updown 模式取同一数据（那是 T-1 口径，数值会与此不一致）。· 免费工具（无需 Key）","read_only":false},{"name":"ashare_hot","title":"","description":"**关注度**排名（谁在被关注，⛔ 不是'谁在涨'）。用户问'什么股票热门/大家在看什么/热度榜/热门板块/热文'用这个。⚠️⚠️ **5 类字段结构完全不同**，⛔ 别按同一套字段读：stock 热搜股票(code/name/zdf/zxj) · wx 全市场热度(**多 pv 热度值**) · news 热门文章(⚠️ **news_id/news_title/source**，⛔ 无 code) · sector 热门板块(⚠️ **symbol**，⛔ 无 code) · etf 热搜 ETF(含 title/tag)。⚠️ 当前快照（无历史）· 免费工具（无需 Key）","read_only":false},{"name":"ashare_news","title":"","description":"个股**财经资讯**。不传 `id` ⇒ 列表（标题 + 来源 + 时间）；传 `id` ⇒ ⭐ 该条**完整正文**。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ **正文是干净的 Markdown**（已清洗 HTML 标签/图片占位/无效内链，保留股票代码关联如 `茅台(sh600519)`，时间 `YYYY-MM-DD HH:MM:SS`）—— **可直接喂给大模型**。⚠️ 列表**只有最新 N 条**（不提供翻页/历史）—— 要**历史公告**请用 ashare_notice。⚠️ 列表里的 `url` 指向动态页面，**直接抓不到正文** ⇒ 要正文请用本工具的 `id` 参数。⚠️ **标的范围**：A 股 / **港股**（`hk00700`）/ **美股**（`usAAPL`）/ 指数 / ETF / 板块 / 可转债。","read_only":false},{"name":"ashare_notice","title":"","description":"上市公司**公告**。不传 id ⇒ 列表（code 必填，支持 type / limit / offset 翻页，可回溯约 20 年）；传 id ⇒ 该公告详情。用户问'公告/披露/半年度报告/年报在哪'用这个。⚠️ **详情有两种形态**（实测约 9/10 给正文）：多数短公告 ⇒ `text`=**正文**（直接读）；少数长报告（如半年报 100+ 页）⇒ `text` 空、`url`=**PDF 链接**。⇒ 判据：**先看 `text`**，空则用 `url`。⚠️ **长报告的 PDF 请自行获取与解析**（用你环境里的 PDF 能力）——我们只给链接，不代做解析。💡 **要财务数字请用 `ashare_finance`**（结构化，比从 100+ 页 PDF 里抠快得多）。⚠️ **支持港股 / 美股**（`hk00700` / `usAAPL`）—— 条数与回溯年限按市场而","read_only":false},{"name":"ashare_macro","title":"","description":"宏观数据（GDP/CPI/PMI/LPR/国债收益率/财政）。用户问'宏观/经济数据/利率/LPR/CPI'用这个。⚠️ 要**指数行情**请用 ashare_quote 或 ashare_market_overview——本工具只给宏观指标。只读查询；按发布日历更新（未到发布日就没有新值）。","read_only":false},{"name":"ashare_bond","title":"","description":"可转债完整条款：溢价率/转股价值/双低值/强赎触发价/回售触发价/转股价/正股/到期日/评级。用户问'转债条款/强赎/双低/溢价'用这个。⚠️ 要转债**行情价**请用 ashare_quote（同样支持转债代码）。只读查询；代码形如 sh113052（沪）/ sz123138（深）。","read_only":false},{"name":"ashare_etf","title":"","description":"ETF 数据。用户问'ETF'时用这个。`kind` 选子集：概览(默认·行情/规模/溢折率/资金流/回撤/估值) · 详情(基金要素/费率/份额/基金经理/持仓Top20) · 持仓(成分股及权重) · 净值(历史净值，**须同时传 start+end**) · 公司(管理人/托管人/跟踪指数) · 持有人(户数/机构个人占比) · 财务(股债商品基金占比)。⚠️ 返回的 `data` 是排版文本，**取字段用 `structured`（首表）或 `tables`（全部表）** —— `详情`/`公司` 是多表，只有 `tables` 拿全。⚠️ **查历史快照**：`kind=概览`/`持仓` + `date=YYYY-MM-DD`。传了 `date` 与不传**返回形态可能不同**（持仓：传 date＝重仓股涨跌 + 申赎清单前 10 两段、`code` 带市场前缀；不传＝单表 **","read_only":false}],"server_info":{"name":"ashare-data-api","version":"2026.11.1"},"category":"finance","tags":["ecommerce","agents","analytics"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-21","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-ashareapi-ashare-data-api/"}