EchoPai (回声投研)

● Active

io.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.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

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>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env ECHOPAI_API_KEY='<your ECHOPAI_API_KEY>' --transport stdio echopai-mcp -- npx -y @echopai/mcp@1.0.1
OpenAI Codex CLI
codex mcp add echopai-mcp --env ECHOPAI_API_KEY='<your ECHOPAI_API_KEY>' -- npx -y @echopai/mcp@1.0.1
VS Code
code --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.

Environment variables
  • 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
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks 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 →
● Working953 msprotocol 2025-06-18v4.0.1toolsresources

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 params

    SHAPE: `{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 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 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 parameters
    • marketstringrequired日历支持 CN、HK
    • micstringCN 缺省 XSHG,HK 缺省 XHKG
    • startstringrequired起始日期 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 parameters
    • marketstringrequiredCN 和 HK 已接入,US 预留
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • digest10 params

    One-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 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 params

    Structured-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 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 only
    • hoursintegerLookback window in hours; omit for no time limit
    • limitintegerMax items returned
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • quote8 params

    Real-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 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 parameters
    • marketstringCN 和 HK 已接入,US 预留
    • micstringISO 10383 交易场所代码,HK 省略时取 XHKG;未来 US 按场所选择日历
    • atstring带时区时刻,例如 2026-12-24T12:08:30+08:00
    • trading_profilestring证券、指数或经核验的午间扩展交易
    • codestring证券或已注册指数规范代码;省略为市场规则模板
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • market_movers14 params

    A-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 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 / BSE
    • includestringactive = 排除 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 th
    • concept_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 params

    One 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 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 params

    Opening 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 parameters
    • trade_datestringYYYY-MM-DD; omit for today
    • codesstringComma-separated canonical codes (max 500); omit for the whole market
    • sortstringRanking key applied before limit
    • orderstringdesc (default) or asc
    • limitintegerMax rows after sorting
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • index_snapshot7 params

    Real-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 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 params

    Snapshot 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 parameters
    • codesarrayCanonical codes to narrow the snapshot (e.g. ['GIDX:NKY', 'HKEX:HSI']); omit for all 30
    • regionstringFilter 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 params

    Directory 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 parameters
    • index_codestringTracked index code, bare ('000300') or prefixed ('SSE:000300')
    • qstringSubstring over Chinese name and ticker
    • asset_classstringShenzhen-only classification; drops all Shanghai funds when set
    • limitintegerMax 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 params

    One 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 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 params

    Ranks 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 parameters
    • windowstringAccumulation window (default 1d)
    • directionstringin = largest net creation (default), out = largest net redemption
    • asset_classstringShenzhen-only; use equity to keep money-market funds off the ranking
    • limitintegerMax items (default 50)
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • views17 params

    KEY 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 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% repor
    • analyststringAnalyst Chinese name (exact / fuzzy)
    • institutionstringBroker / institution Chinese name
    • since_daysintegerLookback in days. ≤30 = rolling feed; >30 switches to range history (needs code / analyst / institution; Pro up to 365). `limit` applies newest-first within the
    • fromstringHistory 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 page
    • fieldsstringResponse 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 params

    Fetch 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 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 params

    Fetch 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 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 slice
    • offsetintegerfull 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 params

    SUPPLEMENTARY 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 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 result
    • hoursintegerRolling-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 wi
    • fromstringHistory 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 page
    • has_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 `display
    • fieldsstringResponse 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 params

    Fetch 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 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 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 offset
    • qstring混合检索词,如「新华医疗 回购」,与 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 params

    Read 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 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 params

    Aggregate 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 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 all
    • trade_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 params

    Intraday 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 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 all
    • trade_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 params

    Intraday 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 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 all
    • trade_datestringTrade date YYYY-MM-DD; omit for today
    • daysintegertrade_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 params

    Real-time A-share market pct-change distribution: bucket counts at ≤-10% / -9% / ... / +10% / 涨停, plus universe total. Snapshot only — historical replay not yet exposed.

    Show parameters
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • sentiment_premium7 params

    SHAPE: 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 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 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 in
    • hoursintegerRolling window in hours ending now (1-168, default 24). Ignored when `date` is given.
    • limitinteger卖方研究排名返回条数(1–100,默认 20)。
    • sourcestring榜单来源,默认 research
    • modestring默认 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 params

    List 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 parameters
    • statusstringConcept status filter
    • sortstringSort field: pct_change / amount / main_net_in / limit_up / stock_count / speed
    • orderstringdesc (default) = top-N; asc = bottom-N, e.g. the concepts falling hardest today
    • limitintegerMax 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 params

    Bulk 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 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 params

    Detail 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 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. A
    • member_sortstringOrder members by: main_net_in (default) / pct_change / amount / weight; members missing the key go last
    • member_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 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. A
    • limitintegerMax 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 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 parameters
    • fromintegerUnix ms; default = now - 24h
    • tointegerUnix ms; default = now
    • rulestringFilter by alert rule
    • limitinteger仅 history,默认 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
    • modestring
    • _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 parameters
    • concept_idintegerrequiredConcept primary key
    • fromstringrequiredInclusive start date YYYY-MM-DD
    • tostringrequiredInclusive end date YYYY-MM-DD
    • kindstringDimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A
    • intervalstringrequiredK 线周期
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • concepts_fundflow_minute9 params

    Minute-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 parameters
    • concept_idintegerrequiredConcept primary key
    • datestringTrade 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 params

    Recent 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 parameters
    • concept_idintegerrequiredConcept primary key
    • daysintegerLookback 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 params

    Broker 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 parameters
    • concept_idintegerrequiredConcept primary key
    • limitintegerMax 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 params

    A-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 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 params

    Limit-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 parameters
    • trade_datestringISO date YYYY-MM-DD; omit for latest
    • includestringactive = 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 parameters
    • trade_datestringISO date YYYY-MM-DD; omit for today / latest
    • includestringactive = 排除 ST / 退市(默认); all = 全部
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • limit_up_history7 params

    Daily 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 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 params

    Per-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 parameters
    • as_ofstringHistorical cutoff with timezone, no later than now; saved versions only
    • trade_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 params

    Single-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 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 params

    Batch 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 parameters
    • codesarrayrequiredCanonical codes (daily ≤100; minute ≤20)
    • fromstringrequiredInclusive start date YYYY-MM-DD
    • tostringrequiredInclusive end date YYYY-MM-DD
    • orderstringDaily bar date order (default desc); minute bars are always ascending
    • minutebooleanMinute-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 params

    Full-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 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 before
    • sortstringServer-side ranking key, applied before `limit`; omit for `canonical_code` order. `margin_balance` / `margin_net_buy` turn `include_margin` on. Null sort values
    • orderstringSort 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: tru
    • concept_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 mo
    • concept_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 params

    KEY 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 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 params

    Minute-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 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 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 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 params

    Daily 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 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 params

    Market-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 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 params

    Ranks 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 parameters
    • sortstringRanking key: net_buy_desc (default) / net_buy_asc / balance_desc / balance_chg_pct_desc / balance_chg_pct_asc
    • limitintegerNumber 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 params

    Daily 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 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 params

    Ranks 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 parameters
    • sortstringRanking key: pct_desc (default) / pct_asc / shares_chg_desc / shares_chg_asc / mv_desc
    • limitintegerNumber 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 params

    Official 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 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), consecutiv
    • inst_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 value
    • limitintegerRows 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 params

    One 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 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 params

    Ranks 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 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 params

    One 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 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 params

    One-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 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 params

    Point-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 parameters
    • codestringrequiredCanonical A-share code
    • datestringTrade 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 params

    Last 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 parameters
    • codestringrequiredCanonical A-share code
    • limitintegerMax 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 params

    Time 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 parameters
    • codestringrequiredCanonical A-share code
    • metricstringrequiredIndicator field name (e.g. roe_simple, revenue, ni_parent)
    • fromstringInclusive earliest report_date
    • tostringInclusive latest report_date
    • limitintegerMax 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 params

    Ownership 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 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 params

    Scan 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 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 market
    • limitintegerMax 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 params

    Earnings-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 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 params

    Scan 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 parameters
    • daysintegerForward window in days (1-90, default 7)
    • codesstringComma-separated canonical codes (max 200) to filter a portfolio; omit to scan the whole market
    • report_typestringRestrict to one report period type
    • limitintegerMax 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 params

    KEY 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 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.lock
    • scopestringFilter by subject scope
    • codesstringComma-separated canonical codes (max 200) to narrow to a portfolio
    • importance_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 hand
    • statusesstringComma-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 params

    KEY 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 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 params

    A 股业绩预告与快报。company 按 code 查最近若干报告期(默认 4 期),包括预告修订历史与自愿披露的快报;快报缺失很常见。recent 扫描最近披露的业绩预告(默认 7 天、200 条),支持按方向、报告类型、同比下限或股票组合筛选。预告方向取自预告类型,修订以完整历史为基准。

    Show parameters
    • daysintegerrecent 回看天数,默认 7
    • directionstringFilter by forecast direction (derived from type, not from the percentage)
    • report_typestringRestrict to one report period type
    • min_pctnumberMinimum YoY net-profit change (percentage points); also drops rows lacking percentage data
    • codesstringComma-separated canonical codes (max 200) to filter a portfolio
    • limitintegerrecent 返回条数上限,默认 200
    • modestringrequiredcompany 单股报告期历史;recent 近期业绩预告
    • codestringcompany 必填,如 SSE:600519
    • periodsintegercompany 报告期数,默认 4
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • capabilities8 params

    Pass `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 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 req
    • response_shapestring按 views/news 的返回模式查询字段契约;须同时提供 verb
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • whoami6 params

    What 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 parameters
    • _intentstring用户原问题一句话,仅分析用,可留空
    • _fieldsstring逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq
    • _jqstringJMESPath,对 data 求值(写 items[*].id)
    • _max_bytesinteger响应字节上限,默认约 50 KB
    • _spillbooleantrue=全量落盘,只回摘要与取数地址
    • _max_bytes_modestring正文超限处理,默认 truncate 保留前缀
  • usage6 params

    This 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 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 parameters
    • guidestring
    • sectionstring
    • offsetinteger
  • report_issue4 params

    当实际结果与工具声明明显矛盾,或使用返回的游标、偏移量仍无法推进时,免费调用 report_issue 一次。正常空结果、预期权限限制无需提交;无需为复现再次执行付费查询。只写脱敏摘要,省略对话、原文与凭据。

    Show parameters
    • toolstringrequired发生问题的 EchoPai 工具名,如 report
    • expectedstringrequired根据文档或工具定义预期的行为
    • 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-httphttps://mcp.huishengpai.com/mcp

The most-starred AI & Agents servers in the index, with their live-check result.

ServerStarsLast pushLive check
Ruflo81,994Nov 2026Local / not checked
Claude Flow81,985Nov 2026Local / not checked
CodeBurn11,880Nov 2026Local / not checked
Kaneo9,825Nov 2026Local / not checked
Ha MCP7,958Nov 2026Local / 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.
Browse all AI & Agents →

Add the badge to your site

Show visitors that EchoPai (回声投研) is listed here — it’s also the link we check for a free listing.

EchoPai (回声投研) — listed on Serverdex

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

[![EchoPai (回声投研) — listed on Serverdex](https://serverdex.io/brand/badge.svg)](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.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-echopai-echopai-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-echopai-echopai-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](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).