Skip to content

Options · Volatility

Options volatility model free

Model-free implied volatility and skew index per expiration and at 30 days, with its gap to at-the-money volatility.
GET/v1/options/volatility/model-freeoptionsVolatilityModelFree
On this page

For 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=SPXW

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

Parameters

4 parameters, 1 required.

ParameterType and limitsDescription
underlying_symbolqueryrequiredstringat 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 ...
datequeryoptionalstringdateTrading date (YYYY-MM-DD). Default: the current session, else the most recent completed one.
sessionqueryoptionalstringrthgthdefault rthTrading 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_expirationsqueryoptionalintegerdefault 8min 1max 12Number of expirations, nearest first, with at least one day to run.

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

  • dataobjectrequiredModel-free volatility.26 fields inside
    • constant_30dobjectrequiredInterpolated to 30 days.2 fields inside
      • model_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 inside
      • atm_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.rthgthcurball
    • trading_datestringdaterequiredTrading date valued.
    • underlying_symbolstringrequiredThe requested underlying.
    • valuationobjectrequiredWhat the snapshot was valued on.7 fields inside
      • chain_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.