# Commodities Momentum & Relative-Strength API
> Which corner of the commodity complex is leading and which is lagging, ranked by trailing momentum, computed live from Yahoo Finance futures (no key, nothing stored). A price tells you where a commodity is; momentum tells you where the money is flowing. This scores every major commodity — crude, Brent, natural gas, gasoline and heating oil in energy; gold, silver, copper, platinum and palladium in metals; corn, wheat and soybeans in grains; coffee, sugar, cocoa, cotton and orange juice in softs; live cattle and lean hogs in livestock — by its return over five horizons (1 week, 1 month, 3 months, 6 months and a ~1-year proxy), blends them into a single momentum score and ranks the whole complex into leaders and laggards. The screener endpoint returns that ranked table with a relative-strength rank and trend regime for each. The momentum endpoint drills into one commodity: its multi-horizon returns, where it sits versus its 50- and 200-day averages, and a trend label. The commodities endpoint lists what is covered. The cross-commodity momentum / relative-strength factor cut — distinct from the commodity-price feed (front-month prices), the commodity-spreads API (crack/crush/ratios) and the precious-metals spot API. It answers what is leading the complex, not what one thing costs.

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

## Pricing
- **Free** (Free) — 800 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 21,000 calls/Mo, 6 req/s
- **Pro** ($31/Mo) — 105,000 calls/Mo, 18 req/s
- **Business** ($75/Mo) — 540,000 calls/Mo, 45 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Commodity complex ranked by momentum with leaders/laggards

**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/commoditymomentum-api/v1/screener?group=metals"
```

### Momentum

#### `GET /v1/momentum` — One commodity multi-horizon returns, MA position and trend regime

**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/commoditymomentum-api/v1/momentum?commodity=gold"
```

### Commodities

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

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

### Meta

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

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


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