Skip to main content
GET
/
v1
/
contract
/
{symbol}
/
rvol
Relative-volume bars for a contract
curl --request GET \
  --url https://flow-api.skylit.ai/v1/contract/{symbol}/rvol \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "bars": [
      {
        "timestamp": "<string>",
        "timestamp_end": "<string>",
        "volume": 1,
        "premium": 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
    }
  },
  "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

​
symbol
string
required

OPRA option symbol in URL-safe form: {ticker}__{YYMMDD}{C|P}{strike×1000, 8 digits} — the ticker and the 15-character contract block are joined by a double underscore (__). For example, an AAPL $250 call expiring 2026-01-17 is AAPL__260117C00250000. (A space-padded 21-char OCC form such as AAPL 260117C00250000 is also accepted on some endpoints, but the __ form is canonical and works across all contract routes.)

Example:

"SPY__250516C00580000"

Query Parameters

​
interval
string
default:1D
​
bucket
string
default:5min
​
avgPeriod
string
default:14d
​
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 for the contract.

​
data
object
required
​
meta
object
required