v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB
Contract

Daily history for a contract

Daily aggregates per trading day in [startDate, endDate] — total premium / volume, OI dynamics, bid/ask execution split, sweep and multi-leg shares, VWAP, last price, IV, and trade count.

get/v1/contract/{symbol}/history

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

start_datestring date required
end_datestring date required

Response

One row per trading day.

Example response

{
  "meta": {
    "requestId": "d7574836"
  }
}