# 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"
```

**Response:**
```json
{
    "data": {
        "bias": "mixed / choppy",
        "coin": "BTC",
        "note": "changes are percent price moves over 1h/4h/24h/7d/30d. alignment_score runs -1 (every timeframe down) to +1 (every timeframe up); high magnitude = a strong coherent trend, near 0 = choppy.",
        "price": 63717.89,
        "source": "Binance",
        "symbol": "BTCUSDT",
        "changes": {
            "d1": 0.9,
            "d7": 1.89,
            "h1": -0.05,
            "h4": 1.17,
            "d30": -21.15
        },
        "horizons": [
            "1h",
            "4h",
            "24h",
            "7d",
            "30d"
        ],
        "timeframes_up": 3,
        "alignment_score": 0.2,
        "timeframes_down": 2
    },
    "meta": {
        "timestamp": "2026-06-12T10:35:44.310Z",
        "request_id": "2c16a963-1efb-47d2-95d6-5fe556a71f36"
    },
    "status": "ok",
    "message": "Momentum retrieved successfully",
    "success": true
}
```

#### `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"
```

**Response:**
```json
{
    "data": {
        "note": "Coins ranked by multi-timeframe alignment. strongest_uptrends have the most timeframes pointing up; strongest_downtrends the most pointing down. Default basket is the liquid majors; pass coins=BTC,ETH,... to customise.",
        "source": "Binance",
        "scanned": 5,
        "strongest_uptrends": [
            {
                "d1": 1.75,
                "d7": 2.28,
                "h1": -0.41,
                "d30": -23.84,
                "bias": "mixed / choppy",
                "coin": "DOGE",
                "alignment_score": 0.2
            },
            {
                "d1": 0.9,
                "d7": 1.89,
                "h1": -0.05,
                "d30": -21.15,
                "bias": "mixed / choppy",
                "coin": "BTC",
                "alignment_score": 0.2
            },
            {
                "d1": 1.99,
                "d7": 0.68,
                "h1": -0.24,
                "d30": -21.54,
                "bias": "mixed / choppy",
                "coin": "XRP",
                "alignment_score": 0.2
            },
            {
                "d1": 2.06,
                "d7": 0.65,
                "h1": -0.48,
                "d30": -29.48,
                "bias": "mixed / choppy",
                "coin": "SOL",
                "alignment_score": 0.2
            }
        ],
        "strongest_downtrends": [
            {
                "d1": 1.05,
                "d7": -0.04,
                "h1"
…(truncated, see openapi.json for full schema)
```

#### `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"
```

**Response:**
```json
{
    "data": {
        "count": 435,
        "quote": "USDT",
        "source": "Binance",
        "symbols": [
            "0GUSDT",
            "1000CATUSDT",
            "1000CHEEMSUSDT",
            "1000SATSUSDT",
            "1INCHUSDT",
            "1MBABYDOGEUSDT",
            "2ZUSDT",
            "AAVEUSDT",
            "ACEUSDT",
            "ACHUSDT",
            "ACMUSDT",
            "ACTUSDT",
            "ACXUSDT",
            "ADAUSDT",
            "ADXUSDT",
            "AEURUSDT",
            "AEVOUSDT",
            "AGLDUSDT",
            "AIGENSYNUSDT",
            "AIUSDT",
            "AIXBTUSDT",
            "ALCXUSDT",
            "ALGOUSDT",
            "ALICEUSDT",
            "ALLOUSDT",
            "ALPINEUSDT",
            "ALTUSDT",
            "AMPUSDT",
            "ANIMEUSDT",
            "ANKRUSDT",
            "APEUSDT",
            "API3USDT",
            "APTUSDT",
            "ARBUSDT",
            "ARDRUSDT",
            "ARKMUSDT",
            "ARKUSDT",
            "ARPAUSDT",
            "ARUSDT",
            "ASRUSDT",
            "ASTERUSDT",
            "ASTRUSDT",
            "ATMUSDT",
            "ATOMUSDT",
            "ATUSDT",
            "AUCTIONUSDT",
            "AUDIOUSDT",
            "AUSDT",
            "AVAUSDT",
            "AVAXUSDT",
            "AVNTUSDT",
            "AWEUSDT",
            "AXLUSDT",
            "AXSUSDT",
            "BABYUSDT",
            "BANANAS31USDT",
            "BANANAUSDT",
          
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "symbol is a Binance pair (BTCUSDT) or coin=BTC&quote=USDT. Horizons are fixed at 1h/4h/24h/7d/30d. screener takes coins=BTC,ETH,... (default liquid majors, max 25). Read fresh per call; only the tradable-symbol list is cached hourly.",
        "source": "Binance public REST (api.binance.com/api/v3/klines, hourly, live)",
        "service": "cryptomomentum-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/symbols": "Tradable Binance pairs, optionally filtered by quote (quote=USDT).",
            "GET /v1/momentum": "One coin's change across 1h/4h/24h/7d/30d with alignment score and bias (symbol=BTCUSDT).",
            "GET /v1/screener": "Rank a basket by multi-timeframe alignment — strongest up/down trends (coins=BTC,ETH,SOL)."
        },
        "description": "Crypto multi-timeframe momentum — whether a coin trends the same way across 1h/4h/24h/7d/30d, computed live from Binance candles (no key, nothing stored). momentum returns one coin's percent change over each horizon, the per-timeframe direction, an alignment score (-1 fully bearish to +1 fully bullish) and a bias label. screener scans a basket and ranks coins by aligned momentum, surfacing the strongest coherent uptrends and downtrends. symbols lists tradable pairs. The multi-timeframe momentum / trend-alignment cut for crypto — distinct from single-window movers, the Donchian breakout screener, the FX-pivot and generic indicator-calc
…(truncated, see openapi.json for full schema)
```


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