# Crypto Multi-Timeframe Momentum API
> Whether a coin is trending the same way across every timeframe, computed live from Binance candles — no key, nothing stored. A single 24-hour change is noise; what traders want is alignment — when the 1-hour, 4-hour, 1-day, 1-week and 1-month returns all point the same direction, that is a strong, coherent trend, and when they disagree the move is choppy or turning. The momentum endpoint returns, for one coin, the percent change over each of those five horizons, the up/down direction of each, an alignment score (how strongly the timeframes agree, from -1 fully bearish to +1 fully bullish) and an overall bias label. The screener endpoint scans a basket and ranks the coins by aligned momentum, surfacing the strongest coherent uptrends (every timeframe up) and downtrends (every timeframe down). The symbols endpoint lists tradable pairs. This is the multi-timeframe momentum / trend-alignment cut for crypto — distinct from the single-window movers, the Donchian breakout screener, the FX-pivot and the generic indicator-calculator APIs in the catalogue. Pairs are Binance symbols (BTCUSDT) or a coin=BTC&quote=USDT form; horizons are fixed at 1h/4h/24h/7d/30d.

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

## Pricing
- **Free** (Free) — 400 calls/Mo, 2 req/s
- **Starter** ($11/Mo) — 12,800 calls/Mo, 6 req/s
- **Pro** ($36/Mo) — 72,000 calls/Mo, 16 req/s
- **Business** ($81/Mo) — 370,000 calls/Mo, 40 req/s

## Endpoints

### Momentum

#### `GET /v1/momentum` — One coin's multi-timeframe momentum & alignment

**Parameters:**
- `symbol` (query, required, string) — Binance pair Example: `BTCUSDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomomentum-api/v1/momentum?symbol=BTCUSDT"
```

#### `GET /v1/screener` — Rank a basket by trend alignment

**Parameters:**
- `coins` (query, optional, string) — Comma list of coins (default liquid majors) Example: `BTC,ETH,SOL,DOGE,XRP`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomomentum-api/v1/screener?coins=BTC%2CETH%2CSOL%2CDOGE%2CXRP"
```

#### `GET /v1/symbols` — Tradable Binance pairs

**Parameters:**
- `quote` (query, optional, string) — Filter by quote asset Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomomentum-api/v1/symbols?quote=USDT"
```

### Meta

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

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


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