{"openapi":"3.1.0","info":{"title":"US Equity Market Breadth API","version":"1.0.0","description":"How broad the US stock market's move really is under the surface, computed live from Yahoo Finance across a large-cap universe (no key, nothing stored). The S&P 500 can be dragged up by a handful of megacaps while most stocks fall; breadth tells you how many stocks are actually participating. The breadth endpoint scans a ~50-name large-cap universe spanning every sector and returns the share trading above their 20-, 50- and 200-day moving averages (the classic participation gauges), the advancers versus decliners on the day, the advance/decline ratio, the average and median daily change and a regime label (broad strength, mixed or broad weakness). The components endpoint returns the per-stock table behind it — each name's price, daily change and whether it is above each moving average — so you can see exactly which stocks are carrying or dragging the market. The constituents endpoint lists the universe. The equity market-internals / breadth cut — distinct from the crypto-breadth API (which scans coins), the single-quote, index-constituent and movers APIs. It answers whether a rally is broad or narrow, not how one stock is doing.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/equitybreadth-api","description":"oanor gateway"}],"tags":[{"name":"Breadth"},{"name":"Components"},{"name":"Constituents"},{"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/breadth":{"get":{"operationId":"get_v1_breadth","tags":["Breadth"],"summary":"Market-wide breadth: % above MAs, advance/decline, regime","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Breadth across a ~50-name large-cap US universe spanning all sectors. pct_above_ma200 is the share trading above their 200-day average — high = a broad bull market, low = a broad bear. advance_decline_ratio above 1 means more stocks up than down today. A curated liquid large-cap universe, not all 500 constituents.","regime":"mixed","source":"Yahoo Finance","advancers":28,"decliners":22,"avg_change_pct":0.95,"pct_above_ma20":52,"pct_above_ma50":50,"stocks_scanned":50,"pct_above_ma200":56,"median_change_pct":0.52,"advance_decline_ratio":1.27},"meta":{"timestamp":"2026-06-12T10:35:24.000Z","request_id":"f3d5cece-8d32-430a-848e-f92ad7adcd8d"},"status":"ok","message":"Breadth 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/components":{"get":{"operationId":"get_v1_components","tags":["Components"],"summary":"Per-stock breadth table (price, daily change, above each MA)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Per-stock breadth table: price, daily change and whether each stock is above its 20/50/200-day moving average. Sorted by daily change.","source":"Yahoo Finance","components":[{"price":116.96,"symbol":"INTC","above_ma20":true,"above_ma50":true,"change_pct":9.27,"above_ma200":true},{"price":488.45,"symbol":"AMD","above_ma20":true,"above_ma50":true,"change_pct":7.97,"above_ma200":true},{"price":202.96,"symbol":"QCOM","above_ma20":false,"above_ma50":true,"change_pct":6.15,"above_ma200":true},{"price":221.63,"symbol":"BA","above_ma20":true,"above_ma50":false,"change_pct":6.04,"above_ma200":true},{"price":297.1,"symbol":"TXN","above_ma20":false,"above_ma50":true,"change_pct":5.35,"above_ma200":true},{"price":897.63,"symbol":"CAT","above_ma20":true,"above_ma50":true,"change_pct":4.84,"above_ma200":true},{"price":399.15,"symbol":"TSLA","above_ma20":false,"above_ma50":true,"change_pct":4.6,"above_ma200":false},{"price":45.96,"symbol":"NKE","above_ma20":true,"above_ma50":true,"change_pct":4.55,"above_ma200":false},{"price":332.76,"symbol":"GE","above_ma20":true,"above_ma50":true,"change_pct":4.41,"above_ma200":true},{"price":385.57,"symbol":"AVGO","above_ma20":false,"above_ma50":false,"change_pct":3.62,"above_ma200":true},{"price":1035.64,"symbol":"GS","above_ma20":true,"above_ma50":true,"change_pct":3.43,"above_ma200":true},{"price":121.83,"symbol":"CSCO","above_ma20":true,"above_ma50":true,"change_pct":2.55,"above_ma200":true},{"price":26.17,"symbol":"PFE","above_ma20":true,"above_ma50":false,"change_pct":2.23,"above_ma200":true},{"price":204.87,"symbol":"NVDA","above_ma20":false,"above_ma50":false,"change_pct":2.22,"above_ma200":true},{"price":326.01,"symbol":"HD","above_ma20":true,"above_ma50":true,"change_pct":2.22,"above_ma200":false},{"price":1160.95,"symbol":"LLY","above_ma20":true,"above_ma50":true,"change_pct":2.16,"above_ma200":true},{"price":100.34,"symbol":"DIS","above_ma20":false,"above_ma50":false,"change_pct":1.75,"above_ma200":false},{"price":241.51,"symbol":"AMZN","above_ma20":false,"above_ma50":false,"change_pct":1.47,"above_ma200":true},{"price":313.49,"symbol":"JPM","above_ma20":true,"above_ma50":true,"change_pct":1.41,"above_ma200":true},{"price":120.76,"symbol":"MRK","above_ma20":true,"above_ma50":true,"change_pct":1.4,"above_ma200":true},{"price":295.63,"symbol":"AAPL","above_ma20":false,"above_ma50":true,"change_pct":1.39,"above_ma200":true},{"price":55.16,"symbol":"BAC","above_ma20":true,"above_ma50":true,"change_pct":1.14,"above_ma200":true},{"price":274.85,"symbol":"IBM","above_ma20":true,"above_ma50":true,"change_pct":0.91,"above_ma200":true},{"price":284.77,"symbol":"MCD","above_ma20":true,"above_ma50":false,"change_pct":0.8,"above_ma200":false},{"price":89.65,"symbol":"ABT","above_ma20":true,"above_ma50":false,"change_pct":0.54,"above_ma200":false},{"price":82.4,"symbol":"WFC","above_ma20":true,"above_ma50":true,"change_pct":0.52,"above_ma200":false},{"price":485.79,"symbol":"BRK-B","above_ma20":true,"above_ma50":true,"change_pct":0.44,"above_ma200":false},{"price":357.77,"symbol":"GOOGL","above_ma20":false,"above_ma50":false,"change_pct":0.39,"above_ma200":true},{"price":238.33,"symbol":"JNJ","above_ma20":true,"above_ma50":true,"change_pct":-0.07,"above_ma200":true},{"price":120.5,"symbol":"WMT","above_ma20":false,"above_ma50":false,"change_pct":-0.07,"above_ma200":true},{"price":224.77,"symbol":"ABBV","above_ma20":true,"above_ma50":true,"change_pct":-0.08,"above_ma200":true},{"price":143.73,"symbol":"PEP","above_ma20":false,"above_ma50":false,"change_pct":-0.41,"above_ma200":false},{"price":568.43,"symbol":"META","above_ma20":false,"above_ma50":false,"change_pct":-0.45,"above_ma200":false},{"price":405.55,"symbol":"UNH","above_ma20":true,"above_ma50":true,"change_pct":-0.47,"above_ma200":true},{"price":148.34,"symbol":"PG","above_ma20":true,"above_ma50":true,"change_pct":-0.48,"above_ma200":false},{"price":486.51,"symbol":"MA","above_ma20":false,"above_ma50":false,"change_pct":-0.53,"above_ma200":false},{"price":975.69,"symbol":"COST","above_ma20":false,"above_ma50":false,"change_pct":-0.78,"above_ma200":true},{"price":81.27,"symbol":"NFLX","above_ma20":false,"above_ma50":false,"change_pct":-0.89,"above_ma200":false},{"price":23,"symbol":"T","above_ma20":false,"above_ma50":false,"change_pct":-0.9,"above_ma200":false},{"price":319.05,"symbol":"V","above_ma20":false,"above_ma50":true,"change_pct":-1.21,"above_ma200":false},{"price":82.53,"symbol":"KO","above_ma20":true,"above_ma50":true,"change_pct":-1.27,"above_ma200":true},{"price":475.66,"symbol":"TMO","above_ma20":true,"above_ma50":false,"change_pct":-1.32,"above_ma200":false},{"price":180.79,"symbol":"DHR","above_ma20":true,"above_ma50":false,"change_pct":-1.55,"above_ma200":false},{"price":167.52,"symbol":"ACN","above_ma20":false,"above_ma50":false,"change_pct":-1.75,"above_ma200":false},{"price":390.34,"symbol":"MSFT","above_ma20":false,"above_ma50":false,"change_pct":-1.77,"above_ma200":false},{"price":185.82,"symbol":"CVX","above_ma20":false,"above_ma50":false,"change_pct":-2.1,"above_ma200":true},{"price":166.45,"symbol":"CRM","above_ma20":false,"above_ma50":false,"change_pct":-2.62,"above_ma200":false},{"price":146.6,"symbol":"XOM","above_ma20":false,"above_ma50":false,"change_pct":-2.67,"above_ma200":true},{"price":218.8,"symbol":"ADBE","above_ma20":false,"above_ma50":false,"change_pct":-6.25,"above_ma200":false},{"price":184.1,"symbol":"ORCL","above_ma20":false,"above_ma50":false,"change_pct":-8.53,"above_ma200":false}],"stocks_scanned":50},"meta":{"timestamp":"2026-06-12T10:35:24.221Z","request_id":"bf769665-3c40-449e-adbf-f240e8084893"},"status":"ok","message":"Components 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/constituents":{"get":{"operationId":"get_v1_constituents","tags":["Constituents"],"summary":"The large-cap universe used","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The curated large-cap US universe used for the breadth reading — the largest, most-liquid names across all eleven sectors.","count":50,"source":"Yahoo Finance","constituents":["AAPL","MSFT","NVDA","AMZN","GOOGL","META","TSLA","AVGO","ORCL","ADBE","CRM","AMD","CSCO","INTC","TXN","QCOM","IBM","NFLX","JPM","BAC","WFC","GS","V","MA","BRK-B","UNH","LLY","JNJ","ABBV","MRK","PFE","TMO","ABT","DHR","XOM","CVX","PG","KO","PEP","COST","WMT","HD","MCD","NKE","DIS","CAT","GE","BA","ACN","T"]},"meta":{"timestamp":"2026-06-12T10:35:24.316Z","request_id":"d7f63d55-43c8-4aea-b9a0-d96bd2e00490"},"status":"ok","message":"Constituents 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":"Parameter-less. The universe is a curated set of the largest, most-liquid US stocks across all eleven sectors (a breadth proxy, not all 500 constituents). Moving averages are simple (20/50/200-day). Read fresh per call, nothing cached.","source":"Yahoo Finance daily closes across a curated large-cap US universe, 1y range, live","service":"equitybreadth-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/breadth":"Market-wide breadth: % above MAs, advance/decline, regime.","GET /v1/components":"Per-stock breadth table (price, daily change, above each MA).","GET /v1/constituents":"The large-cap universe used."},"description":"US equity market breadth — how broad the stock market's move is under the surface, live from Yahoo Finance across a ~50-name large-cap universe (no key, nothing stored). breadth returns the share above their 20/50/200-day moving averages, advancers vs decliners, the advance/decline ratio, the average/median daily change and a regime label. components returns the per-stock table. constituents lists the universe. The equity market-internals / breadth cut — distinct from the crypto-breadth API, the single-quote, index-constituent and movers APIs. It answers whether a rally is broad or narrow.","universe_size":50,"stocks_scanned":50,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:24.492Z","request_id":"e57d181d-4f90-41ac-ae2a-7d1a3a5b28d2"},"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":850,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":994,"monthly_call_quota":19500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3088,"monthly_call_quota":98000,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7340,"monthly_call_quota":520000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/equitybreadth-api"}