Skip to content

Options · Chains

Options chain model greeks

The platform's own implied volatility and Greeks through third order for every contract, live or at a retained minute, without quotes.
On this page

The implied volatility and Greeks the platform computes itself from the option chain for every contract: delta, gamma, theta, vega, rho, vanna, charm, vomma, speed and zomma, with the open interest, live (including the overnight session for the roots that trade overnight, when your plan covers it) or at any retained minute with timestamp. Values are per share, not per contract: theta per day, vega per volatility point, rho per 1% of rate, vanna per volatility point (a delta), charm per day (a delta), vomma per volatility point squared, speed per $1 and zomma per volatility point (a gamma). A contract the model cannot value is null. No bid, offer, mid or last price is returned. Rows are ordered by date_of_expiry, strike, contract_type (call before put) and paginated with cursor_id; a page reads one expiration at a time and may hold fewer rows than limit. When no date_of_expiry is given the chain covers the expirations within max_dte days (default 30). Pages follow a snapshot by row offset: if the data was refreshed between pages the response carries the warning snapshot_changed.

Example request

curl -sS --get "https://api.ordermap.si/v1/options/chain/model-greeks" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode underlying_symbol=SPXW

Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.

Parameters

9 parameters, 1 required.

ParameterType and limitsDescription
underlying_symbolqueryrequiredstringat most 8 characterspattern ^[A-Za-z][A-Za-z0-9.]{0,7}$Underlying: an option root (SPXW, QQQ, NDXP ...) or an index family: SPX covers the SPX and SPXW roots, NDX the NDX and NDXP roots, RUT the RUT and RUTW roots. Rows name the root of each contract.
date_of_expiryqueryoptionalstringdateOnly this expiration, YYYY-MM-DD.
contract_typequeryoptionalstringcallputOnly calls or only puts.
min_strikequeryoptionalnumber> 0max 99999.999Lowest strike to return, in dollars.
max_strikequeryoptionalnumber> 0max 99999.999Highest strike to return, in dollars.
max_dtequeryoptionalintegermin 0max 1000Without date_of_expiry: include expirations up to this many days away (default 30).
timestampqueryoptionalintegerunix-msmin 946684800000max 4102444800000Value the chain at this retained minute (Unix milliseconds) instead of now. The minute must lie in a session whose history your plan covers.
limitqueryoptionalintegerdefault 1000min 1max 2500Maximum rows to return.
cursor_idqueryoptionalstringat most 1024 charactersOpaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page.

Response

StatusMeaningBody
200Successful response.Schema below
400Invalid, unknown or repeated parameters, or an invalid cursor.Error object
401Missing or invalid API key.Error object
403The plan, dataset release or account state does not allow this request.Error object
422The request is valid but no data exists for it.Error object
429Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-AfterError object
500Internal error.Error object
503Data temporarily unavailable; retry after Retry-After seconds.Retry-AfterError object
504The request timed out.Error object

Authenticated responses carry the X-RateLimit-* headers (see rate limits); 429 and 503 add Retry-After.

200 response body

  • dataarray<object>required17 fields inside
    • charmnumber | nullrequiredCharm: change of delta per day.
    • contract_typestringrequiredCall or put.callput
    • date_of_expirystringdaterequiredExpiration date.
    • deltanumber | nullrequiredDelta.
    • gammanumber | nullrequiredGamma per $1 of the underlying.
    • ivnumber | nullrequiredImplied volatility as a decimal (0.18 = 18%).
    • open_interestinteger | nullrequiredOpen interest.
    • option_symbolstringrequiredOCC option symbol of the contract: root padded to six characters, expiration YYMMDD, C or P and the strike in thousandths over eight digits.
    • rhonumber | nullrequiredRho in dollars per share per 1% of rate.
    • speednumber | nullrequiredSpeed: change of gamma per $1.
    • strikenumberrequiredStrike price in dollars.
    • thetanumber | nullrequiredTheta in dollars per share per day.
    • underlying_symbolstringrequiredOption root of the contract.
    • vannanumber | nullrequiredVanna: change of delta per volatility point.
    • veganumber | nullrequiredVega in dollars per share per volatility point.
    • vommanumber | nullrequiredVomma in dollars per share per volatility point squared.
    • zommanumber | nullrequiredZomma: change of gamma per volatility point.
  • metaobjectrequiredMeta object
  • paginationobjectrequiredPagination object

Example response

{
  "data": [
    {
      "charm": 0.0031,
      "contract_type": "call",
      "date_of_expiry": "2026-10-16",
      "delta": 0.5123,
      "gamma": 0.0042,
      "iv": 0.142,
      "open_interest": 4321,
      "option_symbol": "SPXW  261016C06000000",
      "rho": 0.91,
      "speed": -0.00001,
      "strike": 6000,
      "theta": -3.41,
      "underlying_symbol": "SPXW",
      "vanna": -0.012,
      "vega": 2.87,
      "vomma": 0.11,
      "zomma": -0.0002
    }
  ],
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "opra"
  },
  "pagination": {
    "count": 1,
    "has_more": false,
    "limit": 1000,
    "next_cursor_id": null,
    "next_url": null
  }
}

Values are illustrative. Missing values are null, never 0.