Skip to content

Indices · Statistics

Indices volatility

Realized volatility of an index over 10 to 90 sessions and, for SPX, the gap to the 30-day volatility index.
GET/v1/indices/volatilityindicesVolatility
On this page

Annualised realized volatility of one index over the last 10, 20, 30, 60 and 90 sessions: the sample standard deviation of daily log returns times the square root of 252, in percent. For SPX, implied_minus_realized is the 30-day volatility index (VIX, in points of annualised percent) minus the 20-session realized volatility: positive when options price more movement than the index has shown. It is null for other indices and when either part is missing. A window without enough sessions is null. No index values are returned. The figures use a longer lookback than the dated rows your plan's history window allows (the window limits the rows returned, not the lookback a statistic is computed from); this route returns no dated rows.

Example request

curl -sS --get "https://api.ordermap.si/v1/indices/volatility" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=SPX

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

Parameters

1 parameter, 1 required.

ParameterType and limitsDescription
symbolqueryrequiredstringat most 10 characterspattern ^[A-Za-z][A-Za-z0-9]{0,9}$Index symbol, for example SPX.

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

  • dataobjectrequiredVolatility of one index.9 fields inside
    • datestring | nulldaterequiredExchange date of the latest session used.
    • implied_minus_realizedobject | nullrequiredThe 30-day volatility index minus the 20-session realized volatility (SPX only).2 fields inside
      • valuenumber | nullrequiredDifference in volatility points.
      • windowintegerrequiredSessions of the realized volatility.
    • symbolstringrequiredIndex symbol.
    • windowsarray<object>requiredRealized volatility per window, shortest first.3 fields inside
      • observationsintegerrequiredDaily returns available for the window.
      • realized_volnumber | nullrequiredAnnualised standard deviation of daily log returns, in percent.
      • windowintegerrequiredNumber of daily returns the window covers.
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "date": "2026-10-15",
    "implied_minus_realized": {
      "value": 5.1,
      "window": 20
    },
    "symbol": "SPX",
    "windows": [
      {
        "observations": 20,
        "realized_vol": 11.42,
        "window": 20
      }
    ]
  },
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "index_feed"
  }
}

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