{"openapi":"3.1.0","info":{"title":"Currency API","version":"1.0.0","description":"Live & historical foreign-exchange rates from the European Central Bank: latest rates, historical lookups, time-series and currency conversion across 30+ currencies.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/currency-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Conversion"},{"name":"Reference"}],"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/historical":{"get":{"operationId":"get_v1_historical","tags":["Rates"],"summary":"Rates on a specific date","description":"","parameters":[{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2024-01-02"},{"name":"base","in":"query","required":false,"description":"Base currency","schema":{"type":"string"},"example":"EUR"},{"name":"symbols","in":"query","required":false,"description":"Target currencies","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"EUR","date":"2024-01-02","rates":{"USD":1.0956}},"meta":{"timestamp":"2026-05-29T19:13:38.861Z","request_id":"84ac7766-7e4e-48f3-a1f6-ce389e479409"},"status":"ok","message":"Historical rates 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/latest":{"get":{"operationId":"get_v1_latest","tags":["Rates"],"summary":"Latest reference rates","description":"","parameters":[{"name":"base","in":"query","required":false,"description":"Base currency (ISO-4217)","schema":{"type":"string"},"example":"USD"},{"name":"symbols","in":"query","required":false,"description":"Comma-separated target currencies","schema":{"type":"string"},"example":"EUR,GBP"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"USD","date":"2026-05-29","rates":{"EUR":0.85881,"GBP":0.74479}},"meta":{"timestamp":"2026-05-29T19:13:39.238Z","request_id":"539e2f37-15e0-4119-943d-c3ca69c6358c"},"status":"ok","message":"Latest rates 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/timeseries":{"get":{"operationId":"get_v1_timeseries","tags":["Rates"],"summary":"Rates over a date range","description":"","parameters":[{"name":"start_date","in":"query","required":true,"description":"Start YYYY-MM-DD","schema":{"type":"string"},"example":"2024-01-01"},{"name":"end_date","in":"query","required":false,"description":"End YYYY-MM-DD","schema":{"type":"string"},"example":"2024-01-31"},{"name":"base","in":"query","required":false,"description":"Base currency","schema":{"type":"string"},"example":"EUR"},{"name":"symbols","in":"query","required":false,"description":"Target currencies","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"EUR","rates":{"2023-12-29":{"USD":1.105},"2024-01-02":{"USD":1.0956},"2024-01-03":{"USD":1.0919},"2024-01-04":{"USD":1.0953},"2024-01-05":{"USD":1.0921},"2024-01-08":{"USD":1.0946},"2024-01-09":{"USD":1.094},"2024-01-10":{"USD":1.0946},"2024-01-11":{"USD":1.0987},"2024-01-12":{"USD":1.0942},"2024-01-15":{"USD":1.0945},"2024-01-16":{"USD":1.0882},"2024-01-17":{"USD":1.0877},"2024-01-18":{"USD":1.0875},"2024-01-19":{"USD":1.0887},"2024-01-22":{"USD":1.089},"2024-01-23":{"USD":1.0872},"2024-01-24":{"USD":1.0905},"2024-01-25":{"USD":1.0893},"2024-01-26":{"USD":1.0871},"2024-01-29":{"USD":1.0823},"2024-01-30":{"USD":1.0846},"2024-01-31":{"USD":1.0837}},"end_date":"2024-01-31","start_date":"2023-12-29"},"meta":{"timestamp":"2026-05-29T19:13:39.737Z","request_id":"f0fa153d-5217-4982-91df-945cab26642f"},"status":"ok","message":"Time-series 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/convert":{"get":{"operationId":"get_v1_convert","tags":["Conversion"],"summary":"Convert an amount","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"From currency","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"To currency","schema":{"type":"string"},"example":"EUR"},{"name":"amount","in":"query","required":false,"description":"Amount","schema":{"type":"string"},"example":"100"},{"name":"date","in":"query","required":false,"description":"Date YYYY-MM-DD (default latest)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"EUR","date":"2026-05-29","from":"USD","rate":0.85881,"amount":100,"result":85.881},"meta":{"timestamp":"2026-05-29T19:13:40.144Z","request_id":"3a874bea-8a00-4e1b-a535-2bfe8315c7a8"},"status":"ok","message":"Conversion 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/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Reference"],"summary":"Supported currency codes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":30,"currencies":[{"code":"AUD","name":"Australian Dollar"},{"code":"BRL","name":"Brazilian Real"},{"code":"CAD","name":"Canadian Dollar"},{"code":"CHF","name":"Swiss Franc"},{"code":"CNY","name":"Chinese Renminbi Yuan"},{"code":"CZK","name":"Czech Koruna"},{"code":"DKK","name":"Danish Krone"},{"code":"EUR","name":"Euro"},{"code":"GBP","name":"British Pound"},{"code":"HKD","name":"Hong Kong Dollar"},{"code":"HUF","name":"Hungarian Forint"},{"code":"IDR","name":"Indonesian Rupiah"},{"code":"ILS","name":"Israeli New Shekel"},{"code":"INR","name":"Indian Rupee"},{"code":"ISK","name":"Icelandic Króna"},{"code":"JPY","name":"Japanese Yen"},{"code":"KRW","name":"South Korean Won"},{"code":"MXN","name":"Mexican Peso"},{"code":"MYR","name":"Malaysian Ringgit"},{"code":"NOK","name":"Norwegian Krone"},{"code":"NZD","name":"New Zealand Dollar"},{"code":"PHP","name":"Philippine Peso"},{"code":"PLN","name":"Polish Złoty"},{"code":"RON","name":"Romanian Leu"},{"code":"SEK","name":"Swedish Krona"},{"code":"SGD","name":"Singapore Dollar"},{"code":"THB","name":"Thai Baht"},{"code":"TRY","name":"Turkish Lira"},{"code":"USD","name":"United States Dollar"},{"code":"ZAR","name":"South African Rand"}]},"meta":{"timestamp":"2026-05-29T19:13:40.828Z","request_id":"a4091d8e-70be-4cde-87ae-94a05b73ed8c"},"status":"ok","message":"Currencies 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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":900,"monthly_call_quota":50000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":250000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7900,"monthly_call_quota":1000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/currency-api"}