earnings_ this_ week
Earnings announcement scheduled in the next 7 days.
Facts
A boolean signal: screen on it by its bare name (earnings_this_week, or NOT earnings_this_week). It's null on tickers it doesn't apply to.
| definition | 0 <= days_to_earnings <= 7, from the forward earnings calendar and the reported earnings history. |
| type | state (boolean) |
| firing | continuous |
| refresh | post-close daily · 8:05 PM ET |
| grains | 1d |
| asset classes | US equities |
| coverage | all tickers |
| history | with known gaps · since 2003 |
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_this_week"
}'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_this_week",
"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_this_week",
"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_this_week" \
-H "Authorization: Bearer YOUR_KEY"Its firings
curl -G "https://api.tickerbot.io/v2/events" \
-d "kind=signal" -d "from=2026-04-09" -d "signal=earnings_this_week" -d "transition=enter" \
-H "Authorization: Bearer YOUR_KEY"