ATM History

Dev

GET /options/atm-history

Historical at-the-money implied volatility for BTC or ETH — one data point per hour and expiry, showing the IV of the option with the closest strike to the underlying price at that time. Use it to chart how the options market's volatility expectations have evolved, compare IV across term structures, or backtest options strategies.

Authentication

Requires Dev tier or higher. Dev: up to 30 days (days ≤ 30). Pro: up to 90 days.

Parameters

Query parameters

Name	Type	Required	Description
`symbol`	string	–	BTC or ETH. Defaults to BTC.
`days`	int	–	Number of days of history. Range 1–90. Defaults to 30.

Tier behavior

Dev: Maximum 30 days (days ≤ 30).
Pro: Up to 90 days.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/options/atm-history?symbol=BTC&days=7"

Example response

json

{
  "symbol": "BTC",
  "days": 7,
  "count": 1680,
  "data": [
    {
      "hour": "2026-06-01T00:00:00Z",
      "expiry": "2026-06-27T08:00:00Z",
      "underlying_price": 69800.00,
      "strike": 70000,
      "iv": 0.718
    },
    {
      "hour": "2026-06-01T01:00:00Z",
      "expiry": "2026-06-27T08:00:00Z",
      "underlying_price": 70200.00,
      "strike": 70000,
      "iv": 0.712
    }
  ]
}

Errors

400 — days out of range (must be 1–90).
403 — days exceeds your tier's limit. Dev: 30 days max. Upgrade to Pro for 90 days.

For authentication errors (401) and rate limit responses (429), see Errors.