Endpoints: 76,849MCP servers: 32,729Payout addresses: 3,825Paid calls: 6,151Letters: 84Defects: 3,892counted 3 min ago
teppi

Server definition

Hash
sha256:9c49a8123d6443dab6353d1334530a3c8db8644eaa395b586a8033b94212dcd8
What it is
What a remote MCP server returned when asked what it offers: 82 tools

The blob, as servednamed by its sha256

{ "instructions": "你正在使用 EchoPai 的 A 股数据工具组。下面几条不知道就一定会踩,先读完再调用。\n\n## 证券代码格式\n一律用带交易所前缀的规范码:`SSE:600519` / `SZSE:000001` / `BSE:899050`。\n不接受裸六位数字,也不接受点后缀写法。\n⚠️ **前缀决定这串数字是什么**:`SSE:000001` 是上证指数,`SZSE:000001` 是平安银行——\n六位数字本身永远说明不了是哪个。指数区间:`SSE:000xxx` / `SZSE:399xxx` / `BSE:899xxx`。\nA+H 两地上市默认用 A 股那条,除非用户明确问港股。\n\n## 量纲\n涨跌幅类字段一律是**百分点**,不是比率:`8.94` 表示 +8.94%。\n`pct_change` / `speed_3min` / `leader_pct` 都遵守这条。\n金额字段带 `_cny` 后缀的单位是元。日期一律北京时间(UTC+8)交易日。\n\n## 输出控制(每个工具都有)\n响应可能很大。按这个顺序收:\n1. **服务端收窄**最省:`scan` 带 `sort` + `order` + `limit` 才是真正的全市场排名;\n 只给 `limit` 不给 `sort` 拿到的是按代码排序的前 N 个,那是样本不是榜单。\n `report` 先 `format=outline` 看目录,再按 `offset` 取需要的段,别一次拉全文。\n2. **客户端裁剪**:所有工具共有下划线旁路参数——\n `_jq`(表达式对 `data` 求值,写 `items[*].id` 而不是 `data.items[*].id`)、\n `_fields`(顶层字段投影)、`_max_bytes`(硬上限)。\n 未知投影字段直接报 invalid_args;先查 capabilities(verb=工具名)。\n _max_bytes_mode 默认 truncate 保留正文前缀,显式 omit 才整字段省略;研报 next_offset 随实际返回字符推进。\n 默认字节预算约 50 KB,超了会被裁并在 `meta.truncation_hint` 里说明下一步;\n 被丢掉的条目是**真没了**,重跑同样的调用只会拿到同样的范围;情绪广度时间序列保留最新一段,新闻和排名保留前缀。\n3. **整份要全量**时用 `_spill`:数据不进对话,只回「多少条、多大、字段表、两条样例」\n 外加一个取数地址。远程接入拿到的是 `data.url` 与一条现成的 `data.download`\n (`curl -o …`)——把文件下到你自己的机器上再按行 grep / jq,链接一小时有效。\n 本机 stdio 接入拿到的是 `data.path`,直接读那个文件。\n 全市场扫描、批量 K 线、整段研报这类天生要全量的需求走它,别去和 `_max_bytes` 硬碰。\n4. 版本与字段:meta.gateway_version 是工具服务构建号,recommended_cli_version 来自正式发布通道;\n API spec_version 独立,不能按版本大小猜能力。capabilities 带 verb 查询字段、semantic_map 和整形模式;\n views/news 可加 response_shape 区分 index/compact/full。meta.available_keys 仅表示本次实际字段。\n5. `_intent`:填用户原问题,一句话。只用于产品分析、不影响结果,不确定就留空。\n\n## 最容易踩的几条\n- **盘前与集合竞价**:09:00–09:14 尚未开始竞价,09:15–09:29 是集合竞价。\n 读每行 auction.status,只有 matched 的 auction.price/pct_change 才是有效撮合参考。\n 顶层 prev_close 与 auction.prev_close 一致,previous_close 为昨日真实收盘;除权日可不同。\n prev_close_provisional=true 表示今日除权参考价未确认。未撮合顶层展示价不代表平开。\n- **两融数据是 T+1 的**,且毛买不等于净买:判方向用 `financing_net_buy_cny`,\n 不要用 `financing_buy_cny`(毛额,含日内回转)。别把它折进当日盘中叙事而不加说明。\n- **`main_net_in` 是当日累计值,不是速率**:「猛买 45 分钟然后平了」和「全天稳定流入」\n 收盘是同一个数字。要看形状用 `fundflow`;分钟序列里 `*_cum` 是累计值,区间净额 =\n 末值 − 首值,**只有 `*_delta` 可以求和**。`main_net_in_stale: true` = 使用了回退数据层,不代表一定是昨日;quote 请核对 fundflow_latest.trade_date/bar_time。\n- **字段名跨工具不一致**:`news` 正文在 `content`,`search` 在 `snippet`。投影整列 null\n 时先怀疑键名拼错——响应顶层(`data` 之前)的 `_warnings` 会直接点名并给出\n `did_you_mean`,详情在 `meta.jq_null_keys` / `meta.available_keys`。\n- **空结果分三种**:没数据 / 没命中 / 不覆盖。响应会自报是哪一种,别一律当成「没有」。\n- **研报藏在观点流里**:只有约一成观点带全文,用 `views` 的 `report_only` 筛出来再用\n `report` 逐条读;一页全是 `full_text_available=false` 不代表没有研报。\n 解释「为什么涨」先看观点(`views`),新闻(`news`)只作补充面。\n\n## 完整方法论\n以上只是硬事实。完整用法(扫盘顺序、情绪周期、复盘流程、全部陷阱清单)在可安装的 skill 里:\n支持 skill 的宿主上让用户运行 `echopai init` 即可装到项目内。\n", "tools": [ { "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` 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "announcement_id": { "description": "UUID (feed / stock / search 返回的 items[].id)", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string" }, "format": { "default": "outline", "description": "outline=目录(默认)|search=文内检索(需 q)|table=单张表(需 table_index)|full=正文分段", "enum": [ "outline", "search", "table", "full" ], "type": "string" }, "limit": { "default": 10, "description": "search:命中条数上限", "maximum": 30, "minimum": 1, "type": "integer" }, "max_chars": { "default": 40000, "description": "full / table:单次最大字符数(硬顶 80000)", "maximum": 80000, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "full:正文起始偏移(可用 outline 的 char_offset);table:起始数据行(next_row_offset)", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "description": "search:检索词,空格分隔、全部命中(如 \"应收账款 账龄\")", "maxLength": 100, "minLength": 1, "type": "string" }, "table_index": { "description": "table:表序号(来自 search 命中或 outline 的 tables)", "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "announcement_id" ], "type": "object" }, "name": "announcements_detail", "outputSchema": null }, { "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 previous session's close, so a filing dated \"2026-08-27\" by the exchange typically became readable at ~18:00 on 2026-08-26. The scheduled-disclosure stamp is the *next* calendar day at 00:00 and is returned separately as `disclosure_date`; never read `disclosure_date` as a publication time, and never conclude a filing was published at midnight.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "default": 50, "description": "Max items (1-200, default 50)", "maximum": 200, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Pagination offset", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "since": { "description": "ISO datetime 下限(published_at >= since,按实际可见时刻过滤,非预约披露日)。**时区后缀必填**:北京时间用 2026-08-05T00:00:00+08:00,UTC 用 2026-08-05T00:00:00Z。不带时区会被拒绝——A 股业务时间是北京时间,静默按 UTC 解释会少算 8 小时的数据。", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:?\\d{2})$", "type": "string" }, "type": { "description": "分类 slug 过滤(如 annual_report / equity_change / restructuring)。", "maxLength": 64, "type": "string" } }, "type": "object" }, "name": "announcements_feed", "outputSchema": null }, { "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: `published_at` is when the filing became visible (usually the evening before the exchange date); `disclosure_date` (next day 00:00) is never a publication time.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "default": 50, "description": "Max items (1-200, default 50)", "maximum": 200, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Pagination offset", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "description": "名称 / 代码 / 关键词,可混合(如 \"新华医疗 回购\"、\"600587\"、\"回购\")", "maxLength": 100, "minLength": 1, "type": "string" }, "since_days": { "default": 90, "description": "回看天数(1-1825,默认 90)。`limit` 在窗口之后截断,条目密集时实际返回范围会远小于所请求窗口,见响应的 `actual_window`,不足用 `offset` 翻页。⚠️ q 含关键词时按相关性排序而非时间倒序,本页是散落在窗口各处的高分条目:此时 `actual_window.contiguous=false` 且无 `covered_hours`,`earliest`/`latest` 只是本页极值,不代表这段时间已看全;要按时间连续通读改用 announcements_feed / announcements_stock。", "maximum": 1825, "minimum": 1, "type": "integer" }, "type": { "description": "分类 slug 过滤(与 feed 同集合)", "maxLength": 64, "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "announcements_search", "outputSchema": null }, { "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 the exchange typically became readable at ~18:00 on 2026-08-26. The scheduled-disclosure stamp is the *next* calendar day at 00:00 and is returned separately as `disclosure_date`; never read `disclosure_date` as a publication time, and never conclude a filing was published at midnight.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "A-share canonical code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "limit": { "default": 50, "description": "Max items (1-200, default 50)", "maximum": 200, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Pagination offset", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "since_days": { "default": 30, "description": "Lookback window in days (1-1825, default 30)", "maximum": 1825, "minimum": 1, "type": "integer" }, "type": { "description": "分类 slug 过滤(与 feed 同集合)", "maxLength": 64, "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "announcements_stock", "outputSchema": null }, { "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 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。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Comma-separated canonical codes (max 500); omit for the whole market", "type": "string" }, "limit": { "description": "Max rows after sorting", "maximum": 10000, "minimum": 1, "type": "integer" }, "order": { "description": "desc (default) or asc", "enum": [ "desc", "asc" ], "type": "string" }, "sort": { "default": "pct_change", "description": "Ranking key applied before limit", "enum": [ "pct_change", "amount", "volume", "canonical_code" ], "type": "string" }, "trade_date": { "description": "YYYY-MM-DD; omit for today", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "auction", "outputSchema": null }, { "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 a real security with no trading in the window returns an empty `bars[]` — report that as no data, not a bad code.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Canonical codes (daily ≤100; minute ≤20)", "items": { "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array" }, "from": { "description": "Inclusive start date YYYY-MM-DD", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "minute": { "description": "Minute-level bars instead of daily (tighter caps apply)", "type": "boolean" }, "order": { "description": "Daily bar date order (default desc); minute bars are always ascending", "enum": [ "asc", "desc" ], "type": "string" }, "to": { "description": "Inclusive end date YYYY-MM-DD", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "codes", "from", "to" ], "type": "object" }, "name": "bars_batch", "outputSchema": null }, { "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) | 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "periods": { "default": 4, "description": "How many recent report periods to return (1-12, default 4)", "maximum": 12, "minimum": 1, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "calendar_reports", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Comma-separated canonical codes (max 200) to filter a portfolio; omit to scan the whole market", "type": "string" }, "days": { "default": 7, "description": "Forward window in days (1-90, default 7)", "maximum": 90, "minimum": 1, "type": "integer" }, "limit": { "default": 200, "description": "Max rows (1-1000, default 200)", "maximum": 1000, "minimum": 1, "type": "integer" }, "report_type": { "description": "Restrict to one report period type", "enum": [ "q1", "interim", "q3", "annual" ], "type": "string" } }, "type": "object" }, "name": "calendar_upcoming", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "response_shape": { "description": "按 views/news 的返回模式查询字段契约;须同时提供 verb", "enum": [ "index", "compact", "full" ], "type": "string" }, "verb": { "description": "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.", "type": "string" } }, "type": "object" }, "name": "capabilities", "outputSchema": null }, { "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, 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Single canonical code — stock (e.g. SSE:600519) or A-share index (e.g. SSE:000001, SZSE:399006, BSE:899050)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ|CSI):[0-9]{6}$", "type": "string" }, "date": { "description": "Single trade date YYYY-MM-DD (minute mode)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "days": { "default": 30, "description": "Daily lookback (ignored when from/to or minute mode are set)", "maximum": 365, "minimum": 1, "type": "integer" }, "from": { "description": "YYYY-MM-DD inclusive start (daily mode; overrides days)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "kind": { "description": "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.", "enum": [ "stock", "index" ], "type": "string" }, "minute": { "description": "Switch to minute-level bars (requires date)", "type": "boolean" }, "to": { "description": "YYYY-MM-DD inclusive end (daily mode; overrides days)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "chart", "outputSchema": null }, { "description": "查询股票当前热炒题材与完整基础概念标签,同时返回待确认、未同步、无已确认归属等状态。热炒活跃状态与长期基础归属分别返回;基础标签不等于当天上涨原因。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "逗号分隔的规范证券代码,最多 200 个", "maxLength": 3200, "minLength": 1, "type": "string" } }, "required": [ "codes" ], "type": "object" }, "name": "concept_tags", "outputSchema": null }, { "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 drown the feed.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" } }, "type": "object" }, "name": "concepts_alerts", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "from": { "description": "Unix ms; default = now - 24h", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "limit": { "default": 500, "description": "Max items (1-2000, default 500)", "maximum": 2000, "minimum": 1, "type": "integer" }, "rule": { "description": "Filter by alert rule", "enum": [ "big_move", "limit_up_cluster" ], "type": "string" }, "to": { "description": "Unix ms; default = now", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "type": "object" }, "name": "concepts_alerts_history", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Concept primary key", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "from": { "description": "Inclusive start date YYYY-MM-DD", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "to": { "description": "Inclusive end date YYYY-MM-DD", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "concept_id", "from", "to" ], "type": "object" }, "name": "concepts_daily_bars", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Concept primary key", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "date": { "description": "Trade date YYYY-MM-DD (default: today, Beijing time)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" } }, "required": [ "concept_id" ], "type": "object" }, "name": "concepts_fundflow_minute", "outputSchema": null }, { "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 bottom-N); concepts missing the sort key always go last. Entry point for browsing; drill in with `concepts_show` / `concepts_daily_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).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "limit": { "default": 500, "description": "Max items (1-1000, default 500)", "maximum": 1000, "minimum": 1, "type": "integer" }, "order": { "default": "desc", "description": "desc (default) = top-N; asc = bottom-N, e.g. the concepts falling hardest today", "enum": [ "desc", "asc" ], "type": "string" }, "sort": { "default": "pct_change", "description": "Sort field: pct_change / amount / main_net_in / limit_up / stock_count / speed", "enum": [ "pct_change", "amount", "main_net_in", "limit_up", "speed", "stock_count" ], "type": "string" }, "status": { "default": "active", "description": "Concept status filter", "enum": [ "active", "pending_review", "deprecated" ], "type": "string" } }, "type": "object" }, "name": "concepts_list", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Concept primary key", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "from": { "description": "Inclusive start date YYYY-MM-DD", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "to": { "description": "Inclusive end date YYYY-MM-DD (max 7 days)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "concept_id", "from", "to" ], "type": "object" }, "name": "concepts_minute_bars", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Concept primary key", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "days": { "default": 30, "description": "Lookback window in days (1-365, default 30)", "maximum": 365, "minimum": 1, "type": "integer" }, "limit": { "default": 50, "description": "Max items (1-200, default 50)", "maximum": 200, "minimum": 1, "type": "integer" } }, "required": [ "concept_id" ], "type": "object" }, "name": "concepts_news", "outputSchema": null }, { "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` 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical code, exact (e.g. SSE:600519). Preferred over `query` when resolved.", "pattern": "^(SSE|SZSE|BSE):[0-9]{6}$", "type": "string" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "limit": { "default": 10, "description": "Max matched securities (1-20, default 10). Caps securities, not concepts per security.", "maximum": 20, "minimum": 1, "type": "integer" }, "query": { "description": "Substring over security name or ticker (e.g. 宁德时代 / 300750). May match several.", "maxLength": 32, "minLength": 1, "type": "string" } }, "type": "object" }, "name": "concepts_of", "outputSchema": null }, { "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 are ordered by `main_net_in` desc by default (who is drawing money in); change with `member_sort` / `member_order`.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Concept primary key (PG concepts.id)", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "member_order": { "default": "desc", "description": "desc (default) or asc", "enum": [ "desc", "asc" ], "type": "string" }, "member_sort": { "default": "main_net_in", "description": "Order members by: main_net_in (default) / pct_change / amount / weight; members missing the key go last", "enum": [ "main_net_in", "pct_change", "amount", "weight" ], "type": "string" } }, "required": [ "concept_id" ], "type": "object" }, "name": "concepts_show", "outputSchema": null }, { "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`.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Comma-separated concept_id list (e.g. `1,2,3`); omit for all.", "type": "string" }, "kind": { "default": "concept", "description": "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 establish current trading activity; use concept_tags for current status.", "enum": [ "concept", "industry", "base" ], "type": "string" } }, "type": "object" }, "name": "concepts_snapshot", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Concept primary key", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "limit": { "default": 50, "description": "Max items (1-200, default 50)", "maximum": 200, "minimum": 1, "type": "integer" } }, "required": [ "concept_id" ], "type": "object" }, "name": "concepts_views", "outputSchema": null }, { "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 `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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "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.", "pattern": "^((SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$", "type": "string" }, "limit_per_bucket": { "default": 10, "description": "Per-bucket item cap (views/news). Quote/snapshot/sentiment aren't paginated here.", "maximum": 50, "minimum": 1, "type": "integer" }, "news_hours": { "default": 24, "description": "Lookback for news bucket (hours, default 24 — event horizon)", "maximum": 168, "minimum": 1, "type": "integer" }, "views_since_days": { "default": 7, "description": "Lookback for views bucket (days, 1-30; views feed caps at 30d). For longer research history use the `views` verb's from/to.", "maximum": 30, "minimum": 1, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "digest", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "category": { "description": "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_listing, no_limit, other", "enum": [ "deviation_up", "deviation_down", "turnover", "amplitude", "three_day_deviation_up", "three_day_deviation_down", "consecutive_limit", "abnormal_severe", "st_risk", "new_listing", "no_limit", "other" ], "type": "string" }, "date": { "description": "Trading day YYYY-MM-DD. Omit for the latest day that has data (during trading hours that is the previous trading day).", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "inst_only": { "description": "Only rows whose BUY side contains an institutional seat (机构专用).", "type": "boolean" }, "kind": { "description": "Security kind; defaults to stock (B shares / funds / convertibles excluded).", "enum": [ "stock", "b_share", "fund", "convertible_bond", "all" ], "type": "string" }, "limit": { "description": "Rows to return (1-500, default 200).", "maximum": 500, "minimum": 1, "type": "integer" }, "northbound": { "description": "Only rows where a northbound (沪深股通) seat appears on either side.", "type": "boolean" }, "sort": { "description": "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, ascending included — an ascending page of nulls would look like the smallest names when it is really just the ones with no data.", "enum": [ "net_buy_desc", "net_buy_asc", "pct_change_desc", "pct_change_asc", "amount_desc", "amount_asc", "buy_total_desc", "buy_total_asc", "sell_total_desc", "sell_total_asc", "institution_net_desc", "institution_net_asc" ], "type": "string" } }, "type": "object" }, "name": "dragon_tiger_daily", "outputSchema": null }, { "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 board is a seat regular before reading anything into a single appearance.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "description": "Rows to return (1-200, default 50).", "maximum": 200, "minimum": 1, "type": "integer" }, "name": { "description": "Seat name exactly as disclosed, e.g. 东方财富证券股份有限公司拉萨金融城南环路证券营业部", "maxLength": 255, "minLength": 2, "type": "string" }, "window": { "description": "Look-back window (default 30d).", "enum": [ "30d", "90d", "180d" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "name": "dragon_tiger_seat", "outputSchema": null }, { "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 default; request them explicitly and check `is_aggregate`. No per-seat NET figures (Shanghai discloses one side per seat).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "description": "Seats to return (1-200, default 50).", "maximum": 200, "minimum": 1, "type": "integer" }, "min_appearances": { "description": "Minimum appearances to qualify (default 3). Also gates win-rate sample count when sorting by win rate.", "maximum": 100, "minimum": 1, "type": "integer" }, "seat_type": { "description": "Restrict to one seat kind. Omit for branches only — the meaningful leaderboard.", "enum": [ "institution", "northbound", "branch" ], "type": "string" }, "sort": { "description": "Ranking key (default appearances_desc).", "enum": [ "appearances_desc", "buy_total_desc", "win_rate_desc", "avg_premium_desc" ], "type": "string" }, "window": { "description": "Look-back window (default 30d).", "enum": [ "30d", "90d", "180d" ], "type": "string" } }, "type": "object" }, "name": "dragon_tiger_seats", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SZSE:000533)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "limit": { "description": "Number of past appearances to return (1-200, default 30).", "maximum": 200, "minimum": 1, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "dragon_tiger_stock", "outputSchema": null }, { "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 rows inside the window, so a downgrade filed today reads as revised_down even when its first version predates the window. Note `min_pct` also drops rows that have no percentage data.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Comma-separated canonical codes (max 200) to filter a portfolio", "type": "string" }, "days": { "default": 7, "description": "Lookback window in days (1-90, default 7)", "maximum": 90, "minimum": 1, "type": "integer" }, "direction": { "description": "Filter by forecast direction (derived from type, not from the percentage)", "enum": [ "positive", "negative", "uncertain" ], "type": "string" }, "limit": { "default": 200, "description": "Max rows (1-1000, default 200)", "maximum": 1000, "minimum": 1, "type": "integer" }, "min_pct": { "description": "Minimum YoY net-profit change (percentage points); also drops rows lacking percentage data", "type": "number" }, "report_type": { "description": "Restrict to one report period type", "enum": [ "q1", "interim", "q3", "annual" ], "type": "string" } }, "type": "object" }, "name": "earnings_recent", "outputSchema": null }, { "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_flat); `has_downward_revision` flags a downgrade. ⚠️ Flash reports are voluntary and sparse — an absent `express` is normal.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "periods": { "default": 4, "description": "How many recent report periods to return (1-12, default 4)", "maximum": 12, "minimum": 1, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "earnings_show", "outputSchema": null }, { "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_class=equity` fixes that but drops every Shanghai-listed fund.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "asset_class": { "description": "Shenzhen-only; use equity to keep money-market funds off the ranking", "enum": [ "equity", "bond", "money" ], "type": "string" }, "direction": { "description": "in = largest net creation (default), out = largest net redemption", "enum": [ "in", "out" ], "type": "string" }, "limit": { "description": "Max items (default 50)", "maximum": 500, "minimum": 1, "type": "integer" }, "window": { "description": "Accumulation window (default 1d)", "enum": [ "1d", "5d", "20d" ], "type": "string" } }, "type": "object" }, "name": "etf_flows", "outputSchema": null }, { "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 tenth of the stock tick).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "asset_class": { "description": "Shenzhen-only classification; drops all Shanghai funds when set", "enum": [ "equity", "bond", "money" ], "type": "string" }, "index_code": { "description": "Tracked index code, bare ('000300') or prefixed ('SSE:000300')", "maxLength": 32, "type": "string" }, "limit": { "description": "Max items (default 50)", "maximum": 500, "minimum": 1, "type": "integer" }, "offset": { "description": "Pagination offset", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "q": { "description": "Substring over Chinese name and ticker", "maxLength": 32, "type": "string" } }, "type": "object" }, "name": "etf_list", "outputSchema": null }, { "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 (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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical code, e.g. SSE:510300", "pattern": "^(SSE|SZSE|BSE):[0-9]{6}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "etf_show", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "canonical_code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "limit": { "default": 100, "description": "Max rows PER LIST (1-500, default 100) — upcoming and past are capped separately", "maximum": 500, "minimum": 1, "type": "integer" }, "past_days": { "default": 90, "description": "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.", "maximum": 365, "minimum": 1, "type": "integer" }, "upcoming_days": { "default": 180, "description": "Forward window in days (1-365, default 180)", "maximum": 365, "minimum": 1, "type": "integer" } }, "required": [ "canonical_code" ], "type": "object" }, "name": "events_timeline", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Comma-separated canonical codes (max 200) to narrow to a portfolio", "type": "string" }, "date_from": { "description": "Window start YYYY-MM-DD (defaults to today)", "type": "string" }, "date_to": { "description": "Window end YYYY-MM-DD. Span is capped at 180 days and clamped if longer.", "type": "string" }, "days": { "default": 14, "description": "Forward window in days (1-180, default 14). Ignored when date_to is given.", "maximum": 180, "minimum": 1, "type": "integer" }, "importance_min": { "default": 1, "description": "Minimum importance (1-5, 5 highest — e.g. FOMC)", "maximum": 5, "minimum": 1, "type": "integer" }, "kinds": { "description": "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.dividend, ipo.subscription, ipo.listing, macro.data_release, macro.monetary, macro.lpr_release, policy.event, policy.regulation, policy.trade_measure, industry.expo, industry.event, corp.product_launch, corp.capacity_online, corp.price_change, corp.event", "type": "string" }, "limit": { "default": 200, "description": "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.", "maximum": 1000, "minimum": 1, "type": "integer" }, "precision": { "description": "`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`.", "enum": [ "day", "fuzzy" ], "type": "string" }, "scope": { "description": "Filter by subject scope", "enum": [ "security", "industry", "concept", "market", "macro" ], "type": "string" }, "statuses": { "description": "Comma-separated status set; defaults to `scheduled,postponed` (the two open states). Add `occurred` / `expired` to see what already passed.", "type": "string" } }, "type": "object" }, "name": "events_upcoming", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "date": { "description": "Trade date YYYY-MM-DD; defaults to today", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "financials_pit", "outputSchema": null }, { "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 real-time.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "date": { "description": "Trade date YYYY-MM-DD; omit for real-time snapshot", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "financials_quote_snapshot", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "kind": { "description": "Filter by report kind", "enum": [ "Q1", "H1", "Q3", "annual", "preliminary" ], "type": "string" }, "limit": { "default": 12, "description": "Max periods (1-100, default 12)", "maximum": 100, "minimum": 1, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "financials_reports", "outputSchema": null }, { "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).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "from": { "description": "Inclusive earliest report_date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "limit": { "default": 40, "description": "Max points (1-200, default 40)", "maximum": 200, "minimum": 1, "type": "integer" }, "metric": { "description": "Indicator field name (e.g. roe_simple, revenue, ni_parent)", "maxLength": 64, "minLength": 1, "type": "string" }, "to": { "description": "Inclusive latest report_date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code", "metric" ], "type": "object" }, "name": "financials_series", "outputSchema": null }, { "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 to tell whether a move is carried by large orders or by retail, and to spot late-session accumulation a daily number hides.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Single canonical code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "date": { "description": "Trade date YYYY-MM-DD (default: today, Beijing time)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "fundflow", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Canonical codes to narrow the snapshot (e.g. ['GIDX:NKY', 'HKEX:HSI']); omit for all 30", "items": { "pattern": "^(GIDX|HKEX):[A-Z0-9]{2,10}$", "type": "string" }, "maxItems": 30, "minItems": 1, "type": "array" }, "region": { "description": "Filter by region; combine with `codes` to narrow further. Omit for all regions", "enum": [ "asia_pacific", "europe", "americas", "hong_kong" ], "type": "string" } }, "type": "object" }, "name": "global_index_snapshot", "outputSchema": null }, { "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 can lead (`HK:` prefix). Window: trailing `hours` (default 24), or with `date` the previous trading day's 15:00 → that day's 15:00 (China time). ⚠️ Walk trading days, not calendar days — a weekend `date` returns a cumulative, overlapping window; drive the walk from `trading_days`. ⚠️ Windows differ in length (a Monday spans the weekend), so `mention_count` does not compare across days as-is; rank within a day does. An empty array means no mentions (failures return 503). History starts 2026-02-25 — earlier dates are *not covered*, not quiet.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "date": { "description": "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` window ending now.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "hours": { "description": "Rolling window in hours ending now (1-168, default 24). Ignored when `date` is given.", "maximum": 168, "minimum": 1, "type": "integer" }, "limit": { "description": "Rows to return (1-100, default 20).", "maximum": 100, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "hot", "outputSchema": null }, { "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 now' — `quote` covers individual stocks only. CSI-series indices (CSI:*) have no live feed and are not returned.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Canonical index codes to narrow the snapshot (e.g. ['SSE:000001', 'BSE:899050']); omit for all 172", "items": { "pattern": "^(SSE|SZSE|BSE):[0-9]{6}$", "type": "string" }, "maxItems": 172, "minItems": 1, "type": "array" } }, "type": "object" }, "name": "index_snapshot", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "as_of": { "description": "Historical cutoff with timezone, no later than now; saved versions only", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "trade_date": { "description": "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)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "limit_up_analysis", "outputSchema": null }, { "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 days before 2026-08-25 count brief flicker — expect a STEP DOWN at 2026-08-25; segments are not comparable.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "days": { "default": 30, "description": "Lookback window in trading days (1-250, default 30)", "maximum": 250, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "limit_up_history", "outputSchema": null }, { "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 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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "include": { "default": "active", "description": "active = 排除 ST/退市(默认); all = 全部", "enum": [ "active", "all" ], "type": "string" }, "include_broken": { "default": false, "description": "true 时连炸板(status=broken)也一起返回;默认只返回当前封板 status=limit_up", "type": "boolean" }, "trade_date": { "description": "ISO date YYYY-MM-DD; omit for latest (pre-open fallback)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "limit_up_pool", "outputSchema": null }, { "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 `canonical_code`, `name`, `prev_height`, `outcome`, `today_height`, `pct_change`. The core sentiment-cycle read (昨日 3 板今天几家晋级、几家炸、几家跌停) that `max_height` cannot give. Intraday the outcome is live and can still change before the close.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "include": { "default": "active", "description": "active = 排除 ST / 退市(默认); all = 全部", "enum": [ "active", "all" ], "type": "string" }, "trade_date": { "description": "ISO date YYYY-MM-DD; omit for today / latest", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "limit_up_promotion", "outputSchema": null }, { "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-sealed included). ⚠️ Different populations, NOT nested — ever_broken_count can be lower than broken_count; never subtract them. '现在多少没封住' → broken_count; '今天封过又开过' → ever_broken_count. ⚠️ Our own measure, not comparable with terminals, and not across 2026-08-25 (rule change). Pre-open fallback applies.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "include": { "default": "active", "description": "active = all_a_ex_st 口径(默认); all = all_a 口径", "enum": [ "active", "all" ], "type": "string" }, "trade_date": { "description": "ISO date YYYY-MM-DD; omit for latest", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "limit_up_summary", "outputSchema": null }, { "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-share and HK (e.g. 工商银行 SSE:601398 / HK:01398), prefer the A-share canonical for all downstream analysis unless the user explicitly asks for the HK side.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "default": 10, "description": "Max matches (1-30)", "maximum": 30, "minimum": 1, "type": "integer" }, "text": { "description": "Search text: Chinese name (贵州茅台), code (600519), or pinyin (gzmt)", "maxLength": 50, "minLength": 1, "type": "string" } }, "required": [ "text" ], "type": "object" }, "name": "lookup", "outputSchema": null }, { "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 day). Coverage is wider than the margin list, so presence here without `margin_show` is not a gap. `null` = not published, not zero.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "days": { "description": "Look-back window in calendar days (1-250, default 60). Ignored when from/to given.", "maximum": 250, "minimum": 1, "type": "integer" }, "from": { "description": "Start date YYYY-MM-DD. Must be given together with `to`.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "to": { "description": "End date YYYY-MM-DD. Must be given together with `from`.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "margin_collateral", "outputSchema": null }, { "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 excluded, not zero. **T+1, published later than margin data** — may lag `margin_movers` by a day. ⚠️ Noisy on small caps — check `collateral_mv_cny`. Coverage is wider than the margin list.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "description": "Number of rows to return (1-200, default 30)", "maximum": 200, "minimum": 1, "type": "integer" }, "sort": { "description": "Ranking key: pct_desc (default) / pct_asc / shares_chg_desc / shares_chg_asc / mv_desc", "enum": [ "pct_desc", "pct_asc", "shares_chg_desc", "shares_chg_asc", "mv_desc" ], "type": "string" }, "trade_date": { "description": "YYYY-MM-DD. Defaults to the latest trading day present in the data.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "margin_collateral_movers", "outputSchema": null }, { "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 of turnover, account counts and collateral value. **T+1**, and `structure` publishes later — the two arrays may not end on the same date; read each row's `trade_date`. Direction = `exchanges[].financing_net_buy_cny`; `structure[].financing_buy_cny` is gross.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "days": { "description": "Look-back window in calendar days (1-250, default 60)", "maximum": 250, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "margin_market", "outputSchema": null }, { "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 small balances — check `financing_balance_cny`.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "limit": { "description": "Number of rows to return (1-200, default 30)", "maximum": 200, "minimum": 1, "type": "integer" }, "sort": { "description": "Ranking key: net_buy_desc (default) / net_buy_asc / balance_desc / balance_chg_pct_desc / balance_chg_pct_asc", "enum": [ "net_buy_desc", "net_buy_asc", "balance_desc", "balance_chg_pct_desc", "balance_chg_pct_asc" ], "type": "string" }, "trade_date": { "description": "YYYY-MM-DD. Defaults to the latest trading day present in the data.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "margin_movers", "outputSchema": null }, { "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; short side likewise by the change in `short_balance_shares`. ⚠️ `null` = not published / not derivable (Shenzhen and Beijing publish no repayment), not zero. ⚠️ `financing_balance_chg_*` is versus `prev_trade_date` — check it is adjacent.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "days": { "description": "Look-back window in calendar days (1-250, default 60). Ignored when from/to given.", "maximum": 250, "minimum": 1, "type": "integer" }, "from": { "description": "Start date YYYY-MM-DD. Must be given together with `to`.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "to": { "description": "End date YYYY-MM-DD. Must be given together with `from`.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "margin_show", "outputSchema": null }, { "description": "按显式 market 查询交易日历,当前仅接入 HK,CN/US 预留且不回退。含完整交易日、半日市及休市日。最多 366 天,days 为含首尾日期的列表。calendar_known=false 或 is_open=null 表示未覆盖,不能按工作日推测。is_settlement_day=null 表示交收属性未知。source 返回发布版本与最后成功检查时间。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "end": { "description": "结束日期 YYYY-MM-DD,包含当日,最多 366 天", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", "type": "string" }, "market": { "description": "必填市场范围:CN/HK/US。本组端点当前仅接入 HK;CN/US 不回退港股,返回 market_not_supported;原有 A 股端点保持兼容", "enum": [ "CN", "HK", "US" ], "type": "string" }, "mic": { "description": "ISO 10383 交易场所代码,HK 省略时取 XHKG;未来 US 按场所选择日历", "pattern": "^[A-Z0-9]{4}$", "type": "string" }, "start": { "description": "起始日期 YYYY-MM-DD,包含当日", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", "type": "string" } }, "required": [ "market", "start", "end" ], "type": "object" }, "name": "market_calendar", "outputSchema": null }, { "description": "按显式 market 查询市场阶段,当前仅接入 HK,CN/US 预留且不回退。含半日市、竞价、午休及人工例外;省略 at 使用服务端当前时间。at 必须带时区,返回所选市场的 IANA 时区时间。trading_profile=index 只表示相关市场阶段,指数计算时段未核验。午间扩展交易须提供有已核验资格的证券代码。actual_end_unknown=true 表示随机结束时点未知,null 表示日历或阶段未知;不存在的具体证券返回 security_not_found;市场阶段不证明个股未停牌。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "at": { "description": "带时区时刻,例如 2026-12-24T12:08:30+08:00", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "type": "string" }, "code": { "description": "港股或已注册指数规范代码;省略为市场规则模板", "pattern": "^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.]{0,19}|HKEX:(HSI|HSCEI|HSTECH|HSCCI|HSCI))$", "type": "string" }, "market": { "description": "必填市场范围:CN/HK/US。本组端点当前仅接入 HK;CN/US 不回退港股,返回 market_not_supported;原有 A 股端点保持兼容", "enum": [ "CN", "HK", "US" ], "type": "string" }, "mic": { "description": "ISO 10383 交易场所代码,HK 省略时取 XHKG;未来 US 按场所选择日历", "pattern": "^[A-Z0-9]{4}$", "type": "string" }, "trading_profile": { "default": "equity", "description": "证券、指数或经核验的午间扩展交易", "pattern": "^[a-z][a-z0-9_]{0,31}$", "type": "string" } }, "required": [ "market" ], "type": "object" }, "name": "market_clock", "outputSchema": null }, { "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 `top_pct_change` ranks the auction. Empty lists carry `empty_reason`; failed blocks are null + `meta.partial_failures`.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "scope": { "default": "all_a_ex_st", "description": "Scope for breadth and turnover (same as sentiment_overview)", "enum": [ "all_a", "all_a_ex_st", "st_only", "main_board", "star_market", "chinext", "bse" ], "type": "string" }, "trade_date": { "description": "Historical YYYY-MM-DD; live-only blocks then come back not_covered", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "market_digest", "outputSchema": null }, { "description": "按显式 market 查询指数目录,当前仅接入 HK,CN/US 预留且不回退。港股包含:恒生、国企、恒生科技、红筹、综合指数。items 行标识为 canonical_code;registry_revision 为随代码维护的注册表版本,不能视为实时行情源日期。quote_enabled/chart_enabled=false 表示报价和图表未启用。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "market": { "description": "必填市场范围:CN/HK/US。本组端点当前仅接入 HK;CN/US 不回退港股,返回 market_not_supported;原有 A 股端点保持兼容", "enum": [ "CN", "HK", "US" ], "type": "string" } }, "required": [ "market" ], "type": "object" }, "name": "market_indices", "outputSchema": null }, { "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 09:00-09:14. Each row carries `industry` and `top_concept`; both are often missing — coverage, not failure (`top_concept` a subset of A-shares; `industry` excludes `BSE:*`), and `top_concept` is not the limit-up `leading_concept`, which is not served here. Live rows also expose `top_base_concept` `{id,name,kind:base,pct_change}` and `top_concept_status` / `top_base_concept_status` (ready, no_membership, no_snapshot, unavailable). The two layers rank independently; use kind=base for base detail. Historical rows carry neither current theme field nor their statuses. The snapshot includes ETFs: pass `security_type=stock` for a stock-only `amount` board. Historical `date` boards sort only by `pct` / `pct_asc` / `amount` / `turnover`, carry no `top_concept`, and cannot combine `concept_id`.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Rank inside one concept / industry instead of the whole market. Filtering happens server-side before ranking, so this is the concept's own leaderboard rather than the market top-N intersected with it. An unknown / inactive / wrong-dimension id returns 404. Get ids from `concepts_list` or `concepts_of`.", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "concept_kind": { "description": "Dimension of `concept_id`: concept (themes, default) or industry (Shenwan). Ignored alone.", "enum": [ "concept", "industry" ], "type": "string" }, "date": { "description": "Past A-share trading day (YYYY-MM-DD) to rank instead of the live snapshot — that day's daily bars. Omit for today. Only pct / pct_asc / amount / turnover sort historically; concept_id cannot be combined.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "exchange": { "description": "Narrow to one exchange: SSE / SZSE / BSE", "enum": [ "SSE", "SZSE", "BSE" ], "type": "string" }, "include": { "default": "active", "description": "active = 排除 ST/退市(默认); all = 全集(含 ST + 退市 + 未知 status)", "enum": [ "active", "all" ], "type": "string" }, "security_type": { "description": "stock = 只看股票 / etf = 只看 ETF / all(默认)= 两者都要。成交额榜(sort=amount)不传 stock 会被货币 / 短融 ETF 占住头部。服务端在 top-N 截断前过滤。", "enum": [ "stock", "etf", "all" ], "type": "string" }, "sort": { "default": "pct", "description": "Sort field: pct / pct_asc / speed / amount / turnover / total_mv / main_net_in (主力净流入榜) / main_net_in_asc (净流出榜)", "enum": [ "pct", "pct_asc", "speed", "amount", "turnover", "total_mv", "main_net_in", "main_net_in_asc" ], "type": "string" }, "top": { "default": 20, "description": "Top N items (1-500, default 20)", "maximum": 500, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "market_movers", "outputSchema": null }, { "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 populated (unknown). `is_holiday` marks shut weekdays only (weekends read false). Free — call before quote / bars to choose pre-market vs intraday vs after-close behaviour.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" } }, "type": "object" }, "name": "market_status", "outputSchema": null }, { "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 / HK / US) → news mentioning that security; `query` (free text, all terms required, newest first); neither → recent feed. A canonical_code passed as `query` will not match — use `code`. A+H: pass the A-share canonical.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Filter by security canonical_code (e.g. SSE:600519, HK:00700). Takes precedence over `query`.", "pattern": "^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$", "type": "string" }, "fields": { "description": "Response shape: compact (default — title + ai_summary + first ~300 chars) or full (complete content)", "enum": [ "compact", "full" ], "type": "string" }, "from": { "description": "History range start (China date YYYY-MM-DD). Range mode: needs code or query; Pro-only up to 365 days back.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "has_title": { "description": "true = only items with a headline. Flash news has none (often ~40% of the feed), so pass this when filtering or summarising by headline; otherwise read `display_title`, which falls back to the first sentence.", "type": "boolean" }, "hours": { "default": 24, "description": "Rolling-feed lookback in hours (default 24 — much narrower than views). For longer history use from/to with code or query. The `limit` cap applies after this window, newest first, so a dense feed can shrink the covered span far below what you asked for — read `actual_window` in the response for the range actually returned, and page with `offset` if it falls short.", "maximum": 168, "minimum": 1, "type": "integer" }, "limit": { "default": 20, "description": "Max items per page", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "description": "Pagination offset for paging through long history ranges.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "query": { "description": "Free-text query (Chinese or English) matched against news content; omit for time-window feed. Terms are AND-ed — a document must contain every term — and results stay in strict reverse-chronological order, so extra terms narrow rather than broaden. Pass 2-3 distinctive terms; for relevance-ranked recall that matches any term, use the `search` tool instead. Chinese needs no spaces, and AND/OR/quotes are treated literally rather than as operators. Do NOT pass canonical_code here — use `code` instead.", "type": "string" }, "to": { "description": "History range end (inclusive, China date; defaults to today). Use with from.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "news", "outputSchema": null }, { "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-level source. Remember `news` is the SUPPLEMENTARY stream: for forming an investment opinion prefer `views`. Free, and takes no scope of its own.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "news_id": { "description": "News id from a `news` list row (items[].id)", "pattern": "^[0-9]+$", "type": "string" } }, "required": [ "news_id" ], "type": "object" }, "name": "news_get", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Comma-separated canonical codes (max 200) to filter a portfolio; omit to scan the whole market", "type": "string" }, "days": { "default": 30, "description": "Forward window in days (1-90, default 30)", "maximum": 90, "minimum": 1, "type": "integer" }, "limit": { "default": 200, "description": "Max rows (1-1000, default 200)", "maximum": 1000, "minimum": 1, "type": "integer" }, "min_pct": { "default": 0, "description": "Minimum unlock pct of total shares (percentage points, default 0)", "maximum": 100, "minimum": 0, "type": "number" } }, "type": "object" }, "name": "ownership_lockups", "outputSchema": null }, { "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 restricted-share cancellation at grant price, not open-market support. ⚠️ `plan_expires_on` is usually null = UNKNOWN, not still valid — use `disclosed_days_ago`. T+1.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical A-share code (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "lockup_days": { "default": 30, "description": "Lockup forward window in days (1-180, default 30)", "maximum": 180, "minimum": 1, "type": "integer" }, "repurchase_days": { "default": 30, "description": "Repurchase lookback window in days (1-180, default 30)", "maximum": 180, "minimum": 1, "type": "integer" }, "txn_days": { "default": 30, "description": "Holder-trade lookback window in days (1-180, default 30)", "maximum": 180, "minimum": 1, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "ownership_show", "outputSchema": null }, { "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; null if missing; not comparable to market turnover `volume_ratio`), `fundflow_latest` {trade_date, bar_time, main_net_cum, super_net_cum} (latest stored minute cumulative CNY; check its date/time), `industry` (Shenwan L1/L2), `top_concept` (strongest member concept now) and, for margin-list names, a T+1 `margin` block. Expect `industry` / `top_concept` to be absent on many rows — coverage, not failure: `top_concept` resolves for only a subset of A-shares and `industry` does not cover 北交所 (`BSE:*`). `top_concept` is **not** the limit-up LLM `leading_concept`, which is not served here. Live rows also expose `top_base_concept` `{id,name,kind:base,pct_change}` and `top_concept_status` / `top_base_concept_status` (ready, no_membership, no_snapshot, unavailable). The two layers rank independently; use kind=base for base detail. Historical rows carry neither current theme field nor their statuses. **In `pre_open` / `auction` sessions read the `auction` block `{status, prev_close, price, pct_change, volume, amount}`, not top-level `price` / `pct_change`.** `status` is `not_started` / `matched` / `no_match`; a top-level `pct_change` of 0 in that window is ambiguous — only `auction.status = matched` with `auction.pct_change = 0` is a flat auction. 盘前顶层 prev_close 与 auction.prev_close 对齐为今日基准,prev_close_date 为上一交易日;previous_close 为昨日实际收盘价。prev_close_basis 区分交易所参考价、事件调整价与未校准昨收,prev_close_provisional=true 时不可视为已确认除权参考价。未撮合的顶层 price 仅为基准展示,pct_change 为 null。 Suspended / frozen names report `no_match`; `auction.volume` / `amount` stay null until the 09:25 match (volume in shares). Read `market_trade_date`, not `snapshot_at`, to tell whether a row is today's. Unknown codes are omitted; known-but-unmatched codes come back with null prices. super_net_in 为最新已存分钟累计超大单净流入(元),时间与 fundflow_latest 相同。 `main_net_in` = current-day cumulative main-capital net inflow (CNY; `main_net_in_stale` = fallback layer, not necessarily previous-day data; check fundflow_latest.trade_date/bar_time; null for `BSE:*`). 竞价未匹配量 unmatched 为股,正买负卖;unmatched_as_of 是最后有效竞价观测的源时间(09:25 后冻结),历史未采集为 null。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Array of canonical codes (e.g. ['SSE:600519', 'SZSE:000001'])", "items": { "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "maxItems": 200, "minItems": 1, "type": "array" }, "include_l2": { "description": "Include L2 5-level order book (requires quote:l2 scope)", "type": "boolean" } }, "required": [ "codes" ], "type": "object" }, "name": "quote", "outputSchema": null }, { "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 reports exist. Consumer pricing: 1 credit per PDF page, with no minimum or maximum document charge, per UTC day. Call format=quote first for free page_count and credit_cost; all subsequent outline/full reads share the same daily document charge. Unknown PDF page count blocks paid reads; unpaginated non-PDF documents cost 1. Two-step usage: default `format=outline` returns a few-KB heading map + total_chars + each heading's char_offset; then call `format=full` with `offset` (e.g. an outline char_offset) to read the body in pages — follow `next_offset` to page through large docs instead of pulling everything at once.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "format": { "default": "outline", "description": "quote=free page count and price; outline=heading map (default, charges document); full=body slice", "enum": [ "quote", "outline", "full" ], "type": "string" }, "max_chars": { "default": 40000, "description": "full mode: max chars per page (hard cap 80000)", "maximum": 80000, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "full mode: start char offset (use an outline char_offset)", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "view_id": { "description": "View id from `views --report-only` items[].id (full_text_available=true)", "pattern": "^[0-9]+$", "type": "string" } }, "required": [ "view_id" ], "type": "object" }, "name": "report", "outputSchema": null }, { "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) — `total` is only how many rows came back. The universe includes ETFs (`security_type` on every row); money-market ETFs dominate `sort=amount`, so pass `security_type=stock` for a stock-only board (filtered before sort/limit). `include_margin` attaches the T+1 margin block; `include_industry` attaches `industry` (Shenwan L1/L2) and `top_concept`. Both are often absent — coverage, not failure: `top_concept` resolves for only a subset of A-shares and `industry` does not cover `BSE:*`; `top_concept` is not the limit-up LLM `leading_concept`, which is not served here. Live rows also expose `top_base_concept` `{id,name,kind:base,pct_change}` and `top_concept_status` / `top_base_concept_status` (ready, no_membership, no_snapshot, unavailable). The two layers rank independently; use kind=base for base detail. Historical rows carry neither current theme field nor their statuses. **In `pre_open` / `auction` sessions read each row's `auction` block, not top-level `price` / `pct_change`** (same rules as `quote`: only `auction.status = matched` with `auction.pct_change = 0` is a flat auction; compute from `auction.prev_close`). Read `market_trade_date`, not `snapshot_at`, to decide whether a row is today's — a frozen feed keeps `snapshot_at` moving. `is_margin_target` is margin-list membership (T+1), not activity; the key is absent (never `false`) when the list cannot be loaded. `trade_date=YYYY-MM-DD` scans that past day's daily bars (see the parameter for allowed combinations). 竞价未匹配量 unmatched 为股,正买负卖;unmatched_as_of 是最后有效竞价观测的源时间(09:25 后冻结),历史未采集为 null。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "concept_id": { "description": "Restrict the scan to one concept's / industry's members. Applied **before** sort and limit, so `concept_id` + `sort=pct_change` + `limit=10` gives the top 10 movers **inside that concept** (and `matched_total` counts its members, not the whole market). An unknown / inactive / wrong-dimension id returns 404, so an empty result means the theme has no members in today's snapshot rather than a bad id. Get ids from `concepts_list` or `concepts_of`.", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "concept_kind": { "description": "Dimension of `concept_id`: concept (hot-theme library, default), base (base labels), or industry (Shenwan). Ignored alone.", "enum": [ "concept", "industry", "base" ], "type": "string" }, "exchange": { "description": "Filter by exchange (omit for all)", "enum": [ "SSE", "SZSE", "BSE" ], "type": "string" }, "include": { "description": "`active` (default) drops ST / delisted / stale rows; `all` keeps them, flagged with `stale: true` and `stale_since`.", "enum": [ "active", "all" ], "type": "string" }, "include_industry": { "description": "Attach `industry` (Shenwan L1/L2 `{l1:{id,name}, l2:{id,name}}`) and `top_concept` (`{id,name,pct_change}`, highest-moving member concept now; not the limit-up `leading_concept`). Also attaches `top_base_concept` (kind=base) and separate availability statuses for both layers. Off by default (payload). Ids feed the concepts endpoints (`kind=industry` / `kind=concept`).", "type": "boolean" }, "include_margin": { "description": "Attach the T+1 margin block (off by default, ~25% larger). `as_of` is normally the previous trading day; judge direction by `financing_net_buy_cny` (`financing_buy_cny` is gross); null = not published, not zero.", "type": "boolean" }, "limit": { "description": "Keep the first N rows **after** sorting (1-10000). Always pair with `sort` — an unsorted limit is an alphabetical sample. When rows are dropped: `truncated: true` + `matched_total` (pre-limit count); `total` is only the returned count.", "maximum": 10000, "minimum": 1, "type": "integer" }, "margin_target": { "description": "Keep only margin-eligible securities (true) or only non-eligible (false); omit for both. Returns 503 if the list cannot be loaded.", "type": "boolean" }, "order": { "description": "Sort direction. Defaults to `desc` for numeric keys and `asc` for `canonical_code`. Ignored without `sort`.", "enum": [ "asc", "desc" ], "type": "string" }, "security_type": { "description": "`stock` keeps only stocks, `etf` only ETFs, `all` (default) both. Money-market / short-bond ETFs dominate `sort=amount` unless you pass `stock`. Filtered before sort / limit; every row carries `security_type` either way.", "enum": [ "stock", "etf", "all" ], "type": "string" }, "sort": { "description": "Server-side ranking key, applied before `limit`; omit for `canonical_code` order. `margin_balance` / `margin_net_buy` turn `include_margin` on. Null sort values land last in both directions.", "enum": [ "price", "pct_change", "speed_3min", "amount", "main_net_in", "total_mv", "turnover_rate", "margin_balance", "margin_net_buy", "canonical_code" ], "type": "string" }, "trade_date": { "description": "Past trading day (YYYY-MM-DD) to scan instead of the live snapshot — rows are that day's daily bars. Only `price` / `pct_change` / `amount` / `turnover_rate` / `canonical_code` sort historically; `concept_id`, `include_margin` and `margin_target` cannot be combined. Today / future / non-trading days are rejected.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "scan", "outputSchema": null }, { "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 光模块/光通信/光芯片; '减肥药' brings out 创新药; '智驾' brings out 智能驾驶. Use `news` or `views` instead if you need strict time-window listing.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "hours": { "description": "Lookback window in hours; omit for no time limit", "maximum": 720, "minimum": 1, "type": "integer" }, "limit": { "default": 20, "description": "Max items returned", "maximum": 50, "minimum": 1, "type": "integer" }, "mode": { "default": "hybrid", "description": "hybrid = entity + concept-graph + full-text fused; exact = keyword full-text only", "enum": [ "hybrid", "exact" ], "type": "string" }, "q": { "description": "Free-text query (Chinese or English)", "maxLength": 200, "minLength": 1, "type": "string" }, "type": { "default": "all", "description": "Search scope (views weighted higher in 'all')", "enum": [ "news", "views", "all" ], "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "search", "outputSchema": null }, { "description": "按规范代码查询证券参考详情,当前仅接入港股,CN/US 预留:ISIN、币种、每手股数、双柜台关联及身份核验状态。source 包含来源、版本、源日期、观测时间和最后成功检查时间;stale=null 表示未知。collection_eligible 仅为参考资格,不代表报价已启用。listing_status/trading_status=unknown 不可解释为正常交易。", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "规范证券代码,例如 HK:00700 或 US:AAPL;由前缀确定市场,当前详情仅接入 HK", "pattern": "^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.]{0,19})$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "security_reference", "outputSchema": null }, { "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 breadth fields. Coverage reports source and returned time ranges. Budget trimming retains latest points, ascending.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "fields": { "description": "响应模式;REST/CLI 默认 full,MCP 默认 compact(导出除外)", "enum": [ "compact", "full" ], "type": "string" }, "last_n": { "description": "仅返回最近 N 个交易分钟点,午休不计入", "maximum": 240, "minimum": 1, "type": "integer" }, "scope": { "default": "all_a_ex_st", "description": "Universe filter: all_a | all_a_ex_st (default, ex-ST + ex-newly-listed) | st_only | main_board | star_market | chinext | bse. The four boards sum exactly to all_a_ex_st.", "enum": [ "all_a", "all_a_ex_st", "st_only", "main_board", "star_market", "chinext", "bse" ], "type": "string" }, "trade_date": { "description": "Trade date YYYY-MM-DD; omit for today", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "sentiment_breadth", "outputSchema": null }, { "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 leverage block is T+1 — not the same day as the rest** — and each sub-block has its own `as_of`. `leverage` null = unavailable. Also a `turnover` block (current_turnover / predicted_total / delta_vs_yesterday, same numbers as `sentiment_turnover`'s header) — no second call needed for 成交额. `turnover.volume_trend` = `expanding` (放量) / `contracting` (缩量) / `flat` vs the previous two sessions at the same minute (`vs_prev_2d_ratio`, per-day `prev_sessions[]`); read it instead of comparing against yesterday's full-day total.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "scope": { "default": "all_a_ex_st", "description": "Universe filter: all_a | all_a_ex_st (default, ex-ST + ex-newly-listed) | st_only | main_board | star_market | chinext | bse. The four boards sum exactly to all_a_ex_st.", "enum": [ "all_a", "all_a_ex_st", "st_only", "main_board", "star_market", "chinext", "bse" ], "type": "string" }, "trade_date": { "description": "Trade date YYYY-MM-DD; omit for today realtime", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "sentiment_overview", "outputSchema": null }, { "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" } }, "type": "object" }, "name": "sentiment_pct_distribution", "outputSchema": null }, { "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 curve one day earlier. ⚠️ Read `main_pool_size` / `compare_pool_size` with the curves — they tell a premium move from a population change. ⚠️ Equal-weighted, not cap-weighted, so not comparable to index returns. Series use 240 minute end labels (09:31-11:30, 13:01-15:00). Pool dates are trading days, resolved server-side. Empty `main` with a non-zero pool size = session not started. Optional scope filters both pools; omit it to preserve the legacy all_a basket. ETF is excluded.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "scope": { "description": "Stock basket; all_a includes ST, all_a_ex_st excludes ST and newly listed stocks. Defaults to all_a for compatibility.", "enum": [ "all_a", "all_a_ex_st", "st_only", "main_board", "star_market", "chinext", "bse" ], "type": "string" } }, "type": "object" }, "name": "sentiment_premium", "outputSchema": null }, { "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 same-minute YoY comparison.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "days": { "default": 1, "description": "trade_date 当日 + 之前 days-1 天(1-5,默认 1)", "maximum": 5, "minimum": 1, "type": "integer" }, "scope": { "default": "all_a_ex_st", "description": "Universe filter: all_a | all_a_ex_st (default, ex-ST + ex-newly-listed) | st_only | main_board | star_market | chinext | bse. The four boards sum exactly to all_a_ex_st.", "enum": [ "all_a", "all_a_ex_st", "st_only", "main_board", "star_market", "chinext", "bse" ], "type": "string" }, "trade_date": { "description": "Trade date YYYY-MM-DD; omit for today", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "sentiment_turnover", "outputSchema": null }, { "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 one hour ago (null = not on the board then). ⚠️ Snapshot only, no history. Read `computed_at` / `stale_seconds` for freshness. Attention is not a bullish signal.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" } }, "type": "object" }, "name": "social_hot", "outputSchema": null }, { "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-of-day technicals for up to 50 A-shares on one server-side methodology. Use scan / limit_up_pool to find candidates, this to vet them. Read winrate only with sample_size, the Wilson interval and excess_winrate — samples are often single-digit.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "codes": { "description": "Canonical codes, 1-50 (e.g. SZSE:300759)", "items": { "pattern": "^(SSE|SZSE|BSE|SH|SZ|BJ):[0-9]{6}$", "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" } }, "required": [ "codes" ], "type": "object" }, "name": "technicals", "outputSchema": null }, { "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 excluded from the denominator. `vwap` is yuan per share. ⚠️ `big_count` / `big_amount` use a fixed 200,000-yuan-per-print line, meaningless on high-priced names (贵州茅台: 97 of 99 prints in one 5-minute bucket cleared it) — compare a stock with itself only; unrelated to fundflow tiers. ⚠️ `tick_count` counts the prints **we captured** (3-second snapshots), not the exchange's trade count. Omit `date` for the latest day that has data. History starts 2026-05-26; earlier = not covered.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "code": { "description": "Canonical code of one A-share security (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE):[0-9]{6}$", "type": "string" }, "date": { "description": "Trading day YYYY-MM-DD (China time). Omit for the latest day that has data.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "interval": { "description": "Bucket size in minutes: 1 / 5 / 15 / 30 / 60 (default 5).", "maximum": 9007199254740991, "minimum": -9007199254740991, "type": "integer" } }, "required": [ "code" ], "type": "object" }, "name": "trades_minute", "outputSchema": null }, { "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 filter on `min_amount` — counting rows will not do it. ⚠️ `side` is inferred from bid/ask (`M` = neither). ⚠️ `seq` may have gaps (backfilled after the close). ⚠️ No 09:25 auction print — never take an open price here. Page with `after_seq` = previous `next_after_seq` until null (a day is ≤3 pages at the default limit). Retention 60 trading days (`retention_from`); coverage starts 2026-06-01.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "after_seq": { "description": "Cursor: only prints with seq greater than this. Use the previous next_after_seq.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "code": { "description": "Canonical code of one A-share security (e.g. SSE:600519)", "pattern": "^(SSE|SZSE|BSE):[0-9]{6}$", "type": "string" }, "date": { "description": "Trading day YYYY-MM-DD (China time). Omit for the latest day that has data.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "from": { "description": "Earliest print time HH:MM (China time), inclusive.", "pattern": "^\\d{2}:\\d{2}$", "type": "string" }, "limit": { "description": "Rows per page (1-2000, default 500).", "maximum": 2000, "minimum": 1, "type": "integer" }, "min_amount": { "description": "Keep only prints reaching this turnover in yuan — the way to find large trades.", "minimum": 0, "type": "number" }, "side": { "description": "B = buyer-initiated, S = seller-initiated, M = neither. Inferred from the book.", "enum": [ "B", "S", "M" ], "type": "string" }, "to": { "description": "Latest print time HH:MM (China time), inclusive.", "pattern": "^\\d{2}:\\d{2}$", "type": "string" } }, "required": [ "code" ], "type": "object" }, "name": "trades_ticks", "outputSchema": null }, { "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 research board, NOT an exchange calendar — use `market_status` for whether the market is open.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "days": { "description": "Look-back in calendar days (7-365, default 90). Only trading days with data are returned.", "maximum": 365, "minimum": 7, "type": "integer" } }, "type": "object" }, "name": "trading_days", "outputSchema": null }, { "description": "This key's credit usage for the current month: `used`, `base_cap`, `base_remaining`, `pack_remaining` (purchased top-ups, spent only after the base allowance runs out), `total_remaining`, plus a 6-month history in `monthly`. Use it to decide whether a wide sweep is affordable before starting one, and to tell a 429 that means 'out of credits' apart from one that means 'too fast' — the first will not clear by waiting. ⚠️ **Consumer keys only** (`kind=user`): partner and agent tokens are billed per contract and get 403 here — `whoami` reports quota for those instead. Checking usage is itself free and never cached.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" } }, "type": "object" }, "name": "usage", "outputSchema": null }, { "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 with research_entity_id attribution — prefer over `news`. Only ~10% of items have `full_text_available=true`, so an all-false page says nothing; pass `report_only=true` for the report stream, then `report` each. Default `fields=compact` (summary + ~300 chars); `fields=index` (~150 B/row) for a first pass over many rows, `full` only when needed. A+H: pass the A-share canonical for consolidated coverage.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "analyst": { "description": "Analyst Chinese name (exact / fuzzy)", "type": "string" }, "code": { "description": "Filter by security canonical_code (e.g. SSE:600519, HK:00700, US:AAPL)", "pattern": "^((SSE|SZSE|BSE):[0-9]{6}|HK:[0-9]{5}|US:[A-Z][A-Z0-9.\\-]{0,5})$", "type": "string" }, "fields": { "description": "Response shape: `index` (thinnest, ~150 B/row: id, published_at, source_label, primary security canonical_code/security_name/recommend_action, one-line headline, full_text_available, doc_kind — no body; 60 rows ≈ 9 KB, list-then-pick), `compact` (default — ai_summary + first ~300 chars; `securities` lists only non-primary names, `attachment` only kind/name) or `full` (complete content).", "enum": [ "index", "compact", "full" ], "type": "string" }, "from": { "description": "History range start (China date YYYY-MM-DD). Range mode: needs a filter; Pro-only up to 365 days back.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "institution": { "description": "Broker / institution Chinese name", "type": "string" }, "limit": { "default": 30, "description": "Max items per page", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "description": "Pagination offset for paging through long history ranges.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "report_only": { "description": "true = only formal research reports, i.e. views whose full text is archived and readable via `report` (full_text_available). Omit for the mixed feed (~10% reports). Use true whenever the task is to actually read sell-side research.", "type": "boolean" }, "since_days": { "default": 7, "description": "Lookback in days. ≤30 = rolling feed; >30 switches to range history (needs code / analyst / institution; Pro up to 365). `limit` applies newest-first within the window — read `actual_window` and page with `offset` if it falls short.", "maximum": 365, "minimum": 1, "type": "integer" }, "to": { "description": "History range end (inclusive, China date; defaults to today). Use with from.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" } }, "type": "object" }, "name": "views", "outputSchema": null }, { "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. ⚠️ **This is not `report`.** `report` returns the parsed long-form text of an archived sell-side PDF and only works where `full_text_available=true`; this returns the view record itself and works on every id. If the list row already carries what you need, do not call this — a `views` page at `fields=full` has the body inline. Free, and takes no scope of its own.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" }, "view_id": { "description": "View id from a `views` list row (items[].id)", "pattern": "^[0-9]+$", "type": "string" } }, "required": [ "view_id" ], "type": "object" }, "name": "views_get", "outputSchema": null }, { "description": "What this API key can do: `kind` (user / partner / agent), `scopes`, rate limit, monthly quota, `cli_release` (latest / minimum_supported — is this build behind), `endpoints` (entry-point policy), and `operations.available` / `operations.unavailable` (with `missing_scopes_any` or `not_allowed_for_kind`). Call this **before concluding a capability does not exist** — a missing tool or a 403 is usually an ungranted scope. Advisory (server is the authority). Free, cached 5 minutes.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "_fields": { "description": "逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq", "type": "string" }, "_intent": { "description": "用户原问题一句话,仅分析用,可留空", "maxLength": 200, "type": "string" }, "_jq": { "description": "JMESPath,对 data 求值(写 items[*].id)", "type": "string" }, "_max_bytes": { "description": "响应字节上限,默认约 50 KB", "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "_max_bytes_mode": { "description": "正文超限处理,默认 truncate 保留前缀", "enum": [ "truncate", "omit" ], "type": "string" }, "_spill": { "description": "true=全量落盘,只回摘要与取数地址", "type": "boolean" } }, "type": "object" }, "name": "whoami", "outputSchema": null } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:9c49a8123d6443dab6353d1334530a3c8db8644eaa395b586a8033b94212dcd8 | sha256sum