Skip to main content
GET
Top contracts by trailing-5-day flow

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer
default:100

Maximum rows to return. Server caps at 500.

Required range: 1 <= x <= 500
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"

ticker
string
min_premium
number<double>
max_premium
number<double>
min_volume
integer
Required range: x >= 0
max_volume
integer
Required range: x >= 0
min_oi
integer
Required range: x >= 0
max_oi
integer
Required range: x >= 0
right
enum<string>
Available options:
C,
P
min_dte
integer
max_dte
integer
min_strike
number<double>
max_strike
number<double>
expiration
string<date>
min_iv
number<double>
max_iv
number<double>
order_by
enum<string>
default:premium
Available options:
premium,
volume,
oi,
iv
order
enum<string>
default:desc
Available options:
asc,
desc
only_sweeps
boolean
default:false
only_multi_leg
boolean
default:false
exclude_multi_leg
boolean
default:false

Response

Top contracts for the trailing week.

data
object[]
required
meta
object
required