# Front-Month Futures Quotes API
> Live continuous front-month (1!) quotes for the major liquid futures across every asset class, with no key: precious & base metals (gold, silver, copper, platinum), energy (WTI crude, natural gas, gasoline, heating oil), grains (wheat, corn, soybeans), softs (coffee, sugar, cocoa, cotton), livestock, equity-index (E-mini S&P 500, Nasdaq, Dow, Russell), interest-rate (2/5/10/30-year Treasuries) and FX futures from COMEX, NYMEX, CBOT, CME, CME_MINI and ICE US. Get a per-contract quote by short code (GC, CL, ES, ZW) with last price, % change and intraday OHLC, a full cross-asset board, or a per-category cut — a curated board of the contracts that actually trade.

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

## Pricing
- **Free** (Free) — 1,560 calls/Mo, 3 req/s
- **Basic** ($13/Mo) — 45,300 calls/Mo, 7 req/s
- **Pro** ($37/Mo) — 190,000 calls/Mo, 18 req/s
- **Business** ($78/Mo) — 785,000 calls/Mo, 45 req/s

## Endpoints

### Futures

#### `GET /v1/board` — Full cross-asset futures board

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

**Response:**
```json
{
    "data": {
        "count": 37,
        "quotes": [
            {
                "low": 4283.4,
                "code": "GC",
                "high": 4366.1,
                "last": 4359,
                "name": "Gold",
                "open": 4289.4,
                "volume": 61066,
                "category": "metals",
                "contract": "COMEX:GC1!",
                "currency": "USD",
                "change_abs": 120.2,
                "change_pct": 2.8357
            },
            {
                "low": 68.725,
                "code": "SI",
                "high": 70.935,
                "last": 70.73,
                "name": "Silver",
                "open": 68.9,
                "volume": 16726,
                "category": "metals",
                "contract": "COMEX:SI1!",
                "currency": "USD",
                "change_abs": 2.756,
                "change_pct": 4.0545
            },
            {
                "low": 6.4775,
                "code": "HG",
                "high": 6.562,
                "last": 6.493,
                "name": "Copper",
                "open": 6.51,
                "volume": 18476,
                "category": "metals",
                "contract": "COMEX:HG1!",
                "currency": "USD",
                "change_abs": 0.048,
                "change_pct": 0.7448
            },
            {
                "low": 1730.6,
                "code": "PL",
                "high": 1789.7,
                "last
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/category` — Futures in one category

**Parameters:**
- `category` (query, required, string) — metals, energy, grains, softs, livestock, index, rates, fx or crypto Example: `energy`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cmefutures-api/v1/category?category=energy"
```

**Response:**
```json
{
    "data": {
        "count": 4,
        "quotes": [
            {
                "low": 79.7,
                "code": "CL",
                "high": 82.42,
                "last": 80.28,
                "name": "WTI Crude Oil",
                "open": 81.4,
                "volume": 72767,
                "category": "energy",
                "contract": "NYMEX:CL1!",
                "currency": "USD",
                "change_abs": -4.6,
                "change_pct": -5.4194
            },
            {
                "low": 3.017,
                "code": "NG",
                "high": 3.094,
                "last": 3.018,
                "name": "Natural Gas",
                "open": 3.085,
                "volume": 17962,
                "category": "energy",
                "contract": "NYMEX:NG1!",
                "currency": "USD",
                "change_abs": -0.102,
                "change_pct": -3.2692
            },
            {
                "low": 2.8591,
                "code": "RB",
                "high": 2.96,
                "last": 2.873,
                "name": "RBOB Gasoline",
                "open": 2.9374,
                "volume": 8285,
                "category": "energy",
                "contract": "NYMEX:RB1!",
                "currency": "USD",
                "change_abs": -0.1137,
                "change_pct": -3.8069
            },
            {
                "low": 3.2114,
                "code": "HO",
                "high": 3.316,
  
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/quote` — Front-month quote for one or more codes

**Parameters:**
- `symbols` (query, required, string) — Comma-separated futures codes Example: `GC,CL,ES`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cmefutures-api/v1/quote?symbols=GC%2CCL%2CES"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "quotes": [
            {
                "low": 4283.4,
                "code": "GC",
                "high": 4366.1,
                "last": 4359,
                "name": "Gold",
                "open": 4289.4,
                "volume": 61066,
                "category": "metals",
                "contract": "COMEX:GC1!",
                "currency": "USD",
                "change_abs": 120.2,
                "change_pct": 2.8357
            },
            {
                "low": 79.7,
                "code": "CL",
                "high": 82.42,
                "last": 80.28,
                "name": "WTI Crude Oil",
                "open": 81.4,
                "volume": 72767,
                "category": "energy",
                "contract": "NYMEX:CL1!",
                "currency": "USD",
                "change_abs": -4.6,
                "change_pct": -5.4194
            },
            {
                "low": 7542,
                "code": "ES",
                "high": 7597,
                "last": 7593.75,
                "name": "E-mini S&P 500",
                "open": 7543.5,
                "volume": 179693,
                "category": "index",
                "contract": "CME_MINI:ES1!",
                "currency": "USD",
                "change_abs": 158.75,
                "change_pct": 2.1352
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:50.358Z",
        "request_id": "3ace8f33-c
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Codes, categories & endpoint guide

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

**Response:**
```json
{
    "data": {
        "codes": {
            "6A": {
                "name": "Australian Dollar",
                "category": "fx",
                "contract": "CME:6A1!"
            },
            "6B": {
                "name": "British Pound",
                "category": "fx",
                "contract": "CME:6B1!"
            },
            "6C": {
                "name": "Canadian Dollar",
                "category": "fx",
                "contract": "CME:6C1!"
            },
            "6E": {
                "name": "Euro FX",
                "category": "fx",
                "contract": "CME:6E1!"
            },
            "6J": {
                "name": "Japanese Yen",
                "category": "fx",
                "contract": "CME:6J1!"
            },
            "CC": {
                "name": "Cocoa",
                "category": "softs",
                "contract": "ICEUS:CC1!"
            },
            "CL": {
                "name": "WTI Crude Oil",
                "category": "energy",
                "contract": "NYMEX:CL1!"
            },
            "CT": {
                "name": "Cotton No.2",
                "category": "softs",
                "contract": "ICEUS:CT1!"
            },
            "ES": {
                "name": "E-mini S&P 500",
                "category": "index",
                "contract": "CME_MINI:ES1!"
            },
            "GC": {
                "name": "Gold",
                "category": "metals",
                "con
…(truncated, see openapi.json for full schema)
```


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