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 yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:9c49a8123d6443dab6353d1334530a3c8db8644eaa395b586a8033b94212dcd8 | sha256sum