tickerbot.io

premarket_change_pct

Pre-market: percent change from the previous close to the latest pre-market trade. Resets at the session boundary.

Facts

A numeric signal: screen on it with a comparison operator (premarket_change_pct > 15). It's null on tickers it doesn't apply to.

definition(latest pre-market trade, 04:00-09:30 ET - previous regular-session close) / previous regular-session close x 100; null before the session's first pre-market trade
typenumeric
unit%
refresh1 min · 4 AM–8 PM ET
grains1m 1h 1d
asset classesUS equities
coverageall tickers
history1d full · since 2003; 1h full · since 2003; 1m full · since 2003
nullableyes

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": "premarket_change_pct > 15",
    "order": "premarket_change_pct"
  }'

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": "premarket_change_pct > 15",
    "asof": "2026-08-17",
    "order": "premarket_change_pct"
  }'

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": "premarket_change_pct > 15",
    "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,premarket_change_pct" \
  -H "Authorization: Bearer YOUR_KEY"