Skip to main content
GET
/
v1
/
underlying
/
{ticker}
/
rvol
Relative-volume bars for a ticker
curl --request GET \
  --url https://flow-api.skylit.ai/v1/underlying/{ticker}/rvol \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "bars": [
      {
        "timestamp": "<string>",
        "timestamp_end": "<string>",
        "call_volume": 1,
        "put_volume": 1,
        "volume": 1,
        "premium": 123,
        "stock_price": 123,
        "avg_call_volume": 123,
        "avg_put_volume": 123,
        "avg_volume": 123,
        "avg_premium": 123,
        "avg_days_count": 123
      }
    ],
    "stats": {
      "today_volume": 1,
      "today_premium": 123,
      "avg_volume": 123,
      "avg_premium": 123,
      "rvol_volume": 123,
      "rvol_premium": 123,
      "avg_days_count": 1
    },
    "call_rvol": 123,
    "put_rvol": 123
  },
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "requestId": "d7574836"
  }
}

Authorizations

Authorization
string
header
required

Skylit API key in the Authorization header (Authorization: Bearer fs_live_<key>). X-API-Key is also accepted.

Path Parameters

ticker
string
required

Underlying ticker symbol (uppercase, e.g. SPY, AAPL).

Example:

"SPY"

Query Parameters

interval
string
default:1D
bucket
string
default:5min
avgPeriod
string
default:14d

Lookback for the baseline (e.g. 14d, 30d).

date
string<date>

Trading date the request targets, in YYYY-MM-DD. Defaults to the current trading date (the most recent session that has settled enough data to be queryable). Past dates fall through to the daily rollup tables.

Example:

"2026-05-27"

orderBy
enum<string>
default:time
Available options:
rvol,
volume,
premium,
time
order
enum<string>
Available options:
asc,
desc
limit
integer
Required range: x >= 1
format
enum<string>
default:full
Available options:
full,
summary

Response

RVOL bars + aggregate stats (snake_case).

data
object
required
meta
object
required