Sign in

v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB
Contract

Relative-volume bars for a contract

Same shape as /v1/underlying/{ticker}/rvol but scoped to a single contract.

get/v1/contract/{symbol}/rvol

Path parameters

symbolstring required
Example:SPY__250516C00580000

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.)

Query parameters

intervalstring
Example:1D

Trailing window — {N}D where N is 1–365.

bucket'1min' | '5min' | '10min' | '15min' | '30min' | '1d' | '1w'
avg_periodstring

Baseline lookback as {N}d (e.g. 14d). Max 365 days.

datestring date
Example:2026-05-27

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.

order_by'rvol' | 'volume' | 'premium' | 'time'
order'asc' | 'desc'

Sort direction. Defaults to asc when order_by=time, otherwise desc.

limitinteger
format'full' | 'summary'

Response

RVOL bars + aggregate stats for the contract.

Example response

{
  "meta": {
    "requestId": "d7574836"
  }
}