com.ashareapi/ashare-data-api · v2026.10.8 · productivity
A股数据 API (A-Share Data API) is healthy: it completed an MCP handshake in 3469 ms and exposes 38 tools. It scores 59/100.
A-share data over MCP: quotes, profile, order book, K-line, financials, money flow, boards. 31 tools
Endpoint: https://api.ashareapi.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| health | 17 / 25 |
| authEase | 15 / 15 |
| toolQuality | 15 / 15 |
| maintenance | 7 / 15 |
| adoption | 0 / 10 |
| usage | 0 / 10 |
| security | 5 / 10 |
Scoring v0.3, computed 2026-10-15T02:31:07.894Z.
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-14T18:10:37.985Z | Healthy | 3469 |
ashare_quote | A股/港股/美股实时行情快照（**轻量 8 字段**：现价/开高低/成交量/成交额/换手率）。用户问'某股票现在多少钱/什么价'用这个。⚠️ `data` 是**数组**（默认 30 条日线，`data[0]` 为最新）—— 取现价用 `data[0].last`。⚠️ 换手率的字段名是 **`turnover`**（%）—— 与 /v1/snapshot **同名同值**。⚠️ **不含**估值/市值 —— 用 ashare_snapshot（35 字段，付费）。要**历史走势**请用 ashare_kline；要**五档盘口（order book）**请用 ashare_orderbook |
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_snapshot | **全字段行情画像**：价格 + 盘口（买五卖五+委差）+ 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本（流通/总）+ 打板（涨停/跌停价 + 量比 + 振幅 + 涨速）+ 标识（证券类型/股票状态/币种）+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠️ **与 ashare_quote 的分工**：quote 轻（8 字段）**免费**；本工具**全（35 字段）· 付费**——**只要现价/涨跌用 ashare_quote 更轻**（字段少、省上下文）。✅ **计费 = 次数**：本工具 1 次拿 |
ashare_kline | K线（日/周/月/季/年 + 分钟线）。用户问'走势/最近表现/历史K线/趋势'用这个。⚠️ 只要**当前价**用 ashare_quote；要**分时**（盘中每分钟价+累计量）用 ashare_minute ——**分钟 K 线**（OHLC 蜡烛）用本工具的 `period=m1/m5/...`，两者不是一回事。⚠️ 换手率字段名是 **`turnover`**（%）—— 与 ashare_quote、ashare_snapshot 同名同值。⚠️ 复权口径由服务端固定（无 `adjust` 参数）：日线及以上**前复权**（除权除息日不跳空），分钟线**不复权** —— **不要再自己 |
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_kline_full | 全历史K线（**10 年日线**，2016-08-08 起）+ **可选复权口径**。用户问'十年走势/长期回测/全历史数据/复权价/后复权/原始价'用这个。⚠️ 与 ashare_kline 的**三点不同**：① 数据量与范围 —— 本工具**全历史 10 年**（2465 条）；ashare_kline 上限 1212 条；② 复权可选 —— 本工具有 **`fq`** 参数（qfq 前复权 / hfq 后复权 / nofq 原始价）；ashare_kline **写死前复权、无参数**；③ 标的范围 —— 本工具**仅 A 股股票**（⛔ ETF/可转债/指数/板块/港股/美股/期货/ |
ashare_market_kline | **全市场单日K线** —— 一次请求返回某交易日**全 A 股（5000+ 只）**的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠️ **用途**：替代「逐只循环 5000 次」——每天收盘后调 **1 次**即可拿到全市场，适合建本地行情库/做全市场扫描/每日批量更新。⚠️ **两种硬限定**：① **仅 Pro（¥99）与 Unlimited（¥199）** 可用（Standard 及以下会被拒）；② **1 次调用折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）。⚠️ 另有**独立日额度**（Pro 200 / Unlimi |
ashare_backtest | **量化回测**：按策略跑历史收益（返回收益/最大回撤/交易次数/净值曲线等）。用户问'回测一下/这个策略收益如何/买卖点效果/最大回撤'用这个。⚠️ 两种模式：`mode=single`（默认）**单标的实时计算**，须配 `code`；`mode=portfolio` **组合**（须用 `strategies` 里的组合策略，区间受预置批次限制）。⚠️ `weighting=inv_vol`（按波动率倒数配仓）**仅组合模式 + 不限量版**可用。⚠️ 想知道有哪些策略/参数范围，先调 ashare_strategies；想一次跑多标的×多策略，用 ashare_backtest_bat |
ashare_backtest_batch | **批量回测**：一次跑 **多标的 × 多策略**，返回对比矩阵（哪个组合最好一目了然）。用户问'这几只股票用不同策略分别跑一下/批量回测/策略对比'用这个。⚠️ 与 ashare_backtest 的区别：本工具**一次给多标的×多策略的横向对比**，ashare_backtest 只跑**一个**策略。⚠️ 上限：标的 ≤20 · 策略 ≤10 · 组合 ≤60（**超限直接报错，不静默截断**）。⚠️ 组合策略不能用于批量回测（批量只支持单标的择时策略）。⚠️ 参数可传**列表**（自动转逗号）。⚠️ **付费工具**（需 Key）：**Pro（¥69）及以上**，有独立日额度。 |
ashare_strategies | **量化策略清单**：返回可回测的全部策略（20 条单标的择时 + 9 条组合），含各自参数范围与说明，⭐ **并附「实测表现」**（`performance` 字段）—— 在 800 只（沪深300+中证500）· 2019 年至今、**含真实交易成本**上跑出的真实成绩。`verdict` 分级：`effective` 实测有效 / `neutral` 一般 / `weak` 偏弱 / **`avoid` 实测亏损**；`note` 字段给避坑提示。⚠️ **无效的策略同样列出**（便于避开常见陷阱，如高换手被成本吃光）。用户问'有哪些策略/哪些策略能赚/哪个策略坑/策略参数是什么'用这个 |
ashare_factors | **量化因子库**：88 个因子 + 50 个筛选入口 + 22 个预设组合，可按分类/类型筛选。用户问'有哪些因子/因子库/选股因子/因子分类'用这个。⚠️ 这是**清单**（静态元数据）；要用因子实际选股，用 ashare_screen。⚠️ `category` / `kind` **只接受中文枚举值**（category：估值/行情/盈利/成长/财务/资金…；kind：排行/标签/事件）。传英文会返回空。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。 |
ashare_playbooks | **量化方法论库**：25 条「怎么判断市场」的流程（含判据 / 阶段 / 实测证据）。用户问'怎么判断/交易方法/方法论/判断流程'用这个。⚠️ 这是**方法论清单**（帮助判断，非投资建议）；要看可回测的策略用 ashare_strategies。⚠️ 可按分类或 id 取单条。⚠️ **付费工具**（需 Key）：**Standard（¥29.9）及以上**。 |
ashare_finance | 财务报表（利润表/资产负债表/现金流量表，**最近 N 期**）。用户问'营收/净利润/毛利率/负债/财务数据'用这个。⚠️ 返回**三张表**：data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表；每表按期次**降序**（最新一期在最前）。⚠️ 只要估值倍数（PE/PB）请用 ashare_sector_valuation 或 ashare_quote 的估值字段。只读查询；按财报披露节奏更新（未到披露日就没有新数据，不是故障）。 |
ashare_fund | 个股级交易面：这只股的 主力资金（当日/5/10/20 日净流入+全市场排名）+ 龙虎榜上榜明细（上榜原因/营业部）+ 大宗交易 + 融资融券。用户问'某只股票的主力资金/机构动向'用这个。⚠️ 全市场榜单（今天机构榜/游资榜/活跃席位）请用 ashare_lhb——本工具只针对单只股票。 |
ashare_technical | 技术指标 MA/MACD/KDJ/RSI/BOLL。用户问'技术面/指标/金叉死叉/超买超卖'用这个。⚠️ 只要原始 K 线（不算指标）请用 ashare_kline——本工具返回已算好的指标值。只读查询；按日线收盘更新。 |
ashare_shareholder | 股东研究：十大股东/股东户数（筹码集中度）/机构持仓。用户问'谁在持有/股东变化/筹码集中/机构持仓'用这个。⚠️ 要看机构**整体**在全市场买什么，请用 ashare_lhb 的机构榜。只读查询；股东户数按定期报告披露（季度级）。 |
ashare_events | 个股事件标签（42 类：大宗/龙虎榜/回购/分红/解禁等）。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠️ 要看**全市场**某一类事件名单，请用 ashare_lhb（龙虎榜分榜）或 ashare_dividend（分红送转）——本工具是**单只股票**的事件总览。只读查询；按披露节奏更新。 |
ashare_lhb | 全市场龙虎榜分榜（6 类）：type=all 全市场总榜（净买/买卖额）/ institution 机构榜（机构买入/净买/机构数）/ activeseat 活跃席位（席位买入额+关联个股）/ winbuy 高胜率买入（净买额/胜率/席位明细）/ winseat 高胜率席位（席位胜率+关联个股）/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠️ hotmoney（游资榜）上游暂无数据，建议改用 all/activeseat/winbuy。⚠️ 龙虎榜为收盘后发布（一般 18:00 后）；date 留空=最近交易日。⚠️ 某只股票的上榜明细（上榜原 |
ashare_screen | 因子选股（量化筛股）。expression 是多因子交集表达式，例：intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])；常用字段：PE_TTM/PB/PS_TTM/ROE/ROETTM/ROIC/DividendRatioTTM/OperatingRevenueGrowRate/DebtAssetsRatio。用户问'筛选/选股/符合条件的股票'用这个。 |
ashare_sector | 板块行情榜（行业/概念/地域涨幅 + 领涨股 + 涨跌家数）。用户问'哪些板块在涨/板块轮动/行业热度'用这个。⚠️ 要板块**估值分位**请用 ashare_sector_valuation；要**产业链上下游**请用对应工具。只读查询；交易时段内更新。 |
ashare_sector_valuation | 板块估值（PE/PB/PS/PCF + 股息率 + 历史百分位）。用户问'某板块贵不贵/估值分位'用这个。⚠️ 要看板块**涨跌幅与领涨股**请用 ashare_sector——本工具只给估值指标。只读查询；板块代码形如 pt01801780（pt 前缀 + 8 位）。 |
ashare_market_overview | 市场级画像。type=summary 画像总评/trade 收盘/interval 多周期/technical 大盘技术/valuation 估值分位/rotation 风格轮动。用户问'今天市场怎么样/大盘环境/风格轮动/估值分位'用这个。⚠️ 涨跌家数（市场广度）请用 ashare_changedist：本工具的 updown 模块为 **T-1 口径**（返回里会标数据日期，可能滞后一个交易日），已不推荐用于回答'今天的涨跌家数'。· 免费工具（无需 Key） |
ashare_changedist | 全市场涨跌家数与市场广度（**当期口径**）：上涨/下跌/平盘/停牌家数 + 上涨占比 + 涨停/跌停 + 11 档涨跌幅区间分布 + 两市成交额。用户问'今天涨跌家数/多少家涨停/市场情绪/市场广度'用这个——这是市场广度的**唯一推荐入口**。⚠️ 不要用 ashare_market_overview 的 updown 模式取同一数据（那是 T-1 口径，数值会与此不一致）。· 免费工具（无需 Key） |
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_news | 个股**财经资讯**。不传 `id` ⇒ 列表（标题 + 来源 + 时间）；传 `id` ⇒ ⭐ 该条**完整正文**。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ **正文是干净的 Markdown**（已清洗 HTML 标签/图片占位/无效内链，保留股票代码关联如 `茅台(sh600519)`，时间 `YYYY-MM-DD HH:MM:SS`）—— **可直接喂给大模型**。⚠️ 列表**只有最新 N 条**（上游不提供翻页/历史）—— 要**历史公告**请用 ashare_notice。⚠️ 列表里的 `url` 指向动态页面，**直接抓不到正文** ⇒ 要正文请用 |
ashare_notice | 上市公司**公告**。不传 id ⇒ 列表（code 必填，支持 type / limit / offset 翻页，可回溯约 20 年）；传 id ⇒ 该公告详情。用户问'公告/披露/半年度报告/年报在哪'用这个。⚠️ **详情有两种形态**（实测约 9/10 给正文）：多数短公告 ⇒ `text`=**正文**（直接读）；少数长报告（如半年报 100+ 页）⇒ `text` 空、`url`=**PDF 链接**。⇒ 判据：**先看 `text`**，空则用 `url`。⚠️ **长报告的 PDF 请自行获取与解析**（用你环境里的 PDF 能力）——我们只给链接，不代做解析。💡 **要财务 |
ashare_macro | 宏观数据（GDP/CPI/PMI/LPR/国债收益率/财政）。用户问'宏观/经济数据/利率/LPR/CPI'用这个。⚠️ 要**指数行情**请用 ashare_quote 或 ashare_market_overview——本工具只给宏观指标。只读查询；按发布日历更新（未到发布日就没有新值）。 |
ashare_bond | 可转债完整条款：溢价率/转股价值/双低值/强赎触发价/回售触发价/转股价/正股/到期日/评级。用户问'转债条款/强赎/双低/溢价'用这个。⚠️ 要转债**行情价**请用 ashare_quote（同样支持转债代码）。只读查询；代码形如 sh113052（沪）/ sz123138（深）。 |
ashare_etf | ETF 行情/规模/溢折率/资金流。用户问'ETF'时用这个。⚠️ 要 ETF 的**成分股/净值/持有人**请用对应端点（本工具给运作概览）。只读查询；代码形如 sh510300。 |
ashare_ipo | 新股日历（发行/申购/中签/上市）。用户问'新股/打新/IPO'用这个。只读查询；按发行日历更新。 |
ashare_dividend | 分红送转历史（每股分红/送股/除权日）。用户问'分红/股息/送转'用这个。⚠️ 要**分红派息日历**（哪天除权）请用 ashare_events——本工具是历史记录。只读查询；按公告披露更新。 |
ashare_dehydrated | 脱水研报（券商研报摘要）。用户问'研报/机构观点/券商怎么说'用这个。mode=list 列表 / mode=detail 详情（detail 需给 symbol）。⚠️ 要**个股新闻/公告**请用 ashare_events。只读查询；按研报发布更新。 |
ashare_search | 股票/基金/板块搜索（模糊词消歧）。用户只给名称时**先用这个确认代码**。⚠️ 本工具只返回代码与名称，不含行情——拿到代码后再调 ashare_quote / ashare_kline。只读查询。 |
ashare_usage | 查自己的 API 用量与剩余额度（今日调用次数/剩余总量/到期时间/限流额度）。用户问'我的额度还剩多少/今天调了多少次'用这个。只读查询；需 API Key。 |
ashare_wiki_search | **产品文档检索**：字段单位 / 口径说明 / 常见误用 / 跨市场差异。⚠️ **不确定某字段的含义、单位、口径时先用这个查**，比凭记忆回答准。渐进加载（省上下文）：不带参返回**目录**；`q=关键词` 返回**摘要**（不含全文）；`slug=xxx` 取**该篇全文**。建议路径：先看目录 → 再取需要的那一篇。免费工具（无需 Key），但每次调用仍计入用量与限流。 |
ashare_abnormal | **异动 / 偏离值**（短线监管异动体系）：触发「严重异动」、「10日100% 偏离」、异动盯盘名单。用户问'今天有哪些异动股/偏离值/触发严重异动/被监控的票/短线风险股'用这个。`mode` 取值：`deviation` 偏离值热门榜（今日，默认）· `deviation_hist` 偏离值历史（需 date）· `deviation_plan` 偏离值（今日+明日两组，`group` 字段区分）· `abnormal` 异动频率+异动原因（需 date，每日全量）· `watch` 异动盯盘名单（今日）· `watch_hist` 盯盘历史（需 date）· `alert` **严重异 |
ashare_review | **短线复盘（涨停结构）**：看今天钱在哪些题材、梯队结构长什么样。用户问'今天什么题材最强 / 板块主线 / 连板梯队 / 几板几只 / 谁是反包'用这个。`mode` 取值：`board` **板块主线**（默认）—— 题材板块 + `limit_count` 涨停数 + `amount` 板块成交额 + `stocks` 成分股代码；`ladder` **连板梯队** —— 按连板高度分组的涨停个股，含 `board_name` 所属板块 / `market_cap` 总市值 / `tips`（如「7天4板」）/ `max_streak` 区间最高连板 / `limit_days` 区间 |
ashare_limit_up | **短线打板（涨停池明细）**：当日全部涨停个股，含**涨停原因**与**资金面**。用户问'今天哪些票涨停 / 涨停原因 / 封单多大 / 主力买了多少'用这个。`mode` 取值：`limit` **涨停池明细**（默认）—— 每只含 `reason` 涨停原因 / `seal_amount` 封单额 / `seal_amount_max` 最大封单 / `main_net` 主力净额 / `main_buy`·`main_sell` 主力买入·卖出 / `amount` 成交额 / `concepts` 概念 / `float_cap` 流通市值 / `turnover` 换手% / ` |