{"openapi":"3.1.0","info":{"title":"Multi-Timeframe Momentum & Alignment (Multi-Asset) API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/multiassetmomentum-api","description":"oanor gateway"}],"tags":[{"name":"Screener"},{"name":"Asset"},{"name":"Universe"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/screener":{"get":{"operationId":"get_v1_screener","tags":["Screener"],"summary":"Cross-asset board with fully aligned trends ranked by alignment score","description":"","parameters":[{"name":"class","in":"query","required":false,"description":"Filter by class: equities, sector, commodities, bonds, crypto","schema":{"type":"string"},"example":"sector"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","6m":"up","12m":"up"},"returns_pct":{"1m":0.76,"1w":1.17,"3m":6.6,"6m":10.91,"12m":6.37},"timeframes_up":5,"alignment_score":5,"timeframes_down":0},{"key":"technology","class":"sector","label":"Technology","coherence":"leaning up","directions":{"1m":"up","1w":"down","3m":"up","6m":"up","12m":"up"},"returns_pct":{"1m":4.57,"1w":-5.16,"3m":32.91,"6m":23.77,"12m":51.06},"timeframes_up":4,"alignment_score":3,"timeframes_down":1},{"key":"financials","class":"sector","label":"Financials","coherence":"leaning up","directions":{"1m":"up","1w":"up","3m":"up","6m":"down","12m":"up"},"returns_pct":{"1m":2.02,"1w":0.82,"3m":7.76,"6m":-1.24,"12m":3.18},"timeframes_up":4,"alignment_score":3,"timeframes_down":1},{"key":"industrials","class":"sector","label":"Industrials","coherence":"leaning up","directions":{"1m":"up","1w":"down","3m":"up","6m":"up","12m":"up"},"returns_pct":{"1m":0.46,"1w":-0.57,"3m":6,"6m":14.28,"12m":21.75},"timeframes_up":4,"alignment_score":3,"timeframes_down":1},{"key":"utilities","class":"sector","label":"Utilities","coherence":"mixed / no clear trend","directions":{"1m":"down","1w":"up","3m":"down","6m":"up","12m":"up"},"returns_pct":{"1m":-2.52,"1w":0.25,"3m":-5.27,"6m":3.04,"12m":7.58},"timeframes_up":3,"alignment_score":1,"timeframes_down":2},{"key":"energy","class":"sector","label":"Energy","coherence":"mixed / no clear trend","directions":{"1m":"down","1w":"down","3m":"down","6m":"up","12m":"up"},"returns_pct":{"1m":-0.78,"1w":-2.77,"3m":-0.68,"6m":24.99,"12m":31.93},"timeframes_up":2,"alignment_score":-1,"timeframes_down":3}],"source":"Yahoo Finance","scanned":7,"fully_aligned_up":[{"key":"health_care","label":"Health Care"},{"key":"real_estate","label":"Real Estate"}],"fully_aligned_down":[]},"meta":{"timestamp":"2026-06-12T10:35:01.870Z","request_id":"bcf6624a-f3bb-46ce-8275-43b6e97c752b"},"status":"ok","message":"Screener retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/asset":{"get":{"operationId":"get_v1_asset","tags":["Asset"],"summary":"One market multi-timeframe momentum card","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"Asset key (see /v1/universe)","schema":{"type":"string"},"example":"sp500"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/universe":{"get":{"operationId":"get_v1_universe","tags":["Universe"],"summary":"Supported instruments","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","symbol":"XLE"},{"key":"health_care","class":"sector","label":"Health Care","symbol":"XLV"},{"key":"industrials","class":"sector","label":"Industrials","symbol":"XLI"},{"key":"utilities","class":"sector","label":"Utilities","symbol":"XLU"},{"key":"real_estate","class":"sector","label":"Real Estate","symbol":"XLRE"},{"key":"gold","class":"commodities","label":"Gold","symbol":"GLD"},{"key":"silver","class":"commodities","label":"Silver","symbol":"SLV"},{"key":"oil","class":"commodities","label":"Crude Oil","symbol":"USO"},{"key":"natural_gas","class":"commodities","label":"Natural Gas","symbol":"UNG"},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities","symbol":"DBC"},{"key":"long_treasuries","class":"bonds","label":"Long Treasuries","symbol":"TLT"},{"key":"high_yield","class":"bonds","label":"High-Yield Credit","symbol":"HYG"},{"key":"bitcoin","class":"crypto","label":"Bitcoin","symbol":"BTC-USD"},{"key":"ether","class":"crypto","label":"Ether","symbol":"ETH-USD"}],"source":"Yahoo Finance","classes":["equities","sector","commodities","bonds","crypto"]},"meta":{"timestamp":"2026-06-12T10:35:02.248Z","request_id":"db8a8ecf-1d15-40ef-b2a5-f3f45390059d"},"status":"ok","message":"Universe retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 / alignment cut — distinct from the crypto-only multi-timeframe API, the commodity-momentum ranking and the relative-strength APIs.","universe_size":21,"assets_scanned":21,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:02.704Z","request_id":"177f2735-17eb-465b-bd25-c0f7c17d96c0"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":750,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1206,"monthly_call_quota":16600,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3640,"monthly_call_quota":88000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8180,"monthly_call_quota":478000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/multiassetmomentum-api"}