v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB

Contract

Top contracts by trailing-5-day flow

Same shape as /v1/contract/top/daily, rolled up over the trailing 5 trading days ending on date.

get/v1/contract/top/weekly

Query parameters

limitinteger

Maximum rows to return. Server caps at 500.

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.

tickerstring

min_premiumnumber double

max_premiumnumber double

min_volumeinteger

max_volumeinteger

min_oiinteger

max_oiinteger

right'C' | 'P'

min_dteinteger

max_dteinteger

min_strikenumber double

max_strikenumber double

expirationstring date

min_ivnumber double

max_ivnumber double

order_by'premium' | 'volume' | 'oi' | 'iv'

order'asc' | 'desc'

only_sweepsboolean

only_multi_legboolean

exclude_multi_legboolean

Response

Top contracts for the trailing week.

Example response

{
  "data": [
    {
      "symbol": "SPY 250516C00580000"
    }
  ],
  "meta": {
    "requestId": "d7574836"
  }
}