# Commodity Spreads API
> The spreads and ratios that commodity traders actually trade, not just the raw prices, computed live from the underlying futures — no key, nothing stored. A single commodity price means little on its own; the money is in the relationships. The crack endpoint returns the 3:2:1 crack spread — the refining margin from turning three barrels of crude oil into two of gasoline and one of heating oil, the number that drives refiner profits and gasoline prices. The crush endpoint returns the soybean crush spread — the processing margin from crushing soybeans into meal and oil. The ratios endpoint returns the classic macro ratios: gold/silver (the "fear versus growth" gauge), gold/oil (real-asset value), oil/natural-gas (the energy ratio) and gold/copper. Each comes with the component futures prices so you can see exactly how it is built. This is the commodity-spread / inter-commodity cut — distinct from the single-commodity price feed, the precious-metals spot API and the FX APIs in the catalogue. It gives you the margin and the ratio, the things that are actually positioned. All endpoints are parameter-less and return the current values with their components; the crack spread is in USD per barrel and the crush in USD per bushel.

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

## Pricing
- **Free** (Free) — 600 calls/Mo, 2 req/s
- **Starter** ($10/Mo) — 15,800 calls/Mo, 6 req/s
- **Pro** ($32/Mo) — 84,000 calls/Mo, 16 req/s
- **Business** ($75/Mo) — 440,000 calls/Mo, 40 req/s

## Endpoints

### Spreads

#### `GET /v1/crack` — 3:2:1 crack spread (refining margin)

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

#### `GET /v1/crush` — Soybean crush spread (processing margin)

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

#### `GET /v1/ratios` — Gold/silver, gold/oil, oil/natgas ratios

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

### Meta

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

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


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