v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB

Contract

Raw enriched trades for a contract

Same enriched trade shape as /v1/underlying/{ticker}/trades, scoped to a single OPRA contract. Because the contract is fixed, chain-level filters (moneyness, strike, DTE, expiration) do not apply here.

get/v1/contract/{symbol}/trades

Path parameters

symbolstring required

Example:SPY__250516C00580000

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

Query parameters

startstring

Lower time bound — RFC 3339 or Unix seconds. Defaults to start-of-trading-day.

endstring

Upper time bound — RFC 3339 or Unix seconds. Defaults to now.

limitinteger

only_sweepsboolean

only_multi_legboolean

exclude_multi_legboolean

min_premiumnumber double

Response

Enriched trades for the contract.

Example response

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