v1

latestOpenAPI 3.1.02026-07-2655154175.6 KB

Ratios

Per-contract bid/ask/mid distribution

Single-contract counterpart to /v1/chain-ratio/{ticker}. Returns askRatio, bidRatio, midRatio, aggressionRatio, and a bias/aggression/confidence interpretation for one specific OPRA option symbol.

get/v1/contract-ratio/{symbol}

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

datestring date

timeframe'5m' | '15m' | '1h' | '4h' | '1d'

min_premiuminteger

Response

Contract ratio analysis with interpretation.

Example response

{
  "data": {
    "symbol": "SPY 250516C00580000"
  },
  "meta": {
    "requestId": "d7574836"
  }
}