# CCI Screener (Multi-Asset) API
> Which markets are stretched to an overbought or oversold extreme on the Commodity Channel Index, computed live from Yahoo Finance (no key, nothing stored). The CCI measures how far price has run from its statistical average relative to normal volatility: above +100 a market is in a strong up-move (and, when it unwinds, overbought), below -100 a strong down-move (or oversold), and the swing through zero frames trend and reversal trades. For a cross-asset, cross-sector universe — equity indices and sectors, gold, oil, commodities, bonds and crypto — this computes each asset's 20-period CCI from its typical price (high+low+close over three) and tags it overbought, bullish, bearish or oversold, then ranks the whole board. The screener endpoint returns the overbought (>+100) and oversold (<-100) markets right now. The asset endpoint returns one market's CCI card. The universe endpoint lists what is covered. The cross-asset CCI / extension screener cut — distinct from the bring-your-own-candle oscillator API, the RSI screener (a different oscillator), the OBV/volume and Bollinger screeners. It finds the over-extended markets across every asset class at once.

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

## Pricing
- **Free** (Free) — 820 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 17,600 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 90,500 calls/Mo, 16 req/s
- **Business** ($76/Mo) — 496,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Cross-asset board with overbought/oversold CCI extremes, ranked

**Parameters:**
- `class` (query, optional, string) — Filter by class: equities, sector, commodities, bonds, crypto Example: `sector`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cci-api/v1/screener?class=sector"
```

### Asset

#### `GET /v1/asset` — One market CCI card

**Parameters:**
- `asset` (query, required, string) — Asset key (see /v1/universe) Example: `sp500`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cci-api/v1/asset?asset=sp500"
```

### Universe

#### `GET /v1/universe` — Supported instruments

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

### Meta

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

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


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