Skip to main content
GET
/
v1
/
contract
/
top
/
daily
Top contracts by daily flow
curl --request GET \
  --url https://flow-api.skylit.ai/v1/contract/top/daily \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "symbol": "SPY 250516C00580000",
      "ticker": "<string>",
      "expiration": "2023-12-25",
      "strike": 123,
      "dte": 123,
      "totalPremium": 123,
      "totalVolume": 1,
      "openInterest": 1,
      "oiChange": 123,
      "volumeOiRatio": 123,
      "bidVolume": 1,
      "askVolume": 1,
      "midVolume": 1,
      "vwap": 123,
      "lastPrice": 123,
      "underlyingPrice": 123,
      "iv": 123,
      "tradeCount": 1,
      "sweepVolume": 1,
      "sweepPremium": 123,
      "multiLegVolume": 1,
      "multiLegPremium": 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.

Query Parameters

limit
integer
default:50

Maximum rows to return.

Required range: 1 <= x <= 200
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
Example:

"SPY"

minPremium
number<double>
maxPremium
number<double>
minVolume
integer
Required range: x >= 0
maxVolume
integer
Required range: x >= 0
minOi
integer
Required range: x >= 0
maxOi
integer
Required range: x >= 0
right
enum<string>
Available options:
C,
P
minDte
integer
maxDte
integer
minStrike
number<double>
maxStrike
number<double>
expiration
string<date>
minIv
number<double>
maxIv
number<double>
orderBy
enum<string>
default:premium
Available options:
premium,
volume,
oi,
iv
order
enum<string>
default:desc
Available options:
asc,
desc
onlySweeps
boolean
default:false
onlyMultiLeg
boolean
default:false
excludeMultiLeg
boolean
default:false

Response

Top contracts for the day.

data
object[]
required
meta
object
required