v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB

Underlying

Raw enriched trades for a ticker

Returns the raw enriched trade rows that feed the chart bars and the live feed. Supports rich filtering — sweep-only / multi-leg, moneyness, premium floor, DTE / strike / expiration windows. See OptionTradeRow below.

get/v1/underlying/{ticker}/trades

Path parameters

tickerstring required

Example:SPY

Underlying ticker symbol (uppercase, e.g. SPY, AAPL).

Query parameters

startstring

Lower time bound — ISO 8601 (e.g. 2026-01-12T09:30:00Z) or Unix seconds. Defaults to start-of-trading-day.

endstring

Upper time bound — ISO 8601 or Unix seconds. Defaults to now.

limitinteger

only_sweepsboolean

only_multi_legboolean

exclude_multi_legboolean

moneyness'ITM' | 'ATM' | 'OTM'

min_moneyness_pctnumber double

max_moneyness_pctnumber double

min_premiumnumber double

min_dteinteger

max_dteinteger

min_strikenumber double

max_strikenumber double

expirationstring date

Response

Filtered enriched trades.

Example response

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