# Volatility Indices API
> Live market "fear gauges" across asset classes as an API, served from Yahoo Finance. The VIX is the market's headline fear index — the S&P 500's 30-day implied volatility — and this returns it alongside the rest of the family: the 9-day VIX (short-term fear), the Nasdaq-100 (VXN) and Dow (VXD) volatility indices, crude-oil (OVX) and gold (GVZ) volatility, and the VVIX, the volatility of the VIX itself. Each comes with its current level, the day's change, and its day and 52-week range, and the board adds a plain-language fear regime from the VIX (complacent, normal, elevated, high or extreme). Get the whole board or one index. The implied-volatility and risk-sentiment layer for trading, macro-research and dashboard apps. Live, no key, no cache. Distinct from equity-index, crypto-volatility and FX-volatility APIs — this is the cross-asset implied-volatility (fear) suite.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/volatilityindices-api/..."
```

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 4 req/s
- **Starter** ($9/Mo) — 115,000 calls/Mo, 12 req/s
- **Pro** ($22/Mo) — 590,000 calls/Mo, 35 req/s
- **Desk** ($53/Mo) — 3,000,000 calls/Mo, 100 req/s

## Endpoints

### Indices

#### `GET /v1/indices` — All fear gauges + the VIX market-fear regime

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/volatilityindices-api/v1/indices"
```

**Response:**
```json
{
    "data": {
        "as_of": "2026-06-08T20:15:01.000Z",
        "count": 7,
        "indices": [
            {
                "name": "VIX",
                "as_of": "2026-06-08T20:15:01.000Z",
                "index": "vix",
                "level": 18.92,
                "change": -2.59,
                "regime": "normal",
                "symbol": "^VIX",
                "day_low": 17.94,
                "day_high": 20.35,
                "change_pct": -12.04,
                "week52_low": 13.38,
                "asset_class": "S&P 500",
                "description": "30-day implied volatility of the S&P 500 — the market's headline fear index.",
                "week52_high": 35.3,
                "previous_close": 21.51
            },
            {
                "name": "VIX9D",
                "as_of": "2026-06-08T20:15:02.000Z",
                "index": "vix9d",
                "level": 19.69,
                "change": -4.23,
                "regime": "normal",
                "symbol": "^VIX9D",
                "day_low": 17.83,
                "day_high": 20.42,
                "change_pct": -17.68,
                "week52_low": 13.33,
                "asset_class": "S&P 500",
                "description": "9-day implied volatility — short-term fear.",
                "week52_high": 41.52,
                "previous_close": 23.92
            },
            {
                "name": "VXN",
                "as_of": "2026-06-08T20:15:01.000Z",
              
…(truncated, see openapi.json for full schema)
```

### Index

#### `GET /v1/index` — One volatility index

**Parameters:**
- `index` (query, required, string) — Index key (vix|vix9d|vxn|vxd|ovx|gvz|vvix) Example: `vix`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/volatilityindices-api/v1/index?index=vix"
```

**Response:**
```json
{
    "data": {
        "name": "VIX",
        "as_of": "2026-06-08T20:15:01.000Z",
        "index": "vix",
        "level": 18.92,
        "change": -2.59,
        "regime": "normal",
        "symbol": "^VIX",
        "day_low": 17.94,
        "day_high": 20.35,
        "change_pct": -12.04,
        "week52_low": 13.38,
        "asset_class": "S&P 500",
        "description": "30-day implied volatility of the S&P 500 — the market's headline fear index.",
        "week52_high": 35.3,
        "previous_close": 21.51
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:01.698Z",
        "request_id": "ea436a9d-e50f-4aa6-a368-6fcb670bb6a8"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata and index list

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/volatilityindices-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Yahoo Finance CBOE volatility indices (live)",
        "indices": {
            "gvz": "GVZ — Gold",
            "ovx": "OVX — Crude Oil",
            "vix": "VIX — S&P 500",
            "vxd": "VXD — Dow Jones",
            "vxn": "VXN — Nasdaq-100",
            "vvix": "VVIX — VIX",
            "vix9d": "VIX9D — S&P 500"
        },
        "service": "volatilityindices-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/index": "One volatility index (index=vix|vxn|ovx|gvz|vvix|vix9d|vxd).",
            "GET /v1/indices": "All fear gauges + the VIX market-fear regime."
        },
        "description": "Live market fear gauges from Yahoo Finance: the VIX (S&P 500 30-day implied volatility) plus the 9-day VIX, Nasdaq-100 (VXN), Dow (VXD), crude-oil (OVX), gold (GVZ) volatility indices and the VVIX (vol-of-vol). Each with current level, day change, day and 52-week range, and a VIX-scale fear regime. Get the whole board or one index. Live, no key. Distinct from equity-index, crypto-volatility and FX-volatility APIs — this is the cross-asset implied-volatility (fear) suite.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:01.776Z",
        "request_id": "37c52e66-23e5-4a57-bd68-64f0d49b7cde"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/volatilityindices-api
OpenAPI spec: https://www.oanor.com/api/volatilityindices-api/openapi.json