Quickstart

curl -G https://api.sandmark.com/volatility/v1/timeseries/iv \
  -H "X-API-Key: $SANDMARK_API_KEY" \
  -d asset=DER.BTC_USD \
  -d frequency=1h \
  -d option_type=C \
  -d tenor_label=1m \
  -d delta_target_pct=50 \
  -d limit=24

import os
import requests

BASE_URL = "https://api.sandmark.com/volatility"
session = requests.Session()
session.headers["X-API-Key"] = os.environ["SANDMARK_API_KEY"]

response = session.get(
    f"{BASE_URL}/v1/timeseries/iv",
    params={
        "asset": "DER.BTC_USD",
        "frequency": "1h",
        "option_type": "C",
        "tenor_label": "1m",
        "delta_target_pct": 50,
        "limit": 24,
    },
    timeout=30,
)
response.raise_for_status()

for row in response.json()["data"]:
    print(row["DATETIME"], f'{row["IV"] * 100:.2f} vol')

const BASE_URL = "https://api.sandmark.com/volatility";

const params = new URLSearchParams({
  asset: "DER.BTC_USD",
  frequency: "1h",
  option_type: "C",
  tenor_label: "1m",
  delta_target_pct: "50",
  limit: "24",
});

const response = await fetch(`${BASE_URL}/v1/timeseries/iv?${params}`, {
  headers: { "X-API-Key": process.env.SANDMARK_API_KEY },
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);

const { data } = await response.json();
for (const row of data) console.log(row.DATETIME, `${(row.IV * 100).toFixed(2)} vol`);