events_upcoming
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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "events_upcoming"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _jq | No | JMESPath,对 data 求值(写 items[*].id) | |
| days | No | Forward window in days (1-180, default 14). Ignored when date_to is given. | |
| codes | No | Comma-separated canonical codes (max 200) to narrow to a portfolio | |
| kinds | No | 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 | |
| limit | No | 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. | |
| scope | No | Filter by subject scope | |
| _spill | No | true=全量落盘,只回摘要与取数地址 | |
| _fields | No | 逗号分隔的直接字段;有 items 时投影每行,否则投影 data;外层字段或嵌套结构用 _jq | |
| _intent | No | 用户原问题一句话,仅分析用,可留空 | |
| date_to | No | Window end YYYY-MM-DD. Span is capped at 180 days and clamped if longer. | |
| statuses | No | Comma-separated status set; defaults to `scheduled,postponed` (the two open states). Add `occurred` / `expired` to see what already passed. | |
| date_from | No | Window start YYYY-MM-DD (defaults to today) | |
| precision | No | `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`. | |
| _max_bytes | No | 响应字节上限,默认约 50 KB | |
| importance_min | No | Minimum importance (1-5, 5 highest — e.g. FOMC) | |
| _max_bytes_mode | No | 正文超限处理,默认 truncate 保留前缀 |