A股数据 API (A-Share Data API)
Server Details
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 92 tools
Many tools overlap heavily: quote vs snapshot vs their _batch variants, kline vs kline_full vs kline_batch vs market_kline, fund vs fund_flow vs fund_batch, and seven bigorder_* variants all describe similar money-flow data. The descriptions do an unusually good job of explicitly stating each tool's division of labor against its near-neighbors, which rescues selection, but the sheer number of pairwise distinctions (single vs batch vs full vs history) makes misselection a real risk.
All tools share an ashare_ prefix and snake_case resource names, with readable suffix modifiers (_batch, _full, _history, _flow, _rank). A few agent-style names (ashare_agent_search, ashare_ask_user, ashare_scanner, ashare_analyst) deviate from the noun-based convention, but overall the pattern is predictable.
92 tools is far beyond a well-scoped surface; the domain is broad (quotes, K-lines, funds, financials, news, screening, backtest, watchlist) but the set is inflated by many single-vs-batch and tier-gated duplicates. Several tools exist only to work around limitations of a sibling tool, which suggests the count could be consolidated considerably.
Coverage is extensive: quotes, historical K-lines, financials, fund flows, L2 order data, news/announcements/research, ETF, index, macro, screening, backtesting, watchlist CRUD, usage, and docs. Minor gaps exist — no trading/execution, no streaming subscriptions, some documented dead ends (hotmoney 游资榜 has no data, long-report PDFs must be parsed by the caller), and tier gating hides many tools from lower plans.
Available Tools
92 toolsashare_abnormalAInspect
异动 / 偏离值(短线监管异动体系):触发「严重异动」、「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 数据日期。只读查询。
Inputs: date, mode, limit. Returns: result
ashare_agent_searchAInspect
一句话取数 + 证据链:把「宁德时代最近资金流入怎么样」这种自然语言问题,直接映射到我们自己的数据端点,返回一行结构化数据 + 完整证据(value_hash / source_endpoint / params / as_of),并可核验。
⭐ 与 ashare_evidence 的分工:ashare_evidence 是公告/资讯/研报原文检索(关键词搜);本工具是把问句变成数据查询(资金流 / 行情 / 公告)。问'多少/怎么样/是什么'用这个;问'发了什么公告/有什么新闻'用 evidence。
⭐ 返回 = 行数组(data)+ 顶部 citations[] + verification[]:
· data[] 是扁平表,一行 = 一条证据(rank / source_endpoint / field_path / value / value_hash / as_of / authority_score)
· citations[] 是完整引用(含 params 原对象,可拿它 + field_path 重新取值核对)
· verification.claims[] 是逐条裁决(supported / unverified 等)—— ⭐ 这是本产品与同类最大的差别:明确告诉你哪些已验、哪些没验
⚠️ interpreted.intent_source 必须看:llm = 模型理解;rules_fallback / local_rules = 退回规则(此时能力受词表限制,复杂问法可能判不出)。
⭐ readable(可读值):资金流/成交额/成交量这类大数值,每行额外给 readable(如 -14.26 亿元)+ unit + rule(换算规则,可反算回原值)—— 直接引用它,别自己换算(实测 LLM 换算 5 次错 1 次,-1524347183 会算成 1.52 亿)。⚠️ value 仍是数据源原值、一字不改;价格/点位类不换算(readable=null)。
⭐ number_gate(数字自查):你要据此写一段话时,按其中 rules 自查 —— verbatim(原值)/ unit_convert(换单位)可;derived(涨跌幅/同比/占比这类自行计算的派生量)不可,派生量必须来自数据源。
⚠️ 覆盖边界(如实告知用户,别乱承诺):支持 A股/港股/美股 的资金流(含 5/10/20 日累计)/ 行情价格 / 公告资讯 / 研报观点 / 龙虎榜 / 大宗交易 / 融资融券,以及多标的对比(「宁德时代和比亚迪哪个资金流入更多」)。⛔ 不支持:板块、大盘统计、技术面(K线/指标/支撑位)、基本面(市盈率/ROE/分红/股东人数)、归因分析(「为什么跌」)、预测与荐股 —— 这些会明确拒答(ok:false + 原因),⛔ 不会拿别的字段凑数。
⚠️ 取不到对应字段时直接拒答并说明,⛔ 绝不返回'看起来像'的其它指标。
⭐ scope(数据源范围,可选):ashare(自有数据)· notice,news,report(公告/资讯/研报)· web(网页检索,需 X-LLM-Key)· wechat(微信公众号,同 web + 限定公众号)。网页/微信检索可覆盖我们数据库之外的内容(行业政策、宏观解读、非 A 股公司等),⚠️ 但要客户自己的模型 key(费用由客户承担)。⚠️ 显式传 web/wechat 时只在该通道内找,取不到会如实 ok:false(⛔ 不会退回别的通道凑答案);⛔ 暂不支持 a2b(浏览器渲染)/ xhs / local。
⭐ 网页/微信检索的行(source_type=web_search):除通用字段外还给 rerank_score(相关性 0~3,≥1.5 为优质)+ quality(good / fair)—— 用它判断这批结果够不够好,别只看条数。
⭐ 句级定位:网页正文类证据带 start_char / end_char(字符区间),可精确回答'哪一句、第几个字符';end_char 与 value 长度一致,可对账。
⭐ replay=true(重放对账,可选):额外调一次模型比对输出,结果标 match / non_deterministic / not_replayable / skipped_no_client。⚠️ 模型路径下通常为 non_deterministic(同一输入、输出字节可能不同)—— 这不代表结论不可靠(确定性 ≠ 判断质量)。默认关闭。
Inputs: q (required), recency, max_results. Returns: result
ashare_analystAInspect
复盘分析师(analyst Agent):输入 scanner 快照 ID,读取快照与 T+1/T+5/T+20 评估,输出收益/基准/超额/命中率、赢家输家、数据缺口和复盘报告。只读、不选股、不预测、不推荐买卖。
⚠️ 可选 BYOK:带 X-LLM-Key 用模型润色;不带返回确定性复盘。
Inputs: snapshot_id (required), focus, horizon. Returns: result
ashare_ask_userAInspect
歧义时向用户提问(结构对齐 Claude Code AskUserQuestion)。\n⭐ 什么时候用:用户只给了模糊名称(「平安」「腾讯」),你不确定指哪家公司时。\n 本工具不会替你选,而是返回 1–4 个带说明的选项(如「中国平安 · 沪市主板·保险龙头」),由你转成问题问用户。\n⚠️ 选项说明由模型生成(需要语义:"中国平安"和"平安银行"差在哪,规则写不出来) ⇒ 带 X-LLM-Key 时质量最好;不带则只返回原始候选(无说明)。\n⚠️ 返回 needs_clarification=false 表示歧义已消(模型判断只有一家可能),此时 chosen_code 就是答案,直接用它继续。\n⛔ 本工具不查数据,只做消歧。拿到 code 后再调 ashare_agent_search / ashare_quote。
Inputs: q (required). Returns: result
ashare_auctionAInspect
集合竞价:个股 9:15–9:25 集合竞价数据,含**「竞价触及涨停 / 触及跌停」判定**。用户问'竞价分时 / 竞价怎么走的 / 集合竞价买了多少 / 哪些票竞价就涨停了 / 哪些竞价跌停'用这个。mode 取值:stock 当日竞价分时(默认,分钟级逐笔)· stock-history 历史竞价分时(秒级逐笔,需 date)· volume 当日竞价量 / 资金净额(单点)。⭐ is_limit_up = 「竞价触及涨停」判定(竞价段最高价 ≥ 涨停价,涨停价取自行情源原始值);⭐ is_limit_down = 「竞价触及跌停」判定(竞价段最低价 ≤ 跌停价,跌停价同样取自行情源原始值)。另含 up_px 涨停价 / down_px 跌停价 / hprice 竞价段最高价 / lprice 竞价段最低价 / open_px 09:25 撮合价 / preclose_px 昨收。⚠️ mode=stock 仅当日;历史请用 mode=stock-history 且必传 date(真实交易日)。只读查询。⚠️ 付费工具:专业版(¥99)及以上,标准版不可用。
Inputs: code (required), date, mode. Returns: result
ashare_backtestAInspect
量化回测:按策略跑历史收益(返回收益/最大回撤/交易次数/净值曲线等)。用户问'回测一下/这个策略收益如何/买卖点效果/最大回撤'用这个。⚠️ 两种模式:mode=single(默认)单标的实时计算,须配 code;mode=portfolio 组合(须用 strategies 里的组合策略,区间受预置批次限制)。⚠️ weighting=inv_vol(按波动率倒数配仓)仅组合模式 + 机构版可用。⚠️ 想知道有哪些策略/参数范围,先调 ashare_strategies;想一次跑多标的×多策略,用 ashare_backtest_batch。⚠️ 付费工具(需 Key):单标的 Standard(¥29.9)起;组合 / 批量回测为 Pro 及以上,且有独立日额度,余量可查 ashare_usage。
Inputs: strategy (required), end, code, mode, +4 more. Returns: result
ashare_backtest_batchAInspect
批量回测:一次跑 多标的 × 多策略,返回对比矩阵(哪个组合最好一目了然)。用户问'这几只股票用不同策略分别跑一下/批量回测/策略对比'用这个。⚠️ 与 ashare_backtest 的区别:本工具一次给多标的×多策略的横向对比,ashare_backtest 只跑一个策略。⚠️ 上限:标的 ≤20 · 策略 ≤10 · 组合 ≤60(超限直接报错,不静默截断)。⚠️ 组合策略不能用于批量回测(批量只支持单标的择时策略)。⚠️ 参数可传列表(自动转逗号)。⚠️ 付费工具(需 Key):Pro(¥69)及以上,有独立日额度。
Inputs: codes (required), strategies (required), end, start, +1 more. Returns: result
ashare_bigorderAInspect
单股 L2 大单资金分时(分钟级):net = 该分钟大单净额(元),正数=大单净买入、负数=净卖出。用户问'大单在买还是卖/主力资金分时/哪一分钟砸盘'用这个。⚠️ 仅当日(非交易日/盘前返回最近一个交易日),日期看返回顶层 day。⚠️ 盘中末尾几分钟仍在追加:09:30–15:00 约 242 点,盘中调用点数会随交易时段增长。⚠️ 这是大单口径(按成交金额聚合)—— 不是逐笔委托、也不是十档盘口,别把它当'盘口深度'用。⚠️ 机构版专属:专业版及以下调用会返回明确说明 + 升级链接,不会静默失败。⚠️ 与 ashare_fund 的分工:ashare_fund 给日级汇总(主力净额 1/5/10/20 日)+ 龙虎榜/大宗/两融;本工具给当日分钟级大单曲线 ⇒ 看趋势用本工具,看快照用 fund。
Inputs: code (required). Returns: result
ashare_bigorder_flowAInspect
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 = 被截断):要全天全量(算金额、算净流入)请用 ashare_bigorder_flow_full;只要最新一段(看方向)用本工具,配合 money 抬高阈值缩小范围。⚠️ 这是成交口径,不是逐笔委托、也不是十档盘口。⚠️ 机构版专属:其他档位返回明确说明 + 升级链接。
Inputs: code (required), limit, money. Returns: result
ashare_bigorder_flow_fullAInspect
L2 大单成交·全天完整:把当日全部成交额 ≥ 阈值的大单一次拿全,不受「单次最多 200 笔」限制。用于算全天金额(主力净流入多少、四方向各多少)。行字段与 ashare_bigorder_flow 完全一致;顶层 meta 有 total(当日总笔数)/ returned / deduped(合并掉的重复条数)/ pages / complete(是否已拿全)/ summary(四方向金额合计,summary_scope=all_rows,拿全时即当日全量)。用户问'今天主力净流入多少 / 主动买和主动卖各多少 / 大单金额合计'用这个。⭐ 与 ashare_bigorder_flow 的分工:flow 只给最新 200 笔(快,看方向);本工具给全天全量(慢,算金额)。只拿 200 笔去算全天金额会算错。⚠️ 比 flow 慢(内部逐页取,每页约 0.8 秒):30 万档活跃票约 20~30 秒,100 万档约 10 秒,300 万档约 2 秒 ⇒ 只要结论时建议 money=2(100 万)以上。⚠️ 返回量大(5000 行约 600 KB):只要方向不要金额时,用 ashare_bigorder_flow 更省;确实需要全量但上下文紧张时,可用 max_rows 调小。⚠️ 仅当日。⚠️ 这是成交口径,不是逐笔委托、也不是十档盘口。⚠️ 机构版专属:其他档位返回明确说明 + 升级链接。
Inputs: code (required), money, max_rows. Returns: result
ashare_bigorder_historyAInspect
L2 历史大单净额(逐日,往回最多 100 个交易日):每天一个值,行字段 date / net(当日大单净额,元,正=净买入负=净卖出),倒序(最新在前)。用户问'这票大单最近是不是一直在吸/大单资金趋势/前几个月大单怎么走的'用这个。⭐ 与 ashare_bigorder 的分工:那个只能看今天,本工具补「往回看」—— 判断是持续吸筹还是只今天冲一下,以及哪天开始转向。⚠️ 数据源固定返 100 个交易日,limit 只在本地截断(省流量不省调用)。⚠️ net 是大单口径(按成交金额聚合),⛔ 不是主力净额、不是龙虎榜、不是逐笔。⚠️ 机构版专属:其他档位返回明确说明 + 升级链接。
Inputs: code (required), limit. Returns: result
ashare_bigorder_queueAInspect
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" 表示只统计返回的样本,不是当日全量。用户问'封单是真的吗/有没有大单挂了又撤/假封单'用这个。⭐ 与 bigorder-flow 是两件事:queue = 挂单(可能撤),flow = 成交(真买了)。两个一起看才能分清「挂了没成」和「真买了」。⚠️ 仅当日;vol ∈ {500,1000,2000,5000,10000} 手、tur ∈ {30,50,100,200,500,1000} 万;单次最多约 200 笔。⚠️ 这是委托口径,不是成交、也不是十档盘口。⚠️ 机构版专属。
Inputs: code (required), tur, vol, limit. Returns: result
ashare_bigorder_rankAInspect
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。用户问'今天主力在买什么/资金流入最多的是哪几只/谁在被砸/哪些板块主力在买'用这个。⭐ 恒等式可自检:main_buy + main_sell == main_net(全市场 100% 成立)。⭐ 下钻路径:本工具选股 → ashare_bigorder(分钟净额)/ ashare_bigorder_split(四分解)看个股结构。⚠️ limit 最大 6000(可一次取全市场,约 1 MB);翻页用 offset。⚠️ market_cap 为数据源原始市值字段,仅供排序/粗筛,⛔ 不要与其它工具的市值字段混用。⚠️ 机构版专属。
Inputs: date, sort, limit, offset. Returns: result
ashare_bigorder_splitAInspect
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 笔);本工具是分钟聚合(看节奏与均价,可回看历史、无条数上限)。⚠️ 传 date = 历史某交易日;不传 = 当日实时。⚠️ 这是资金口径(按成交方向拆分),⛔ 不是委托队列、不是十档盘口。⚠️ 机构版专属。
Inputs: code (required), date. Returns: result
ashare_block_tradeAInspect
大宗交易成交明细:成交价 / 成交量 / 成交额 / 折溢价率 / 买方营业部 / 卖方营业部。用户问'有没有大宗交易/折价还是溢价成交/谁在接盘/机构席位'用这个。⚠️ code 可留空:留空 = 当日全市场大宗交易;给了 code = 该股的大宗记录。⚠️ date 留空 = 最近交易日。⚠️ 当日无大宗交易时返回的是行情元信息(code/name/date/closePrice/changePct,证明标的没问题、只是没有大宗)—— 判『有没有大宗』要看返回里有没有TurnoverPrice/BuySalesDepartment 这类成交字段。⚠️ 与 ashare_fund 的关系:ashare_fund 的大宗只是概览一行;本工具是逐笔明细。
Inputs: code, date. Returns: result
ashare_bondAInspect
可转债完整条款:溢价率/转股价值/双低值/强赎触发价/回售触发价/转股价/正股/到期日/评级。用户问'转债条款/强赎/双低/溢价'用这个。⚠️ 要转债行情价请用 ashare_quote(同样支持转债代码)。只读查询;代码形如 sh113052(沪)/ sz123138(深)。
Inputs: code (required). Returns: result
ashare_broken_boardAInspect
炸板历史(某日涨停被砸开的票):行字段 code / name / change_pct 涨幅% / main_net 主力净额(元)/ amount 成交额(元)/ turnover_rate 换手% / concepts 所属概念(如「金融科技、金融概念」)/ raw 原始行。用户问'今天有哪些票炸板/封板质量怎么样/哪些涨停被砸开'用这个。⭐ 与 ashare_limit_up 互补:涨停池是封住的,本工具是没封住的,两者一比就是当天封板质量。⚠️ date 留空 = 最近工作日(周末回退到上周五);法定节假日请显式传。⚠️ is_fallback=true 表示没拿到你指定的那天,以 date 为准。⚠️ 机构版专属。
Inputs: date, limit. Returns: result
ashare_buybackAInspect
公司股份回购记录。用户问'这家公司在回购吗/回购了多少/回购价多少'时用。⚠️⚠️ 返回结构按市场不同,⛔ 不能按同一套列名解析:A 股 ⇒ 事件概要 code/name/market;港股 ⇒ 逐日明细 date/BuybackMoney/BuybackPrice/BuybackShares/BuybackCumMoney/closePrice。⚠️ 与 ashare_shareholder(谁持有)不同:本工具看的是公司自己买自己。只读查询;标准版(¥29.9)及以上。
Inputs: code (required), end, start. Returns: result
ashare_calendarAInspect
个股事件日历:分红派息 / 限售解禁 / 财报披露 / 新股发行 / 会议 / 增发 等公司事件排期,从指定日期起约 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 只是建议值,数据按事件类型分段、各段条数不严格等于该值。⚠️ 支持港股(实测 hk00700 返回 151 条事件,密度远高于 A 股)。
Inputs: date, limit. Returns: result
ashare_changedistAInspect
全市场涨跌家数与市场广度(当期口径):上涨/下跌/平盘/停牌家数 + 上涨占比 + 涨停/跌停 + 11 档涨跌幅区间分布 + 两市成交额。用户问'今天涨跌家数/多少家涨停/市场情绪/市场广度'用这个——这是市场广度的唯一推荐入口。⚠️ 不要用 ashare_market_overview 的 updown 模式取同一数据(那是 T-1 口径,数值会与此不一致)。· 免费工具(无需 Key)
Inputs: no named parameters. Returns: result
ashare_chipAInspect
筹码分布 / 持仓成本(沪深 A 股 + ETF):获利盘比例 + 平均成本 + 90% 与 70% 集中度 + 当日收盘价。用户问'筹码集中吗/套牢盘多不多/平均成本多少/抛压大不大/主力成本在哪'用这个。⚠️ 多只请用 ashare_chip_batch(一次 200 只、逐只标明成功与否)—— 本工具只查一只。⚠️ date 可回看历史(YYYY-MM-DD,缺省=最新);历史仅保留约近 1 年;非交易日/未来日期会自动回退到最近交易日,以返回行的 date 为准。⚠️ 代码可传 sh600667 或裸 6 位 600667。⚠️ ETF 也能查(实测 sh510300:平均成本 4.39 / 获利 13.47%),口径与个股相同;港美股不支持。⚠️ 付费工具:需 Key(体验版及以上),免费/匿名不可用。
Inputs: code (required), date. Returns: result
ashare_chip_batchAInspect
⭐ 批量筹码分布:一次拿多只的获利盘比例 / 平均成本 / 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)及以上,标准版不可用。
Inputs: codes (required), date. Returns: result
ashare_consensusAInspect
卖方一致预期:分析师目标价 + 未来预测(EPS/营收/净利润/预测 PE·PB·PS/机构覆盖数)。用户问'机构怎么看/目标价多少/明年利润预测/一致预期'时用。⚠️ codes 逗号多只、逐只回 ok,单次 ≤15 只(数据源 >15 只静默丢数据:20 只只回 6 只)。⚠️ 字段按市场不同:A 股有 targetPrice;港股没有目标价,字段是 *Forecast 一套。只读查询;专业版(¥99)及以上。
Inputs: codes (required). Returns: result
ashare_dehydratedAInspect
脱水研报(券商研报摘要)。用户问'研报/机构观点/券商怎么说'用这个。mode=list 列表 / mode=detail 详情(detail 需给 symbol)。⚠️ 要个股新闻/公告请用 ashare_events。只读查询;按研报发布更新。
Inputs: mode, limit, symbol. Returns: result
ashare_disclosureAInspect
业绩预约披露日:哪天披露财报(disclosureDate)+ 报告期(reportEndDate)+ 说明文案。用户问'什么时候出财报/几号披露/三季报什么时候发'时用。三市场:A 股 / 港股 / 美股。⚠️ 与 ashare_calendar(分红/解禁/会议)不是一回事。⚠️ 港股 disclosureDate 常为空,日期写在 disclosureDesc 文案里(如「将于2026-11-18发布财报」)。只读查询;标准版(¥29.9)及以上。
Inputs: codes (required). Returns: result
ashare_dividendAInspect
分红送转历史(每股分红/送股/除权日)。用户问'分红/股息/送转'用这个。⚠️ 要分红派息日历(哪天除权)请用 ashare_events——本工具是历史记录。只读查询;按公告披露更新。⚠️ 支持港股(代码 5 位 hk00700)。ETF 没有分红明细(只有 ashare_etf(kind='概览') 的 divTtm)。
Inputs: code (required), years. Returns: result
ashare_etfAInspect
ETF 数据。用户问'ETF'时用这个。kind 选子集:概览(默认·行情/规模/溢折率/资金流/回撤/估值) · 详情(基金要素/费率/份额/基金经理/持仓Top20) · 持仓(成分股及权重) · 净值(历史净值,须同时传 start+end) · 公司(管理人/托管人/跟踪指数) · 持有人(户数/机构个人占比) · 财务(股债商品基金占比)。⚠️ 返回的 data 是排版文本,取字段用 structured(首表)或 tables(全部表) —— 详情/公司 是多表,只有 tables 拿全。⚠️ 查历史快照:kind=概览/持仓 + date=YYYY-MM-DD。传了 date 与不传返回形态可能不同(持仓:传 date=重仓股涨跌 + 申赎清单前 10 两段、code 带市场前缀;不传=单表 Top20 持仓、code 为裸 6 位)⇒ 按段名/列名取,⛔ 别按位置取。⚠️ 历史快照两个数据源边界:未来日期按最近交易日返回(看 date 列自证);上市前日期回全 0(会被拦成 ok:false)。⚠️ 要『全市场有哪些 ETF / 规模排行 / 主题池(千亿·百亿·金牛奖·科创占比高…)』不在这里 —— 用 ashare_screen(asset='etf'):mode=ranking 有 9 类横截面指标(规模/估值/历史百分位/单日/区间涨跌/换手/成交额/溢折率),mode=label 有 48 个 ETF 主题池;list=true 先列合法取值。⚠️ 仅 ETF 代码:传个股代码返回 ok:false(不扣次数)。⚠️ code 单次只查 1 只:传逗号会 422(本端点没有批量价);多只请分别调用,每只独立计次。只读查询;代码形如 sh510300 或裸 6 位 510300。
Inputs: code (required), end, date, kind, +1 more. Returns: result
ashare_eventsAInspect
个股事件标签(42 类:大宗/龙虎榜/回购/分红/解禁等)。用户问'这只股票最近有什么大事/解禁/回购/定增'用这个。⚠️ 要看全市场某一类事件名单,请用 ashare_lhb(龙虎榜分榜)或 ashare_dividend(分红送转)——本工具是单只股票的事件总览。只读查询;按披露节奏更新。
Inputs: code (required). Returns: result
ashare_evidenceAInspect
财经多源取证:一次查询同时搜巨潮公告(沪深两市·官方一手)与东方财富资讯,归一成一张表并去掉转载重复。行字段 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 分钟。
Inputs: q (required), limit, scope. Returns: result
ashare_factorsAInspect
量化因子库:87 个因子 + 50 个筛选入口 + 22 个预设组合,可按分类/类型筛选。用户问'有哪些因子/因子库/选股因子/因子分类'用这个。⚠️ 这是清单(静态元数据);要用因子实际选股,用 ashare_screen。⚠️ category / kind 只接受中文枚举值(category:估值/行情/盈利/成长/财务/资金…;kind:排行/标签/事件)。传英文会返回空。⚠️ 付费工具(需 Key):Standard(¥29.9)及以上。
Inputs: kind, category. Returns: result
ashare_financeAInspect
财务报表(利润表/资产负债表/现金流量表,最近 N 期)。用户问'营收/净利润/毛利率/负债/财务数据'用这个。⚠️ 返回三张表:data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表;每表按期次降序(最新一期在最前)。⚠️ 只要估值倍数(PE/PB)请用 ashare_sector_valuation 或 ashare_quote 的估值字段。只读查询;按财报披露节奏更新(未到披露日就没有新数据,不是故障)。⚠️ 支持港股(代码 5 位 hk00700)。港股的报表期次/字段口径以返回为准,⛔ 别按 A 股列名硬解析。
Inputs: code (required), num. Returns: result
ashare_finance_batchAInspect
⭐ 批量财务报表:一次拿多只的利润表 / 资产负债表 / 现金流量表,逐只标明成功与否。用户问'这几只的营收/净利/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)及以上,标准版不可用。
Inputs: codes (required), type, fields, periods. Returns: result
ashare_flashAInspect
7×24 财经快讯(全市场电报,财联社等来源),按时间倒序。行字段 id / time / title / content / source / url。用户问'今天有什么大消息/最新财经新闻/刚才发生了什么/宏观突发事件'用这个。⭐ 与 ashare_news 的分工:ashare_news 是按个股的资讯(要传 code);本工具是全市场快讯流(不需要代码)—— 问大盘/宏观/突发用这个,问某只票的消息面用 news。⚠️ 翻页:index 从 0 开始,步长=上次的 limit(limit=20&index=20 是第二页);只能往回翻,无日期参数。⚠️ limit 上限 200;缓存 1 分钟(同一分钟内重复请求不重复消耗)。
Inputs: index, limit. Returns: result
ashare_fundAInspect
个股级交易面:这只股的 主力资金(当日/5/10/20 日净流入+全市场排名)+ 龙虎榜上榜明细(上榜原因/营业部)+ 大宗交易 + 融资融券。用户问'某只股票的主力资金/机构动向'用这个。⚠️ 全市场榜单(今天机构榜/游资榜/活跃席位)请用 ashare_lhb——本工具只针对单只股票。⚠️ 要一次查多只股票的资金流(扫自选池/一个行业),用 ashare_fund_batch。
Inputs: code (required). Returns: result
ashare_fund_batchAInspect
⭐ 批量资金流:一次拿多只股票的资金流(主力资金 + 龙虎榜 + 大宗 + 融资融券),每只一条记录。用户问'这几只股票的资金流/扫一下我这个池子的主力资金/一个行业谁在流入'用这个。⚠️ 与 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)及以上,标准版不可用。
Inputs: codes (required). Returns: result
ashare_fund_flowAInspect
个股资金流向(A 股 / 港股):主力与散户的买入/卖出/净额 + 均价、收盘价。用户问'主力在进还是出/资金流多少'时用。⚠️ 与 ashare_fund(综合:龙虎榜+大宗+两融,仅 A 股)不是一回事 —— 港股只能用本工具。⚠️ 金额单位是元。只读查询;专业版(¥99)及以上。
Inputs: code (required). Returns: result
ashare_fund_shortAInspect
卖空数据(港股 / 美股):卖空股数/金额/比率(ShortShares/ShortAmount/ShortRatio)。用户问'被做空多少/卖空比率'时用。⚠️ 请传 date —— 不传且当日数据未发布时,只回标识字段、没有卖空数值。⚠️ 仅港股 / 美股;A 股没有卖空数据(融券请用 ashare_margin_trade)。只读查询;专业版(¥99)及以上。
Inputs: code (required), date. Returns: result
ashare_fund_southAInspect
港股通南下资金持仓(季度):持股数/持股比例/持股市值。用户问'南下资金持有多少/港股通占比'时用。仅港股。⚠️ 是季度持仓不是逐日流水 —— 逐日净流入用 ashare_fund_flow。⚠️ codes 可逗号多只。只读查询;专业版(¥99)及以上。
Inputs: codes (required), date. Returns: result
ashare_hotAInspect
关注度排名(谁在被关注,⛔ 不是'谁在涨')。用户问'什么股票热门/大家在看什么/热度榜/热门板块/热文'用这个。⚠️⚠️ 5 类字段结构完全不同,⛔ 别按同一套字段读:stock 热搜股票(code/name/zdf/zxj) · wx 全市场热度(多 pv 热度值) · news 热门文章(⚠️ news_id/news_title/source,⛔ 无 code) · sector 热门板块(⚠️ symbol,⛔ 无 code) · etf 热搜 ETF(含 title/tag)。⚠️ 当前快照(无历史)· 免费工具(无需 Key)
Inputs: type, limit. Returns: result
ashare_index_constituentAInspect
指数成分股全量清单(沪深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 国企 / hkHSTECH 恒生科技。⚠️ 一次只查 1 个(逗号多只返回空)。⚠️⚠️ 字段按市场不同,⛔ 不能按同一套键名解析:A 股是 code/name/IndexName;港股是中文键 代码/名称/涨跌幅/成交额(比 A 股多两列)。⚠️ 静态档案(随调仓变化),缓存 1 小时;标准版(¥29.9)及以上。
Inputs: code (required). Returns: result
ashare_index_listAInspect
指数全量清单(1223 个):code/name。用户问'有哪些指数/指数代码是什么'时用;拿到代码后用 ashare_index_constituent 取成分股。⚠️ 分页 limit(≤500)+offset;A股与港股指数混在一起(sh/sz/cs/hk 前缀)。只读查询;专业版(¥99)及以上。
Inputs: date, limit, offset. Returns: result
ashare_industry_chainAInspect
A 股产业链(183 个产业链主题),三种模式:mode=list → 主题列表;mode=graph + topic=超级电容 → 产业链图谱(关联个股 + 所属节点 + 产业链位置 上游/中游/下游);mode=stock + code=sh600667 → 个股所属产业链(主题 / 节点 / 位置 / 关联度 / 业务描述)。用户问'产业链/上下游/某公司处于链上什么位置/这个主题有哪些公司'用这个。⚠️ 参数是二选一:mode=graph 必须给 topic,mode=stock 必须给 code;给错组合(如 mode=graph 却只给 code)拿不到数据。⚠️ 主题名要中文全称(超级电容 / 集成电路)—— 拿不准先 mode=list 搜一遍再问。
Inputs: code, mode, topic. Returns: result
ashare_ipoAInspect
新股日历(发行/申购/中签/上市)。用户问'新股/打新/IPO'用这个。只读查询;按发行日历更新。⚠️ 三市场覆盖:A 股 / 港股 / 美股。
Inputs: days. Returns: result
ashare_klineAInspect
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 股)—— 复权口径属付费档能力。⚠️ 分钟线需 standard(¥29.9)及以上档位(日/周/月免费),必须同时传 start+end(窗口近 1 个月),⚠️ 北交所 / 期货 / 外汇 / 美股指数没有分钟K线 —— 传这些代码返回 422 明确报错(⛔ 不是空数组);北交所的分钟级数据用 ashare_minute(分时),别重试 kline。只读查询;按收盘更新。⚠️ 免费 / 匿名档按 5 分钟刷新;付费档实时(每次取此刻最新)。⭐ 要多只的 K 线(自选池 / 一个行业)—— 用 ashare_quote_batch(它返回逐只状态、4 秒拿完 300 只;本工具的 code 虽接受逗号但返回混在一起、缺了哪只算不出来)。⚠️ 匿名单次最多 5 只标的(付费不限)。· 免费工具(无需 Key)· 分钟线除外
Inputs: code (required), end, count, start, +1 more. Returns: result
ashare_kline_batchAInspect
⭐ 批量 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)及以上,标准版不可用。
Inputs: codes (required), fq, end, count, +2 more. Returns: result
ashare_kline_fullAInspect
全历史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)不可用;且有独立日额度(标准版 200 / 专业版 500 / 机构版 2000 次/天),余量可查 ashare_usage。
Inputs: code (required), fq, end, start. Returns: result
ashare_lhbAInspect
全市场龙虎榜分榜(6 类):type=all 全市场总榜(净买/买卖额)/ institution 机构榜(机构买入/净买/机构数)/ activeseat 活跃席位(席位买入额+关联个股)/ winbuy 高胜率买入(净买额/胜率/席位明细)/ winseat 高胜率席位(席位胜率+关联个股)/ hotmoney 游资榜。用户问'今天机构买了什么/龙虎榜/高胜率席位/活跃席位'用这个。⚠️ hotmoney(游资榜)暂无数据,建议改用 all/activeseat/winbuy。⚠️ 龙虎榜为收盘后发布(一般 18:00 后);date 留空=最近交易日。⚠️ 某只股票的上榜明细(上榜原因/营业部)请用 ashare_fund——本工具是市场级榜单,不针对单只股票。
Inputs: date, type. Returns: result
ashare_lhb_agencyAInspect
龙虎榜机构参与个股榜(全市场):某个交易日机构席位在龙虎榜上参与过的所有个股,一次拿完(实测单日约 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 是单票往下看营业部,本工具是全市场往上筛票 —— 问「今天机构买什么」用本工具,问「这只票是谁买的」用 ashare_lhb_seats。⚠️ net_buy 是净额(买入−卖出),可为负,别取绝对值当买入额。⚠️ 龙虎榜是盘后数据:date 留空 = 最近交易日。requested_date 是你传入的、date 是实际日期,is_fallback=true 表示没拿到你指定的那天,以 date 为准。⚠️ 机构版专属。
Inputs: date, sort, limit. Returns: result
ashare_lhb_seatsAInspect
龙虎榜席位明细:某只票某次上榜的营业部买卖席位(最多 10 个),带 is_youzi 游资标记。行字段 name(营业部)/ total_buy / total_sell / net(净买额)/ is_youzi / log_id,按净买额降序。用户问'今天龙虎榜是谁买的/哪个营业部/是不是游资/沪股通买了多少'用这个。⭐ 与 ashare_lhb 的分工:ashare_lhb 是榜单(机构榜/活跃席位等统计),本工具是单票的具体营业部明细 —— 问「谁买的」用本工具,问「今天哪类资金活跃」用 ashare_lhb。⚠️ 龙虎榜是盘后数据:date 留空 = 最近一次上榜日,以返回的 date 为准。⚠️ 单次最多约 10 个席位。⚠️ 机构版专属。
Inputs: code (required), date. Returns: result
ashare_limit_reasonAInspect
涨停原因(单只票的历史涨停记录 + 完整原因文案):每次涨停的完整原因 + 所属板块 + 当日「日内龙几」。行字段 date / dragon_rank(如「日内龙一」,空 = 非龙头)/ plates 板块代码数组 / reason 完整涨停原因 / concept 概念说明。用户问'这只票为什么涨停/上次涨停什么原因/它靠什么题材涨停'用这个。⭐ 与 ashare_limit_up 的分工:涨停池给今天全市场涨停股;本工具给单只票的历史涨停原因。⚠️ 返回该股票历次涨停的全部记录,date 不用于筛选(is_fallback=true 即表示未按日期筛)。⚠️ code 必须 A 股(6 位或带 sh/sz/bj 前缀)。⚠️ 机构版专属。
Inputs: code (required), date, limit. Returns: result
ashare_limit_upAInspect
短线打板:当日涨停个股,含涨停原因与资金面。用户问'今天哪些票涨停 / 涨停原因 / 封单多大 / 主力买了多少'用这个。mode 取值:auction 竞价涨停 —— 只留「09:25 定盘即封涨停」的票(一字板 / 竞价抢筹),打板族盘前最常看的一张表(竞价中摸过涨停但定盘前被砸开的不算);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。只读查询。
Inputs: date, mode. Returns: result
ashare_macroAInspect
宏观数据(GDP/CPI/PMI/LPR/国债收益率/财政)。用户问'宏观/经济数据/利率/LPR/CPI'用这个。⚠️ 要指数行情请用 ashare_quote 或 ashare_market_overview——本工具只给宏观指标。只读查询;按发布日历更新(未到发布日就没有新值)。
Inputs: names, region. Returns: result
ashare_margin_tradeAInspect
个股融资融券明细:融资余额 / 融资买入 / 融资偿还 / 融券余额 / 融券卖出 / 融券偿还。用户问'这只股票杠杆资金在加还是在撤/融资余额多少/两融数据'用这个。⚠️ code 必填(参数上不是 required,但不传只会得到一句明确说明、没有数据)。⚠️ 支持批量:code 可传逗号分隔(sh600667,sz000651),返回多行 —— 但不带逐只状态,缺了哪只要自己算。⚠️ date 留空 = 最近已披露交易日(两融数据 T+1 披露,当天查不到当天的);未披露的交易日会给出明确原因。⚠️ 与 ashare_fund 的关系:ashare_fund 一次给『资金 + 龙虎榜 + 大宗 + 两融』四块概览;本工具只给两融明细、字段更全 ⇒ 只看两融用本工具。⚠️ ETF 不在两融名单 —— 实测 sh510300 当日与历史日都恒回 NOT_DISCLOSED(文案说'尚未披露',实际是该标的没有两融),⛔ 别当延迟反复重试。
Inputs: code, date. Returns: result
ashare_market_klineAInspect
全市场单日K线 —— 一次请求返回某交易日全 A 股(5000+ 只)的日线。用户问'全市场当天行情/一次拿所有股票K线/每日增量更新/全A股数据'用这个。⚠️ 用途:替代「逐只循环 5000 次」——每天收盘后调 1 次即可拿到全市场,适合建本地行情库/做全市场扫描/每日批量更新。⚠️ 两种硬限定:① 仅专业版(¥99)与机构版(¥199) 可用(Standard 及以下会被拒);② 1 次调用折算 500 次额度(一次动 5000+ 只,量级远超单只接口)。⚠️ 另有独立日额度(专业版 200 / 机构版 1000 次/天),余量可查 ashare_usage。⚠️ 数据范围:仅 A 股股票(5572 只)、2016-08-08 起、不复权原始价;不含 ETF/可转债/指数/板块/港股/美股。最新数据到前一交易日(盘中当日数据不可用)。⚠️ 体积约 785 KB/次。字段 8 列:code time open high low close volume amount。
Inputs: date (required), codes, limit, offset. Returns: result
ashare_market_moodAInspect
市场情绪(破板率 + 赚钱效应 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 分钟)。⚠️ 机构版专属。
Inputs: date. Returns: result
ashare_market_overviewAInspect
市场级画像。type=summary 画像总评/trade 收盘/interval 多周期/technical 大盘技术/valuation 估值分位/rotation 风格轮动。用户问'今天市场怎么样/大盘环境/风格轮动/估值分位'用这个。⚠️ 涨跌家数(市场广度)请用 ashare_changedist:本工具的 updown 模块为 T-1 口径(返回里会标数据日期,可能滞后一个交易日),已不推荐用于回答'今天的涨跌家数'。· 免费工具(无需 Key)
Inputs: type. Returns: result
ashare_minuteAInspect
分时(当日 / 近 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)不可用。⚠️ 付费档实时(每次取此刻最新)。
Inputs: code (required), days. Returns: result
ashare_new_highAInspect
百日新高(按题材汇总):哪些题材今天在创百日新高。行字段 theme 题材名 / plate_code 板块代码 / raw 原始行(含家数);顶层 date / requested_date / is_fallback。用户问'今天哪些题材创新高/新高最多的是什么板块'用这个。⭐ 新高集中的题材 = 资金在做的主线;可与 ashare_sector(涨幅榜)对照。⚠️ 机构版专属。
Inputs: date, limit. Returns: result
ashare_newsAInspect
个股财经资讯。不传 id ⇒ 列表(标题 + 来源 + 时间);传 id ⇒ ⭐ 该条完整正文。用户问'这股票最近有什么新闻/消息面/这条新闻讲了什么'用这个。⭐ 正文是干净的 Markdown(已清洗 HTML 标签/图片占位/无效内链,保留股票代码关联如 茅台(sh600519),时间 YYYY-MM-DD HH:MM:SS)—— 可直接喂给大模型。⚠️ 列表只有最新 N 条(不提供翻页/历史)—— 要历史公告请用 ashare_notice。⚠️ 列表里的 url 指向动态页面,直接抓不到正文 ⇒ 要正文请用本工具的 id 参数。⚠️ 标的范围:A 股 / 港股(hk00700)/ 美股(usAAPL)/ 指数 / ETF / 板块 / 可转债。
Inputs: id, code, type, limit. Returns: result
ashare_northboundAInspect
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(港股通南下资金)不是一回事。⚠️ 机构版专属。
Inputs: date, limit. Returns: result
ashare_noticeAInspect
上市公司公告。不传 id ⇒ 列表(code 必填,支持 type / limit / offset 翻页,可回溯约 20 年);传 id ⇒ 该公告详情。用户问'公告/披露/半年度报告/年报在哪'用这个。⚠️ 详情有两种形态(实测约 9/10 给正文):多数短公告 ⇒ text=正文(直接读);少数长报告(如半年报 100+ 页)⇒ text 空、url=PDF 链接。⇒ 判据:先看 text,空则用 url。⚠️ 长报告的 PDF 请自行获取与解析(用你环境里的 PDF 能力)——我们只给链接,不代做解析。💡 要财务数字请用 ashare_finance(结构化,比从 100+ 页 PDF 里抠快得多)。⚠️ 支持港股 / 美股(hk00700 / usAAPL)—— 条数与回溯年限按市场而异。
Inputs: id, code, type, limit, +1 more. Returns: result
ashare_orderbookAInspect
五档盘口:买一买五 / 卖一卖五的价格与挂单量(手) + 现价/涨跌/数据时间。用户问'封单多少/买盘卖盘/盘口/挂单/支撑压力位/有没有大单托着'用这个。字段:b1_p/b1_vb5_p/b5_v 买档价格/量 · a1_p/a1_va5_p/a5_v 卖档。⚠️ 本工具是秒级快照(每 10 秒刷新),盘中才有意义(收盘后为当日最后快照)——要实时成交价用 ashare_quote(免费,字段少更轻)。⚠️ 量单位是手(×100 = 股);跌停买档全 0 / 涨停卖档全 0(正常)。
Inputs: code (required). Returns: result
ashare_playbooksAInspect
量化方法论库:25 条「怎么判断市场」的流程(含判据 / 阶段 / 实测证据)。用户问'怎么判断/交易方法/方法论/判断流程'用这个。⚠️ 这是方法论清单(帮助判断,非投资建议);要看可回测的策略用 ashare_strategies。⚠️ 可按分类或 id 取单条。⚠️ 付费工具(需 Key):Standard(¥29.9)及以上。
Inputs: id, category. Returns: result
ashare_profileAInspect
公司简况:上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 员工数 等。用户问'这家公司是做什么的/哪年上市/属于什么行业/董事长是谁'用这个。⚠️ 与 ashare_snapshot 的分工:snapshot 给估值/市值/股本(数字面),本工具给公司本身是谁(业务面)—— 问『做什么的』用本工具,问『贵不贵』用 snapshot。⚠️ 一次只查一只:本工具的 code 虽也支持逗号,但返回是扁平行、无逐只状态,无效码会被直接忽略(sh600519,sz999999 只会回 1 行,没有任何提示)⇒ 多只请用 ashare_profile_batch(专业版 100 只 / 不限量 150 只,逐只标明成功与否)。⚠️ 代码可传 sh600667 或裸 6 位 600667(内部会补前缀)。⚠️ 港股(hk00700)与板块(pt01801081)也能查,但字段会缺(港股无 listedDate;两通道口径不同)⇒ 以返回为准。⚠️ ETF / 指数别用本工具 —— 对 ETF 只有 code/name/listedDate 有值,business/industry/sector 数据源本来就没有(不是取数失败、也不是查不到这只 ETF);ETF 的完整信息(64 字段+基金经理+Top20 持仓)用 ashare_etf(kind='详情')。⚠️ 数据是静态档案,缓存 24 小时 —— 同一天重复问不会重复消耗配额。
Inputs: code (required). Returns: result
ashare_profile_batchAInspect
⭐ 批量公司简况:一次拿多只的上市日期 / 主营业务 / 所属行业 / 官网 / 注册资本 / 董事长 / 注册地址 / 联系方式,逐只标明成功与否。用户问'这几只都是做什么的/帮我按行业归类/筛出来的池子逐个看基本面/什么时候上市的'用这个。⚠️ 与 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)及以上,标准版不可用。
Inputs: codes (required). Returns: result
ashare_quoteAInspect
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)⭐ 美股三大指数也能查:道指 usDJI · 纳指 usIXIC · 标普500 usINX(不是 usSPX)。
Inputs: code (required). Returns: result
ashare_quote_batchAInspect
⭐ 批量行情:一次拿多只股票的行情,逐只标明成功与否。用户问'这几只现在什么价/扫一下我这个池子/一个行业现在的行情'用这个。⚠️ 与 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)及以上,标准版不可用。
Inputs: codes (required), end, count, start, +1 more. Returns: result
ashare_ratingAInspect
卖方机构评级:目标价(均值/最高/最低)+ 评级分布(买入/增持/中性/减持/卖出 + 覆盖机构数)+ 评级月度趋势。用户问'机构目标价多少/评级怎么样/多少家覆盖'时用(港股 / 美股)。⚠️ 只支持港股 / 美股(hk00700 / usAAPL);A 股请用 ashare_consensus(A 股没有卖方评级)。⚠️ codes 逗号多只,每只一段(用 tables 取全部段)。只读查询;专业版(¥99)及以上。
Inputs: codes (required). Returns: result
ashare_reportAInspect
卖方研报:不传 id ⇒ 列表(标题+机构+评级+类型);传 id ⇒ 研报全文(Markdown,含财务点评)。用户问'有没有研报/机构怎么说/这篇讲了什么'时用。A 股 / 港股都覆盖。⚠️ 列表单次最多 20 条(limit>20 会 422),翻页用 offset;「共 N 条」是历史总数;实测条数会有 +1 余量,⛔ 别按条数严格校验。⚠️ 没有时间范围参数;与 ashare_dehydrated(脱水摘要)互补。只读查询;专业版(¥99)及以上。
Inputs: id, code, limit, offset. Returns: result
ashare_reviewAInspect
短线复盘(涨停结构):看今天钱在哪些题材、梯队结构长什么样。用户问'今天什么题材最强 / 板块主线 / 连板梯队 / 几板几只 / 谁是反包'用这个。mode 取值:board 板块主线(默认)—— 题材板块 + limit_count 涨停数 + amount 板块成交额 + stocks 成分股代码;ladder 连板梯队 —— 按连板高度分组的涨停个股,含 board_name 所属板块 / market_cap 总市值 / tips(如「7天4板」)/ max_streak 区间最高连板 / limit_days 区间涨停天数 / is_repack 反包标记。⚠️ date 留空 = 实时;给 YYYY-MM-DD 取该交易日历史(须为真实交易日,非交易日返空)。⚠️ 实时天梯在收盘后约一个半小时(16:30 前后)才汇总齐,此前返回上一交易日(以 date 为准);北交所补入行带 partial: true。⚠️ 要涨停原因 / 封单 / 主力资金请用 ashare_limit_up。只读查询。
Inputs: date, mode. Returns: result
ashare_scannerAInspect
选股员(scanner Agent):把自然语言条件交给只读取数工具,返回候选池 + 证据引用 + 工具轨迹。适合『高ROE + 央企 + 近5日主力净流入』这类条件选股。
⚠️ BYOK:除 ASHARE_KEY 外还要设 ASHARE_LLM_KEY(模型 Key),模型 token 由客户自己付。
⚠️ 专业版(¥99)起;scanner 额度独立(2,000 次),不占数据 API 的 500k 总池。
⚠️ 只做条件选股,不做涨跌预测、不推荐买卖、不自动交易。
Inputs: q (required). Returns: result
ashare_scoreAInspect
股票评分(仅 A 股):基本面 / 技术 / 综合 / 资金 / 风险 五维,每维带周/月/季变动(0~100,越高越好)。用户问'这票几分/基本面评分/技术评分'时用。⭐ 返回已结构化:每维 value + chg_week/chg_month/chg_quarter,⛔ 不需要自己解析字符串。⚠️ chg_quarter 是本季累计(评分每季重置,通常等于 value),不是 0。⚠️ codes 逗号多只;date 可查历史但最早到 2026-04 下旬;仅 A 股。只读查询;专业版(¥99)及以上。
Inputs: codes (required), date. Returns: result
ashare_screenAInspect
选股(量化筛股),五种模式用 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。⭐ 可用字段 94 个(估值/行情/盈利/资产负债/现金流),先用 list=fields 拿清单(带中文名与单位),⛔ 不要凭猜填字段名 —— 写错会返回 422 并给出可用清单。⭐ 排序:sort=roe_ttm(降序)/ sort=-roe_ttm(升序);评分不能排序,要排行用 mode=rank。⚠️ 不知道某模式的取值 ⇒ 先传 list=true(返回该模式全部合法取值,带中文名与分组),⛔ 不要凭猜填(非法值会报错)。也可以直接 list=fields|boards|presets|metrics|pools|strategies|events。⚠️ 返回是排版好的表格;多标签/多策略会分多段返回 ⇒ 用 tables 取全部段。⭐ 要覆盖全市场:把 limit 设大即可一次取全(如 limit=9999,实测返回 5000+ 只),结果直接读,不需要分批。⭐ 响应里的 trace_id 是本次请求编号 —— 出问题把它给我们即可定位。⚠️ 付费工具(需 Key):Standard(¥29.9)及以上。
Inputs: end, date, list, mode, +13 more. Returns: result
ashare_searchAInspect
股票/基金/板块搜索(模糊词消歧)。用户只给名称时先用这个确认代码。⚠️ 本工具只返回代码与名称,不含行情——拿到代码后再调 ashare_quote / ashare_kline。⚠️ 覆盖 A 股 / 港股 / 美股(hk00700 港股 5 位、usAAPL 美股)。只读查询。
Inputs: q (required). Returns: result
ashare_sectorAInspect
板块行情榜(行业/概念/地域涨幅 + 领涨股 + 涨跌家数)。用户问'哪些板块在涨/板块轮动/行业热度'用这个。⚠️ 要板块估值分位请用 ashare_sector_valuation;要产业链上下游请用对应工具。只读查询;交易时段内更新。
Inputs: no named parameters. Returns: result
ashare_sector_valuationAInspect
板块估值(PE/PB/PS/PCF + 股息率 + 历史百分位)。用户问'某板块贵不贵/估值分位'用这个。⚠️ 要看板块涨跌幅与领涨股请用 ashare_sector——本工具只给估值指标。只读查询;板块代码形如 pt01801780(pt 前缀 + 8 位)。
Inputs: code (required). Returns: result
ashare_shareholderAInspect
股东研究:十大股东/股东户数(筹码集中度)/机构持仓。用户问'谁在持有/股东变化/筹码集中/机构持仓'用这个。⚠️ 要看机构整体在全市场买什么,请用 ashare_lhb 的机构榜。只读查询;股东户数按定期报告披露(季度级)。
Inputs: code (required). Returns: result
ashare_shareholder_batchAInspect
⭐ 批量股东研究:一次拿多只的十大股东 / 十大流通股东 / 股东户数统计,逐只标明成功与否。用户问'这几只谁在持有/股东户数变少了吗/股权集中不集中/机构在不在里面'用这个。⚠️ 与 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)及以上,标准版不可用。
Inputs: codes (required). Returns: result
ashare_snapshotAInspect
全字段行情画像:价格 + 盘口(买五卖五+委差)+ 估值(PE TTM/动/静 + PB)+ 市值(流通/总)+ 股本(流通/总)+ 打板(涨停/跌停价 + 量比 + 振幅 + 涨速)+ 标识(证券类型/股票状态/币种)+ 外盘/内盘。用户问'这股票估值怎么样/PE PB 多少/市值多大/股本多少/涨停价多少/涨停跌停板在哪'用这个。⚠️ 与 ashare_quote 的分工:quote 轻(8 字段)免费;本工具全(35 字段)· 付费——只要现价/涨跌用 ashare_quote 更轻(字段少、省上下文)。✅ 计费 = 次数:本工具 1 次拿全——要估值+市值+股本+涨停价多项时,比分别调 quote/valuation/orderbook 更省次数(3 次 → 1 次)。⚠️ 仅 A 股(港股/美股字段布局不同,用 ashare_quote)——传其他市场返回空,不返回错数据。⚠️ 单位:量=手 · 成交额=万元 · 市值=亿元 · 股本=股 · 比率=百分数。
Inputs: code (required). Returns: result
ashare_snapshot_batchAInspect
⭐ 批量全字段画像:一次拿多只股票的完整画像(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)及以上,标准版不可用。
Inputs: codes (required). Returns: result
ashare_stocksAInspect
全市场股票清单(一次拿全 A 股约 5576 只):代码 / 名称 / 市场 / 上市日期 / 行业 / 板块 / 发行价 / 注册资本。用户问『所有上市公司有哪些 / 全部股票代码 / 某行业有哪些公司』或需要建标的池时用这个。⚠️ 与 ashare_search 的分工:search 必须给关键词(查单只),本工具不需要关键词、直接给全量。⚠️ 务必带 limit:全量约 1 MB,会吃掉大量上下文;只要代码清单时用 market 收窄 + limit 分页。⚠️ 字段值为 '-' 表示数据源对该标的没有这项,不是取数失败。
Inputs: limit, market, offset, industry. Returns: result
ashare_strategiesAInspect
量化策略清单:返回可回测的全部策略(20 条单标的择时 + 9 条组合),含各自参数范围与说明,⭐ 并附「实测表现」(performance 字段)—— 在 800 只(沪深300+中证500)· 2019 年至今、含真实交易成本上跑出的真实成绩。verdict 分级:effective 实测有效 / neutral 一般 / weak 偏弱 / avoid 实测亏损;note 字段给避坑提示。⚠️ 无效的策略同样列出(便于避开常见陷阱,如高换手被成本吃光)。用户问'有哪些策略/哪些策略能赚/哪个策略坑/策略参数是什么'用这个。⚠️ 这是清单 + 实测摘要(不跑新计算);要真跑回测用 ashare_backtest。⚠️ 付费工具(需 Key):Standard(¥29.9)及以上。
Inputs: no named parameters. Returns: result
ashare_suspensionAInspect
停复牌清单(沪深 / 港股 / 美股):哪些票停牌、哪些复牌、停牌原因。用户问'今天哪些票停牌/复牌'时用。⚠️ 选股里过滤停牌股用这个 —— 因子/策略筛选不剔除停牌,拿到候选后与本清单交叉核对。⚠️ market 传中文(沪深/港股/美股)或 hs/hk/us。只读查询;标准版(¥29.9)及以上。
Inputs: market. Returns: result
ashare_tail_chaseAInspect
尾盘抢筹(全市场抢筹金额榜):尾盘资金在抢哪些票,约 292 只。行字段 code / name / fund_tag 标记(如「基金」)/ theme 所属题材 / change_pct 涨幅% / chase_amount 抢筹金额(元) / masked 代码与名称是否不显示 / raw 原始行。用户问'尾盘谁在被抢筹/尾盘资金流入哪些票'用这个。⚠️ 返回结果前 4 行代码与名称不显示(金额仍完整),带 masked=true 的行不代表可交易标的。⭐ 结果已按 sort 重排(默认 chase_amount 降序),第一条即当日抢筹最大。⚠️ 只提供最近交易日,不支持按日期回看。⚠️ 机构版专属。
Inputs: sort, limit. Returns: result
ashare_technicalAInspect
技术指标 MA/MACD/KDJ/RSI/BOLL。用户问'技术面/指标/金叉死叉/超买超卖'用这个。⚠️ 只要原始 K 线(不算指标)请用 ashare_kline——本工具返回已算好的指标值。只读查询;按日线收盘更新。
Inputs: code (required). Returns: result
ashare_technical_batchAInspect
⭐ 批量技术指标:一次拿多只的 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)及以上,标准版不可用。
Inputs: codes (required), date. Returns: result
ashare_usageAInspect
查自己的 API 用量与剩余额度(今日调用次数/剩余总量/到期时间/限流额度)。用户问'我的额度还剩多少/今天调了多少次'用这个。只读查询;需 API Key。
Inputs: no named parameters. Returns: result
ashare_watchlist_addBInspect
加自选股:把股票加入自选;code 可逗号分隔批量;重复添加幂等。
Inputs: code (required), note, tags, list_name. Returns: result
ashare_watchlist_listAInspect
查自选股:按 API Key 隔离,返回列表和标的;CRUD 不扣数据次数。
Inputs: no named parameters. Returns: result
ashare_watchlist_quotesCInspect
自选股批量行情:一次返回自选股最新行情。
Inputs: list_name. Returns: result
ashare_watchlist_removeCInspect
删自选股:从自选列表删除标的;code 可逗号分隔批量。
Inputs: code (required), list_name. Returns: result
ashare_wiki_searchAInspect
产品文档检索:字段单位 / 口径说明 / 常见误用 / 跨市场差异。⚠️ 不确定某字段的含义、单位、口径时先用这个查,比凭记忆回答准。渐进加载(省上下文):不带参返回目录;q=关键词 返回摘要(不含全文);slug=xxx 取该篇全文。建议路径:先看目录 → 再取需要的那一篇。免费工具(无需 Key),但每次调用仍计入用量与限流。
Inputs: q, lang, slug. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
China A-share market data for research, backtesting and AI agents via MCP.
China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.
China A-share & equity research MCP server (回声投研) for market quotes, filings, financials, fund flows, concepts & sentiment.
Mycel unified MCP gateway: China realtime data and 20 tool modules. API key required.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to Chinese mainland financial data including A-stock quotes, financial statements, industry analysis, and macroeconomics through 42 MCP tools, with automatic data source fallback and no API key required.46Apache 2.0

ApocData MCP Serverofficial
Alicense-Not gradedqualityCmaintenanceProvides 46 no-authentication A-share (Chinese stock market) data tools covering quotes, financials, capital flows, sectors, announcements, macro data, and more, callable from any MCP client without API keys.123 npm2Apache 2.0- Flicense-Not gradedqualityDmaintenanceMCP server that wraps SFC financial data API into 32 tools for comprehensive A-share market data, including real-time quotes, rankings, limit-up statistics, news, themes, financials, charts, research reports, and watchlists.-
- AlicenseAqualityDmaintenanceProvides access to Chinese A-share market financial data, including historical K-line, real-time quotes, financial statements, shareholder information, and technical indicators, via MCP protocol.1214 npm3MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.