Skip to main content
GET
/
v1
/
contract
/
unusual-volume
Contracts with unusual relative volume
curl --request GET \
  --url https://flow-api.skylit.ai/v1/contract/unusual-volume \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "symbol": "<string>",
      "ticker": "<string>",
      "expiration": "2023-12-25",
      "strike": 123,
      "dte": 123,
      "date": "2023-12-25",
      "volume": 1,
      "avgVolume": 123,
      "rvol": 123,
      "premium": 123,
      "openInterest": 1,
      "prevOi": 1,
      "oiChange": 123,
      "oiChangePct": 123,
      "volumeOiRatio": 123,
      "bidVolume": 1,
      "askVolume": 1,
      "bidPct": 123,
      "askPct": 123,
      "lastPrice": 123,
      "underlyingPrice": 123,
      "iv": 123,
      "moneynessPct": 123,
      "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
minRvol
number<double>
default:2
avgPeriod
string
default:10d
minAvgVolume
integer
default:100
Required range: x >= 0
minPremium
number<double>
ticker
string
right
enum<string>
Available options:
C,
P
minDte
integer
maxDte
integer
minStrike
number<double>
maxStrike
number<double>
expiration
string<date>
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:rvol
Available options:
rvol,
volume,
premium,
volOi,
oiChange
minVolOiRatio
number<double>
minOiChange
integer
maxOiChange
integer
onlySweeps
boolean
onlyMultiLeg
boolean
excludeMultiLeg
boolean
minOiChangePct
number<double>
minBidImbalance
number<double>
Required range: 0 <= x <= 1
minAskImbalance
number<double>
Required range: 0 <= x <= 1
moneyness
enum<string>
Available options:
ITM,
ATM,
OTM
minMoneynessPct
number<double>
maxMoneynessPct
number<double>
minIv
number<double>
maxIv
number<double>
excludeTickers
string

Comma-separated tickers to exclude (e.g. SPY,QQQ,IWM).

Response

Contracts ranked by the requested metric.

data
object[]
required
meta
object
required