{"id":"io.github.echopai/echopai-mcp","slug":"io-github-echopai-echopai-mcp","title":"EchoPai (回声投研)","description":"China equity & quantitative research MCP server with 50 tools for reports, filings & sentiment.","version":"1.0.1","publisher":{"kind":"github","id":"echopai","label":"@echopai on GitHub","url":"https://github.com/echopai"},"website":"https://echopai.com","repository":"https://github.com/echopai/echopai-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.huishengpai.com/mcp","headers":[{"description":"Optional Bearer API key (Bearer eps_live_...). Omit when using browser OAuth 2.0.","isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"npm","identifier":"@echopai/mcp","version":"1.0.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"EchoPai API key (eps_live_...) from https://echopai.com/go/app/agent","isSecret":true,"name":"ECHOPAI_API_KEY"}]}],"published":"2026-11-15","updated":"2026-11-15","status":"online","auth":"","latency_ms":2580,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"lookup","title":"","description":"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-","read_only":false},{"name":"security_reference","title":"","description":"按规范代码查询证券参考详情，当前仅接入港股，CN/US 预留：ISIN、币种、每手股数、双柜台关联及身份核验状态。source 包含来源、版本、源日期、观测时间和最后成功检查时间；stale=null 表示未知。collection_eligible 仅为参考资格，不代表报价已启用。listing_status/trading_status=unknown 不可解释为正常交易。","read_only":false},{"name":"market_calendar","title":"","description":"按显式 market 查询交易日历，当前仅接入 HK，CN/US 预留且不回退。含完整交易日、半日市及休市日。最多 366 天，days 为含首尾日期的列表。calendar_known=false 或 is_open=null 表示未覆盖，不能按工作日推测。is_settlement_day=null 表示交收属性未知。source 返回发布版本与最后成功检查时间。","read_only":false},{"name":"market_clock","title":"","description":"按显式 market 查询市场阶段，当前仅接入 HK，CN/US 预留且不回退。含半日市、竞价、午休及人工例外；省略 at 使用服务端当前时间。at 必须带时区，返回所选市场的 IANA 时区时间。trading_profile=index 只表示相关市场阶段，指数计算时段未核验。午间扩展交易须提供有已核验资格的证券代码。actual_end_unknown=true 表示随机结束时点未知，null 表示日历或阶段未知；不存在的具体证券返回 security_not_found；市场阶段不证明个股未停牌。","read_only":false},{"name":"market_indices","title":"","description":"按显式 market 查询指数目录，当前仅接入 HK，CN/US 预留且不回退。港股包含：恒生、国企、恒生科技、红筹、综合指数。items 行标识为 canonical_code；registry_revision 为随代码维护的注册表版本，不能视为实时行情源日期。quote_enabled/chart_enabled=false 表示报价和图表未启用。","read_only":false},{"name":"digest","title":"","description":"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 `me","read_only":false},{"name":"search","title":"","description":"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 光模块/","read_only":false},{"name":"quote","title":"","description":"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; nul","read_only":false},{"name":"market_status","title":"","description":"Current A-share session state. `session` ∈ `pre_open` (09:00-09:14) / `auction` (09:15-09:29) / `open` / `break` (lunch) / `closed`, same enum as `quote`. **Read `session`, not `is_market_open` / `is_premarket`** — both are false at lunch AND after the close. `trade_date` is today's China calendar date, not the trading day — qualify with `is_trading_day`; `next_trading_day` null = calendar not pop","read_only":false},{"name":"market_movers","title":"","description":"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 0","read_only":false},{"name":"market_digest","title":"","description":"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 `t","read_only":false},{"name":"auction","title":"","description":"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 pric","read_only":false},{"name":"index_snapshot","title":"","description":"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 ","read_only":false},{"name":"global_index_snapshot","title":"","description":"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 exc","read_only":false},{"name":"etf_list","title":"","description":"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 te","read_only":false},{"name":"etf_show","title":"","description":"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 (","read_only":false},{"name":"etf_flows","title":"","description":"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_c","read_only":false},{"name":"views","title":"","description":"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 wi","read_only":false},{"name":"views_get","title":"","description":"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. ⚠️ ","read_only":false},{"name":"report","title":"","description":"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","read_only":false},{"name":"news","title":"","description":"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 / H","read_only":false},{"name":"news_get","title":"","description":"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-","read_only":false},{"name":"announcements_search","title":"","description":"Hybrid search over A-share announcements: Chinese company name / 6-digit code / free-text keyword in one query (name or code → filter by stock; keyword → full-text relevance × recency over title + ai_summary + body start). Use when you DON'T have a canonical_code (\"新华医疗 回购\", \"600587\", \"回购\"); for a known stock prefer `announcements_stock`, for the market feed `announcements_feed`. ⚠️ TIME: `publish","read_only":false},{"name":"announcements_feed","title":"","description":"Recent A-share announcement feed (sorted by published_at desc). Filter by `type` slug (e.g. annual_report / equity_change / restructuring) or `since` lower bound. Use when surveying market-wide disclosures over a recent window — for a specific stock prefer `announcements_stock`. ⚠️ TIME: `published_at` is when the filing actually became visible — most A-share announcements go live after the previo","read_only":false},{"name":"announcements_stock","title":"","description":"Announcement history for a single A-share security. Default lookback 30 days, max 5 years. AH dual-listing: pass the A-share canonical (announcements are A-share only — HK side has separate HKEX disclosures not covered here). ⚠️ TIME: `published_at` is when the filing actually became visible — most A-share announcements go live after the previous session's close, so a filing dated \"2026-08-27\" by ","read_only":false},{"name":"announcements_detail","title":"","description":"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` gi","read_only":false},{"name":"sentiment_overview","title":"","description":"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 levera","read_only":false},{"name":"sentiment_breadth","title":"","description":"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","read_only":false},{"name":"sentiment_turnover","title":"","description":"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 sam","read_only":false},{"name":"sentiment_pct_distribution","title":"","description":"Real-time A-share market pct-change distribution: bucket counts at ≤-10% / -9% / ... / +10% / 涨停, plus universe total. Snapshot only — historical replay not yet exposed.","read_only":false},{"name":"sentiment_premium","title":"","description":"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 cu","read_only":false},{"name":"hot","title":"","description":"SHAPE: `data` is a TOP-LEVEL ARRAY of `{name, canonical_code, mention_count, latest_at}` — no `items` wrapper (write `[*].name`). Stocks most mentioned by sell-side research notes; array order is the rank. `mention_count` is every mention in the window, not deduplicated. ⚠️ Sell-side attention, not retail — retail attention is `social_hot`; the two do not validate each other. HK names appear and c","read_only":false},{"name":"social_hot","title":"","description":"Retail-attention leaderboard: A-shares retail investors are watching now, aggregated across several public attention boards. ⚠️ Retail board — `hot` is the sell-side board; they measure different populations and do not validate each other. `score` / `mention_count` are a weighted rank aggregate, **not a count of posts** and not comparable to `hot`. Array order is the rank. `rank_change` is versus ","read_only":false},{"name":"trading_days","title":"","description":"Trading days that have a hot-stock board, newest first, as `{dates:[...]}` (China time). **Use this to drive a `date` walk over `hot` — never iterate calendar days**: a weekend `hot` date returns a cumulative window that re-counts notes, whereas these days tile with no overlap and all have data. `days` looks back in CALENDAR days (7-365); coverage begins 2026-02-25. ⚠️ A coverage index for the res","read_only":false},{"name":"concepts_list","title":"","description":"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 botto","read_only":false},{"name":"concepts_snapshot","title":"","description":"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`.","read_only":false},{"name":"concepts_show","title":"","description":"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 ar","read_only":false},{"name":"concepts_of","title":"","description":"**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`","read_only":false},{"name":"concept_tags","title":"","description":"查询股票当前热炒题材与完整基础概念标签，同时返回待确认、未同步、无已确认归属等状态。热炒活跃状态与长期基础归属分别返回；基础标签不等于当天上涨原因。","read_only":false},{"name":"concepts_alerts","title":"","description":"Currently active concept alerts. Two rules: `big_move` (|pct_change| > 3%) and `limit_up_cluster` (limit_up_count >= 3 AND stock_count >= 5). Cheap, non-billable. Use as the agent's signal for 'which themes are running hot right now'. With `kind=industry`, only `big_move` ever fires — a Shenwan level-1 industry holds 150+ members, so the limit-up cluster rule would trigger nearly every day and dro","read_only":false},{"name":"concepts_alerts_history","title":"","description":"Concept-alert historical events (default last 24h). Filter by `rule` (big_move / limit_up_cluster) and Unix-ms `from`/`to` window. Used by AI agent / admin to review what fired and when.","read_only":false},{"name":"concepts_daily_bars","title":"","description":"Daily OHLC for a concept index (chain-linked equal-weight, base 1000). Returns breadth fields and `is_backfilled` flag. Pass `kind=industry` when the id is a Shenwan industry — a dimension mismatch returns 404, same as an unknown id. Requires `bars:read` scope.","read_only":false},{"name":"concepts_minute_bars","title":"","description":"Concept-index minute-level OHLC (chain-linked equal-weight, base 1000). Minute-end labels, 240 bars per full session (09:31-11:30, 13:01-15:00); boundary bars are merged preserving volume and amount. Max 7 days per request. Pass `kind=industry` when the id is a Shenwan industry — a dimension mismatch returns 404, same as an unknown id. Requires `bars:read` scope.","read_only":false},{"name":"concepts_fundflow_minute","title":"","description":"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 ","read_only":false},{"name":"concepts_news","title":"","description":"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.","read_only":false},{"name":"concepts_views","title":"","description":"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.","read_only":false},{"name":"limit_up_pool","title":"","description":"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 ","read_only":false},{"name":"limit_up_summary","title":"","description":"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-seal","read_only":false},{"name":"limit_up_promotion","title":"","description":"晋级 / 断板追踪: 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 `c","read_only":false},{"name":"limit_up_history","title":"","description":"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 ","read_only":false},{"name":"limit_up_analysis","title":"","description":"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 di","read_only":false},{"name":"chart","title":"","description":"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,","read_only":false},{"name":"bars_batch","title":"","description":"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 ","read_only":false},{"name":"scan","title":"","description":"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","read_only":false},{"name":"technicals","title":"","description":"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-o","read_only":false},{"name":"fundflow","title":"","description":"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 t","read_only":false},{"name":"trades_minute","title":"","description":"**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 e","read_only":false},{"name":"trades_ticks","title":"","description":"⚠️ **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 f","read_only":false},{"name":"margin_show","title":"","description":"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","read_only":false},{"name":"margin_market","title":"","description":"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 o","read_only":false},{"name":"margin_movers","title":"","description":"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 smal","read_only":false},{"name":"margin_collateral","title":"","description":"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","read_only":false},{"name":"margin_collateral_movers","title":"","description":"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 exclu","read_only":false},{"name":"dragon_tiger_daily","title":"","description":"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 con","read_only":false},{"name":"dragon_tiger_stock","title":"","description":"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 a","read_only":false},{"name":"dragon_tiger_seats","title":"","description":"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 defa","read_only":false},{"name":"dragon_tiger_seat","title":"","description":"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","read_only":false},{"name":"financials_quote_snapshot","title":"","description":"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 ","read_only":false},{"name":"financials_pit","title":"","description":"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.","read_only":false},{"name":"financials_reports","title":"","description":"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.","read_only":false},{"name":"financials_series","title":"","description":"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).","read_only":false},{"name":"ownership_show","title":"","description":"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 res","read_only":false},{"name":"ownership_lockups","title":"","description":"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.","read_only":false},{"name":"calendar_reports","title":"","description":"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) |","read_only":false},{"name":"calendar_upcoming","title":"","description":"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 del","read_only":false},{"name":"events_upcoming","title":"","description":"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 ","read_only":false},{"name":"events_timeline","title":"","description":"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 pinn","read_only":false},{"name":"earnings_show","title":"","description":"Earnings pre-announcements and flash reports for one A-share. `forecasts` = mandatory guided ranges (net-profit floor/ceiling CNY + YoY); `express` = voluntary unaudited actuals. `direction` (positive / negative / uncertain) comes from the forecast TYPE, not the percentage (turnaround names have misleading YoY). Every revision is kept with `revision` (first / revised_up / revised_down / revised_fl","read_only":false},{"name":"earnings_recent","title":"","description":"Scan A-share earnings pre-announcements filed in the last N days, newest first then YoY floor desc — the first-hand material for attributing a move to results rather than news flow. Filter by `direction` (positive|negative|uncertain), `report_type`, `min_pct` (YoY floor in percentage points), or `codes` to narrow to a portfolio. `revision` is computed against each name's FULL history, not just row","read_only":false},{"name":"capabilities","title":"","description":"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","read_only":false}],"server_info":{"name":"echopai","version":"4.0.1","title":"EchoPai"},"category":"finance","tags":["analytics","developer","news"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-15","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-echopai-echopai-mcp/"}