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

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "a-api-a-share-data-api": {
      "type": "http",
      "url": "https://api.ashareapi.com/mcp"
    }
  }
}

39 tools

• ashare_quote

  A股/港股/美股实时行情快照（**轻量 8 字段**：现价/开高低/成交量/成交额/换手率）。用户问'某股票现在多少钱/什么价'用这个。⚠️ `data` 是**数组**（默认 30 条日线，`data[0]` 为最新）—— 取现价用 `data[0].last`。⚠️ 换手率的字段名是 **`turnover`**（%）—— 与 /v1/snapshot **同名同值**。⚠️ **不含**估值/市值 —— 用 ashare_snapshot（35 字段，付费）。要**历史走势**请用 ashare_kline；要**五档盘口（order…

• ashare_orderbook

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

• ashare_snapshot

  **全字段行情画像**：价格 + 盘口（买五卖五+委差）+ 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本（流通/总）+ 打板（涨停/跌停价 + 量比 + 振幅 + 涨速）+ 标识（证券类型/股票状态/币种）+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠️ **与 ashare_quote 的分工**：quote 轻（8 字段）**免费**；本工具**全（35 字段）· 付费**——**只要现价/涨跌用 ashare_quote 更轻**（字段少、省上下文）。✅…

• 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）—— 门槛…

• ashare_kline_full

  全历史K线（**10 年日线**，2016-08-08 起）+ **可选复权口径**。用户问'十年走势/长期回测/全历史数据/复权价/后复权/原始价'用这个。⚠️ 与 ashare_kline 的**三点不同**：① 数据量与范围 —— 本工具**全历史 10 年**（2465 条）；ashare_kline 上限 1212 条；② 复权可选 —— 本工具有 **`fq`** 参数（qfq 前复权 / hfq 后复权 / nofq 原始价）；ashare_kline **写死前复权、无参数**；③ 标的范围 —— 本工具**仅 A 股股票**（⛔…

• ashare_market_kline

  **全市场单日K线** —— 一次请求返回某交易日**全 A 股（5000+ 只）**的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠️ **用途**：替代「逐只循环 5000 次」——每天收盘后调 **1 次**即可拿到全市场，适合建本地行情库/做全市场扫描/每日批量更新。⚠️ **两种硬限定**：① **仅 Pro（¥99）与 Unlimited（¥199）** 可用（Standard 及以下会被拒）；② **1 次调用折算 500 次额度**（一次动 5000+ 只，量级远超单只接口）。⚠️…

• ashare_backtest

  **量化回测**：按策略跑历史收益（返回收益/最大回撤/交易次数/净值曲线等）。用户问'回测一下/这个策略收益如何/买卖点效果/最大回撤'用这个。⚠️ 两种模式：`mode=single`（默认）**单标的实时计算**，须配 `code`；`mode=portfolio` **组合**（须用 `strategies` 里的组合策略，区间受预置批次限制）。⚠️ `weighting=inv_vol`（按波动率倒数配仓）**仅组合模式 + 不限量版**可用。⚠️ 想知道有哪些策略/参数范围，先调…

• ashare_backtest_batch

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

• 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)。⚠️…

• 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'时用这个。`kind` 选子集：概览(默认·行情/规模/溢折率/资金流/回撤/估值) · 详情(基金要素/费率/份额) · 持仓(成分股及权重) · 净值(历史净值，**须同时传 start+end**) · 公司(管理人/托管人/跟踪指数) · 持有人(户数/机构个人占比) · 财务(股债商品基金占比)。⚠️ 返回的 `data` 是排版文本，**取字段用 `structured`（首表）或 `tables`（全部表）** —— `详情`/`公司` 是多表，只有 `tables` 拿全。⚠️ **仅 ETF…

• 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` 盯盘历史（需…

• ashare_review

  **短线复盘（涨停结构）**：看今天钱在哪些题材、梯队结构长什么样。用户问'今天什么题材最强 / 板块主线 / 连板梯队 / 几板几只 / 谁是反包'用这个。`mode` 取值：`board` **板块主线**（默认）—— 题材板块 + `limit_count` 涨停数 + `amount` 板块成交额 + `stocks` 成分股代码；`ladder` **连板梯队** —— 按连板高度分组的涨停个股，含 `board_name` 所属板块 / `market_cap` 总市值 / `tips`（如「7天4板」）/ `max_streak`…

• ashare_limit_up

  **短线打板（涨停池明细）**：当日全部涨停个股，含**涨停原因**与**资金面**。用户问'今天哪些票涨停 / 涨停原因 / 封单多大 / 主力买了多少'用这个。`mode` 取值：`limit` **涨停池明细**（默认）—— 每只含 `reason` 涨停原因 / `seal_amount` 封单额 / `seal_amount_max` 最大封单 / `main_net` 主力净额 / `main_buy`·`main_sell` 主力买入·卖出 / `amount` 成交额 / `concepts` 概念 / `float_cap` 流通市值…

• ashare_auction

  **集合竞价**：个股 9:15–9:25 集合竞价数据，含**「竞价触及涨停」判定**。用户问'竞价分时 / 竞价怎么走的 / 集合竞价买了多少 / 哪些票竞价就涨停了'用这个。`mode` 取值：`stock` **当日竞价分时**（默认，分钟级逐笔）· `stock-history` **历史竞价分时**（秒级逐笔，需 `date`）· `volume` **当日竞价量 / 资金净额**（单点）。⭐ `is_limit_up` = 「竞价触及涨停」判定（竞价段最高价 ≥ 涨停价，涨停价取自行情源原始值）。另含 `up_px` 涨停价 /…

Security scan

Recent checks