earnings_today signal | Tickerbot Docs

Facts

definition	`An earnings report dated today. Both pre-market and post-market reports count.`
type	event (boolean)
firing	sticky
cadence	daily · 4:01 AM ET
intervals	`1m` `1h` `1d`
asset classes	US equities
universe	all tickers
history	1d with known gaps · since 2003; 1h full · since 2003; 1m full · 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_today"
  }'

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_today",
    "asof": "2026-08-08"
  }'

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_today",
    "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/series?tickers=NVDA&columns=close,earnings_today" \
  -H "Authorization: Bearer YOUR_KEY"

Its firings

curl -G "https://api.tickerbot.io/v2/events" \
  -d "kind=signal" -d "signal=earnings_today" -d "transition=enter" -d "from=2026-03-31" \
  -H "Authorization: Bearer YOUR_KEY"