volume_ change_ vs_ avg
Today's volume relative to avg_volume_10d, the 10-session average that includes today. For a comparison against prior sessions only, use relative_volume.
Facts
A numeric signal: screen on it with a comparison operator (volume_change_vs_avg > 0.41). It's null on tickers it doesn't apply to.
| definition | Live: today's volume / avg_volume_10d, where avg_volume_10d is the mean of today's volume so far and the 9 sessions before it; 0 on a session with no volume. Past-date values do not follow this formula; for a volume ratio that is the same live and on past dates, use relative_volume. |
| type | numeric |
| refresh | 1 min · 4 AM–8 PM ET · crypto and FX 24/7 |
| grains | 1m 1h 1d |
| asset classes | US equities, Crypto |
| coverage | all tickers |
| history | 1d full · since 2003; 1h full · since 2003; 1m full · since 2003 |
| nullable | yes |
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": "volume_change_vs_avg > 0.41",
"order": "volume_change_vs_avg"
}'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": "volume_change_vs_avg > 0.41",
"asof": "2026-08-17",
"order": "volume_change_vs_avg"
}'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": "volume_change_vs_avg > 0.41",
"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,volume_change_vs_avg" \
-H "Authorization: Bearer YOUR_KEY"