# 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" ``` **Response:** ```json { "data": { "note": "Each market's trailing return over 1w/1m/3m/6m/12m, the direction of each, and an alignment_score from -5 (all down) to +5 (all up). A fully aligned trend (all five timeframes agreeing) is the strongest, most coherent signal; a mixed score means the trend is choppy or turning. Sorted by alignment_score (most bullish first).", "class": "sector", "assets": [ { "key": "health_care", "class": "sector", "label": "Health Care", "coherence": "fully aligned up (every timeframe rising)", "directions": { "1m": "up", "1w": "up", "3m": "up", "6m": "up", "12m": "up" }, "returns_pct": { "1m": 5.65, "1w": 1.32, "3m": 2.62, "6m": 2.75, "12m": 12.63 }, "timeframes_up": 5, "alignment_score": 5, "timeframes_down": 0 }, { "key": "real_estate", "class": "sector", "label": "Real Estate", "coherence": "fully aligned up (every timeframe rising)", "directions": { "1m": "up", "1w": "up", "3m": "up", …(truncated, see openapi.json for full schema) ``` ### 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" ``` **Response:** ```json { "data": { "key": "sp500", "note": "One market's multi-timeframe momentum: trailing returns over 1w/1m/3m/6m/12m with each timeframe's direction and the overall alignment score (-5 to +5) and coherence.", "class": "equities", "label": "S&P 500", "source": "Yahoo Finance", "symbol": "SPY", "coherence": "mixed / no clear trend", "directions": { "1m": "down", "1w": "down", "3m": "up", "6m": "up", "12m": "up" }, "returns_pct": { "1m": -0.06, "1w": -2.55, "3m": 10.76, "6m": 8.01, "12m": 22.2 }, "timeframes_up": 3, "alignment_score": 1, "timeframes_down": 2 }, "meta": { "timestamp": "2026-06-12T10:35:02.118Z", "request_id": "9ef7ffe3-4a2f-4059-9c92-1dc1b0a3605a" }, "status": "ok", "message": "Asset retrieved successfully", "success": true } ``` ### Universe #### `GET /v1/universe` — Supported instruments **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/multiassetmomentum-api/v1/universe" ``` **Response:** ```json { "data": { "note": "Supported instruments. Pass key as asset= to /v1/asset, class= to /v1/screener.", "count": 21, "assets": [ { "key": "sp500", "class": "equities", "label": "S&P 500", "symbol": "SPY" }, { "key": "nasdaq100", "class": "equities", "label": "Nasdaq 100", "symbol": "QQQ" }, { "key": "small_caps", "class": "equities", "label": "US Small Caps", "symbol": "IWM" }, { "key": "developed_intl", "class": "equities", "label": "Developed ex-US", "symbol": "EFA" }, { "key": "emerging", "class": "equities", "label": "Emerging Markets", "symbol": "EEM" }, { "key": "technology", "class": "sector", "label": "Technology", "symbol": "XLK" }, { "key": "financials", "class": "sector", "label": "Financials", "symbol": "XLF" }, { "key": "energy", "class": "sector", "label": "Energy", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/multiassetmomentum-api/v1/meta" ``` **Response:** ```json { "data": { "note": "screener class= filters by class. asset= is a supported key (see /v1/universe). alignment_score = (timeframes up) minus (timeframes down) over 1w/1m/3m/6m/12m. Read fresh per call, nothing cached.", "source": "Yahoo Finance daily closes (1y range) across a multi-asset universe, live", "classes": [ "equities", "sector", "commodities", "bonds", "crypto" ], "service": "multiassetmomentum-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/asset": "One market's multi-timeframe momentum card (asset=sp500).", "GET /v1/screener": "Cross-asset board with fully aligned trends, ranked by alignment score (class=sector optional).", "GET /v1/universe": "The supported instruments." }, "timeframes": [ "1w", "1m", "3m", "6m", "12m" ], "description": "Multi-timeframe momentum & alignment (multi-asset) — whether each market is trending the same way across 1w/1m/3m/6m/12m, live from Yahoo Finance (no key, nothing stored). screener returns the fully aligned uptrends and downtrends across a cross-asset board ranked by alignment. asset returns one market's multi-timeframe momentum card with the alignment score (-5 to +5) and coherence. universe lists what is covered. The cross-asset multi-timeframe momentum / alignm …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/multiassetmomentum-api OpenAPI spec: https://www.oanor.com/api/multiassetmomentum-api/openapi.json