Material events
stocks_eventsRetrieve a company's 8-K material-event filings, filtered by item code, with pagination support.
Instructions
List a company's 8-K material-event filings, optionally filtered to a single item code (e.g. 2.02). Most recent first; paginate with cursor/limit, or set max_items to auto-collect across pages. For earnings releases specifically use stocks_earnings.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "stocks_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | No | Filter by 8-K item code, e.g. "2.02". | |
| limit | No | Page size (endpoint-specific default and max). | |
| cursor | No | Opaque cursor from a previous response's meta.next_cursor. | |
| ticker | Yes | US equity ticker, e.g. AAPL. | |
| max_items | No | If set, auto-paginate across pages and return up to this many items (ignores cursor). |