{"openapi":"3.1.0","info":{"title":"Relative Strength vs S&P 500 API","version":"1.0.0","description":"Which markets are beating the benchmark and which are lagging, ranked, computed live from Yahoo Finance (no key, nothing stored). Relative strength is the engine of rotation: money flows toward what is outperforming, and the leaders of one quarter often lead the next. For a cross-asset, cross-sector universe — the eleven S&P 500 sectors plus small caps, international and emerging equities, gold, oil, commodities, bonds and crypto — this measures each asset's return MINUS the S&P 500's over one, three and six months, blends them into a relative-strength score, and ranks the whole board into leaders and laggards. A positive score means the asset is beating the market; a negative one means it is lagging. The ranking endpoint returns that ranked board with the benchmark's own return and the standout leaders and laggards. The asset endpoint returns one market's relative strength across each window, its beta to the S&P 500 and whether its relative strength is improving or fading. The universe endpoint lists what is covered. The relative-strength / market-leadership rotation cut — distinct from the absolute-momentum, the sector-correlation and the altcoin-season APIs. It answers what is leading the market, measured against it.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/relativestrength-api","description":"oanor gateway"}],"tags":[{"name":"Ranking"},{"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/ranking":{"get":{"operationId":"get_v1_ranking","tags":["Ranking"],"summary":"Cross-asset board ranked by relative strength vs the S&P 500 with leaders/laggards","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":"Relative strength = asset return minus the S&P 500's return over 1, 3 and 6 months; rs_score blends them. Positive = beating the market (a leader); negative = lagging. Ranked by rs_score, leaders first. rs_trend improving = short-term RS above longer-term (gaining leadership).","class":"sector","assets":[{"key":"technology","rank":1,"class":"sector","label":"Technology","rs_pct":{"1m":4.63,"3m":22.15,"6m":15.76},"rs_score":14.18,"rs_trend":"fading"},{"key":"energy","rank":2,"class":"sector","label":"Energy","rs_pct":{"1m":-0.72,"3m":-11.44,"6m":16.98},"rs_score":1.61,"rs_trend":"improving"},{"key":"industrials","rank":3,"class":"sector","label":"Industrials","rs_pct":{"1m":0.52,"3m":-4.77,"6m":6.27},"rs_score":0.67,"rs_trend":"improving"},{"key":"materials","rank":4,"class":"sector","label":"Materials","rs_pct":{"1m":-1.71,"3m":-7.66,"6m":10.03},"rs_score":0.22,"rs_trend":"improving"},{"key":"real_estate","rank":5,"class":"sector","label":"Real Estate","rs_pct":{"1m":0.82,"3m":-4.17,"6m":2.9},"rs_score":-0.15,"rs_trend":"improving"},{"key":"consumer_staples","rank":6,"class":"sector","label":"Consumer Staples","rs_pct":{"1m":1.04,"3m":-9.55,"6m":1.32},"rs_score":-2.4,"rs_trend":"improving"},{"key":"health_care","rank":7,"class":"sector","label":"Health Care","rs_pct":{"1m":5.71,"3m":-8.15,"6m":-5.26},"rs_score":-2.57,"rs_trend":"improving"},{"key":"financials","rank":8,"class":"sector","label":"Financials","rs_pct":{"1m":2.07,"3m":-3,"6m":-9.25},"rs_score":-3.39,"rs_trend":"improving"},{"key":"consumer_discretionary","rank":9,"class":"sector","label":"Consumer Discretionary","rs_pct":{"1m":-1.63,"3m":-6.48,"6m":-9.44},"rs_score":-5.85,"rs_trend":"improving"},{"key":"utilities","rank":10,"class":"sector","label":"Utilities","rs_pct":{"1m":-2.47,"3m":-16.03,"6m":-4.97},"rs_score":-7.82,"rs_trend":"improving"},{"key":"communication","rank":11,"class":"sector","label":"Communication","rs_pct":{"1m":-3.17,"3m":-13.5,"6m":-11.68},"rs_score":-9.45,"rs_trend":"improving"}],"source":"Yahoo Finance","window":"1m/3m/6m blend","leaders":[{"key":"technology","label":"Technology","rs_score":14.18,"rs_trend":"fading"},{"key":"energy","label":"Energy","rs_score":1.61,"rs_trend":"improving"},{"key":"industrials","label":"Industrials","rs_score":0.67,"rs_trend":"improving"},{"key":"materials","label":"Materials","rs_score":0.22,"rs_trend":"improving"},{"key":"real_estate","label":"Real Estate","rs_score":-0.15,"rs_trend":"improving"}],"scanned":11,"laggards":[{"key":"communication","label":"Communication","rs_score":-9.45,"rs_trend":"improving"},{"key":"utilities","label":"Utilities","rs_score":-7.82,"rs_trend":"improving"},{"key":"consumer_discretionary","label":"Consumer Discretionary","rs_score":-5.85,"rs_trend":"improving"},{"key":"financials","label":"Financials","rs_score":-3.39,"rs_trend":"improving"},{"key":"health_care","label":"Health Care","rs_score":-2.57,"rs_trend":"improving"}],"benchmark":"S&P 500","benchmark_return_6m_pct":8.01},"meta":{"timestamp":"2026-06-12T10:35:10.098Z","request_id":"96d4a65f-e470-4e29-bafb-af7270248c12"},"status":"ok","message":"Ranking 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 relative strength per window + beta + improving/fading","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"Asset key (see /v1/universe)","schema":{"type":"string"},"example":"technology"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"key":"technology","note":"Relative strength = asset return minus the S&P 500's return over 1, 3 and 6 months; rs_score blends them. Positive = beating the market (a leader); negative = lagging. beta_to_sp500 shows how much it amplifies market moves.","read":"outperforming the market","class":"sector","label":"Technology","rs_pct":{"1m":4.63,"3m":22.15,"6m":15.76},"source":"Yahoo Finance","symbol":"XLK","rs_score":14.18,"rs_trend":"fading","benchmark":"S&P 500","beta_to_sp500":1.598},"meta":{"timestamp":"2026-06-12T10:35:10.233Z","request_id":"5c74191d-59b8-47b3-9348-5410f6fbd5dd"},"status":"ok","message":"Asset relative strength 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, all measured against the S&P 500. Pass key as asset= to /v1/asset, class= to /v1/ranking.","count":23,"assets":[{"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":"consumer_discretionary","class":"sector","label":"Consumer Discretionary","symbol":"XLY"},{"key":"consumer_staples","class":"sector","label":"Consumer Staples","symbol":"XLP"},{"key":"industrials","class":"sector","label":"Industrials","symbol":"XLI"},{"key":"materials","class":"sector","label":"Materials","symbol":"XLB"},{"key":"utilities","class":"sector","label":"Utilities","symbol":"XLU"},{"key":"real_estate","class":"sector","label":"Real Estate","symbol":"XLRE"},{"key":"communication","class":"sector","label":"Communication","symbol":"XLC"},{"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":"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"],"benchmark":"S&P 500 (SPY)"},"meta":{"timestamp":"2026-06-12T10:35:10.325Z","request_id":"367bd74e-5a71-4f78-b0ed-83e9970e4c38"},"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":"ranking class= filters by class. asset= is a supported key (see /v1/universe). Relative strength = excess return over SPY over 1/3/6 months. Read fresh per call, nothing cached.","source":"Yahoo Finance daily closes (1y range) vs SPY benchmark, live","classes":["equities","sector","commodities","bonds","crypto"],"service":"relativestrength-api","benchmark":"S&P 500","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"One market's relative strength per window + beta + improving/fading (asset=technology).","GET /v1/ranking":"Cross-asset board ranked by relative strength vs the S&P 500 with leaders/laggards (class=sector optional).","GET /v1/universe":"The supported instruments."},"description":"Relative strength vs S&P 500 — which markets are beating the benchmark and which are lagging, ranked, live from Yahoo Finance (no key, nothing stored). ranking returns a cross-asset, cross-sector board ranked by relative strength (excess return over the S&P 500 blended across 1/3/6 months) with leaders and laggards. asset returns one market's relative strength per window, its beta to the S&P 500 and whether its RS is improving or fading. universe lists what is covered. The relative-strength / market-leadership rotation cut — distinct from the absolute-momentum, sector-correlation and altcoin-season APIs.","universe_size":23,"assets_scanned":23,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:10.665Z","request_id":"d446f8e7-028d-47dc-acbf-b43fc841fd34"},"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":710,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1108,"monthly_call_quota":16300,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3344,"monthly_call_quota":88500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7620,"monthly_call_quota":478000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/relativestrength-api"}