{"openapi":"3.1.0","info":{"title":"FX Drawdown API","version":"1.0.0","description":"A live forex risk analytic that measures the worst peak-to-trough decline a currency pair has suffered, computed from European Central Bank daily reference rates. For any pair it returns the maximum drawdown over the period — the deepest drop from a high to a later low, with the dates it happened — how far the pair is currently below its period high, and whether it has recovered. Get a pair's drawdown over a month, quarter, half-year or year, or scan a basket to rank pairs by worst-case risk. Position-sizing and risk input for forex, trading and research apps. Live, no key. Distinct from rate, strength, volatility, correlation, signal, range and seasonality APIs.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fxdrawdown-api","description":"oanor gateway"}],"tags":[{"name":"Drawdown"},{"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/drawdown":{"get":{"operationId":"get_v1_drawdown","tags":["Drawdown"],"summary":"A pair's max + current drawdown","description":"","parameters":[{"name":"base","in":"query","required":true,"description":"Base currency","schema":{"type":"string"},"example":"EUR"},{"name":"quote","in":"query","required":true,"description":"Quote currency","schema":{"type":"string"},"example":"USD"},{"name":"period","in":"query","required":false,"description":"1m | 3m | 6m | 1y","schema":{"type":"string"},"example":"1y"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"EUR","pair":"EURUSD","quote":"USD","period":"1y","current":1.154,"to_date":"2026-06-08","from_date":"2025-06-05","peak_date":"2026-01-28","recovered":false,"peak_value":1.1974,"trough_date":"2026-03-13","observations":257,"trough_value":1.1476,"max_drawdown_pct":-4.16,"current_drawdown_pct":-3.62},"meta":{"timestamp":"2026-06-09T03:03:06.698Z","request_id":"9cd56537-e4c0-4ed5-9b5a-865f34136f93"},"status":"ok","message":"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/scan":{"get":{"operationId":"get_v1_scan","tags":["Drawdown"],"summary":"Scan a basket ranked by drawdown","description":"","parameters":[{"name":"base","in":"query","required":false,"description":"Base currency","schema":{"type":"string"},"example":"USD"},{"name":"period","in":"query","required":false,"description":"1m | 3m | 6m | 1y","schema":{"type":"string"},"example":"1y"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"USD","as_of":"2026-06-08","count":7,"pairs":[{"pair":"USDAUD","quote":"AUD","recovered":false,"max_drawdown_pct":-11.99,"current_drawdown_pct":-9.73},{"pair":"USDNZD","quote":"NZD","recovered":false,"max_drawdown_pct":-7.82,"current_drawdown_pct":-3.9},{"pair":"USDCHF","quote":"CHF","recovered":false,"max_drawdown_pct":-6.76,"current_drawdown_pct":-3.22},{"pair":"USDGBP","quote":"GBP","recovered":false,"max_drawdown_pct":-5.59,"current_drawdown_pct":-2.38},{"pair":"USDEUR","quote":"EUR","recovered":false,"max_drawdown_pct":-4.76,"current_drawdown_pct":-1.18},{"pair":"USDCAD","quote":"CAD","recovered":false,"max_drawdown_pct":-4.28,"current_drawdown_pct":-1.37},{"pair":"USDJPY","quote":"JPY","recovered":true,"max_drawdown_pct":-3.91,"current_drawdown_pct":0}],"period":"1y"},"meta":{"timestamp":"2026-06-09T03:03:06.834Z","request_id":"b13d8ad3-97a0-4e7a-9f7c-f9525432db47"},"status":"ok","message":"Scan 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":{"as_of":"2026-06-08","source":"ECB daily reference rates via Frankfurter (live)","periods":["1m","3m","6m","1y"],"service":"fxdrawdown-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/scan":"Scan a basket vs a base, ranked by worst drawdown (base=USD, period=).","GET /v1/drawdown":"A pair's max drawdown + current drawdown (base=EUR&quote=USD, period=1m|3m|6m|1y)."},"description":"Live FX drawdown (worst-case risk) analytic from ECB reference rates (Frankfurter): for any currency pair, the maximum peak-to-trough decline over the period (with dates), the current drawdown from the period high, and whether it has recovered. Get a pair's drawdown or scan a basket by risk. Live, no key. Distinct from rate, strength, volatility, correlation, signal, range and seasonality APIs.","scan_basket":["USD","EUR","JPY","GBP","AUD","CAD","CHF","NZD"]},"meta":{"timestamp":"2026-06-09T03:03:07.013Z","request_id":"24ae4bbe-f083-4ffb-bf0e-514ac0ce9ff7"},"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":360,"rps_limit":3,"hard_limit":true},{"slug":"trader","name":"Trader","price_cents_month":1100,"monthly_call_quota":9400,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2500,"monthly_call_quota":46500,"rps_limit":25,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5600,"monthly_call_quota":232000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fxdrawdown-api"}