earnings-surprises
Retrieve historical earnings per share (EPS) surprises for any US stock, including actual vs. consensus estimates, surprise percentage, beat rate, and 30-day estimate revisions.
Instructions
Historical EPS beat/miss data for any US equity: actual EPS, consensus estimate, surprise %, beat rate, estimate revisions (30-day EPS drift), and next earnings date. Free Yahoo Finance data, no API key. Pairs with analyst-ratings and equity-fundamentals for a complete earnings intelligence stack.
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": "earnings-surprises"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | No | US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive. | |
| quarters | No | Number of past quarters to return (1-8, default 4). |