Earnings history
stocks_earningsRetrieve a company's earnings release history from 8-K Item 2.02 filings, sorted most recent first. Supports pagination with cursor or auto-collect via max_items.
Instructions
List a company's earnings-release history, sourced from 8-K Item 2.02 filings, most recent first. Paginate with cursor/limit, or set max_items to auto-collect across pages. For all 8-K material events (not just earnings) use stocks_events.
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_earnings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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). |