---
title: "Get session relative-volume history"
method: GET
path: "/companies/{ticker}/rvol-history"
tags: ["Companies"]
---

# Get session relative-volume history

`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`

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**

## Path parameters

- `ticker` string, required

## Query parameters

- `session` string
- `days` integer
- `asOfTime` string

## Response `200`

Session relative-volume time series

- object

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `402`: Not enough credits for this request
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/signal8/apis/signal8-public-api.md) · [All operations](https://skmtc.dev/signal8/apis/signal8-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signal8/apis/signal8-public-api/revisions/5a18ae8d6d58?raw)