top_gainer signal | Tickerbot Docs

Facts

definition	`Ranks in the top 20 by change_1d_pct among active tickers with price above $1 and session volume above 100k shares.`
type	state (boolean)
firing	continuous
cadence	1 min · 4 AM–8 PM ET
intervals	`1m`
asset classes	US equities
universe	~1k most liquid tickers
history	recent only · since 2026

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": "top_gainer"
  }'

Backtest it at a past moment (minute grain)

curl -X POST "https://api.tickerbot.io/v2/scan" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "q": "top_gainer",
    "asof": "2026-08-08T17:45:00Z",
    "interval": "1m"
  }'

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": "top_gainer",
    "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 firings

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