The Vol Radar API uses standard HTTP status codes. Error bodies are JSON with a detail field.
Status codes
Paging
/v1/signals pages with limit (1–1,000, default 100) and offset. The response gives count, the number of
matching signals, so you can page until offset + limit >= count. Signals are sorted by first day (newest first),
then tier, then score.
Defaults worth knowing
/v1/signals without date, from or changed_since returns signals first detected in the 30 days to the
last day of data.
/v1/signals?date=… without status returns the active signals (new, escalated or ongoing).
/v1/snapshot on a date with no data (a weekend, a holiday) returns the latest earlier day; date in the
response says which.
/v1/series defaults to the 30D bucket.
Versions and the closed beta
- Paths start with
/v1. /v1/status reports api_version.
- During the closed beta, fields may still be added or renamed. Breaking changes are announced to beta users first.
- A signal’s published evidence and earlier-case outcomes never change; see
Keep a local copy up to date for the cases where a signal is updated or withdrawn.
Last modified on November 3, 2026