{"openapi":"3.1.0","info":{"title":"Cross-Asset Drawdown & Recovery Monitor API","version":"1.0.0","description":"How far every major market is below its peak and how long it has been underwater, computed live from Yahoo Finance (no key, nothing stored). Drawdown is the risk investors actually feel: not volatility in the abstract, but the gap between today's price and the high-water mark, and the painful stretch spent climbing back. For every asset — equity indices, bonds, gold, oil, commodities, FX and crypto — this measures the current drawdown from its rolling peak, the worst (maximum) drawdown over the window, the date and level of the peak, how many days it has been underwater, and how much of the fall it has already recovered. The monitor endpoint returns the whole universe ranked by current drawdown — what is deepest underwater and what is back at new highs — with a summary of how many markets are in drawdown. The asset endpoint returns one market's drawdown card. The universe endpoint lists what is covered. The cross-asset drawdown / underwater-recovery cut — distinct from the FX-only drawdown API, the crypto all-time-high API and the cross-asset volatility API (which ranks risk-adjusted return, not the underwater curve). It answers how far from the highs, and how long.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/assetdrawdown-api","description":"oanor gateway"}],"tags":[{"name":"Monitor"},{"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/monitor":{"get":{"operationId":"get_v1_monitor","tags":["Monitor"],"summary":"Universe ranked by current drawdown with new-high list and drawdown count","description":"","parameters":[{"name":"class","in":"query","required":false,"description":"Filter by class: equities, bonds, commodities, fx, crypto, real_estate","schema":{"type":"string"},"example":"equities"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every market ranked by current drawdown (deepest underwater first). current_drawdown_pct is the fall from the window's highest close; max_drawdown_pct is the worst drawdown in the window; days_since_peak is how long underwater; recovery_from_trough_pct is how much of the fall has been clawed back. Window is two years. Not financial advice.","class":"equities","assets":[{"key":"emerging","class":"equities","label":"Emerging Markets","price":67.5,"status":"near highs","peak_date":"2026-06-02","peak_price":70.8,"at_new_high":false,"days_since_peak":9,"max_drawdown_pct":-18.67,"current_drawdown_pct":-4.66,"recovery_from_trough_pct":46.9},{"key":"nasdaq100","class":"equities","label":"Nasdaq 100","price":717.12,"status":"near highs","peak_date":"2026-06-02","peak_price":746.16,"at_new_high":false,"days_since_peak":9,"max_drawdown_pct":-22.88,"current_drawdown_pct":-3.89,"recovery_from_trough_pct":44.7},{"key":"sp500","class":"equities","label":"S&P 500","price":737.76,"status":"near highs","peak_date":"2026-06-02","peak_price":759.57,"at_new_high":false,"days_since_peak":9,"max_drawdown_pct":-19,"current_drawdown_pct":-2.87,"recovery_from_trough_pct":36.1},{"key":"developed_intl","class":"equities","label":"Developed ex-US","price":104.73,"status":"near highs","peak_date":"2026-02-25","peak_price":105.66,"at_new_high":false,"days_since_peak":106,"max_drawdown_pct":-14.05,"current_drawdown_pct":-0.88,"recovery_from_trough_pct":92.3},{"key":"russell2000","class":"equities","label":"Russell 2000","price":290.41,"status":"near highs","peak_date":"2026-05-28","peak_price":292.03,"at_new_high":false,"days_since_peak":14,"max_drawdown_pct":-27.88,"current_drawdown_pct":-0.55,"recovery_from_trough_pct":84.4}],"source":"Yahoo Finance","scanned":5,"at_new_highs":[],"in_drawdown_count":5,"deepest_underwater":[{"key":"emerging","status":"near highs","current_drawdown_pct":-4.66},{"key":"nasdaq100","status":"near highs","current_drawdown_pct":-3.89},{"key":"sp500","status":"near highs","current_drawdown_pct":-2.87},{"key":"developed_intl","status":"near highs","current_drawdown_pct":-0.88},{"key":"russell2000","status":"near highs","current_drawdown_pct":-0.55}]},"meta":{"timestamp":"2026-06-12T10:35:10.988Z","request_id":"dd13a328-8e3b-44f5-a2fe-807e4d5f3121"},"status":"ok","message":"Monitor 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 drawdown & recovery card","description":"","parameters":[{"name":"asset","in":"query","required":true,"description":"Asset key (see /v1/universe)","schema":{"type":"string"},"example":"bitcoin"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"key":"bitcoin","note":"One market's drawdown card over a two-year window: current drawdown from the peak, the worst drawdown, the peak date/level, days underwater and how much of the fall has recovered.","class":"crypto","label":"Bitcoin","price":63675.5781,"source":"Yahoo Finance","status":"deep drawdown","symbol":"BTC-USD","peak_date":"2025-10-06","peak_price":124752.5313,"at_new_high":false,"days_since_peak":249,"max_drawdown_pct":-51.21,"current_drawdown_pct":-48.96,"recovery_from_trough_pct":4.4},"meta":{"timestamp":"2026-06-12T10:35:11.154Z","request_id":"70050a9b-f9bb-4b98-80d1-9ebfce89a755"},"status":"ok","message":"Asset drawdown 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, class= to /v1/monitor.","count":17,"assets":[{"key":"sp500","class":"equities","label":"S&P 500","symbol":"SPY"},{"key":"nasdaq100","class":"equities","label":"Nasdaq 100","symbol":"QQQ"},{"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":"us_dollar","class":"fx","label":"US Dollar Index","symbol":"UUP"},{"key":"real_estate","class":"real_estate","label":"US Real Estate (REITs)","symbol":"VNQ"},{"key":"bitcoin","class":"crypto","label":"Bitcoin","symbol":"BTC-USD"},{"key":"ether","class":"crypto","label":"Ether","symbol":"ETH-USD"}],"source":"Yahoo Finance","classes":["equities","bonds","commodities","fx","crypto","real_estate"]},"meta":{"timestamp":"2026-06-12T10:35:11.248Z","request_id":"0540258b-0611-42de-af02-9732f034c642"},"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":"monitor class= filters by asset class. asset= is a supported key (see /v1/universe). Drawdowns are measured over a two-year window from the running peak. Read fresh per call, nothing cached.","source":"Yahoo Finance daily closes (2y range) across a multi-asset universe, live","classes":["equities","bonds","commodities","fx","crypto","real_estate"],"service":"assetdrawdown-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"One market's drawdown & recovery card (asset=bitcoin).","GET /v1/monitor":"Universe ranked by current drawdown, with new-high list and drawdown count (class=equities optional).","GET /v1/universe":"The supported instruments."},"description":"Cross-asset drawdown & recovery monitor — how far every major market is below its peak and how long it has been underwater, live from Yahoo Finance (no key, nothing stored). monitor ranks the universe by current drawdown (deepest underwater first) with the new-high list and a drawdown count. asset returns one market's drawdown card (current/max drawdown, peak date, days underwater, recovery). universe lists what is covered. The cross-asset drawdown / underwater-recovery cut — distinct from the FX-only drawdown API, the crypto all-time-high API and the cross-asset volatility API (risk-adjusted return, not the underwater curve).","universe_size":17,"assets_scanned":17,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T10:35:11.667Z","request_id":"60a3277c-0355-42f9-af0e-6c28907e1553"},"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":740,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1024,"monthly_call_quota":17200,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3088,"monthly_call_quota":90500,"rps_limit":16,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7160,"monthly_call_quota":484000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/assetdrawdown-api"}