tickerbot.io
Data › Signals › Events › Earnings

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.

definition0 <= days_to_earnings <= 7, from the forward earnings calendar and the reported earnings history.
typestate (boolean)
firingcontinuous
refreshpost-close daily · 8:05 PM ET
grains1d
asset classesUS equities
coverageall tickers
historywith 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"