Skip to main content
GET
/
v1
/
contract
/
{symbol}
/
trades
Raw enriched trades for a contract
curl --request GET \
  --url https://flow-api.skylit.ai/v1/contract/{symbol}/trades \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "date": 123,
      "ts_event": 123,
      "instrument_id": 123,
      "raw_symbol": "SPY   250516C00580000",
      "ticker": "SPY",
      "expiration": 123,
      "strike": 123,
      "dte": 123,
      "price": 123,
      "size": 1,
      "publisher_id": 123,
      "neutral_sz": 123,
      "total_premium": 123,
      "underlying_price": 123,
      "moneyness_percent": 123,
      "open_interest": 1,
      "prev_oi": 1,
      "daily_volume": 1,
      "sweep_trade": true,
      "block_trade": true,
      "multi_leg": true,
      "ingestion_timestamp": 123,
      "ts_event_us": 123,
      "bid_px": 123,
      "ask_px": 123,
      "bid_sz": 123,
      "ask_sz": 123,
      "spread": 123,
      "iv": 123,
      "prev_close": 123,
      "prev_close_age": 1,
      "price_change": 123,
      "prev_iv": 123,
      "next_iv": 123,
      "flow_score": 0,
      "chain_bid_pct": 123,
      "chain_ask_pct": 123,
      "contract_bid_pct": 123,
      "contract_ask_pct": 123,
      "agg_count": 1,
      "agg_total_premium": 123,
      "agg_total_size": 1,
      "ml_sibling": true,
      "strategy_group_id": "<string>",
      "strategy_type": "<string>",
      "strategy_leg_count": 2,
      "earnings_dte": 123,
      "next_earnings_date": 123,
      "cache_miss": true,
      "sector": "<string>",
      "industry": "<string>"
    }
  ],
  "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

start
string
end
string
limit
integer
default:500
Required range: 1 <= x <= 5000
onlySweeps
boolean
onlyMultiLeg
boolean
excludeMultiLeg
boolean
moneyness
enum<string>
Available options:
ITM,
ATM,
OTM
minMoneynessPct
number<double>
maxMoneynessPct
number<double>
minPremium
number<double>
Required range: x >= 0
minDte
integer
maxDte
integer
minStrike
number<double>
maxStrike
number<double>
expiration
string<date>

Response

Enriched trades for the contract.

data
object[]
required
meta
object
required