Get market and corporate events
get_market_eventsQuery upcoming and recent TWSE/TPEx market events—holidays, ex-dividend/rights dates, disposition and attention notices, and trading halts—by symbols, event type, and date window.
Instructions
Upcoming and recent events on TWSE and TPEx: market holidays (休市), ex-dividend / ex-rights dates (除權息) with cash dividend per share, disposition stocks under restricted trading (處置股), attention notices for unusual trading (注意股), and trading halts (暫停交易). Filter by symbols, kinds and a date window; events whose period overlaps the window are included. Default window: 14 days ago to 45 days ahead; giving only start or end keeps the other default. Each exchange dataset covers only a limited period, reported in coverage per kind and market: attention notices are for the latest trading day only, dispositions are recent announcements, ex-dividend schedules run a few weeks ahead, and holidays cover only the calendar year TWSE currently publishes. No event outside a dataset's from/to range means no data, not that nothing happened.
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": "get_market_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Window end, YYYY-MM-DD. | |
| kinds | No | Default: all of ["holiday","dividend","disposition","attention","halt"]. | |
| limit | No | Maximum events (default 100). | |
| start | No | Window start, YYYY-MM-DD. | |
| market | No | Omit for both markets. | |
| symbols | No | Only events for these codes or exact names. Holidays are always included unless excluded via kinds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| start | Yes | ||
| total | Yes | ||
| events | Yes | ||
| coverage | Yes | Per dataset: what it keeps (scope) and the event dates it actually contained (from/to, null when empty). | |
| warnings | Yes | ||
| truncated | Yes | ||
| unresolved | Yes |