Earnings by Ticker
GET/v1/earnings/{ticker}
Retrieve reported and estimated earnings for a ticker: report date, actual vs estimated EPS and revenue for each period. Use this to see whether a company beat or missed expectations, track the earnings calendar historically or feed surprise metrics into research tools. Results are ordered by report date, most recent first.
Use cases
- Earnings surprise and beat
/missanalysis - Historical EPS and revenue trend charts
- Pre-earnings research and estimate comparison
- Event-driven trading or alerting around report dates
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| limit | integer | Max results (default 500). |
Output parameters
| Field | Type | Description |
|---|---|---|
| results | array | Earnings reports, most recent first. |
| results[].ticker | string | Ticker. |
| results[].report_date | string | Report date (YYYY-MM-DD). |
| results[].eps_actual | float | Reported EPS. |
| results[].eps_estimated | float | Consensus EPS estimate. |
| results[].revenue_actual | float | Reported revenue. |
| results[].revenue_estimated | float | Consensus revenue estimate. |
| results[].last_updated | string | Last update timestamp (ISO 8601). |
| count | integer | Number of earnings records returned. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_earnings("AAPL")
print(result){
"results": [
{
"ticker": "AAPL",
"report_date": "2026-07-30",
"eps_actual": null,
"eps_estimated": 1.86,
"revenue_actual": null,
"revenue_estimated": 108393400000,
"last_updated": "2026-06-06"
},
{
"ticker": "AAPL",
"report_date": "2026-04-30",
"eps_actual": 2.01,
"eps_estimated": 1.95,
"revenue_actual": 111184000000,
"revenue_estimated": 109457600000,
"last_updated": "2026-06-06"
}
],
"count": 27
}