EchoPai (回声投研)
● Activeio.github.echopai/echopai-mcp
China equity & quantitative research MCP server with 50 tools for reports, filings & sentiment.
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"echopai-mcp": {
"command": "npx",
"args": [
"-y",
"@echopai/mcp@1.0.1"
],
"env": {
"ECHOPAI_API_KEY": "<your ECHOPAI_API_KEY>"
}
}
}
}claude mcp add --env ECHOPAI_API_KEY='<your ECHOPAI_API_KEY>' --transport stdio echopai-mcp -- npx -y @echopai/mcp@1.0.1codex mcp add echopai-mcp --env ECHOPAI_API_KEY='<your ECHOPAI_API_KEY>' -- npx -y @echopai/mcp@1.0.1code --add-mcp '{"name":"echopai-mcp","type":"stdio","command":"npx","args":["-y","@echopai/mcp@1.0.1"],"env":{"ECHOPAI_API_KEY":"<your ECHOPAI_API_KEY>"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- ECHOPAI_API_KEYsecretEchoPai API key (eps_live_...) from https://echopai.com/go/app/agent
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- AI & Agents
- Version
- 1.0.1
- Registry
- active
- Published
- 11/15/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: EchoPai (回声投研) is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 7 days ago (Nov 15, 2026), 0 open issues.
- Official registry
- Active
- Published as io.github.echopai/echopai-mcp in the official MCP registry, version 1.0.1.
- Source
- Open source, MIT
- Public repository under the MIT licence, 1 stars, 0 forks.
- Runs
- Local package or hosted
- Ships as a local package (npm) that runs on your machine, and as a hosted endpoint at mcp.huishengpai.com that receives what your client sends it.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 02:09 UTCStatus history & uptime →The endpoint answered the MCP handshake as "EchoPai" and listed 76 tools. Answering since Nov 17, 2026.
Context cost ≈ 39k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 76 tools.
Tools (76)
lookup9 paramsSHAPE: `{matches: [{canonical_code, name_cn, ticker, exchange}], count}` — the row container is `matches`, not `items`, and the name field is `name_cn`. Resolve a Chinese name / A-share code / pinyin initials to canonical codes (e.g. SSE:600519). Use this first whenever the agent has a description but needs a canonical_code for downstream calls. AH dual-listing: when a company is listed on both A-share and HK (e.g. 工商银行 SSE:601398 / HK:01398), same-name matches rank A shares first before limit. Specify market=HK to search only Hong Kong. US is reserved.
Show parametersHide parameters
marketstringCN 和 HK 已接入,US 预留textstringrequiredSearch text: Chinese name (贵州茅台), code (600519), or pinyin (gzmt)limitintegerMax matches (1-30)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
security_reference8 params按规范代码查询证券参考详情,支持 A 股和港股,US 预留:ISIN、币种、每手股数、双柜台关联及身份核验状态。source 包含来源、版本、源日期、观测时间和最后成功检查时间;stale=null 表示未知。collection_eligible 仅为参考资格,不代表报价已启用。listing_status/trading_status=unknown 不可解释为正常交易。
Show parametersHide parameters
marketstringCN 和 HK 已接入,US 预留codestringrequired规范证券代码,例如 HK:00700 或 US:AAPL;由前缀确定市场,当前接入 CN 和 HK_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
market_calendar10 params按显式 market 查询交易日历,支持 CN(上交所日历)与 HK,US 预留。含完整交易日、半日市及休市日。最多 366 天,days 为含首尾日期的列表。calendar_known=false 或 is_open=null 表示未覆盖,不能按工作日推测。is_settlement_day=null 表示交收属性未知。CN 的 observed_at 为所查记录最近写入时间,HK 提供发布版本和最后成功检查时间。
Show parametersHide parameters
marketstringrequired日历支持 CN、HKmicstringCN 缺省 XSHG,HK 缺省 XHKGstartstringrequired起始日期 YYYY-MM-DD,包含当日endstringrequired结束日期 YYYY-MM-DD,包含当日,最多 366 天_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
market_indices7 params按显式 market 查询指数目录,支持 CN 和 HK,US 预留。港股包含:恒生、国企、恒生科技、红筹、综合指数。items 行标识为 canonical_code;registry_revision 为随代码维护的注册表版本,不能视为实时行情源日期。quote_enabled/chart_enabled=false 表示报价和图表未启用。
Show parametersHide parameters
marketstringrequiredCN 和 HK 已接入,US 预留_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
digest10 paramsOne-shot research digest for one security: views (PRIMARY), quote, valuation snapshot, market sentiment, supplementary news, ownership_events (30-day insider trades + buybacks, next-30-day lockups) and margin (~7 trading days). Margin is **T+1** — judge direction by `financing_net_buy_cny`, never gross `financing_buy_cny`. Separate buckets, not ranked against each other; partial failures go to `meta.partial_failures[]`. First call for 'what's going on with <stock>'. A-share returns all buckets; HK/US return only views + news. A+H: pass the A-share canonical.
Show parametersHide parameters
codestringrequiredCanonical code: A-share SSE:600519 | HK HK:00700 | US US:BABA. HK/US return only views+news. Use `lookup` first if you only have a name.views_since_daysintegerLookback for views bucket (days, 1-30; views feed caps at 30d). For longer research history use the `views` verb's from/to.news_hoursintegerLookback for news bucket (hours, default 24 — event horizon)limit_per_bucketintegerPer-bucket item cap (views/news). Quote/snapshot/sentiment aren't paginated here._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
search11 paramsStructured-first hybrid search across analyst views + news (views weighted higher). Three lanes — entity (company codes / names, analyst names), concept-graph hub (theme alias → concept → constituents & research), and full-text keyword matching (Chinese word-segmented) — fused with RRF. Deterministic & explainable: no vector kNN, no LLM rerank. Best for theme/concept queries: 'CPO' brings out 光模块/光通信/光芯片; '减肥药' brings out 创新药; '智驾' brings out 智能驾驶. Use `news` or `views` instead if you need strict time-window listing.
Show parametersHide parameters
qstringrequiredFree-text query (Chinese or English)typestringSearch scope (views weighted higher in 'all')modestringhybrid = entity + concept-graph + full-text fused; exact = keyword full-text onlyhoursintegerLookback window in hours; omit for no time limitlimitintegerMax items returned_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
quote8 paramsReal-time quote for 1-200 A-share securities (last price, volume, change %, bid/ask). For >200 codes use `scan`. HK codes are not supported; for an A+H company use the A-share canonical (SSE:601398, not HK:01398). Rows also carry `turnover_rate` (percent), `same_minute_volume_ratio` (cumulative shares through the snapshot minute divided by the five-session same-minute cumulative-share average; null if missing; not comparable to market turnover `volume_ratio`), `fundflow_latest` {trade_date, bar_time, main_net_cum, super_net_cum} (latest stored minute cumulative CNY; check its date/time), `industry` (Shenwan L1/L2), `top_concept` (strongest member concept now) and, for margin-list names, a T+1 `margin` block. Expect `industry` / `top_concept` to be absent on many rows — coverage, not failure: `top_concept` resolves for only a subset of A-shares and `industry` does not cover 北交所 (`BSE:*`). `top_concept` is **not** the limit-up LLM `leading_concept`, which is not served here. Live rows also expose `top_base_concept` `{id,name,kind:base,pct_change}` and `top_concept_status` / `top_base_concept_status` (ready, no_membership, no_snapshot, unavailable). The two layers rank independently; use kind=base for base detail. Historical rows carry neither current theme field nor their statuses. **In `pre_open` / `auction` sessions read the `auction` block `{status, prev_close, price, pct_change, volume, amount}`, not top-level `price` / `pct_change`.** `status` is `not_started` / `matched` / `no_match`; a top-level `pct_change` of 0 in that window is ambiguous — only `auction.status = matched` with `auction.pct_change = 0` is a flat auction. 盘前顶层 prev_close 与 auction.prev_close 对齐为今日基准,prev_close_date 为上一交易日;previous_close 为昨日实际收盘价。prev_close_basis 区分交易所参考价、事件调整价与未校准昨收,prev_close_provisional=true 时不可视为已确认除权参考价。未撮合的顶层 price 仅为基准展示,pct_change 为 null。 Suspended / frozen names report `no_match`; `auction.volume` / `amount` stay null until the 09:25 match (volume in shares). Read `mark
Show parametersHide parameters
codesarrayrequiredArray of canonical codes (e.g. ['SSE:600519', 'SZSE:000001'])include_l2booleanInclude L2 5-level order book (requires quote:l2 scope)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
market_status11 params查询 CN 或 HK 的交易阶段,读 session,具体阶段见 phase。at 必须带时区,US 预留。无参数保留原 A 股状态、日期与刷新标记。查询交易日请用 market_calendar。
Show parametersHide parameters
marketstringCN 和 HK 已接入,US 预留micstringISO 10383 交易场所代码,HK 省略时取 XHKG;未来 US 按场所选择日历atstring带时区时刻,例如 2026-12-24T12:08:30+08:00trading_profilestring证券、指数或经核验的午间扩展交易codestring证券或已注册指数规范代码;省略为市场规则模板_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
market_movers14 paramsA-share top-N movers from the live snapshot (or a past trading day via `date`). Sort keys: `pct` / `pct_asc` / `speed` / `amount` / `turnover` / `total_mv` / `main_net_in` / `main_net_in_asc`; rows with a null sort value land last in both directions. Downloads the full ~3 MB snapshot and ranks client-side — `scan` with `sort` + `limit` ranks server-side and is cheaper. Empty with a `note` during 09:00-09:14. Each row carries `industry` and `top_concept`; both are often missing — coverage, not failure (`top_concept` a subset of A-shares; `industry` excludes `BSE:*`), and `top_concept` is not the limit-up `leading_concept`, which is not served here. Live rows also expose `top_base_concept` `{id,name,kind:base,pct_change}` and `top_concept_status` / `top_base_concept_status` (ready, no_membership, no_snapshot, unavailable). The two layers rank independently; use kind=base for base detail. Historical rows carry neither current theme field nor their statuses. The snapshot includes ETFs: pass `security_type=stock` for a stock-only `amount` board. Historical `date` boards sort only by `pct` / `pct_asc` / `amount` / `turnover`, carry no `top_concept`, and cannot combine `concept_id`.
Show parametersHide parameters
sortstringSort field: pct / pct_asc / speed / amount / turnover / total_mv / main_net_in (主力净流入榜) / main_net_in_asc (净流出榜)topintegerTop N items (1-500, default 20)exchangestringNarrow to one exchange: SSE / SZSE / BSEincludestringactive = 排除 ST/退市(默认); all = 全集(含 ST + 退市 + 未知 status)security_typestringstock = 只看股票 / etf = 只看 ETF / all(默认)= 两者都要。成交额榜(sort=amount)不传 stock 会被货币 / 短融 ETF 占住头部。服务端在 top-N 截断前过滤。concept_idintegerRank inside one concept / industry instead of the whole market. Filtering happens server-side before ranking, so this is the concept's own leaderboard rather thconcept_kindstringDimension of `concept_id`: concept (themes, default) or industry (Shenwan). Ignored alone.datestringPast A-share trading day (YYYY-MM-DD) to rank instead of the live snapshot — that day's daily bars. Omit for today. Only pct / pct_asc / amount / turnover sort_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
market_digest8 paramsOne call for the whole board: session, 6 core indices, breadth + turnover, limit-up premium & ladder (with promotion rate), top concepts / industries and top 10 stocks by `pct_change` / `main_net_in`. Every list is `{items}`, fixed length — use the single verbs for longer lists. `mode` + `trade_date` say which day: before 09:15 or on a non-trading day it is the last session's close; 09:15–09:29 `top_pct_change` ranks the auction. Empty lists carry `empty_reason`; failed blocks are null + `meta.partial_failures`.
Show parametersHide parameters
scopestringScope for breadth and turnover (same as sentiment_overview)trade_datestringHistorical YYYY-MM-DD; live-only blocks then come back not_covered_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
auction11 paramsOpening call auction (集合竞价) as its own dataset — today or any past trading day. Items: `canonical_code`, `name`, `auction_price` (= the official open), `prev_close`, `pct_change` (points), `volume` (shares), `amount` (CNY). `stage`: `final` = settled result (after the 09:25 match; backfilled for history) / `live` = today 09:15–09:25 from the live snapshot — before 09:25 that is the INDICATIVE price, `volume`/`amount` null (nothing traded yet). Auction leaderboard: `sort=pct_change` + `limit` (`order=asc` for the weakest); watchlist: `codes`. Empty with a `note` on non-trading days or before the dataset starts. 竞价未匹配量 unmatched 为股,正买负卖;unmatched_as_of 是最后有效竞价观测的源时间(09:25 后冻结),历史未采集为 null。
Show parametersHide parameters
trade_datestringYYYY-MM-DD; omit for todaycodesstringComma-separated canonical codes (max 500); omit for the whole marketsortstringRanking key applied before limitorderstringdesc (default) or asclimitintegerMax rows after sorting_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
index_snapshot7 paramsReal-time snapshot for the 172 A-share indices with a live quote feed (e.g. 上证指数 SSE:000001, 深证成指 SZSE:399001, 创业板指 SZSE:399006, 科创50 SSE:000688, 北证50 BSE:899050): price, pct_change, amount, speed_3min per index, refreshed ~15s during market hours (last intraday snapshot outside trading hours). Pass `codes` to narrow to a subset; omit for all 172. Use this for 'how is the broad market doing right now' — `quote` covers individual stocks only. CSI-series indices (CSI:*) have no live feed and are not returned.
Show parametersHide parameters
codesarrayCanonical index codes to narrow the snapshot (e.g. ['SSE:000001', 'BSE:899050']); omit for all 172_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
global_index_snapshot8 paramsSnapshot for 30 global equity indices plus Hong Kong indices (e.g. 日经225 GIDX:NKY, 标普500 GIDX:SPX, 纳斯达克 GIDX:IXIC, 恒生指数 HKEX:HSI). A-share indices are `index_snapshot`. These markets span time zones — always read `data_tier`: `realtime` = trading now; `closed` / `warm` / `daily` / `stale_cache` = a previous close, never report as live; `unavailable` = no data. `is_stale` is true for everything except `realtime`; `meta.realtime_count` / `meta.closed_count` give the split. `market_trade_date` is each market's LOCAL trading day — never compare it with a Beijing date. `volume` null = not published.
Show parametersHide parameters
codesarrayCanonical codes to narrow the snapshot (e.g. ['GIDX:NKY', 'HKEX:HSI']); omit for all 30regionstringFilter by region; combine with `codes` to narrow further. Omit for all regions_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
etf_list11 paramsDirectory of A-share ETFs: manager, tracked index, tick size, daily limit band. Filter by `index_code` (`000300` or `SSE:000300`), `q` (name/ticker substring) or `asset_class`. For a fund's own numbers use `etf_show`. ⚠️ `asset_class` is only published for Shenzhen-listed funds — filtering by it drops every Shanghai one. ⚠️ `limit_pct` null = band unknown, not unbanded. `price_tick` is 0.001 (a tenth of the stock tick).
Show parametersHide parameters
index_codestringTracked index code, bare ('000300') or prefixed ('SSE:000300')qstringSubstring over Chinese name and tickerasset_classstringShenzhen-only classification; drops all Shanghai funds when setlimitintegerMax items (default 50)offsetintegerPagination offset_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
etf_show7 paramsOne ETF's profile plus its latest daily row: close, shares outstanding, unit NAV, premium/discount, estimated net creation. ⚠️ Two premium fields, not interchangeable: `premium_rate_same_day` only when the NAV date equals the trade date; `premium_rate_ref` falls back to the latest NAV (date in `premium_ref_nav_date`) — cross-border ETFs publish NAV late, so `ref` is not same-day. Both are ratios (0.012 = 1.2%), not percentage points. ⚠️ `accum_nav` is not on the same basis as `unit_nav` after a share conversion — do not compare or derive returns. `quality` / `inputs_mask` say which inputs were present; `latest` null = no row yet.
Show parametersHide parameters
codestringrequiredCanonical code, e.g. SSE:510300_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
etf_flows10 paramsRanks ETFs by estimated net creation/redemption in CNY over a 1/5/20 trading-day window. **An estimate** (`share change × that day's unit NAV`), not a reported flow, and **null is not 0**: uncomputable days (stale shares / NAV, share-conversion dates) are skipped — **read `valid_days` with the total**. ⚠️ Without `asset_class`, money-market ETFs dominate by one to two orders of magnitude; `asset_class=equity` fixes that but drops every Shanghai-listed fund.
Show parametersHide parameters
windowstringAccumulation window (default 1d)directionstringin = largest net creation (default), out = largest net redemptionasset_classstringShenzhen-only; use equity to keep money-market funds off the rankinglimitintegerMax items (default 50)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
views17 paramsKEY FIELDS (per item): `report.title` (nullable, only compact/full; index uses `title`), `source_label` (the institution; no `institution`), `ai_summary`, `content` (+ `content_truncated`), `primary_security.canonical_code` / `.name` / `.recommend_action`, `full_text_available`, `published_at`, `id` (for `report`). PRIMARY research source for stock judgement: analyst views and sell-side reports with research_entity_id attribution — prefer over `news`. Only ~10% of items have `full_text_available=true`, so an all-false page says nothing; pass `report_only=true` for the report stream, then `report` each. Default `fields=compact` (summary + ~300 chars); `fields=index` (~150 B/row) for a first pass over many rows, `full` only when needed. A+H: pass the A-share canonical for consolidated coverage.
Show parametersHide parameters
codestringFilter by security canonical_code (e.g. SSE:600519, HK:00700, US:AAPL)report_onlybooleantrue = only formal research reports, i.e. views whose full text is archived and readable via `report` (full_text_available). Omit for the mixed feed (~10% reporanalyststringAnalyst Chinese name (exact / fuzzy)institutionstringBroker / institution Chinese namesince_daysintegerLookback in days. ≤30 = rolling feed; >30 switches to range history (needs code / analyst / institution; Pro up to 365). `limit` applies newest-first within thefromstringHistory range start (China date YYYY-MM-DD). Range mode: needs a filter; Pro-only up to 365 days back.tostringHistory range end (inclusive, China date; defaults to today). Use with from.cursorstringOpaque snapshot pagination cursor from the previous response's `next_cursor` (freezes time window & sort anchor; preferred over `offset`).offsetintegerLegacy pagination offset (prefer `cursor` from `next_cursor` to avoid duplicates/skips on a live stream).limitintegerMax items per pagefieldsstringResponse shape: `index` (thinnest, ~150 B/row: id, published_at, source_label, primary security canonical_code/security_name/recommend_action, one-line headline_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
views_get7 paramsFetch one analyst view by id — the read half of list→read, for when a `views` list row is not enough. Returns that view's complete body (never truncated, regardless of the `fields` mode the list was fetched with), its AI summary, attached images, and tagged securities. Use it on any id from `views`; that includes the ~90% of the feed that are plain analyst opinion rather than archived reports. ⚠️ **This is not `report`.** `report` returns the parsed long-form text of an archived sell-side PDF and only works where `full_text_available=true`; this returns the view record itself and works on every id. If the list row already carries what you need, do not call this — a `views` page at `fields=full` has the body inline. Free, and takes no scope of its own.
Show parametersHide parameters
view_idstringrequiredView id from a `views` list row (items[].id)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
report10 paramsFetch the FULL research-report text behind a view (parsed long-form), for when the `views` summary is not enough. Only works on views where `full_text_available=true` (archived sell-side reports) — get those from `views --report-only`, do not guess a view_id. A 404 `no_full_text` means that one view is a plain opinion with no archived report; it does NOT mean the endpoint is unavailable or that no reports exist. Consumer pricing: 1 credit per PDF page, with no minimum or maximum document charge, per UTC day. Call format=quote first for free page_count and credit_cost; all subsequent outline/full reads share the same daily document charge. Unknown PDF page count blocks paid reads; unpaginated non-PDF documents cost 1. Two-step usage: default `format=outline` returns a few-KB heading map + total_chars + each heading's char_offset; then call `format=full` with `offset` (e.g. an outline char_offset) to read the body in pages — follow `next_offset` to page through large docs instead of pulling everything at once.
Show parametersHide parameters
view_idstringrequiredView id from `views --report-only` items[].id (full_text_available=true)formatstringquote=free page count and price; outline=heading map (default, charges document); full=body sliceoffsetintegerfull mode: start char offset (use an outline char_offset)max_charsintegerfull mode: max chars per page (hard cap 80000)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
news16 paramsSUPPLEMENTARY news / market briefs (short-horizon event stream) — use only to fill gaps not covered by `views`, the primary research source. Default `fields=compact` (title + ai_summary + ~300 chars); `full` only when needed. Flash news has `title: null` — read `display_title` (falls back to the first sentence), or pass `has_title=true` to drop untitled items. Modes: `code` (canonical, A-share / HK / US) → news mentioning that security; `query` (free text, all terms required, newest first); neither → recent feed. A canonical_code passed as `query` will not match — use `code`. A+H: pass the A-share canonical.
Show parametersHide parameters
codestringFilter by security canonical_code (e.g. SSE:600519, HK:00700). Takes precedence over `query`.querystringFree-text query (Chinese or English) matched against news content; omit for time-window feed. Terms are AND-ed — a document must contain every term — and resulthoursintegerRolling-feed lookback in hours (default 24 — much narrower than views). For longer history use from/to with code or query. The `limit` cap applies after this wifromstringHistory range start (China date YYYY-MM-DD). Range mode: needs code or query; Pro-only up to 365 days back.tostringHistory range end (inclusive, China date; defaults to today). Use with from.cursorstringOpaque snapshot pagination cursor from the previous response's `next_cursor` (freezes time window & sort anchor; preferred over `offset`).offsetintegerLegacy pagination offset (prefer `cursor` from `next_cursor` to avoid duplicates/skips on a live stream).limitintegerMax items per pagehas_titlebooleantrue = only items with a headline. Flash news has none (often ~40% of the feed), so pass this when filtering or summarising by headline; otherwise read `displayfieldsstringResponse shape: compact (default — title + ai_summary + first ~300 chars) or full (complete content)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
news_get7 paramsFetch one news item by id — the read half of list→read, for when a `news` list row is not enough. Returns that item's full content plus its tagged securities and source labels. ⚠️ Field `author` is the **byline entity — an outlet brand or a social account handle, never a reporter's name** (reporter bylines are split off at ingest), so do not present it as a person; `source_label` is the collector-level source. Remember `news` is the SUPPLEMENTARY stream: for forming an investment opinion prefer `views`. Free, and takes no scope of its own.
Show parametersHide parameters
news_idstringrequiredNews id from a `news` list row (items[].id)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
announcements_list15 params查询公告列表。传 q 按名称、代码或关键词检索,关键词结果按相关性排序,actual_window 的起止不代表连续覆盖;传 code 按单股查询;均省略则按发布时间倒序浏览全市场。用 offset 翻页,取 items[].id 调 announcements_detail。published_at 是实际可见时刻,disclosure_date 是披露日期。
Show parametersHide parameters
typestring分类 slug 过滤(如 annual_report / equity_change / restructuring)。marketstring市场过滤:CN(A股默认)/ HK(港股)/ US(美股预留)/ ALL(全市场)originalboolean是否返回公告原始字符(如港股繁体);默认 false 返回简体中文sincestringISO datetime 下限(published_at >= since,按实际可见时刻过滤,非预约披露日)。**时区后缀必填**:北京时间用 2026-08-05T00:00:00+08:00,UTC 用 2026-08-05T00:00:00Z。不带时区会被拒绝——A 股业务时间是北京时间,静默按 UTC 解释会limitintegerMax items (1-200, default 50)offsetintegerPagination offsetqstring混合检索词,如「新华医疗 回购」,与 code 互斥codestring单股公告历史,如 SSE:600519,与 q 互斥since_daysinteger仅单股或检索:单股默认 30 天,检索默认 90 天_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
announcements_detail14 paramsRead one announcement on demand (id from feed/stock/search `items[].id`) — an annual report is 200k+ chars, so do not expect the whole body. Financial question path: 1) `format=search` with `q` (space-separated, all terms must match) → hits with `section_path`, `scope_hint`, `table_index`; 2) `format=table` with that `table_index` → table + `unit` / `page` / `footnote`. Default `format=outline` gives headings (`char_offset`) and page anchors (short notices include full `content`); `format=full` pages via `offset` / `next_offset`. ⚠️ `scope_hint` is a hint: balances appear in both consolidated and parent-company notes, and `policy` hits are accounting policy text — say which you cite. `content_status`: `pending` = retry later, `unavailable` = read `pdf_url`. ⚠️ TIME: `published_at` is when the filing became visible; `disclosure_date` (next day 00:00) is never a publication time.
Show parametersHide parameters
announcement_idstringrequiredUUID (feed / stock / search 返回的 items[].id)formatstringoutline=目录(默认)|search=文内检索(需 q)|table=单张表(需 table_index)|full=正文分段qstringsearch:检索词,空格分隔、全部命中(如 "应收账款 账龄")limitintegersearch:命中条数上限table_indexintegertable:表序号(来自 search 命中或 outline 的 tables)offsetintegerfull:正文起始偏移(可用 outline 的 char_offset);table:起始数据行(next_row_offset)max_charsintegerfull / table:单次最大字符数(硬顶 80000)originalboolean是否返回公告原始字符(如港股繁体);默认 false 返回简体中文_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
sentiment_overview8 paramsAggregate sentiment for one trading day's latest minute: up/down/flat, limit-up/down, gt3/lt3 breadth, divergence index + label, MA20/50/200 breadth, 52w new highs/lows. Omit `trade_date` for today realtime. Also a `leverage` block (融资融券): judge by `exchanges.financing_net_buy_cny`, never gross `financing_buy_cny`; `structure.avg_maintenance_ratio` below 1.3 = forced-liquidation line. **The leverage block is T+1 — not the same day as the rest** — and each sub-block has its own `as_of`. `leverage` null = unavailable. Also a `turnover` block (current_turnover / predicted_total / delta_vs_yesterday, same numbers as `sentiment_turnover`'s header) — no second call needed for 成交额. `turnover.volume_trend` = `expanding` (放量) / `contracting` (缩量) / `flat` vs the previous two sessions at the same minute (`vs_prev_2d_ratio`, per-day `prev_sessions[]`); read it instead of comparing against yesterday's full-day total.
Show parametersHide parameters
scopestringUniverse filter: all_a | all_a_ex_st (default, ex-ST + ex-newly-listed) | st_only | main_board | star_market | chinext | bse. The four boards sum exactly to alltrade_datestringTrade date YYYY-MM-DD; omit for today realtime_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
sentiment_breadth10 paramsIntraday breadth time series for one trading day (240 minute bars; 13:00 excluded — ticks at the lunch-break boundary are too sparse). `trade_date` omitted = today (pre-open returns empty); explicit YYYY-MM-DD = historical replay. Returns per-minute rows of up/down/flat/limit_up/limit_down/breadth/divergence fields — full mode matches `sentiment_overview`; compact omits long summaries and extended breadth fields. Coverage reports source and returned time ranges. Budget trimming retains latest points, ascending.
Show parametersHide parameters
fieldsstring响应模式;REST/CLI 默认 full,MCP 默认 compact(导出除外)last_ninteger仅返回最近 N 个交易分钟点,午休不计入scopestringUniverse filter: all_a | all_a_ex_st (default, ex-ST + ex-newly-listed) | st_only | main_board | star_market | chinext | bse. The four boards sum exactly to alltrade_datestringTrade date YYYY-MM-DD; omit for today_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
sentiment_turnover9 paramsIntraday turnover time series with `current_turnover` / `predicted_total` / `delta_vs_yesterday` headline fields, plus `volume_trend` (`expanding` 放量 / `contracting` 缩量 / `flat`) and `vs_prev_2d_ratio` vs the previous two sessions at the same minute. `trade_date` omitted = today (pre-open returns nulls); explicit YYYY-MM-DD = historical. `days` (1-5) pulls that day + N-1 prior trading days for same-minute YoY comparison.
Show parametersHide parameters
scopestringUniverse filter: all_a | all_a_ex_st (default, ex-ST + ex-newly-listed) | st_only | main_board | star_market | chinext | bse. The four boards sum exactly to alltrade_datestringTrade date YYYY-MM-DD; omit for todaydaysintegertrade_date 当日 + 之前 days-1 天(1-5,默认 1)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
sentiment_pct_distribution6 paramsReal-time A-share market pct-change distribution: bucket counts at ≤-10% / -9% / ... / +10% / 涨停, plus universe total. Snapshot only — historical replay not yet exposed.
Show parametersHide parameters
_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
sentiment_premium7 paramsSHAPE: two curves `main[]` and `compare[]` (not `bars` / `items`), rows `{bar_time, avg_pct, stock_count}`, plus `main_pool_size` / `compare_pool_size`. Are yesterday's limit-up buyers making money today? Yesterday's limit-up pool (minus one-word boards and boards that broke and stayed broken), plotted minute by minute today as an **equal-weighted** average percent change; `compare` is the same curve one day earlier. ⚠️ Read `main_pool_size` / `compare_pool_size` with the curves — they tell a premium move from a population change. ⚠️ Equal-weighted, not cap-weighted, so not comparable to index returns. Series use 240 minute end labels (09:31-11:30, 13:01-15:00). Pool dates are trading days, resolved server-side. Empty `main` with a non-zero pool size = session not started. Optional scope filters both pools; omit it to preserve the legacy all_a basket. ETF is excluded.
Show parametersHide parameters
scopestringStock basket; all_a includes ST, all_a_ex_st excludes ST and newly listed stocks. Defaults to all_a for compatibility._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
hot12 params股票关注榜。source=research(默认)返回卖方研究提及榜数组,可按 date 或滚动 hours 查询;mention_count 为窗口内提及次数。按日期回溯先用 mode=dates 取 {dates},周一窗口含周末,提及次数不能直接跨日比较。榜中可含港股。历史从 2026-02-25 起,覆盖期内空榜表示无提及,请求失败返回 503;更早日期无覆盖。source=social 返回当前散户综合排行、排名变化及快照时间;score 为多榜加权分,仅提供最新快照。两榜衡量的人群不同,排名不能互相验证。旧调用 social_hot、trading_days 继续兼容。
Show parametersHide parameters
datestringTrading day YYYY-MM-DD (China time). Window = previous trading day's close 15:00 → that day's close 15:00; mention_count is every mention inside it, counted inhoursintegerRolling window in hours ending now (1-168, default 24). Ignored when `date` is given.limitinteger卖方研究排名返回条数(1–100,默认 20)。sourcestring榜单来源,默认 researchmodestring默认 ranking;dates 查询有卖方榜单的日期daysinteger仅 mode=dates 使用,回看 7–365 个自然日,默认 90_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_list11 paramsList concepts with a live snapshot (pct_change / index_value / up_count / down_count / limit_up_count / amount / speed_3min). Default sort pct_change desc; `order=asc` gives the bottom-N instead (e.g. today's worst concepts). All sort keys (`pct_change` / `amount` / `main_net_in` / `limit_up` / `speed` / `stock_count`) rank the whole universe before `limit`, so the result is a true top-N (or bottom-N); concepts missing the sort key always go last. Entry point for browsing; drill in with `concepts_show` / `concepts_bars`. Every item echoes `kind` (`concept` / `base` / `industry`) — pass it along with the id, since by-id verbs default to `kind=concept` and an industry id without it returns 404. During 09:00–09:14 values are the previous close (`note` says so).
Show parametersHide parameters
statusstringConcept status filtersortstringSort field: pct_change / amount / main_net_in / limit_up / stock_count / speedorderstringdesc (default) = top-N; asc = bottom-N, e.g. the concepts falling hardest todaylimitintegerMax items (1-1000, default 500)kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_snapshot8 paramsBulk live snapshot of all concepts. Use `codes` (comma-separated concept_id list) to filter; omit for the full set. Cheaper than `concepts_list` when only the live numbers are needed without joining meta. Percent-change fields are in **percentage points** (`8.94` = +8.94%), same convention as `quote`.
Show parametersHide parameters
codesstringComma-separated concept_id list (e.g. `1,2,3`); omit for all.kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_show10 paramsDetail for one concept: meta plus current member securities with latest snapshots. Use after `concepts_list`. Pass `kind=industry` for a Shenwan industry id — a dimension mismatch returns 404, same as an unknown id. Members carry `close` / `pct_change` plus `price` (identical to `close`, the name `quote` / `scan` use for the last price). The response echoes `kind`; carry it with the id. Members are ordered by `main_net_in` desc by default (who is drawing money in); change with `member_sort` / `member_order`.
Show parametersHide parameters
concept_idintegerrequiredConcept primary key (PG concepts.id)kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. Amember_sortstringOrder members by: main_net_in (default) / pct_change / amount / weight; members missing the key go lastmember_orderstringdesc (default) or asc_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_of10 params**Which themes does this stock belong to?** Inverse of `concepts_show`: returns a security's active concepts (id, name, today's percent change). Pass `code` (preferred; `lookup` first if you only have a name) or `query` (substring over name/ticker, may match several — read each `canonical_code`); at least one. ⚠️ A concept with null `name` and `pct_change` exists but has no snapshot yet. ⚠️ `kind` returns one dimension: `concept` (hot-theme library, default), `base` (base labels), or `industry` — carry the dimension with each id. ⚠️ An empty array means no recorded membership in this dimension. Use `concept_tags` for both layers, coverage states and currently active themes.
Show parametersHide parameters
codestringCanonical code, exact (e.g. SSE:600519). Preferred over `query` when resolved.querystringSubstring over security name or ticker (e.g. 宁德时代 / 300750). May match several.kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. AlimitintegerMax matched securities (1-20, default 10). Caps securities, not concepts per security._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concept_tags7 params查询股票当前热炒题材与完整基础概念标签,同时返回待确认、未同步、无已确认归属等状态。热炒活跃状态与长期基础归属分别返回;基础标签不等于当天上涨原因。
Show parametersHide parameters
codesstringrequired逗号分隔的规范证券代码,最多 200 个_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_alerts12 params板块异动。active 查看当前仍触发的信号(big_move 为绝对涨跌幅超过 3%,limit_up_cluster 要求至少 5 只成分股且至少 3 只涨停);history 查看曾经触发的事件(默认最近 24 小时)。历史支持 Unix 毫秒 from/to、rule 和 limit。行业仅触发 big_move。
Show parametersHide parameters
fromintegerUnix ms; default = now - 24htointegerUnix ms; default = nowrulestringFilter by alert rulelimitinteger仅 history,默认 500kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. Amodestring_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_bars11 params概念、行业或基础指数 K 线(链式等权,基点 1000)。daily 返回日线、市场宽度和 is_backfilled;minute 返回分钟终点标签,完整交易日 240 根,单次最多 7 天。沿用列表中的 kind 和 concept_id。
Show parametersHide parameters
concept_idintegerrequiredConcept primary keyfromstringrequiredInclusive start date YYYY-MM-DDtostringrequiredInclusive end date YYYY-MM-DDkindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. AintervalstringrequiredK 线周期_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_fundflow_minute9 paramsMinute-by-minute capital flow for a concept or industry, summed over its current active constituents — the same basis as `main_net_in` in `concepts list`. Same field semantics as the per-security `fundflow` verb: `*_cum` are running day totals (never sum across bars), `*_delta` is the per-bar change. Amounts are CNY, positive = net inflow. Each bar carries `covered_members`, how many constituents had data by that minute. Pass `kind=industry` when the id is a Shenwan industry. Use it to see whether a theme is being accumulated or distributed while it moves.
Show parametersHide parameters
concept_idintegerrequiredConcept primary keydatestringTrade date YYYY-MM-DD (default: today, Beijing time)kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_news9 paramsRecent news mentioning the concept name (ILIKE on news.title + content). Short-term implementation; long-term will switch to AI tagging. Requires `news:read` scope.
Show parametersHide parameters
concept_idintegerrequiredConcept primary keydaysintegerLookback window in days (1-365, default 30)limitintegerMax items (1-200, default 50)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
concepts_views8 paramsBroker views associated with a concept (concept_views × broker_views, ai_status=done), sorted by published_at desc. Primary research source for a theme. Requires `views:read` scope.
Show parametersHide parameters
concept_idintegerrequiredConcept primary keylimitintegerMax items (1-200, default 50)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
limit_up_pool9 paramsA-share limit-up pool for a trade date, per stock: first/last seal time, final pct, seal amount (CNY) / volume (lots), `max_seal_amount` + `max_seal_time` (the day's peak seal), `broken_count`, `consecutive_days` (连板数), `board_count_within`, one-word-board flag, status (limit_up / broken), board class. Read `max_seal_amount / seal_amount`: peak >> current = 封单被吃掉, ≈ 1 = 封单从来就薄. ⚠️ The peak has no history before 2026-08-25 (0 / null = not recorded — never substitute `seal_amount`). `broken_count` = 当日开板次数, debounced: counts breaks below the limit lasting ≥30 consecutive seconds after a genuine intraday seal (auction touches never count); kept after re-sealing. ⚠️ Our own measure — not comparable with terminals' 开板次数, not with the `broken_count` of `limit_up_summary`, and not across 2026-08-25 (older dates used a per-snapshot rule). 行内提供 pct_change(兼容 final_pct)、turnover_rate、amount、main_net_in、super_net_in,资金流为当日最新已存分钟累计元;metrics_trade_date、quote_as_of、fundflow_as_of 标明日期和源时间,缺测为 null,历史不混入今日数据。 Rows include same-day `reason` / `concept_tags` / `attributed_at`, preferring LLM `leading_concept` while keeping `graph_leading_concept`; attribution outages are explicit. `prev_trade_date` and nullable `resumed_after_suspension` distinguish recorded suspensions from data gaps. Sort: consecutive_days → board_count_within → seal_amount, desc. Pre-open fallback applies.
Show parametersHide parameters
trade_datestringISO date YYYY-MM-DD; omit for latest (pre-open fallback)includestringactive = 排除 ST/退市(默认); all = 全部include_brokenbooleantrue 时连炸板(status=broken)也一起返回;默认只返回当前封板 status=limit_up_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
limit_up_summary8 paramsLimit-up summary for a trade date: limit_up_count / broken_count + ever_broken_count / limit_down_count / max_height / ladder[{height, count}]. Two seal-break measures: `broken_count` = INSTANTANEOUS boards open right now (day high touched the limit, currently unsealed; auction touches included); `ever_broken_count` = CUMULATIVE 当日曾炸板家数 (sealed ≥9:30 then broke for ≥30 consecutive seconds, re-sealed included). ⚠️ Different populations, NOT nested — ever_broken_count can be lower than broken_count; never subtract them. '现在多少没封住' → broken_count; '今天封过又开过' → ever_broken_count. ⚠️ Our own measure, not comparable with terminals, and not across 2026-08-25 (rule change). Pre-open fallback applies.
Show parametersHide parameters
trade_datestringISO date YYYY-MM-DD; omit for latestincludestringactive = all_a_ex_st 口径(默认); all = all_a 口径_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
limit_up_promotion8 params晋级 / 断板追踪: every stock that closed sealed at the limit on the previous trading day, and what it did on `trade_date` — grouped by yesterday's height (highest first). Each level: `count` / `promoted` (sealed again, `today_height` = height+1) / `broken` (touched but unsealed) / `failed` (never reached the limit) / `promotion_rate` / `avg_pct_change` (that cohort's premium today). `members[]` carry `canonical_code`, `name`, `prev_height`, `outcome`, `today_height`, `pct_change`. The core sentiment-cycle read (昨日 3 板今天几家晋级、几家炸、几家跌停) that `max_height` cannot give. Intraday the outcome is live and can still change before the close.
Show parametersHide parameters
trade_datestringISO date YYYY-MM-DD; omit for today / latestincludestringactive = 排除 ST / 退市(默认); all = 全部_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
limit_up_history7 paramsDaily limit-up trend over the last N trading days: { trade_date, limit_up_count, broken_count, ever_broken_count, max_height }, oldest first. Same two seal-break measures as `limit_up_summary` (instantaneous end-of-day vs cumulative ≥30s breaks) — different populations, NOT nested; never subtract the series. ⚠️ The counting rule changed twice: values before mid-June 2026 include auction noise and days before 2026-08-25 count brief flicker — expect a STEP DOWN at 2026-08-25; segments are not comparable.
Show parametersHide parameters
daysintegerLookback window in trading days (1-250, default 30)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
limit_up_analysis8 paramsPer-stock limit-up attribution based only on published views and research. Returns leading_concept, concept_tags, nullable reason, attribution_status, empty_reason, evidence_refs and last_attempt_at. Incremental updates depend on service configuration; scheduled generation also maintains processing status. pending, processing, no_verified_catalyst, failed, budget_deferred and legacy_unknown are distinct. Inherited reasons retain their original generation time. Omit trade_date for the latest stored day; pass today explicitly for today's coverage. Optional as_of reads saved versions available at a historical instant without using later evidence.
Show parametersHide parameters
as_ofstringHistorical cutoff with timezone, no later than now; saved versions onlytrade_datestringISO date YYYY-MM-DD; omit for the latest *attributed* day (falls back to the previous day until today's first slot lands ~09:47 Beijing — pass today explicitly_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
chart13 paramsSingle-security K-line for **stocks and A-share indices** (daily by default; `minute=true` + one `date` for intraday). Multi-code: `bars_batch` (stocks only). Indices are detected from the code: `SSE:000xxx`, `SZSE:399xxx`, `BSE:899xxx`. ⚠️ The exchange prefix decides it — `SSE:000001` is the Shanghai Composite, `SZSE:000001` is 平安银行; pass `kind` to override. To measure a stock against its market, call twice over the same window (stock + index) — `index_snapshot` has no history. Index minute bars are capped at 7 calendar days. Indices add `pct_change` and have no turnover-rate or market-cap field.
Show parametersHide parameters
codestringrequiredSingle canonical code — stock (e.g. SSE:600519) or A-share index (e.g. SSE:000001, SZSE:399006, BSE:899050)kindstringOverride the stock/index guess made from the code. Omit unless the code is one the rule gets wrong — SSE:000xxx / SZSE:399xxx / BSE:899xxx are read as indices,daysintegerDaily lookback (ignored when from/to or minute mode are set)fromstringYYYY-MM-DD inclusive start (daily mode; overrides days)tostringYYYY-MM-DD inclusive end (daily mode; overrides days)minutebooleanSwitch to minute-level bars (requires date)datestringSingle trade date YYYY-MM-DD (minute mode)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
bars_batch11 paramsBatch K-line for multiple A-shares in one round-trip. Daily bars default to date desc; use order=asc for chronological calculations. Response sort echoes the date order. Daily: ≤100 codes × ≤1 yr; minute: ≤20 codes × ≤7 d. Envelope: `{items:[{canonical_code, bars}], errors:[{canonical_code, error_code, message}]}`. ⚠️ Read `errors[]` first: an unknown code lands there as `unknown_security`, while a real security with no trading in the window returns an empty `bars[]` — report that as no data, not a bad code.
Show parametersHide parameters
codesarrayrequiredCanonical codes (daily ≤100; minute ≤20)fromstringrequiredInclusive start date YYYY-MM-DDtostringrequiredInclusive end date YYYY-MM-DDorderstringDaily bar date order (default desc); minute bars are always ascendingminutebooleanMinute-level bars instead of daily (tighter caps apply)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
scan18 paramsFull-market real-time quote scan (~5800 A-share securities, ~3 MB unfiltered). Narrow server-side first: `sort` + `order` + `limit` return a real ranking (`sort=pct_change, order=desc, limit=50` = the day's 50 strongest in a few KB); `limit` without `sort` is an alphabetical sample, not a ranking. When rows are dropped the response carries `truncated: true` and `matched_total` (the pre-limit count) — `total` is only how many rows came back. The universe includes ETFs (`security_type` on every row); money-market ETFs dominate `sort=amount`, so pass `security_type=stock` for a stock-only board (filtered before sort/limit). `include_margin` attaches the T+1 margin block; `include_industry` attaches `industry` (Shenwan L1/L2) and `top_concept`. Both are often absent — coverage, not failure: `top_concept` resolves for only a subset of A-shares and `industry` does not cover `BSE:*`; `top_concept` is not the limit-up LLM `leading_concept`, which is not served here. Live rows also expose `top_base_concept` `{id,name,kind:base,pct_change}` and `top_concept_status` / `top_base_concept_status` (ready, no_membership, no_snapshot, unavailable). The two layers rank independently; use kind=base for base detail. Historical rows carry neither current theme field nor their statuses. **In `pre_open` / `auction` sessions read each row's `auction` block, not top-level `price` / `pct_change`** (same rules as `quote`: only `auction.status = matched` with `auction.pct_change = 0` is a flat auction; compute from `auction.prev_close`). Read `market_trade_date`, not `snapshot_at`, to decide whether a row is today's — a frozen feed keeps `snapshot_at` moving. `is_margin_target` is margin-list membership (T+1), not activity; the key is absent (never `false`) when the list cannot be loaded. `trade_date=YYYY-MM-DD` scans that past day's daily bars (see the parameter for allowed combinations). 竞价未匹配量 unmatched 为股,正买负卖;unmatched_as_of 是最后有效竞价观测的源时间(09:25 后冻结),历史未采集为 null。
Show parametersHide parameters
exchangestringFilter by exchange (omit for all)includestring`active` (default) drops ST / delisted / stale rows; `all` keeps them, flagged with `stale: true` and `stale_since`.security_typestring`stock` keeps only stocks, `etf` only ETFs, `all` (default) both. Money-market / short-bond ETFs dominate `sort=amount` unless you pass `stock`. Filtered beforesortstringServer-side ranking key, applied before `limit`; omit for `canonical_code` order. `margin_balance` / `margin_net_buy` turn `include_margin` on. Null sort valuesorderstringSort direction. Defaults to `desc` for numeric keys and `asc` for `canonical_code`. Ignored without `sort`.limitintegerKeep the first N rows **after** sorting (1-10000). Always pair with `sort` — an unsorted limit is an alphabetical sample. When rows are dropped: `truncated: truconcept_idintegerRestrict the scan to one concept's / industry's members. Applied **before** sort and limit, so `concept_id` + `sort=pct_change` + `limit=10` gives the top 10 moconcept_kindstringDimension of `concept_id`: concept (hot-theme library, default), base (base labels), or industry (Shenwan). Ignored alone.include_marginbooleanAttach the T+1 margin block (off by default, ~25% larger). `as_of` is normally the previous trading day; judge direction by `financing_net_buy_cny` (`financing_margin_targetbooleanKeep only margin-eligible securities (true) or only non-eligible (false); omit for both. Returns 503 if the list cannot be loaded.trade_datestringPast trading day (YYYY-MM-DD) to scan instead of the live snapshot — rows are that day's daily bars. Only `price` / `pct_change` / `amount` / `turnover_rate` /include_industrybooleanAttach `industry` (Shenwan L1/L2 `{l1:{id,name}, l2:{id,name}}`) and `top_concept` (`{id,name,pct_change}`, highest-moving member concept now; not the limit-up_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
technicals7 paramsKEY FIELDS (per item): `pos_in_52w.value` (0–1, plus `high_52w` / `low_52w` / `breakout_52w` / `breakdown_52w`), `consecutive_up.days` + `.pct_change`, `volume_spike.median_next_ret_pct` / `.avg_next_ret_pct` / `.winrate` / `.sample_size` (no `next_day_median_pct`), `overhead.supply_days` / `.traded_amount_ratio`. Every block has `observed_days` + `status` (`no_data` = insufficient history). End-of-day technicals for up to 50 A-shares on one server-side methodology. Use scan / limit_up_pool to find candidates, this to vet them. Read winrate only with sample_size, the Wilson interval and excess_winrate — samples are often single-digit.
Show parametersHide parameters
codesarrayrequiredCanonical codes, 1-50 (e.g. SZSE:300759)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
fundflow8 paramsMinute-by-minute capital flow for one A-share, split by order size: main force (super + big), super, big, normal, small, retail. Amounts are CNY; positive = net inflow. `*_cum` fields are running totals for the day — never sum them across bars; `*_delta` is the per-bar change and is what you sum. Shanghai and Shenzhen only, from 2026-05-26; intraday it runs to the latest completed minute. Use it to tell whether a move is carried by large orders or by retail, and to spot late-session accumulation a daily number hides.
Show parametersHide parameters
codestringrequiredSingle canonical code (e.g. SSE:600519)datestringTrade date YYYY-MM-DD (default: today, Beijing time)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
trades_minute9 params**Who is actually buying — from the trades themselves.** Per-minute (or 5/15/30/60-minute) aggregates over the raw trade feed for one A-share: buyer- vs seller-initiated volume, large-print counts, true VWAP. The self-verifiable counterpart to `fundflow` (the vendor's own classification) — the two routinely disagree. `buy_ratio` = buy_vol / (buy_vol + sell_vol); ⚠️ Neutral volume is deliberately excluded from the denominator. `vwap` is yuan per share. ⚠️ `big_count` / `big_amount` use a fixed 200,000-yuan-per-print line, meaningless on high-priced names (贵州茅台: 97 of 99 prints in one 5-minute bucket cleared it) — compare a stock with itself only; unrelated to fundflow tiers. ⚠️ `tick_count` counts the prints **we captured** (3-second snapshots), not the exchange's trade count. Omit `date` for the latest day that has data. History starts 2026-05-26; earlier = not covered.
Show parametersHide parameters
codestringrequiredCanonical code of one A-share security (e.g. SSE:600519)datestringTrading day YYYY-MM-DD (China time). Omit for the latest day that has data.intervalintegerBucket size in minutes: 1 / 5 / 15 / 30 / 60 (default 5)._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
trades_ticks14 params⚠️ **EXPERIMENTAL — may change or be withdrawn at any time.** Do not build automation on it or persist it as a system of record. Individual prints for one A-share on one trading day, in `seq` order with cursor paging — for inspecting a specific moment; for whole-session work use `trades_minute`. ⚠️ Not exchange tick data: one row is everything traded in a 3-second window, so to find large trades filter on `min_amount` — counting rows will not do it. ⚠️ `side` is inferred from bid/ask (`M` = neither). ⚠️ `seq` may have gaps (backfilled after the close). ⚠️ No 09:25 auction print — never take an open price here. Page with `after_seq` = previous `next_after_seq` until null (a day is ≤3 pages at the default limit). Retention 60 trading days (`retention_from`); coverage starts 2026-06-01.
Show parametersHide parameters
codestringrequiredCanonical code of one A-share security (e.g. SSE:600519)datestringTrading day YYYY-MM-DD (China time). Omit for the latest day that has data.after_seqintegerCursor: only prints with seq greater than this. Use the previous next_after_seq.limitintegerRows per page (1-2000, default 500).min_amountnumberKeep only prints reaching this turnover in yuan — the way to find large trades.sidestringB = buyer-initiated, S = seller-initiated, M = neither. Inferred from the book.fromstringEarliest print time HH:MM (China time), inclusive.tostringLatest print time HH:MM (China time), inclusive._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
margin_show10 paramsDaily margin-trading (融资融券) series for one A-share: financing balance / gross buy / repayment / net buy, short-sell and short balance (shares and CNY), total balance, day-over-day change. **T+1 — the latest row is normally the previous trading day** (in backtests visible_date = trade_date + 1). ⚠️ `financing_buy_cny` is GROSS (includes round-trips) — judge direction by `financing_net_buy_cny` only; short side likewise by the change in `short_balance_shares`. ⚠️ `null` = not published / not derivable (Shenzhen and Beijing publish no repayment), not zero. ⚠️ `financing_balance_chg_*` is versus `prev_trade_date` — check it is adjacent.
Show parametersHide parameters
codestringrequiredCanonical A-share code (e.g. SSE:600519)daysintegerLook-back window in calendar days (1-250, default 60). Ignored when from/to given.fromstringStart date YYYY-MM-DD. Must be given together with `to`.tostringEnd date YYYY-MM-DD. Must be given together with `from`._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
margin_market7 paramsMarket-wide margin-trading (融资融券) series, two arrays. `exchanges`: per-exchange daily summary (SSE / SZSE / BSE) — balances, gross buy, repayment, net buy, short-sell, `derived_fields`. `structure`: market-wide leverage metrics, most importantly `avg_maintenance_ratio` (margin-call pressure; below 1.3 is the forced-liquidation line), plus balance vs free-float cap, short-sell value, margin share of turnover, account counts and collateral value. **T+1**, and `structure` publishes later — the two arrays may not end on the same date; read each row's `trade_date`. Direction = `exchanges[].financing_net_buy_cny`; `structure[].financing_buy_cny` is gross.
Show parametersHide parameters
daysintegerLook-back window in calendar days (1-250, default 60)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
margin_movers9 paramsRanks A-shares by margin-trading activity for one trading day (default latest). Sort: `net_buy_desc` (default) / `net_buy_asc` / `balance_desc` / `balance_chg_pct_desc` / `balance_chg_pct_asc`. Ranking by gross buy is deliberately not offered (it would surface net-outflow names as leveraged buying). **T+1** — the ranked day is normally the previous trading day. `balance_chg_pct_*` is noisy on small balances — check `financing_balance_cny`.
Show parametersHide parameters
sortstringRanking key: net_buy_desc (default) / net_buy_asc / balance_desc / balance_chg_pct_desc / balance_chg_pct_asclimitintegerNumber of rows to return (1-200, default 30)trade_datestringYYYY-MM-DD. Defaults to the latest trading day present in the data._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
margin_collateral10 paramsDaily collateral-eligible holdings (担保券) series for one A-share: `collateral_shares`, `collateral_shares_chg`, `prev_collateral_shares`, `collateral_mv_cny`, `total_mv_cny`, `collateral_pct_of_total_mv` (collateral value as % of total cap, percentage points — a high and rising share means more of the float is exposed to forced liquidation). **T+1, published later than `margin_show`** (may lag by a day). Coverage is wider than the margin list, so presence here without `margin_show` is not a gap. `null` = not published, not zero.
Show parametersHide parameters
codestringrequiredCanonical A-share code (e.g. SSE:600519)daysintegerLook-back window in calendar days (1-250, default 60). Ignored when from/to given.fromstringStart date YYYY-MM-DD. Must be given together with `to`.tostringEnd date YYYY-MM-DD. Must be given together with `from`._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
margin_collateral_movers9 paramsRanks A-shares by collateral-eligible holdings (担保券) for one trading day (default latest). Default `pct_desc` = `collateral_pct_of_total_mv` (collateral value as % of total cap, percentage points) — how much of a name sits in margin accounts and is exposed to forced liquidation. Other keys: `pct_asc`, `shares_chg_desc` / `shares_chg_asc`, `mv_desc`. Rows with an unpublished ranking field are excluded, not zero. **T+1, published later than margin data** — may lag `margin_movers` by a day. ⚠️ Noisy on small caps — check `collateral_mv_cny`. Coverage is wider than the margin list.
Show parametersHide parameters
sortstringRanking key: pct_desc (default) / pct_asc / shares_chg_desc / shares_chg_asc / mv_desclimitintegerNumber of rows to return (1-200, default 30)trade_datestringYYYY-MM-DD. Defaults to the latest trading day present in the data._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
dragon_tiger_daily13 paramsOfficial dragon-tiger list (龙虎榜) for one trading day, ranked by top-five seats' net buying: brokerage branches, institutional seats (机构专用) and northbound desks. **Published the evening after the close — during trading hours it returns the PREVIOUS trading day**; always state the response's `trade_date`. Check `coverage` per exchange (`complete` / `complete_empty` / `pending` / `failed`) before concluding a name is absent. A name can appear once per qualifying reason (`reason_category`) — do not dedupe. ⚠️ `net_buy_cny` nets the top-five DISCLOSED seats only; not comparable with moneyflow. ⚠️ Totals aggregate each side's OWN list, whereas vendors aggregate over the UNION of both lists, so vendor totals run larger — reconcile on `seats[]`, not on totals, and do not report the gap as a data error. ⚠️ Shanghai (incl. STAR) discloses one side per seat: `sell_cny = null` on a buy-side seat means NOT DISCLOSED, not zero. Prefer the precomputed `institution_net_cny` / `has_northbound`. Amounts CNY, ratios percentage points.
Show parametersHide parameters
datestringTrading day YYYY-MM-DD. Omit for the latest day that has data (during trading hours that is the previous trading day).categorystringFilter by qualifying reason: deviation_up/deviation_down (daily move deviation), turnover, amplitude, three_day_deviation_up/down (3-day cumulative), consecutivinst_onlybooleanOnly rows whose BUY side contains an institutional seat (机构专用).northboundbooleanOnly rows where a northbound (沪深股通) seat appears on either side.kindstringSecurity kind; defaults to stock (B shares / funds / convertibles excluded).sortstringSort key and direction (default net_buy_desc): net_buy / pct_change / amount / buy_total / sell_total / institution_net, each _desc or _asc. Rows with no valuelimitintegerRows to return (1-500, default 200)._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
dragon_tiger_stock8 paramsOne security's dragon-tiger (龙虎榜) appearance history, newest first, each with its full buy/sell seat table — is the money institutional, northbound or retail-branch hot money, and do the same seats keep coming back. Caveats as `dragon_tiger_daily`: end-of-day data (the newest row is never today's flow); one row per qualifying reason; `net_buy_cny` covers the top-five disclosed seats only; totals aggregate each side's OWN list, smaller than vendor UNION totals — reconcile on `seats[]`; Shanghai `null` = not disclosed, not zero. Empty = not on the list in the visible window (depth follows plan tier). Amounts CNY, ratios percentage points.
Show parametersHide parameters
codestringrequiredCanonical A-share code (e.g. SZSE:000533)limitintegerNumber of past appearances to return (1-200, default 30)._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
dragon_tiger_seats11 paramsRanks brokerage branch seats (营业部) by dragon-tiger activity: appearances, cumulative buying, and how their picks opened the NEXT session. Counting is deduplicated by (day, exchange, security, seat). ⚠️ Read `win_rate_pct` with `win_samples` — small samples are noise (`min_appearances` gates win-rate sorting). ⚠️ 机构专用 and 沪/深股通专用 are shared placeholder names, not individual seats — excluded by default; request them explicitly and check `is_aggregate`. No per-seat NET figures (Shanghai discloses one side per seat).
Show parametersHide parameters
windowstringLook-back window (default 30d).seat_typestringRestrict to one seat kind. Omit for branches only — the meaningful leaderboard.min_appearancesintegerMinimum appearances to qualify (default 3). Also gates win-rate sample count when sorting by win rate.sortstringRanking key (default appearances_desc).limitintegerSeats to return (1-200, default 50)._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
dragon_tiger_seat9 paramsOne seat deduplicated dragon-tiger appearance history: which names it traded, on which side, for how much, and how each opened the next session. Deduplication and side semantics match `dragon_tiger_seats` — one row per (trading day, security, side), amounts are the seat OWN side only, and `null` means the exchange did not disclose that side rather than zero. Use it to check whether a name on today board is a seat regular before reading anything into a single appearance.
Show parametersHide parameters
namestringrequiredSeat name exactly as disclosed, e.g. 东方财富证券股份有限公司拉萨金融城南环路证券营业部windowstringLook-back window (default 30d).limitintegerRows to return (1-200, default 50)._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
financials_quote_snapshot8 paramsOne-call 14-field valuation snapshot for one A-share: PE / PE-TTM / PB / PS / PS-TTM, total/float/free share, total/circ market cap, turnover rate (raw & float), volume ratio, dividend yield (last-year & TTM). Computed in-house from raw market data rather than passed through from a vendor feed, and cross-checked against an independent reference. Use `date` to fetch a historical snapshot; omit for real-time.
Show parametersHide parameters
codestringrequiredCanonical A-share code (e.g. SSE:600519)datestringTrade date YYYY-MM-DD; omit for real-time snapshot_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
financials_pit8 paramsPoint-in-time financial indicators for one A-share at a given trade_date. Returns the latest report visible AS OF that date (announce_date ≤ date; conservative 90-day fallback when announce_date is missing). Designed for backtests / AI agents to avoid look-ahead bias. ~25 fields incl. EPS / BPS / ROE / margins / revenue / net-income / equity.
Show parametersHide parameters
codestringrequiredCanonical A-share codedatestringTrade date YYYY-MM-DD; defaults to today_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
financials_reports9 paramsLast N report-period snapshots for one A-share (~25 fields per period). Each item carries `announce_date` for visibility timing. Filter by `kind` to scope to Q1 / H1 / Q3 / annual / preliminary.
Show parametersHide parameters
codestringrequiredCanonical A-share codelimitintegerMax periods (1-100, default 12)kindstringFilter by report kind_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
financials_series11 paramsTime series of a single financial metric for one A-share across reporting periods. `metric` is an indicators-table field name (roe_simple / revenue / ni_parent / debt_asset_ratio / gross_margin / eps_basic, ~150 supported).
Show parametersHide parameters
codestringrequiredCanonical A-share codemetricstringrequiredIndicator field name (e.g. roe_simple, revenue, ni_parent)fromstringInclusive earliest report_datetostringInclusive latest report_datelimitintegerMax points (1-200, default 40)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
ownership_show10 paramsOwnership events for one A-share: recent insider holder trades (net shares/pct, increase/decrease counts), share repurchases (ongoing count, executed amount/shares, latest status) and upcoming lockup expirations (unlocking shares/pct, next date). Holder-trade / repurchase windows look back N days; lockups look forward. ⚠️ A repurchase price ceiling BELOW the current quote is almost certainly a restricted-share cancellation at grant price, not open-market support. ⚠️ `plan_expires_on` is usually null = UNKNOWN, not still valid — use `disclosed_days_ago`. T+1.
Show parametersHide parameters
codestringrequiredCanonical A-share code (e.g. SSE:600519)txn_daysintegerHolder-trade lookback window in days (1-180, default 30)repurchase_daysintegerRepurchase lookback window in days (1-180, default 30)lockup_daysintegerLockup forward window in days (1-180, default 30)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
ownership_lockups10 paramsScan upcoming share-lockup expirations across the whole A-share market for the next N days, sorted by unlock date then unlock pct desc. Forward-looking sell-pressure radar that digest can't provide (digest is single-code). Filter small unlocks with min_pct (percentage points of total shares); pass `codes` to restrict to a portfolio instead of the whole market.
Show parametersHide parameters
daysintegerForward window in days (1-90, default 30)min_pctnumberMinimum unlock pct of total shares (percentage points, default 0)codesstringComma-separated canonical codes (max 200) to filter a portfolio; omit to scan the whole marketlimitintegerMax rows (1-1000, default 200)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
calendar_reports8 paramsEarnings-report disclosure window for one A-share: when the next periodic report is booked (`next_report`), whether today is its booked disclosure date (`discloses_today`), and the most recent report actually filed (`latest_disclosed`). Per-period `status`: scheduled | due_today | awaiting_confirmation (booked date passed, actual date not confirmed yet — T+1 lag or deferral, NOT a missed filing) | disclosed | unscheduled. Always read `coverage` first: schedule_pending means the exchange has not published the next period's calendar yet (released only ~5 days before period end) — a normal blackout, NOT 'this company does not report'; unknown means the name is absent from the calendar. T+1 data.
Show parametersHide parameters
codestringrequiredCanonical A-share code (e.g. SSE:600519)periodsintegerHow many recent report periods to return (1-12, default 4)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
calendar_upcoming10 paramsScan A-shares whose periodic report is booked for disclosure in the next N days, sorted by booked date — the overnight-risk screen for earnings season. Pass `codes` (comma-separated) to narrow to a portfolio, `report_type` to restrict the period. Only names not yet confirmed as disclosed are returned and the window starts today, so `awaiting_confirmation` names (booked date already passed) are deliberately excluded. Note each period's calendar is published only ~5 days before period end, so scanning well ahead of that returns few or no rows.
Show parametersHide parameters
daysintegerForward window in days (1-90, default 7)codesstringComma-separated canonical codes (max 200) to filter a portfolio; omit to scan the whole marketreport_typestringRestrict to one report period typelimitintegerMax rows (1-1000, default 200)_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
events_upcoming16 paramsKEY FIELDS (per item): `event_kind` (not `kind`), `title`, `summary`, `expected_on` + `date_precision` + `window_end`, `entities[].entity_code` (the canonical code lives here), `entities[].role`, `importance` (1–5), `status`, `certainty`, `scope`. Forward catalyst calendar for the whole A-share market: earnings disclosures, lock-up expiries, buyback deadlines, dividends, IPOs, LPR, macro / policy calendar, major tech conferences, US earnings for A-share supply chains, and forward milestones from broker research and newswires. Answers what is scheduled, never what happened. Filter with `kinds` (prefix wildcards like `macro.*`), `scope`, `codes`, `importance_min`, `statuses`. Pass `precision=day` unless you handle `window_end` yourself. ⚠️ Only `date_precision = day` rows are pinned to a day; for week/month/quarter/half/year rows `expected_on` is the START of the window (`window_end` is the far edge) — never render it as the event date. ⚠️ `expired` does NOT mean it did not happen — the window closed without confirmation reaching us; `cancelled` means withdrawn. `certainty: confirmed` on a research-sourced row is not an exchange filing.
Show parametersHide parameters
daysintegerForward window in days (1-180, default 14). Ignored when date_to is given.date_fromstringWindow start YYYY-MM-DD (defaults to today)date_tostringWindow end YYYY-MM-DD. Span is capped at 180 days and clamped if longer.kindsstringComma-separated event_kind filter; prefix wildcards work, e.g. `earnings.disclosure,macro.*`. Kinds: earnings.disclosure, earnings.us_disclosure, ownership.lockscopestringFilter by subject scopecodesstringComma-separated canonical codes (max 200) to narrow to a portfolioimportance_minintegerMinimum importance (1-5, 5 highest — e.g. FOMC)precisionstring`day` = pinned to an actual day; `fuzzy` = period-only rows (`expected_on` is the window START). Omit for both; the two are disjoint. Pass `day` unless you handstatusesstringComma-separated status set; defaults to `scheduled,postponed` (the two open states). Add `occurred` / `expired` to see what already passed.limitintegerMax rows (1-1000, default 200). `total` is the true count in the window and is NOT capped by this; `truncated` flags that more exist._intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
events_timeline10 paramsKEY FIELDS (per row in `upcoming[]` / `past[]`): `event_kind` (not `kind`), `title`, `expected_on` + `date_precision` + `window_end`, `entities[].entity_code`, `importance`, `status`. One A-share security's dated events as two lists: `upcoming` (nearest first) and `past` (most recent first, within the look-back). `limit` applies to each list separately. ⚠️ Only `date_precision = day` rows are pinned to a day; for week/month/quarter/half/year rows `expected_on` is the START of the window (`window_end` is the far edge) — never render it as the event date. ⚠️ `expired` does NOT mean it did not happen — the window closed without confirmation reaching us; `cancelled` means withdrawn. `certainty: confirmed` on a research-sourced row is not an exchange filing.
Show parametersHide parameters
canonical_codestringrequiredCanonical A-share code (e.g. SSE:600519)past_daysintegerLook-back window in days (1-365, default 90). The library only retains 90 days of past events, so a longer look-back simply returns nothing extra.upcoming_daysintegerForward window in days (1-365, default 180)limitintegerMax rows PER LIST (1-500, default 100) — upcoming and past are capped separately_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
earnings15 paramsA 股业绩预告与快报。company 按 code 查最近若干报告期(默认 4 期),包括预告修订历史与自愿披露的快报;快报缺失很常见。recent 扫描最近披露的业绩预告(默认 7 天、200 条),支持按方向、报告类型、同比下限或股票组合筛选。预告方向取自预告类型,修订以完整历史为基准。
Show parametersHide parameters
daysintegerrecent 回看天数,默认 7directionstringFilter by forecast direction (derived from type, not from the percentage)report_typestringRestrict to one report period typemin_pctnumberMinimum YoY net-profit change (percentage points); also drops rows lacking percentage datacodesstringComma-separated canonical codes (max 200) to filter a portfoliolimitintegerrecent 返回条数上限,默认 200modestringrequiredcompany 单股报告期历史;recent 近期业绩预告codestringcompany 必填,如 SSE:600519periodsintegercompany 报告期数,默认 4_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
capabilities8 paramsPass `verb=<tool name>` to get that tool's RESPONSE FIELD LIST locally — no request, no credits; do this before writing a projection instead of guessing field names. Without `verb`: the API `spec_version` — NOT this CLI's version, never infer one from the other — plus a newest-first changelog of capability changes; call at session start or when a response shape surprises you. Free, unauthenticated.
Show parametersHide parameters
verbstringTool / verb name (e.g. `scan`, `technicals`, `views`) or a raw cliKey (`quote.scan`). Returns its response field list from the bundled contract, locally: no reqresponse_shapestring按 views/news 的返回模式查询字段契约;须同时提供 verb_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
whoami6 paramsWhat this API key can do: `kind` (user / partner / agent), `scopes`, rate limit, monthly quota, `cli_release` (latest / minimum_supported — is this build behind), `endpoints` (entry-point policy), and `operations.available` / `operations.unavailable` (with `missing_scopes_any` or `not_allowed_for_kind`). Call this **before concluding a capability does not exist** — a missing tool or a 403 is usually an ungranted scope. Advisory (server is the authority). Free, cached 5 minutes.
Show parametersHide parameters
_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
usage6 paramsThis key's credit usage for the current month: `used`, `base_cap`, `base_remaining`, `pack_remaining` (purchased top-ups, spent only after the base allowance runs out), `total_remaining`, plus a 6-month history in `monthly`. Use it to decide whether a wide sweep is affordable before starting one, and to tell a 429 that means 'out of credits' apart from one that means 'too fast' — the first will not clear by waiting. ⚠️ **Consumer keys only** (`kind=user`): partner and agent tokens are billed per contract and get 403 here — `whoami` reports quota for those instead. Checking usage is itself free and never cached.
Show parametersHide parameters
_intentstring用户原问题一句话,仅分析用,可留空_fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq_jqstringJMESPath,对 data 求值(写 items[*].id)_max_bytesinteger响应字节上限,默认约 50 KB_spillbooleantrue=全量落盘,只回摘要与取数地址_max_bytes_modestring正文超限处理,默认 truncate 保留前缀
read_guide3 params免费读取 EchoPai 的数据接入与盘面研究手册。空参数列出全部资料。guide 选资料,section 可填目录里的完整标题或唯一关键词(如盘前扫)。按 next_offset 续读。
Show parametersHide parameters
guidestringsectionstringoffsetinteger
report_issue4 params当实际结果与工具声明明显矛盾,或使用返回的游标、偏移量仍无法推进时,免费调用 report_issue 一次。正常空结果、预期权限限制无需提交;无需为复现再次执行付费查询。只写脱敏摘要,省略对话、原文与凭据。
Show parametersHide parameters
toolstringrequired发生问题的 EchoPai 工具名,如 reportexpectedstringrequired根据文档或工具定义预期的行为observedstringrequired实际观察到的现象,用短句概括request_idstring原调用返回的 request_id,如有则附上
Checked by Serverdex with a plain initialize + tools/list call to mcp.huishengpai.com/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 22, 2026- Stars
- 1
- Forks
- 0
- Last push
- Nov 15, 2026
- License
- MIT
JavaScriptai-agentchina-stocksclaudecursorechopaiequity-researchfinancemcpmcp-servermodel-context-protocolquantitative-research
From the README
EchoPai MCP Server · 回声投研 English · 简体中文 Turn any AI into an event-driven equity research analyst. Equip Claude, Cursor, VS Code, Gemini CLI, or any MCP-compatible agent with 50 real-time China equity (A-share) & quantitative research tools — full-text broker reports, individual analyst attribution, corporate filings, quantified sentiment cycles, and limit-up analytics, with traceable citations on every answer. This repository provides a complete Node.js MCP Server built on @modelcontextprotocol/sdk and zod (src/index.js, src/tools.js, src/client.js) wrapping EchoPai's Open Platform REST APIs, alongside a hosted Streamable HTTP endpoint (https://mcp.huishengpai.com/mcp) for zero-install OAuth setup. Official Portal Matrix Why EchoPai MCP? Most open-source stock MCP servers only wrap basic price quotes or K-line endpoints. EchoPai connects your AI to institutional-grade event-driven research infrastructure: What It Looks Like in Action Once connected, simply ask complex research questions in natural language.…
Read the full README on GitHub →Remotes
- streamable-http
https://mcp.huishengpai.com/mcp
Alternatives to EchoPai (回声投研)
All EchoPai (回声投研) alternatives →Best AI & Agents servers →The most-starred AI & Agents servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Ruflo | 81,994 | Nov 2026 | Local / not checked |
| Claude Flow | 81,985 | Nov 2026 | Local / not checked |
| CodeBurn | 11,880 | Nov 2026 | Local / not checked |
| Kaneo | 9,825 | Nov 2026 | Local / not checked |
| Ha MCP | 7,958 | Nov 2026 | Local / not checked |
EchoPai (回声投研): questions people ask
- Is EchoPai (回声投研) a remote or a local MCP server?
- According to its entry in the official MCP registry, EchoPai (回声投研) ships as a hosted endpoint (streamable-http) that your client connects to by URL and as a local package (npm) that your client starts on your machine. Use the hosted endpoint when your client supports Streamable HTTP; use the package when you want it to run locally.
- Does EchoPai (回声投研) need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is EchoPai (回声投研) safe to use?
- Looks healthy: EchoPai (回声投研) is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Local package or hosted; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is EchoPai (回声投研) still maintained?
- Active: the repository's last commit 7 days ago. Last push Nov 15, 2026, 1 GitHub stars, MIT licence. Read from GitHub on Nov 22, 2026.
- What tools does EchoPai (回声投研) expose?
- 76 tools as listed by the server itself during the live check, including lookup, security_reference, market_calendar, market_indices, digest. The full list with parameters is in the Live check section above.
- How do I add EchoPai (回声投研) to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More AI & Agents servers
Browse all AI & Agents →EduBase MCP
EduBase
Official EduBase MCP server: training, exams, competencies and results from your AI assistant
Sealed
edwardyen724-g
Per-call paid skills for AI agents, run server-side: inputs in, outputs back. The body never ships.
Efaimo
efaimo-ai
Read-only tools that grade an Agent Skill and measure its context-window token cost
Dedicated Mac Mini AI Bot Setup
eibrahim
Read-only Mac mini AI operator setup offer with queue, pricing, and buyer-route tools.
Nucleus
eidetic-works
Persistent memory for AI agents — shared .brain across Claude Code, Cursor & Codex
Ejentum MCP
ejentum
Reasoning, code, anti-deception, memory harness MCP tools. Stdio or HTTPS api.ejentum.com/mcp
Add the badge to your site
Show visitors that EchoPai (回声投研) is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-echopai-echopai-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="EchoPai (回声投研) — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-echopai-echopai-mcp?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-echopai-echopai-mcp) [](https://serverdex.io/install/vscode/io-github-echopai-echopai-mcp) [](https://serverdex.io/install/claude-code/io-github-echopai-echopai-mcp)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-echopai-echopai-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-echopai-echopai-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-echopai-echopai-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).