EchoPai (回声投研)
REMOTE · MCP.HUISHENGPAI.COM · 2 COMPONENTS
China equity & quantitative research MCP server with 50 tools for reports, filings & sentiment.
Available components
Last scanned (15 hours ago)
Scores higher than 61% of remote servers
Reachable. Last reached 21 Nov 2026.
Category Finance and Payments
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security89
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability53
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 33003 tokens (~434/item across 76 items; 76 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management4
- Stability check failed: schema churn in the 5 days we've observed: 10 tool removals, 0 breaking changes, 0 auth/transport breaks, 4 additions. See how to fix → Fail
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 99% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 76 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 77 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (13)
- TLS certificate
- Authorization
- HTTPS
- HSTS header
- DNSSEC
- Transport
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this hosted endpoint (2)
- Supply Chain SecurityScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
- Provenance & TransparencyScored on package channels only. This is a hosted endpoint, so there is nothing to install or inspect.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 +37
- Stability: unverified → fail ▼ security
- Authorization: unverified → pass ▲ security
- Injection markers: unverified → pass ▲ security
- Tool coverage: unverified → 100 ▲ functional
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 20 Nov 26 −38
- Stability: 0.10 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list. functional
- This server's schema is too large to store in full, so we cannot compare its tools day to day functional
- 19 Nov 26 +1
- “views” added an optional parameter “cursor” cosmetic
- “announcements_detail” added an optional parameter “original” cosmetic
- “announcements_feed” added an optional parameter “market” cosmetic
- “announcements_feed” added an optional parameter “original” cosmetic
- “announcements_search” added an optional parameter “market” cosmetic
- “announcements_search” added an optional parameter “original” cosmetic
- “announcements_stock” added an optional parameter “market” cosmetic
- “announcements_stock” added an optional parameter “original” cosmetic
- “news” added an optional parameter “cursor” cosmetic
- “views” reworded the description of “since_days” cosmetic
- “announcements_stock” reworded the description of “code” cosmetic
- “news” reworded the description of “hours” cosmetic
- “news” reworded the description of “offset” cosmetic
- “views” reworded the description of “offset” cosmetic
14 cosmetic changes on this day. Switch on “Show cosmetic changes” to see them.
- 17 Nov 26 +1
- Stability: unverified → 0.03 ▲ functional
- 16 Nov 26 +37
- Injection markers: unverified → pass ▲ security
- Transport: unverified → pass ▲ security
- First check of Judged manipulation: pass security
- Authorization: Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. security
- MCP protocol: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Schema quality: fail functional
- First check of Destructive annotations: pass functional
- First check of Schema quality: fail functional
- First check of Schema quality: good functional
- First check of Tool coverage: 100 functional
- 15 Nov 26 36
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Probed https://mcp.huishengpai.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_256_GCM_SHA384 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mcp.huishengpai.com | CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN | 20 Nov 2026 | 17 Feb 2027 | RSA 2048 | SHA256-RSA | 59760ef2bef17722876406d446058e7 |
| SANs: mcp.huishengpai.com | ||||||
| CN=TrustAsia DV TLS RSA CA 2025,O=TrustAsia Technologies\, Inc.,C=CN (CA) | CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US | 8 Jan 2025 | 7 Jan 2035 | RSA 4096 | SHA256-RSA | 926323b4964e368461512def1a5d52c |
| CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US (CA) | CN=DigiCert Global Root G2,OU=www.digicert.com,O=DigiCert Inc,C=US | 1 Aug 2013 | 15 Jan 2038 | RSA 2048 | SHA256-RSA | 33af1e6a711a9a0bb2864b11d09fae5 |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of mcp.huishengpai.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | Trust anchor | 20326, 38696 | 8, 8 | Verified |
| com. | DS published | 19718 | 13 | Verified |
| huishengpai.com. | No DS | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer resource_metadata="https://mcp.huishengpai.com/.well-known/oauth-protected-resource"
Bearer resource_metadata="https://mcp.huishengpai.com/.well-known/oauth-protected-resource" Protected resource metadata
| Document | https://mcp.huishengpai.com/.well-known/oauth-protected-resource |
|---|---|
| Retrieved | Yes |
| Resource | https://mcp.huishengpai.com/mcp |
| Authorisation server | https://api.huishengpai.com |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.huishengpai.com/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.huishengpai.com/mcp | HTTPS enforced | 301 | https://mcp.huishengpai.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
announcements_detail ~604
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| announcement_id | string | yes | UUID (feed / stock / search 返回的 items[].id) |
| format | string | – | outline=目录(默认)|search=文内检索(需 q)|table=单张表(需 table_index)|full=正文分段 |
| limit | integer | – | search:命中条数上限 |
| max_chars | integer | – | full / table:单次最大字符数(硬顶 80000) |
| offset | integer | – | full:正文起始偏移(可用 outline 的 char_offset);table:起始数据行(next_row_offset) |
| original | boolean | – | 是否返回公告原始字符(如港股繁体);默认 false 返回简体中文 |
| q | string | – | search:检索词,空格分隔、全部命中(如 "应收账款 账龄") |
| table_index | integer | – | table:表序号(来自 search 命中或 outline 的 tables) |
No output schema declared.
No examples provided.
announcements_list ~532
查询公告列表。传 q 按名称、代码或关键词检索,关键词结果按相关性排序,actual_window 的起止不代表连续覆盖;传 code 按单股查询;均省略则按发布时间倒序浏览全市场。用 offset 翻页,取 items[].id 调 announcements_detail。published_at 是实际可见时刻,disclosure_date 是披露日期。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | – | 单股公告历史,如 SSE:600519,与 q 互斥 |
| limit | integer | – | Max items (1-200, default 50) |
| market | string | – | 市场过滤:CN(A股默认)/ HK(港股)/ US(美股预留)/ ALL(全市场) |
| offset | integer | – | Pagination offset |
| original | boolean | – | 是否返回公告原始字符(如港股繁体);默认 false 返回简体中文 |
| q | string | – | 混合检索词,如「新华医疗 回购」,与 code 互斥 |
| since | string | – | ISO datetime 下限(published_at >= since,按实际可见时刻过滤,非预约披露日)。**时区后缀必填**:北京时间用 2026-08-05T00:00:00+08:00,UTC 用 2026-08-05T00:00:00Z。不带时区会被拒绝——A 股业务时间是北京时间,静默按 UTC 解释会少算 8 小时的数据。 |
| since_days | integer | – | 仅单股或检索:单股默认 30 天,检索默认 90 天 |
| type | string | – | 分类 slug 过滤(如 annual_report / equity_change / restructuring)。 |
No output schema declared.
No examples provided.
auction ~447
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。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | string | – | Comma-separated canonical codes (max 500); omit for the whole market |
| limit | integer | – | Max rows after sorting |
| order | string | – | desc (default) or asc |
| sort | string | – | Ranking key applied before limit |
| trade_date | string | – | YYYY-MM-DD; omit for today |
No output schema declared.
No examples provided.
bars_batch ~366
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | array | yes | Canonical codes (daily ≤100; minute ≤20) |
| from | string | yes | Inclusive start date YYYY-MM-DD |
| minute | boolean | – | Minute-level bars instead of daily (tighter caps apply) |
| order | string | – | Daily bar date order (default desc); minute bars are always ascending |
| to | string | yes | Inclusive end date YYYY-MM-DD |
No output schema declared.
No examples provided.
calendar_reports ~347
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical A-share code (e.g. SSE:600519) |
| periods | integer | – | How many recent report periods to return (1-12, default 4) |
No output schema declared.
No examples provided.
calendar_upcoming ~350
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | string | – | Comma-separated canonical codes (max 200) to filter a portfolio; omit to scan the whole market |
| days | integer | – | Forward window in days (1-90, default 7) |
| limit | integer | – | Max rows (1-1000, default 200) |
| report_type | string | – | Restrict to one report period type |
No output schema declared.
No examples provided.
capabilities ~317
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| response_shape | string | – | 按 views/news 的返回模式查询字段契约;须同时提供 verb |
| verb | string | – | Tool / verb name (e.g. `scan`, `technicals`, `views`) or a raw cliKey (`quote.scan`). Returns its response field list from the bundled contract, locally: no request, no credits. |
No output schema declared.
No examples provided.
chart ~507
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Single canonical code — stock (e.g. SSE:600519) or A-share index (e.g. SSE:000001, SZSE:399006, BSE:899050) |
| date | string | – | Single trade date YYYY-MM-DD (minute mode) |
| days | integer | – | Daily lookback (ignored when from/to or minute mode are set) |
| from | string | – | YYYY-MM-DD inclusive start (daily mode; overrides days) |
| kind | string | – | Override 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, everything else as stocks. |
| minute | boolean | – | Switch to minute-level bars (requires date) |
| to | string | – | YYYY-MM-DD inclusive end (daily mode; overrides days) |
No output schema declared.
No examples provided.
concept_tags ~229
查询股票当前热炒题材与完整基础概念标签,同时返回待确认、未同步、无已确认归属等状态。热炒活跃状态与长期基础归属分别返回;基础标签不等于当天上涨原因。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | string | yes | 逗号分隔的规范证券代码,最多 200 个 |
No output schema declared.
No examples provided.
concepts_alerts ~364
板块异动。active 查看当前仍触发的信号(big_move 为绝对涨跌幅超过 3%,limit_up_cluster 要求至少 5 只成分股且至少 3 只涨停);history 查看曾经触发的事件(默认最近 24 小时)。历史支持 Unix 毫秒 from/to、rule 和 limit。行业仅触发 big_move。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| from | integer | – | Unix ms; default = now - 24h |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
| limit | integer | – | 仅 history,默认 500 |
| mode | string | – | – |
| rule | string | – | Filter by alert rule |
| to | integer | – | Unix ms; default = now |
No output schema declared.
No examples provided.
concepts_bars ~330
概念、行业或基础指数 K 线(链式等权,基点 1000)。daily 返回日线、市场宽度和 is_backfilled;minute 返回分钟终点标签,完整交易日 240 根,单次最多 7 天。沿用列表中的 kind 和 concept_id。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| concept_id | integer | yes | Concept primary key |
| from | string | yes | Inclusive start date YYYY-MM-DD |
| interval | string | yes | K 线周期 |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
| to | string | yes | Inclusive end date YYYY-MM-DD |
No output schema declared.
No examples provided.
concepts_fundflow_minute ~378
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| concept_id | integer | yes | Concept primary key |
| date | string | – | Trade date YYYY-MM-DD (default: today, Beijing time) |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
No output schema declared.
No examples provided.
concepts_list ~498
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).
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
| limit | integer | – | Max items (1-1000, default 500) |
| order | string | – | desc (default) = top-N; asc = bottom-N, e.g. the concepts falling hardest today |
| sort | string | – | Sort field: pct_change / amount / main_net_in / limit_up / stock_count / speed |
| status | string | – | Concept status filter |
No output schema declared.
No examples provided.
concepts_news ~239
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| concept_id | integer | yes | Concept primary key |
| days | integer | – | Lookback window in days (1-365, default 30) |
| limit | integer | – | Max items (1-200, default 50) |
No output schema declared.
No examples provided.
concepts_of ~466
**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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | – | Canonical code, exact (e.g. SSE:600519). Preferred over `query` when resolved. |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
| limit | integer | – | Max matched securities (1-20, default 10). Caps securities, not concepts per security. |
| query | string | – | Substring over security name or ticker (e.g. 宁德时代 / 300750). May match several. |
No output schema declared.
No examples provided.
concepts_show ~401
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`.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| concept_id | integer | yes | Concept primary key (PG concepts.id) |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
| member_order | string | – | desc (default) or asc |
| member_sort | string | – | Order members by: main_net_in (default) / pct_change / amount / weight; members missing the key go last |
No output schema declared.
No examples provided.
concepts_snapshot ~315
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`.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | string | – | Comma-separated concept_id list (e.g. `1,2,3`); omit for all. |
| kind | string | – | Dimension: concept (hot-theme library, default), base (broad base labels), or industry. All use independent chain-linked equal-weight indices with base 1000. A stored theme membership alone does not… |
No output schema declared.
No examples provided.
concepts_views ~223
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| concept_id | integer | yes | Concept primary key |
| limit | integer | – | Max items (1-200, default 50) |
No output schema declared.
No examples provided.
digest ~430
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical 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. |
| limit_per_bucket | integer | – | Per-bucket item cap (views/news). Quote/snapshot/sentiment aren't paginated here. |
| news_hours | integer | – | Lookback for news bucket (hours, default 24 — event horizon) |
| views_since_days | integer | – | Lookback for views bucket (days, 1-30; views feed caps at 30d). For longer research history use the `views` verb's from/to. |
No output schema declared.
No examples provided.
dragon_tiger_daily ~660
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| category | string | – | Filter by qualifying reason: deviation_up/deviation_down (daily move deviation), turnover, amplitude, three_day_deviation_up/down (3-day cumulative), consecutive_limit, abnormal_severe, st_risk, new_… |
| date | string | – | Trading day YYYY-MM-DD. Omit for the latest day that has data (during trading hours that is the previous trading day). |
| inst_only | boolean | – | Only rows whose BUY side contains an institutional seat (机构专用). |
| kind | string | – | Security kind; defaults to stock (B shares / funds / convertibles excluded). |
| limit | integer | – | Rows to return (1-500, default 200). |
| northbound | boolean | – | Only rows where a northbound (沪深股通) seat appears on either side. |
| sort | string | – | Sort 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 for the chosen field always sort LAST,… |
No output schema declared.
No examples provided.
dragon_tiger_seat ~328
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| limit | integer | – | Rows to return (1-200, default 50). |
| name | string | yes | Seat name exactly as disclosed, e.g. 东方财富证券股份有限公司拉萨金融城南环路证券营业部 |
| window | string | – | Look-back window (default 30d). |
No output schema declared.
No examples provided.
dragon_tiger_seats ~387
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).
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| limit | integer | – | Seats to return (1-200, default 50). |
| min_appearances | integer | – | Minimum appearances to qualify (default 3). Also gates win-rate sample count when sorting by win rate. |
| seat_type | string | – | Restrict to one seat kind. Omit for branches only — the meaningful leaderboard. |
| sort | string | – | Ranking key (default appearances_desc). |
| window | string | – | Look-back window (default 30d). |
No output schema declared.
No examples provided.
dragon_tiger_stock ~348
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical A-share code (e.g. SZSE:000533) |
| limit | integer | – | Number of past appearances to return (1-200, default 30). |
No output schema declared.
No examples provided.
earnings ~426
A 股业绩预告与快报。company 按 code 查最近若干报告期(默认 4 期),包括预告修订历史与自愿披露的快报;快报缺失很常见。recent 扫描最近披露的业绩预告(默认 7 天、200 条),支持按方向、报告类型、同比下限或股票组合筛选。预告方向取自预告类型,修订以完整历史为基准。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | – | company 必填,如 SSE:600519 |
| codes | string | – | Comma-separated canonical codes (max 200) to filter a portfolio |
| days | integer | – | recent 回看天数,默认 7 |
| direction | string | – | Filter by forecast direction (derived from type, not from the percentage) |
| limit | integer | – | recent 返回条数上限,默认 200 |
| min_pct | number | – | Minimum YoY net-profit change (percentage points); also drops rows lacking percentage data |
| mode | string | yes | company 单股报告期历史;recent 近期业绩预告 |
| periods | integer | – | company 报告期数,默认 4 |
| report_type | string | – | Restrict to one report period type |
No output schema declared.
No examples provided.
etf_flows ~346
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| asset_class | string | – | Shenzhen-only; use equity to keep money-market funds off the ranking |
| direction | string | – | in = largest net creation (default), out = largest net redemption |
| limit | integer | – | Max items (default 50) |
| window | string | – | Accumulation window (default 1d) |
No output schema declared.
No examples provided.
etf_list ~358
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).
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| asset_class | string | – | Shenzhen-only classification; drops all Shanghai funds when set |
| index_code | string | – | Tracked index code, bare ('000300') or prefixed ('SSE:000300') |
| limit | integer | – | Max items (default 50) |
| offset | integer | – | Pagination offset |
| q | string | – | Substring over Chinese name and ticker |
No output schema declared.
No examples provided.
etf_show ~335
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical code, e.g. SSE:510300 |
No output schema declared.
No examples provided.
events_timeline ~466
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| canonical_code | string | yes | Canonical A-share code (e.g. SSE:600519) |
| limit | integer | – | Max rows PER LIST (1-500, default 100) — upcoming and past are capped separately |
| past_days | integer | – | Look-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_days | integer | – | Forward window in days (1-365, default 180) |
No output schema declared.
No examples provided.
events_upcoming ~821
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | string | – | Comma-separated canonical codes (max 200) to narrow to a portfolio |
| date_from | string | – | Window start YYYY-MM-DD (defaults to today) |
| date_to | string | – | Window end YYYY-MM-DD. Span is capped at 180 days and clamped if longer. |
| days | integer | – | Forward window in days (1-180, default 14). Ignored when date_to is given. |
| importance_min | integer | – | Minimum importance (1-5, 5 highest — e.g. FOMC) |
| kinds | string | – | Comma-separated event_kind filter; prefix wildcards work, e.g. `earnings.disclosure,macro.*`. Kinds: earnings.disclosure, earnings.us_disclosure, ownership.lockup_expiry, buyback.plan_expiry, corp.di… |
| limit | integer | – | Max rows (1-1000, default 200). `total` is the true count in the window and is NOT capped by this; `truncated` flags that more exist. |
| precision | string | – | `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 handle `window_end`. |
| scope | string | – | Filter by subject scope |
| statuses | string | – | Comma-separated status set; defaults to `scheduled,postponed` (the two open states). Add `occurred` / `expired` to see what already passed. |
No output schema declared.
No examples provided.
financials_pit ~263
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical A-share code |
| date | string | – | Trade date YYYY-MM-DD; defaults to today |
No output schema declared.
No examples provided.
financials_quote_snapshot ~294
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical A-share code (e.g. SSE:600519) |
| date | string | – | Trade date YYYY-MM-DD; omit for real-time snapshot |
No output schema declared.
No examples provided.
financials_reports ~244
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical A-share code |
| kind | string | – | Filter by report kind |
| limit | integer | – | Max periods (1-100, default 12) |
No output schema declared.
No examples provided.
financials_series ~276
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).
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Canonical A-share code |
| from | string | – | Inclusive earliest report_date |
| limit | integer | – | Max points (1-200, default 40) |
| metric | string | yes | Indicator field name (e.g. roe_simple, revenue, ni_parent) |
| to | string | – | Inclusive latest report_date |
No output schema declared.
No examples provided.
fundflow ~321
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| code | string | yes | Single canonical code (e.g. SSE:600519) |
| date | string | – | Trade date YYYY-MM-DD (default: today, Beijing time) |
No output schema declared.
No examples provided.
global_index_snapshot ~392
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | array | – | Canonical codes to narrow the snapshot (e.g. ['GIDX:NKY', 'HKEX:HSI']); omit for all 30 |
| region | string | – | Filter by region; combine with `codes` to narrow further. Omit for all regions |
No output schema declared.
No examples provided.
hot ~491
股票关注榜。source=research(默认)返回卖方研究提及榜数组,可按 date 或滚动 hours 查询;mention_count 为窗口内提及次数。按日期回溯先用 mode=dates 取 {dates},周一窗口含周末,提及次数不能直接跨日比较。榜中可含港股。历史从 2026-02-25 起,覆盖期内空榜表示无提及,请求失败返回 503;更早日期无覆盖。source=social 返回当前散户综合排行、排名变化及快照时间;score 为多榜加权分,仅提供最新快照。两榜衡量的人群不同,排名不能互相验证。旧调用 social_hot、trading_days 继续兼容。
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| date | string | – | Trading 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 full. Omit for the rolling `hours` wind… |
| days | integer | – | 仅 mode=dates 使用,回看 7–365 个自然日,默认 90 |
| hours | integer | – | Rolling window in hours ending now (1-168, default 24). Ignored when `date` is given. |
| limit | integer | – | 卖方研究排名返回条数(1–100,默认 20)。 |
| mode | string | – | 默认 ranking;dates 查询有卖方榜单的日期 |
| source | string | – | 榜单来源,默认 research |
No output schema declared.
No examples provided.
index_snapshot ~342
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| codes | array | – | Canonical index codes to narrow the snapshot (e.g. ['SSE:000001', 'BSE:899050']); omit for all 172 |
No output schema declared.
No examples provided.
limit_up_analysis ~340
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| as_of | string | – | Historical cutoff with timezone, no later than now; saved versions only |
| trade_date | string | – | ISO 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 for today's data) |
No output schema declared.
No examples provided.
limit_up_history ~300
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| days | integer | – | Lookback window in trading days (1-250, default 30) |
No output schema declared.
No examples provided.
limit_up_pool ~628
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.
| Name | Type | Req | Description |
|---|---|---|---|
| _fields | string | – | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq |
| _intent | string | – | 用户原问题一句话,仅分析用,可留空 |
| _jq | string | – | JMESPath,对 data 求值(写 items[*].id) |
| _max_bytes | integer | – | 响应字节上限,默认约 50 KB |
| _max_bytes_mode | string | – | 正文超限处理,默认 truncate 保留前缀 |
| _spill | boolean | – | true=全量落盘,只回摘要与取数地址 |
| include | string | – | active = 排除 ST/退市(默认); all = 全部 |
| include_broken | boolean | – | true 时连炸板(status=broken)也一起返回;默认只返回当前封板 status=limit_up |
| trade_date | string | – | ISO date YYYY-MM-DD; omit for latest (pre-open fallback) |
No output schema declared.
No examples provided.
How do I install the EchoPai (回声投研) MCP server?
EchoPai (回声投研) is a hosted endpoint at https://mcp.huishengpai.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · mcp.huishengpai.com
claude mcp add --transport http echopai-echopai-mcp 'https://mcp.huishengpai.com/mcp'
What is the EchoPai (回声投研) MCP server?
EchoPai (回声投研) is an MCP server listed in the public MCP registry as io.github.echopai/echopai-mcp. China equity & quantitative research MCP server with 50 tools for reports, filings & sentiment. This page covers its hosted endpoint (https://mcp.huishengpai.com/mcp).
Is the EchoPai (回声投研) MCP server safe to use?
EchoPai (回声投研) scores 74 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the EchoPai (回声投研) MCP server expose?
EchoPai (回声投研) exposes 76 tools: lookup, security_reference, market_calendar, market_clock, market_indices, and 71 more. Their descriptions and schemas cost roughly 31,479 tokens of context every time the server is loaded.
Does the EchoPai (回声投研) MCP server require authentication?
Yes. EchoPai (回声投研) asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the EchoPai (回声投研) MCP server still maintained?
EchoPai (回声投研) is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What did VerifyMCP test on the EchoPai (回声投研) MCP server?
VerifyMCP ran 13 checks on EchoPai (回声投研), covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.