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

Connect it to your AI

Claude Code

claude mcp add --transport http ashare-data-api https://api.ashareapi.com/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://api.ashareapi.com/mcp

This server expects extra headers, usually an API key from its maker.

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "ashare-data-api": {
      "url": "https://api.ashareapi.com/mcp"
    }
  }
}

Tools it offers

60 tools, as the server itself reported during our check on Oct 31, 2026.

• ashare_quoteA股/港股/美股实时行情快照（**轻量 8 字段**：现价/开高低/成交量/成交额/换手率）。用户问'某股票现在多少钱/什么价'用这个。⚠️ `data` 是**数组**（默认 30 条日线，`data[0]` 为最新）—— 取现价用 `data[0].last`。⚠️ 换手率的字段名是 **`turnover`**（%）—— 与 /v1/snapshot **同名同值**。⚠️ **不含**估值/市值 —— 用 ashare_snap
• ashare_quote_batch⭐ **批量行情：一次拿多只股票的行情**，逐只标明成功与否。用户问'这几只现在什么价/扫一下我这个池子/一个行业现在的行情'用这个。⚠️ 与 ashare_quote 的区别：本工具**一次给多只**，且返回**逐只状态**（`{code, ok, data}`）—— 缺了哪只一眼可见；ashare_quote 只查一只，虽然它的 code 也接受逗号，但返回混在一起、缺了哪只要自己算。⚠️ **为什么值得单开一次调用**：自己循环
• ashare_kline_batch⭐ **批量 K 线：一次拿多只股票的 K 线**（多只 × 同一段时间），逐只标明成功与否。用户问'这几只的走势/把我这个池子的 K 线拉下来/一个行业最近 60 天表现'用这个。⚠️ **与其它三个 K 线工具的分工**：`ashare_kline`=一只（code 虽接受逗号但返回混在一起、缺了哪只算不出）；`ashare_kline_full`=**一只 × 全部历史**；`ashare_market_kline`=**某一天
• ashare_snapshot_batch⭐ **批量全字段画像：一次拿多只股票的完整画像**（35+ 字段：价格/盘口五档/PE·PB/市值/股本/涨停跌停价/量比/振幅/涨速/外盘内盘），逐只标明成功与否。用户问'这几只的估值/市值/市盈率/是不是涨停/扫一下我这个池子的基本面'用这个。⚠️ 与 ashare_snapshot 的区别：本工具**一次给多只**，ashare_snapshot 只查一只。⚠️ **为什么值得单开一次调用**：`ashare_snapshot`
• ashare_profile_batch⭐ **批量公司简况：一次拿多只的上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 注册地址 / 联系方式**，逐只标明成功与否。用户问'这几只都是做什么的/帮我按行业归类/筛出来的池子逐个看基本面/什么时候上市的'用这个。⚠️ 与 ashare_profile 的区别：本工具**一次给多只**，ashare_profile 只查一只。⚠️ **为什么值得单开一次调用**：`ashare_profile` 问
• ashare_chip**筹码分布 / 持仓成本**（沪深 A 股 + **ETF**）：获利盘比例 + 平均成本 + 90% 与 70% 集中度 + 当日收盘价。用户问'筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大/主力成本在哪'用这个。⚠️ **多只请用 `ashare_chip_batch`**（一次 200 只、逐只标明成功与否）—— 本工具只查一只。⚠️ `date` 可回看历史（`YYYY-MM-DD`，缺省=最新）；**历史仅保留约近 1
• ashare_chip_batch⭐ **批量筹码分布：一次拿多只的获利盘比例 / 平均成本 / 90%·70% 集中度**，逐只标明成功与否。用户问'这几只的筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大'用这个。⚠️ **与 ashare_chip 的关系**：`/v1/chip` 的 `code` 虽支持逗号，但返回是**横向并排的 N×8N 对角矩阵**（第 i 行只有第 i 组有值、其余全是 `-`），pandas 一行都拼不出来，而且**无效代码的整组列
• ashare_shareholder_batch⭐ **批量股东研究：一次拿多只的十大股东 / 十大流通股东 / 股东户数统计**，逐只标明成功与否。用户问'这几只谁在持有/股东户数变少了吗/股权集中不集中/机构在不在里面'用这个。⚠️ **与 ashare_shareholder 的关系**：`/v1/shareholder` 的 `code` 虽支持逗号，但返回是**一大坨 markdown**、没有逐只状态，无效代码会**静默消失**（少了哪只算不出来）⇒ **多只请用本工具*
• ashare_finance_batch⭐ **批量财务报表：一次拿多只的利润表 / 资产负债表 / 现金流量表**，逐只标明成功与否。用户问'这几只的营收/净利/ROE/负债率/经营现金流怎么样'用这个。⚠️ **与 ashare_finance 的关系**：`/v1/finance` 的 `code` 虽支持逗号，但返回是**扁平的 3 张表**，哪只没回来、为什么没回来**完全看不出来** ⇒ **多只请用本工具**；只查一只也可以用它（codes 传一个即可）。⚠️
• ashare_technical_batch⭐ **批量技术指标：一次拿多只的 MA / EMA / MACD / KDJ / RSI / BOLL / BIAS / WR / DMI / OBV / VR / BBI / TRIX / DPO / PSY / ENE / CCI 等共 55 项**，逐只标明成功与否。用户问'这批股票的技术面怎么样/哪些金叉了/哪些超买了/哪些在均线之上'用这个。⚠️ **与 ashare_technical 的关系**：`/v1/technic
• ashare_orderbook**五档盘口**：买一~买五 / 卖一~卖五的**价格与挂单量（手）** + 现价/涨跌/数据时间。用户问'封单多少/买盘卖盘/盘口/挂单/支撑压力位/有没有大单托着'用这个。字段：`b1_p`/`b1_v`~`b5_p`/`b5_v` 买档价格/量 · `a1_p`/`a1_v`~`a5_p`/`a5_v` 卖档。⚠️ 本工具是**秒级快照**（每 10 秒刷新），**盘中才有意义**（收盘后为当日最后快照）——要**实时成交价**用
• ashare_snapshot**全字段行情画像**：价格 + 盘口（买五卖五+委差）+ 估值（PE TTM/动/静 + PB）+ 市值（流通/总）+ 股本（流通/总）+ 打板（涨停/跌停价 + 量比 + 振幅 + 涨速）+ 标识（证券类型/股票状态/币种）+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠️ **与 ashare_quote 的分工**：quote 轻（8 字段）**免费**；本工
• ashare_klineK线（日/周/月/季/年 + 分钟线）。用户问'走势/最近表现/历史K线/趋势'用这个。⚠️ 只要**当前价**用 ashare_quote；要**分时**（盘中每分钟价+累计量）用 ashare_minute ——**分钟 K 线**（OHLC 蜡烛）用本工具的 `period=m1/m5/...`，两者不是一回事。⚠️ 换手率字段名是 **`turnover`**（%）—— 与 ashare_quote、ashare_snapsho
• ashare_minute**分时**（当日 / 近 5 日盘中走势）：盘中每分钟的价格与累计成交量。用户问'今天分时/盘中走势/日内走势/近 5 日分时'用这个。⚠️ 与 ashare_kline 的**分钟 K 线不是一回事**：本工具返回**分时**（每分钟一个价+累计量），K 线返回 OHLC 蜡烛 —— 要蜡烛图用 ashare_kline 的 `period=m1/m5/...`。⚠️ `days` **只有 1（当日）和 5（近 5 个交易日）两档
• ashare_kline_full全历史K线（**10 年日线**，2016-08-08 起）+ **可选复权口径**。用户问'十年走势/长期回测/全历史数据/复权价/后复权/原始价'用这个。⚠️ 与 ashare_kline 的**三点不同**：① 数据量与范围 —— 本工具**全历史 10 年**（2465 条）；ashare_kline 上限 1212 条；② 复权可选 —— 本工具有 **`fq`** 参数（qfq 前复权 / hfq 后复权 / nofq 原始
• ashare_market_kline**全市场单日K线** —— 一次请求返回某交易日**全 A 股（5000+ 只）**的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠️ **用途**：替代「逐只循环 5000 次」——每天收盘后调 **1 次**即可拿到全市场，适合建本地行情库/做全市场扫描/每日批量更新。⚠️ **两种硬限定**：① **仅专业版（¥99）与机构版（¥199）** 可用（Standard 及以下会被拒）；② *
• 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：排行/标签/事件）。传英文会返回空。⚠️ **付费工具**（
• 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_fund_batch。
• ashare_fund_batch⭐ **批量资金流**：一次拿**多只股票**的资金流（主力资金 + 龙虎榜 + 大宗 + 融资融券），每只一条记录。用户问'这几只股票的资金流/扫一下我这个池子的主力资金/一个行业谁在流入'用这个。⚠️ 与 ashare_fund 的区别：本工具**一次给多只**，ashare_fund 只查一只。⚠️ **用法**：`codes` 用**逗号分隔**，如 `sh600519,sz000001,sz300750`；支持**裸 6 位码
• ashare_technical技术指标 MA/MACD/KDJ/RSI/BOLL。用户问'技术面/指标/金叉死叉/超买超卖'用这个。⚠️ 只要原始 K 线（不算指标）请用 ashare_kline——本工具返回已算好的指标值。只读查询；按日线收盘更新。
• ashare_shareholder股东研究：十大股东/股东户数（筹码集中度）/机构持仓。用户问'谁在持有/股东变化/筹码集中/机构持仓'用这个。⚠️ 要看机构**整体**在全市场买什么，请用 ashare_lhb 的机构榜。只读查询；股东户数按定期报告披露（季度级）。
• ashare_events个股事件标签（42 类：大宗/龙虎榜/回购/分红/解禁等）。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠️ 要看**全市场**某一类事件名单，请用 ashare_lhb（龙虎榜分榜）或 ashare_dividend（分红送转）——本工具是**单只股票**的事件总览。只读查询；按披露节奏更新。
• ashare_margin_trade**个股融资融券明细**：融资余额 / 融资买入 / 融资偿还 / 融券余额 / 融券卖出 / 融券偿还。用户问'这只股票杠杆资金在加还是在撤/融资余额多少/两融数据'用这个。⚠️ **code 必填**（参数上不是 required，但不传只会得到一句明确说明、没有数据）。⚠️ **支持批量**：`code` 可传逗号分隔（`sh600667,sz000651`），返回多行 —— 但**不带逐只状态**，缺了哪只要自己算。⚠️ `da
• ashare_block_trade**大宗交易成交明细**：成交价 / 成交量 / 成交额 / **折溢价率** / 买方营业部 / 卖方营业部。用户问'有没有大宗交易/折价还是溢价成交/谁在接盘/机构席位'用这个。⚠️ **code 可留空**：留空 = 当日**全市场**大宗交易；给了 code = 该股的大宗记录。⚠️ `date` 留空 = 最近交易日。⚠️ **当日无大宗交易时返回的是行情元信息**（code/name/date/closePrice/chan
• 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`。用户问'封单是真的吗/有没
• ashare_evidence**财经多源取证**：一次查询同时搜**巨潮公告**（沪深两市·官方一手）与**东方财富资讯**，归一成一张表并**去掉转载重复**。行字段 `source`（cninfo/eastmoney）/ `kind`（notice 公告 / news 资讯 / report 研报）/ `title` / `url` / `date` / `code` / `name` / `media` / `authority`（1.0 官方·0.5 门户
• ashare_ask_user**歧义时向用户提问**（结构对齐 Claude Code `AskUserQuestion`）。\n⭐ **什么时候用**：用户只给了**模糊名称**（「平安」「腾讯」），你不确定指哪家公司时。\n 本工具**不会替你选**，而是返回 **1–4 个带说明的选项**（如「中国平安 · 沪市主板·保险龙头」），由你转成问题问用户。\n⚠️ **选项说明由模型生成**（需要语义："中国平安"和"平安银行"差在哪，规则写不出来） ⇒ 带 `
• ashare_agent_search**一句话取数 + 证据链**：把「宁德时代最近资金流入怎么样」这种自然语言问题，直接映射到**我们自己的数据端点**，返回**一行结构化数据 + 完整证据**（`value_hash` / `source_endpoint` / `params` / `as_of`），并可核验。 ⭐ **与 `ashare_evidence` 的分工**：`ashare_evidence` 是**公告/资讯/研报原文检索**（关键词搜）；本工具是**
• ashare_watchlist_list**查自选股**：按 API Key 隔离，返回列表和标的；CRUD 不扣数据次数。
• ashare_watchlist_add**加自选股**：把股票加入自选；重复添加幂等。
• ashare_watchlist_remove**删自选股**：从自选列表删除标的。
• ashare_watchlist_quotes**自选股批量行情**：一次返回自选股最新行情。
• ashare_scanner**选股员（scanner Agent）**：把自然语言条件交给只读取数工具，返回候选池 + 证据引用 + 工具轨迹。适合『高ROE + 央企 + 近5日主力净流入』这类条件选股。 ⚠️ **BYOK**：除 `ASHARE_KEY` 外还要设 `ASHARE_LLM_KEY`（模型 Key），模型 token 由客户自己付。 ⚠️ **专业版（¥99）起**；scanner 额度独立（2,000 次），不占数据 API 的 500k
• ashare_flash**7×24 财经快讯**（全市场电报，财联社等来源），按时间倒序。行字段 `id` / `time` / `title` / `content` / `source` / `url`。用户问'今天有什么大消息/最新财经新闻/刚才发生了什么/宏观突发事件'用这个。⭐ **与 `ashare_news` 的分工**：`ashare_news` 是**按个股**的资讯（要传 code）；本工具是**全市场快讯流**（不需要代码）—— 问大盘
• ashare_lhb_seats**龙虎榜席位明细**：某只票某次上榜的**营业部买卖席位**（最多 10 个），带 **`is_youzi` 游资标记**。行字段 `name`（营业部）/ `total_buy` / `total_sell` / `net`（净买额）/ `is_youzi` / `log_id`，按净买额降序。用户问'今天龙虎榜是谁买的/哪个营业部/是不是游资/沪股通买了多少'用这个。⭐ 与 `ashare_lhb` 的分工：`ashare_lhb

Questions