{"openapi":"3.1.0","info":{"title":"52-Week High/Low Range Screener API","version":"1.0.0","description":"Where every major asset sits in its one-year range — across stocks, indices, bonds, commodities, FX and crypto — computed live from Yahoo Finance (no key, nothing stored). The 52-week high/low is the single most-watched level in markets: assets breaking to new 52-week highs are in confirmed uptrends and chased by momentum, while new 52-week lows mark capitulation, and the \"new highs / new lows\" list is a classic breadth and momentum read. This places each instrument in its range as a 0-100 position (0 = sitting on its 52-week low, 100 = at its 52-week high), with how far it is below the high and above the low, and flags fresh new highs and new lows. The screener endpoint returns the whole multi-asset universe ranked by range position — what is breaking out at the top and breaking down at the bottom — plus the new-high and new-low lists. The asset endpoint drills into one instrument. The universe endpoint lists what is covered. The 52-week-range / new-highs-new-lows momentum cut across asset classes — distinct from the crypto Donchian-breakout screener (crypto only) and the single-quote, index, commodity and stock price feeds, which carry the 52-week high/low as a field but do not rank it across a multi-asset book.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fiftytwoweek-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":"Multi-asset universe ranked by 52-week range position with new-high/low lists","description":"","parameters":[{"name":"class","in":"query","required":false,"description":"Filter by class: equities, bonds, commodities, fx, crypto, stocks","schema":{"type":"string"},"example":"commodities"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every instrument placed in its 52-week range as a 0-100 position (0 = on its low, 100 = at its high), ranked high to low. near_highs are breaking out / momentum leaders; near_lows are breaking down. new_highs/new_lows list fresh 52-week extremes. class filters to equities, bonds, commodities, fx, crypto or stocks.","class":"commodities","assets":[{"key":"copper","class":"commodities","label":"Copper","price":38.94,"status":"upper range","symbol":"CPER","week52_low":27.21,"week52_high":40.6,"pct_from_low":43.11,"pct_from_high":-4.09,"range_position":87.6},{"key":"oil","class":"commodities","label":"Crude Oil","price":128.83,"status":"upper range","symbol":"USO","week52_low":66.17,"week52_high":152.96,"pct_from_low":94.7,"pct_from_high":-15.78,"range_position":72.2},{"key":"broad_commodities","class":"commodities","label":"Broad Commodities","price":28.85,"status":"upper range","symbol":"DBC","week52_low":21.62,"week52_high":31.69,"pct_from_low":33.44,"pct_from_high":-8.96,"range_position":71.8},{"key":"gold","class":"commodities","label":"Gold","price":386.32,"status":"mid range","symbol":"GLD","week52_low":300.96,"week52_high":495.9,"pct_from_low":28.36,"pct_from_high":-22.1,"range_position":43.8},{"key":"silver","class":"commodities","label":"Silver","price":60.82,"status":"lower range","symbol":"SLV","week52_low":32.61,"week52_high":105.6,"pct_from_low":86.51,"pct_from_high":-42.41,"range_position":38.6},{"key":"natural_gas","class":"commodities","label":"Natural Gas","price":11.16,"status":"lower range","symbol":"UNG","week52_low":10.15,"week52_high":18.08,"pct_from_low":9.95,"pct_from_high":-38.27,"range_position":12.7}],"source":"Yahoo Finance","scanned":6,"new_lows":[],"near_lows":[{"key":"natural_gas","label":"Natural Gas","status":"lower range","range_position":12.7},{"key":"silver","label":"Silver","status":"lower range","range_position":38.6},{"key":"gold","label":"Gold","status":"mid range","range_position":43.8},{"key":"broad_commodities","label":"Broad Commodities","status":"upper range","range_position":71.8},{"key":"oil","label":"Crude Oil","status":"upper range","range_position":72.2}],"new_highs":[],"near_highs":[{"key":"copper","label":"Copper","status":"upper range","range_position":87.6},{"key":"oil","label":"Crude Oil","status":"upper range","range_position":72.2},{"key":"broad_commodities","label":"Broad Commodities","status":"upper range","range_position":71.8},{"key":"gold","label":"Gold","status":"mid range","range_position":43.8},{"key":"silver","label":"Silver","status":"lower range","range_position":38.6}]},"meta":{"timestamp":"2026-06-12T10:35:17.597Z","request_id":"69286f05-1db8-4075-acae-5db6d090c59c"},"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 instrument 52-week range detail","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"Asset key (see /v1/universe)","schema":{"type":"string"},"example":"gold"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"key":"gold","note":"range_position is where the current price sits between the 52-week low (0) and high (100). pct_from_high is how far below the high; pct_from_low how far above the low. Computed from one year of daily closes.","class":"commodities","label":"Gold","price":386.32,"source":"Yahoo Finance","status":"mid range","symbol":"GLD","week52_low":300.96,"week52_high":495.9,"pct_from_low":28.36,"pct_from_high":-22.1,"range_position":43.8},"meta":{"timestamp":"2026-06-12T10:35:17.728Z","request_id":"a16157ec-8e7d-4bf8-a337-b19ad04d4961"},"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 cross-asset instruments. Pass key as asset= to /v1/asset, or class= to /v1/screener.","count":30,"assets":[{"key":"sp500","class":"equities","label":"S&P 500","symbol":"SPY"},{"key":"nasdaq100","class":"equities","label":"Nasdaq 100","symbol":"QQQ"},{"key":"dow","class":"equities","label":"Dow Jones","symbol":"DIA"},{"key":"russell2000","class":"equities","label":"Russell 2000","symbol":"IWM"},{"key":"developed_intl","class":"equities","label":"Developed ex-US","symbol":"EFA"},{"key":"emerging","class":"equities","label":"Emerging Markets","symbol":"EEM"},{"key":"long_treasuries","class":"bonds","label":"Long US Treasuries","symbol":"TLT"},{"key":"ig_credit","class":"bonds","label":"Investment-Grade Credit","symbol":"LQD"},{"key":"high_yield","class":"bonds","label":"High-Yield Credit","symbol":"HYG"},{"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":"copper","class":"commodities","label":"Copper","symbol":"CPER"},{"key":"us_dollar","class":"fx","label":"US Dollar Index","symbol":"UUP"},{"key":"eurusd","class":"fx","label":"EUR/USD","symbol":"EURUSD=X"},{"key":"gbpusd","class":"fx","label":"GBP/USD","symbol":"GBPUSD=X"},{"key":"usdjpy","class":"fx","label":"USD/JPY","symbol":"USDJPY=X"},{"key":"bitcoin","class":"crypto","label":"Bitcoin","symbol":"BTC-USD"},{"key":"ether","class":"crypto","label":"Ether","symbol":"ETH-USD"},{"key":"apple","class":"stocks","label":"Apple","symbol":"AAPL"},{"key":"microsoft","class":"stocks","label":"Microsoft","symbol":"MSFT"},{"key":"nvidia","class":"stocks","label":"Nvidia","symbol":"NVDA"},{"key":"amazon","class":"stocks","label":"Amazon","symbol":"AMZN"},{"key":"alphabet","class":"stocks","label":"Alphabet","symbol":"GOOGL"},{"key":"meta","class":"stocks","label":"Meta","symbol":"META"},{"key":"tesla","class":"stocks","label":"Tesla","symbol":"TSLA"},{"key":"jpmorgan","class":"stocks","label":"JPMorgan","symbol":"JPM"},{"key":"exxon","class":"stocks","label":"ExxonMobil","symbol":"XOM"}],"source":"Yahoo Finance","classes":["equities","bonds","commodities","fx","crypto","stocks"]},"meta":{"timestamp":"2026-06-12T10:35:17.836Z","request_id":"c08911be-a381-447b-a8b0-856404cb6a50"},"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 asset class. asset= is a supported key (see /v1/universe). The 52-week high/low are the max/min daily close over the year. Read fresh per call, nothing cached.","source":"Yahoo Finance daily closes (1y range) across a multi-asset universe, live","classes":["equities","bonds","commodities","fx","crypto","stocks"],"service":"fiftytwoweek-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"One instrument's 52-week range detail (asset=gold).","GET /v1/screener":"Multi-asset universe ranked by 52-week range position, with new-high/low lists (class=commodities optional).","GET /v1/universe":"The supported instruments."},"description":"52-week high/low range screener — where every major asset sits in its one-year range, across stocks, indices, bonds, commodities, FX and crypto, live from Yahoo Finance (no key, nothing stored). screener ranks the whole multi-asset universe by range position (0-100) with the near-highs, near-lows and fresh new-high/new-low lists. asset drills into one instrument. universe lists what is covered. The 52-week-range / new-highs-new-lows momentum cut across asset classes — distinct from the crypto Donchian-breakout screener and the single-quote, index, commodity and stock price feeds.","universe_size":30,"assets_scanned":30,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:18.785Z","request_id":"0914b149-438f-4497-a780-293008fc837b"},"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":780,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1126,"monthly_call_quota":17800,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3444,"monthly_call_quota":91500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7880,"monthly_call_quota":498000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fiftytwoweek-api"}