Companies

Get session relative-volume history

Get a per-day relative-volume (RVOL) time series for a company, where each day's session volume is compared against the trailing 90-day average of the same trading session. Sessions are premarket (04:00-09:30 ET), regular (09:30-16:00 ET), afterhours (16:00-20:00 ET), and all (the full extended day). Returns 200 with an empty series when no history exists yet.

Pass asOfTime for a TRUE time-of-day premarket series: the day's cumulative premarket volume known BY that ET cutoff, divided by the 90-day average of the SAME cutoff (not the full 04:00-09:30 session). The requested time snaps to the nearest 15-minute grid cutoff between 04:00 and 09:15 (ties resolve to the earlier cutoff) and forces the premarket bucket. Each point then carries a basis field naming the snapped cutoff used (asof-0700), or full-session for dates with no precomputed as-of row.

Credit cost: 3

get/companies/{ticker}/rvol-history

Request

  • Base URL: https://api.signal8.ai/api/v1/public
  • URL: https://api.signal8.ai/api/v1/public/companies/{ticker}/rvol-history
  • Auth: API key in header X-Api-Key

Path parameters

tickerstring required

Company ticker symbol (1-5 letters, case-insensitive)

Query parameters

sessionstring

Restrict to one session bucket; omit to return all four. Ignored when asOfTime is supplied (premarket is forced).

daysinteger

Series length in calendar days (1-90, default 30). Returns this many points PER session, so keep it tight.

asOfTimestring

Premarket-only true time-of-day basis (HH:MM ET), snapped to the nearest 15-minute cutoff 04:00-09:15. Both the RVOL numerator and its 90-day baseline are taken at that cutoff. Malformed values are ignored (full-session).

Response

Session relative-volume time series

object required

Changes

No recorded changes to this operation across all 1 revision of this API.