# Commodity Movers & Performance API
> What is moving across the commodity complex right now, computed live from Yahoo Finance futures (no key, nothing stored). Just as stock, FX and crypto traders watch the day's biggest gainers and losers, commodity traders want the same board for energy, metals, grains, softs and livestock. For every commodity this measures the change on the day, the week and the month, the day's high and low, the 52-week high and low and where the price sits in that 52-week range. The movers endpoint returns the whole complex ranked by daily change — the top gainers and losers — plus the weekly and monthly leaders, and can be filtered to one sector. The commodity endpoint returns one commodity's full performance card. The commodities endpoint lists what is covered. The commodity movers / performance-board cut — distinct from the commodity-momentum API (which ranks by a blended multi-month momentum factor and trend regime), the commodity-price feed, the commodity-spreads and the seasonality APIs. It answers what moved today, across the complex.

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

## Pricing
- **Free** (Free) — 1,150 calls/Mo, 2 req/s
- **Starter** ($10/Mo) — 27,000 calls/Mo, 6 req/s
- **Pro** ($29/Mo) — 130,000 calls/Mo, 18 req/s
- **Business** ($70/Mo) — 640,000 calls/Mo, 45 req/s

## Endpoints

### Movers

#### `GET /v1/movers` — Commodity complex ranked by daily change with weekly/monthly leaders

**Parameters:**
- `group` (query, optional, string) — Filter by sector: energy, metals, grains, softs, livestock Example: `metals`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/commoditymovers-api/v1/movers?group=metals"
```

### Commodity

#### `GET /v1/commodity` — One commodity performance card

**Parameters:**
- `commodity` (query, required, string) — Key, name or alias (see /v1/commodities) Example: `gold`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/commoditymovers-api/v1/commodity?commodity=gold"
```

### Commodities

#### `GET /v1/commodities` — Supported commodities and groups

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

### Meta

#### `GET /v1/meta` — Service metadata

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


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