Get RVOL History
get_rvol_historyRetrieve per-day relative-volume (RVOL) history for a ticker by trading session, comparing each session to its trailing same-session baseline to reveal unusual volume surges.
Instructions
Get the per-day relative-volume (RVOL) time series for a ticker, bucketed by trading session (premarket 04:00-09:30 ET, regular 09:30-16:00, afterhours 16:00-20:00, or all four). Each day's RVOL compares that session's volume to a trailing same-session baseline (30 trading days by default, configurable via "baselineDays"), so premarket volume is judged against premarket history (not a stale full-day figure); the series shows unusual premarket / session volume surges over the last N days. Each point also carries "baselineState": "ready" (rvol is populated), "warming" (baseline not yet warm), "no-cutoff-history" (established ticker that never traded at this session/cutoff before) or "no-history" (new listing, no prior trading history at all), so a null rvol is explained rather than silent. Points additionally carry "advRatio" (that day's volume / the trailing 30-session average full-day volume, null when no full-day denominator exists) and "advDays" (its sample size), which give a magnitude to points RVOL cannot rate. advRatio is not an RVOL: it compares a partial session to a whole day, so it is typically well under 1 and is not comparable to rvol.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "get_rvol_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Number of trailing calendar days of history (1–90, default 30). | |
| ticker | Yes | Stock ticker symbol (e.g., "AAPL", "TSLA") | |
| session | No | One session bucket; unset returns all four sessions. | |
| asOfTime | No | Optional true time-of-day premarket basis. Any HH:MM ET premarket time; snapped to the nearest 15-minute grid cutoff (04:00–09:15, ties resolve to the earlier cutoff). When set, the series is the premarket as-of RVOL: cumulative volume known by that cutoff / the trailing baselineDays (default 30) average of the same cutoff (not the full 04:00-09:30 session). Forces the premarket session; any "session" argument is ignored. Each point carries a "basis" field: the snapped cutoff actually used ("asof-0700"), or "full-session" for dates with no precomputed as-of row. Unset means the standard full-session series. | |
| baselineDays | No | Rolling RVOL baseline window, in trading rows (same-session days). Default 30; values outside 20-250 are clamped. This is the DENOMINATOR window: every RVOL in the response is that period's volume divided by the average of the trailing N same-session (or same-cutoff) days, excluding the day itself. A SHORTER window tracks recent regime changes faster and is noisier; a LONGER one is smoother and slower to react. The warm-up lookback scales with it automatically, so a wide window is never under-filled into an inflated ratio; the minimum-warm-days gate (20 prior sessions) does NOT scale down, so at the 30-row default a ticker needs 20 of its last 30 sessions populated before rvol is non-null. Unset means the standard 30-day baseline; 90 reproduces the pre-2026-09 window. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No |