Skip to content

Options · Volatility

Options volatility term structure history

Daily constant-maturity implied volatility for up to three maturities, with slope and contango or backwardation.
GET/v1/options/volatility/term-structure/historyoptionsVolatilityTermHistory
On this page

One row per trading date with the constant-maturity implied volatility of up to three maturities (7, 14, 30, 60, 90, 180 or 365 days; 7, 30 and 90 by default), the slope (the longest maturity minus the shortest with a value) and the state: contango when the slope is above 0.005, backwardation when it is below -0.005, flat otherwise. The history is the platform's own daily record, read once per maturity; dates it holds no value for are null. Rows are limited to your plan's history window (up to 365 days); the history is read over 365 days either way, and meta.coverage says when older rows were withheld.

Example request

curl -sS --get "https://api.ordermap.si/v1/options/volatility/term-structure/history" \
  -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

2 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 ...
maturitiesqueryoptionalarray<string>comma-separated in one parameter7143060901803651 to 3 itemsOne to three constant maturities in days, comma separated: 7, 14, 30, 60, 90, 180 or 365. Default 7,30,90.

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>required6 fields inside
    • datestringdaterequiredTrading date.
    • ivarray<object>requiredImplied volatility per requested maturity, shortest first.2 fields inside
      • implied_volatilitynumber | nullrequiredImplied volatility as a decimal.
      • maturity_daysintegerrequiredDays.
    • slopenumber | nullrequiredLongest maturity minus shortest maturity with a value; null with fewer than two.
    • statestring | nullrequiredcontango (slope above 0.005), backwardation (below -0.005) or flat.contangobackwardationflatnull
  • metaobjectrequiredMeta object

Example response

{
  "data": [
    {
      "date": "2026-10-16",
      "iv": [
        {
          "implied_volatility": 0.141,
          "maturity_days": 7
        },
        {
          "implied_volatility": 0.171,
          "maturity_days": 30
        },
        {
          "implied_volatility": 0.186,
          "maturity_days": 90
        }
      ],
      "slope": 0.045,
      "state": "contango"
    }
  ],
  "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.