Skip to main content
GET
/
v1
/
contract
/
{symbol}
/
history
Daily history for a contract
curl --request GET \
  --url https://flow-api.skylit.ai/v1/contract/{symbol}/history \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "date": "2023-12-25",
      "totalPremium": 123,
      "totalVolume": 1,
      "openInterest": 1,
      "oiChange": 123,
      "oiChangePct": 123,
      "bidVolume": 1,
      "askVolume": 1,
      "midVolume": 1,
      "bidPct": 123,
      "askPct": 123,
      "sweepVolume": 1,
      "multiLegVolume": 1,
      "sweepPct": 123,
      "multiLegPct": 123,
      "vwap": 123,
      "lastPrice": 123,
      "underlyingPrice": 123,
      "iv": 123,
      "tradeCount": 1
    }
  ],
  "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.

Path Parameters

symbol
string
required

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

Example:

"SPY__250516C00580000"

Query Parameters

startDate
string<date>
required
endDate
string<date>
required

Response

One row per trading day.

data
object[]
required
meta
object
required