earnings_ date
Next earnings announcement date. Where the company has not published one, the date is projected from its own reporting history and earnings_date_projected is true.
Facts
A date signal: screen on it with a comparison operator (earnings_date BETWEEN now() AND now() + interval '7 days'). It's null on tickers it doesn't apply to.
| type | date |
| refresh | post-close daily |
| grains | 1d |
| asset classes | US equities |
| coverage | all tickers |
| history | full · since 2003 |
| nullable | yes |
Examples
Screen on it
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "earnings_date BETWEEN now() AND now() + interval '"'"'7 days'"'"'"
}'Backtest it on a past date
curl -X POST "https://api.tickerbot.io/v2/scan" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "earnings_date BETWEEN now() AND now() + interval '"'"'7 days'"'"'",
"asof": "2026-08-17"
}'Get an alert when a ticker starts matching
curl -X POST "https://api.tickerbot.io/v2/scan/subscribe" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_KEY" \
-d '{
"q": "earnings_date BETWEEN now() AND now() + interval '"'"'7 days'"'"'",
"target_url": "https://example.com/hooks/tickerbot"
}'Returns 201 with the created webhook object; deliveries carry the tickers matching the condition at each evaluation.
Its history
curl "https://api.tickerbot.io/v2/tickers/NVDA/history?select=close,earnings_date" \
-H "Authorization: Bearer YOUR_KEY"