Options · Chains
Options chain model greeks
/v1/options/chain/model-greeksoptionsChainModelGreeksThe 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=SPXWconst params = new URLSearchParams({
underlying_symbol: "SPXW",
});
const res = await fetch(`https://api.ordermap.si/v1/options/chain/model-greeks?${params}`, {
headers: { Authorization: `Bearer ${process.env.ORDERMAP_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data, meta } = await res.json();
console.log(data, meta.coverage);
// Paginated: repeat with cursor_id set to pagination.next_cursor_id until it is null.Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.
Parameters
9 parameters, 1 required.
| Parameter | Type and limits | Description |
|---|---|---|
underlying_queryrequired | stringat 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_queryoptional | stringdate | Only this expiration, YYYY-MM-DD. |
contract_queryoptional | stringcallput | Only calls or only puts. |
min_queryoptional | number> 0max 99999.999 | Lowest strike to return, in dollars. |
max_queryoptional | number> 0max 99999.999 | Highest strike to return, in dollars. |
max_queryoptional | integermin 0max 1000 | Without date_of_expiry: include expirations up to this many days away (default 30). |
timestampqueryoptional | integerunix-msmin 946684800000max 4102444800000 | Value the chain at this retained minute (Unix milliseconds) instead of now. The minute must lie in a session whose history your plan covers. |
limitqueryoptional | integerdefault 1000min 1max 2500 | Maximum rows to return. |
cursor_queryoptional | stringat most 1024 characters | Opaque cursor returned as pagination.next_cursor_id; resumes the same query on the next page. |
Response
| Status | Meaning | Body |
|---|---|---|
200 | Successful response. | Schema below |
400 | Invalid, unknown or repeated parameters, or an invalid cursor. | Error object |
401 | Missing or invalid API key. | Error object |
403 | The plan, dataset release or account state does not allow this request. | Error object |
422 | The request is valid but no data exists for it. | Error object |
429 | Rate limit, burst limit or cooldown; wait Retry-After seconds.Retry-After | Error object |
500 | Internal error. | Error object |
503 | Data temporarily unavailable; retry after Retry-After seconds.Retry-After | Error object |
504 | The 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 insidecharmnumber | nullrequiredCharm: change of delta per day.contract_typestringrequiredCall or put.callputdate_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 objectpaginationobjectrequiredPagination 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.
