# Stock Options Chain API
> Live (15-minute delayed) US equity and index options chains, served from CBOE's public delayed-quotes feed. For any optionable ticker the summary endpoint returns the underlying quote — current price, day change, open/high/low/close, volume, bid/ask and the 30-day implied volatility (IV30) with its change. The expirations endpoint lists every available expiration date with its call and put contract counts. The chain endpoint returns the option contracts themselves: for each strike and expiry it gives the call/put bid, ask, last, implied volatility, open interest, volume and the full greeks — delta, gamma, theta and vega — and can be filtered by expiration date and by call or put. US index options are addressed with an underscore prefix (_SPX, _VIX). This is the single-name equity and index options surface — strikes, expiries, IV and greeks — distinct from the options-pricing calculators, the crypto-options and the FX/rate APIs in the catalogue. Live, no key on the upstream, nothing stored.

## 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/optionschain-api/..."
```

## Pricing
- **Free** (Free) — 18,000 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 210,000 calls/Mo, 10 req/s
- **Pro** ($27/Mo) — 920,000 calls/Mo, 30 req/s
- **Scale** ($64/Mo) — 3,300,000 calls/Mo, 80 req/s

## Endpoints

### Options

#### `GET /v1/chain` — Option contracts with IV, OI, volume & greeks

**Parameters:**
- `symbol` (query, required, string) — US ticker Example: `AAPL`
- `expiry` (query, optional, string) — Expiration date YYYY-MM-DD (defaults to nearest) Example: `2026-06-12`
- `type` (query, optional, string) — call or put (omit for both) Example: `call`
- `limit` (query, optional, string) — Max contracts (max 500) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/optionschain-api/v1/chain?symbol=AAPL&expiry=2026-06-12&type=call&limit=100"
```

**Response:**
```json
{
    "data": {
        "type": "call",
        "count": 75,
        "expiry": "2026-06-12",
        "source": "CBOE",
        "symbol": "AAPL",
        "contracts": [
            {
                "iv": 0,
                "ask": 187.6,
                "bid": 183.5,
                "last": 0,
                "type": "call",
                "vega": 0,
                "delta": 1,
                "gamma": 0,
                "theta": 0,
                "expiry": "2026-06-12",
                "strike": 110,
                "volume": 0,
                "contract": "AAPL260612C00110000",
                "open_interest": 0
            },
            {
                "iv": 0,
                "ask": 177.6,
                "bid": 173.45,
                "last": 175.59,
                "type": "call",
                "vega": 0,
                "delta": 1,
                "gamma": 0,
                "theta": 0,
                "expiry": "2026-06-12",
                "strike": 120,
                "volume": 4,
                "contract": "AAPL260612C00120000",
                "open_interest": 3
            },
            {
                "iv": 0,
                "ask": 172.6,
                "bid": 168.45,
                "last": 168.44,
                "type": "call",
                "vega": 0,
                "delta": 1,
                "gamma": 0,
                "theta": 0,
                "expiry": "2026-06-12",
                "strike": 125,
                "volume": 1,
           
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/expirations` — Available expiration dates with counts

**Parameters:**
- `symbol` (query, required, string) — US ticker Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/optionschain-api/v1/expirations?symbol=AAPL"
```

**Response:**
```json
{
    "data": {
        "count": 26,
        "source": "CBOE",
        "symbol": "AAPL",
        "expirations": [
            {
                "puts": 75,
                "calls": 75,
                "expiry": "2026-06-12",
                "contracts": 150
            },
            {
                "puts": 43,
                "calls": 43,
                "expiry": "2026-06-15",
                "contracts": 86
            },
            {
                "puts": 48,
                "calls": 48,
                "expiry": "2026-06-17",
                "contracts": 96
            },
            {
                "puts": 116,
                "calls": 116,
                "expiry": "2026-06-18",
                "contracts": 232
            },
            {
                "puts": 49,
                "calls": 49,
                "expiry": "2026-06-22",
                "contracts": 98
            },
            {
                "puts": 46,
                "calls": 46,
                "expiry": "2026-06-24",
                "contracts": 92
            },
            {
                "puts": 72,
                "calls": 72,
                "expiry": "2026-06-26",
                "contracts": 144
            },
            {
                "puts": 58,
                "calls": 58,
                "expiry": "2026-07-02",
                "contracts": 116
            },
            {
                "puts": 58,
                "calls": 58,
                "expiry": "2026-07-10",
     
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/summary` — Underlying quote + IV30 for a symbol

**Parameters:**
- `symbol` (query, required, string) — US ticker; index uses underscore prefix Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/optionschain-api/v1/summary?symbol=AAPL"
```

**Response:**
```json
{
    "data": {
        "ask": 295.85,
        "bid": 295.8,
        "low": 289.59,
        "high": 297,
        "iv30": 23.027,
        "open": 293.71,
        "close": 295.63,
        "change": 4.05,
        "source": "CBOE",
        "symbol": "AAPL",
        "volume": 42572497,
        "change_pct": 1.389,
        "prev_close": 291.58,
        "iv30_change": 0,
        "current_price": 295.84,
        "security_type": "stock",
        "iv30_change_pct": 0,
        "last_trade_time": "2026-06-11T16:00:00"
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:42.585Z",
        "request_id": "66d820b4-bc79-4312-8270-b3152ae3a6f6"
    },
    "status": "ok",
    "message": "Summary retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "note": "symbol is a US ticker (AAPL, MSFT, TSLA); index options use an underscore prefix (_SPX, _VIX). chain defaults to the nearest expiration when none is given; pass expiry=YYYY-MM-DD and type=call|put to filter. Greeks and IV are as published by CBOE.",
        "source": "CBOE delayed quotes (cdn.cboe.com, ~15-min delayed)",
        "service": "optionschain-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/chain": "Option contracts with IV, OI, volume & greeks (symbol=AAPL, expiry=2026-06-12, type=call, limit=100).",
            "GET /v1/summary": "Underlying quote for a symbol — price, change, OHLC, volume, IV30 (symbol=AAPL).",
            "GET /v1/expirations": "All available expiration dates with contract counts (symbol=AAPL)."
        },
        "aapl_price": 295.84,
        "description": "Live (15-min delayed) US equity & index options chains from CBOE. summary returns the underlying quote (price, change, OHLC, volume, bid/ask, 30-day implied volatility IV30); expirations lists every available expiration date with contract counts; chain returns the option contracts for a strike/expiry — call/put bid, ask, last, IV, open interest, volume and the full greeks (delta, gamma, theta, vega), filterable by expiration and call/put. Live, no key, nothing stored. The single-name equity/index options surface, distinct from the options-pricing calculators, crypto options and FX/rate APIs.",
        "upst
…(truncated, see openapi.json for full schema)
```


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