Skip to content

Stocks · Statistics

Stocks volatility

Realized and range volatility of a stock over 10 to 90 sessions, plus average range, as percentages.
GET/v1/stocks/volatilitystocksVolatility
On this page

Annualised volatility of one stock over the last 10, 20, 30, 60 and 90 sessions: realized_vol is the sample standard deviation of daily log returns times the square root of 252, parkinson_vol is the range-based estimator from each day's high and low, both in percent. atr_pct is the 14-session average true range as a percent of the latest close and average_range_pct the mean daily high-to-low range over 20 sessions as a percent of the close. A window without enough sessions is null. Split-adjusted daily bars; no prices 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/stocks/volatility" \
  -H "Authorization: Bearer $ORDERMAP_API_KEY" \
  --data-urlencode symbol=AAPL

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 11 characterspattern ^[A-Za-z]{1,6}(\.[A-Za-z0-9]{1,4})?$Ticker symbol, for example AAPL.

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 stock.9 fields inside
    • atr_pctnumber | nullrequired14-session average true range as a percent of the latest close.
    • average_range_pctnumber | nullrequiredMean daily high-to-low range over 20 sessions as a percent of the close.
    • datestring | nulldaterequiredExchange date of the latest session used.
    • symbolstringrequiredTicker symbol.
    • windowsarray<object>requiredVolatility per window, shortest first.4 fields inside
      • observationsintegerrequiredDaily returns available for the window.
      • parkinson_volnumber | nullrequiredAnnualised range-based volatility of the window's daily high and low, in percent.
      • realized_volnumber | nullrequiredAnnualised standard deviation of the window's daily log returns, in percent.
      • windowintegerrequiredNumber of daily returns the window covers.
  • metaobjectrequiredMeta object

Example response

{
  "data": {
    "atr_pct": 1.92,
    "average_range_pct": 1.74,
    "date": "2026-10-15",
    "symbol": "AAPL",
    "windows": [
      {
        "observations": 20,
        "parkinson_vol": 21.88,
        "realized_vol": 24.31,
        "window": 20
      }
    ]
  },
  "meta": {
    "as_of": 1760659200123,
    "coverage": {
      "complete": true
    },
    "delay_ms": 0,
    "delayed": false,
    "request_id": "0199f0c2-5a1e-7c3b-9d4e-2b6f8a1c3d5e",
    "source": "sip"
  }
}

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