Retrieve upcoming and historical earnings announcement dates, expected EPS, revenue estimates, and confirmed reporting times. Filter by date range or specific symbols to track quarterly earnings releases and plan trades around volatility events.
Use Case: Alert users 24 hours before their portfolio holdings report earnings to manage position risk.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Start date in YYYY-MM-DD format
"2024-01-01"
End date in YYYY-MM-DD format
"2024-01-31"
Optional stock symbol to filter results. If not provided, returns earnings for all symbols.
"AAPL"
Earnings calendar data retrieved successfully
Earnings release date
Actual earnings per share
Estimated earnings per share
Time of day for earnings release: 'bmo' (before market open), 'amc' (after market close), 'dmh' (during market hours)
Quarter number (1-4)
Actual revenue
Estimated revenue
Stock ticker symbol
Year of the earnings
Company name
Difference between actual and estimated EPS
Difference between actual and estimated revenue
Market capitalization in millions
Company logos for UI display
Analyst ratings summary