# Keltner Channels Screener (Multi-Asset) API
> Which markets are breaking out of their volatility-adjusted trend channel, computed live from Yahoo Finance (no key, nothing stored). Keltner Channels wrap a 20-day exponential average in bands set at two Average-True-Ranges above and below it — and unlike Bollinger Bands, whose width is statistical standard deviation, Keltner's width is the market's actual trading range. A close above the upper Keltner band is a trend-following breakout (riding strength), below the lower a breakdown, and price hugging a band signals a powerful, persistent trend. For a cross-asset, cross-sector universe — equity indices and sectors, gold, oil, commodities, bonds and crypto — this computes each asset's Keltner upper, middle and lower bands, where price sits inside the channel, and flags fresh breakouts. The screener endpoint returns the upside and downside Keltner breakouts across the board. The asset endpoint returns one market's Keltner card. The universe endpoint lists what is covered. The cross-asset Keltner-channel / volatility-trend screener cut — distinct from the Bollinger-Bands screener (standard-deviation width, mean-reversion), the bring-your-own-candle ATR API and the other indicator screeners.

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

## Pricing
- **Free** (Free) — 790 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 17,000 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 89,500 calls/Mo, 16 req/s
- **Business** ($77/Mo) — 490,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Cross-asset board with Keltner breakouts and channel-position ranking

**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/keltner-api/v1/screener?class=sector"
```

### Asset

#### `GET /v1/asset` — One market Keltner Channel 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/keltner-api/v1/asset?asset=sp500"
```

### Universe

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

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

### Meta

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

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


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