Options · Volatility
Options volatility model free
/v1/options/volatility/model-freeoptionsVolatilityModelFreeFor each expiration, the model-free implied volatility (the method the volatility indexes use: the variance is the weighted sum of out-of-the-money option prices over every strike, with no pricing model), its gap to the at-the-money volatility (the convexity premium), the skewness of the implied log return and the skew index 100 - 10 x skewness, which is above 100 when the left tail is heavier. truncated is true when the quoted strikes stop while the outermost one still carries more than 1% of the variance. constant_30d interpolates the two expirations around 30 days in total variance; it is null when none brackets 30 days. Volatilities are decimals solved from the option chain by the platform.
Example request
curl -sS --get "https://api.ordermap.si/v1/options/volatility/model-free" \
-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/volatility/model-free?${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);Set ORDERMAP_API_KEY to your key. Replace the dates with a recent trading date.
Parameters
4 parameters, 1 required.
| Parameter | Type and limits | Description |
|---|---|---|
underlying_queryrequired | stringat most 8 characterspattern ^[A-Za-z][A-Za-z0-9.]{0,7}$ | Option root or family: SPX covers the SPX and SPXW roots, SPXW only the weekly root, QQQ, NDXP, RUTW, XSP ... |
datequeryoptional | stringdate | Trading date (YYYY-MM-DD). Default: the current session, else the most recent completed one. |
sessionqueryoptional | stringrthgthdefault rth | Trading session: rth is the regular session, gth the overnight (global trading hours) session before the trading date. Overnight data requires the Pro plan and exists only for underlyings with an overnight session; GET /v1/options/sessions shows which. |
max_queryoptional | integerdefault 8min 1max 12 | Number of expirations, nearest first, with at least one day to run. |
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
dataobjectrequiredModel-free volatility.26 fields insideconstant_30dobjectrequiredInterpolated to 30 days.2 fields insidemodel_free_volnumber | nullrequiredModel-free volatility at 30 days.skew_indexnumber | nullrequiredSkew index at 30 days.
expirationsarray<object>requiredThe nearest expirations with at least a day to run.10 fields insideatm_ivnumber | nullrequiredAt-the-money implied volatility.convexity_premiumnumber | nullrequiredmodel_free_vol minus atm_iv.date_of_expirystringdaterequiredExpiration.dteintegerrequiredCalendar days from the trading date.forwardnumber | nullrequiredForward price implied by the chain.model_free_volnumber | nullrequiredModel-free implied volatility.skew_indexnumber | nullrequired100 minus 10 times the skewness.skewnessnumber | nullrequiredSkewness of the implied log return.strikes_usedintegerrequiredStrikes with a usable volatility.truncatedboolean | nullrequiredThe outermost strike still carries more than 1% of the variance: the strike range stops too soon.
rootsarray<string>requiredOption roots included.sessionstringrequiredSession valued.rthgthcurballtrading_datestringdaterequiredTrading date valued.underlying_symbolstringrequiredThe requested underlying.valuationobjectrequiredWhat the snapshot was valued on.7 fields insidechain_timestampinteger | nullunix-msrequiredTime of the option chain the valuation used. Unix epoch milliseconds (UTC).open_interest_datestring | nulldaterequiredDate of the open interest the positioning is based on.risk_free_ratenumber | nullrequiredContinuously compounded risk-free rate used.timestampinteger | nullunix-msrequiredValuation time. Unix epoch milliseconds (UTC).underlying_pricenumber | nullrequiredUnderlying price used.underlying_stalebooleanrequiredThe underlying price is older than the freshness limit.underlying_timestampinteger | nullunix-msrequiredTime of the underlying price. Unix epoch milliseconds (UTC).
metaobjectrequiredMeta object
Example response
{
"data": {
"constant_30d": {
"model_free_vol": 0.171,
"skew_index": 112.4
},
"expirations": [
{
"atm_iv": 0.152,
"convexity_premium": 0.006,
"date_of_expiry": "2026-10-23",
"dte": 7,
"forward": 6026.3,
"model_free_vol": 0.158,
"skew_index": 111,
"skewness": -1.1,
"strikes_used": 118,
"truncated": false
}
],
"roots": [
"SPX",
"SPXW"
],
"session": "rth",
"trading_date": "2026-10-16",
"underlying_symbol": "SPX",
"valuation": {
"chain_timestamp": 1792160995000,
"open_interest_date": "2026-10-15",
"risk_free_rate": 0.0412,
"timestamp": 1792161000000,
"underlying_price": 6021.4,
"underlying_stale": false,
"underlying_timestamp": 1792160999000
}
},
"meta": {
"as_of": 1760659200123,
"coverage": {
"complete": true
},
"delay_ms": 0,
"delayed": false,
"request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
"source": "opra"
}
}Values are illustrative. Missing values are null, never 0.
