# Multi-Timeframe Momentum & Alignment (Multi-Asset) API
> Whether each market is trending the same way across every timeframe, computed live from Yahoo Finance (no key, nothing stored). A single week's move is noise; what trend traders want is alignment — when the 1-week, 1-month, 3-month, 6-month and 1-year returns all point the same direction, that is a strong, coherent trend, and when they disagree the move is choppy or turning. For a cross-asset, cross-sector universe — equity indices and sectors, gold, oil, commodities, bonds and crypto — this measures each asset's return over those five horizons, the up/down direction of each, and an alignment score from -5 (every timeframe down) to +5 (every timeframe up), with a coherence label. The screener endpoint returns the fully aligned uptrends and downtrends across the board, ranked by alignment. The asset endpoint returns one market's multi-timeframe momentum card. The universe endpoint lists what is covered. The cross-asset multi-timeframe momentum / alignment cut — distinct from the crypto-only multi-timeframe API, the commodity-momentum ranking and the relative-strength APIs. It finds the coherent trends 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/multiassetmomentum-api/..."
```

## Pricing
- **Free** (Free) — 750 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 16,600 calls/Mo, 6 req/s
- **Pro** ($36/Mo) — 88,000 calls/Mo, 16 req/s
- **Business** ($82/Mo) — 478,000 calls/Mo, 40 req/s

## Endpoints

### Screener

#### `GET /v1/screener` — Cross-asset board with fully aligned trends ranked by alignment score

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

### Asset

#### `GET /v1/asset` — One market multi-timeframe momentum 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/multiassetmomentum-api/v1/asset?asset=sp500"
```

### Universe

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

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

### Meta

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

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


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