{"openapi":"3.1.0","info":{"title":"Currency Converter API","version":"1.0.0","description":"Live foreign-exchange conversion across 160+ world currencies — the plain, developer-friendly converter. Get the latest rates for any base currency, convert an amount between any two currencies, read the rate (and inverse) for a single pair, or list every supported currency. Rates are read live from an open exchange-rate source that aggregates a broad set of feeds and covers far more currencies than ECB-only data — including emerging-market and exotic currencies such as the Nigerian naira, Indian rupee or Vietnamese dong. This is the everyday convert / latest-rates utility a checkout, invoice, pricing page or travel app needs — distinct from the FX analytics APIs in the catalogue (historical date ranges, pip and position-size calculators, triangular-arbitrage path maths, currency indices), which compute on rates rather than simply converting them.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/currencyconverter-api","description":"oanor gateway"}],"tags":[{"name":"Convert"},{"name":"Rate"},{"name":"Latest"},{"name":"Currencies"},{"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/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between two currencies","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source ISO 4217 code","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target ISO 4217 code","schema":{"type":"string"},"example":"EUR"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"EUR","from":"USD","rate":0.866606,"amount":100,"result":86.6606,"source":"open.er-api.com","last_update":"Thu, 11 Jun 2026 00:02:31 +0000","next_update":"Fri, 12 Jun 2026 00:14:21 +0000"},"meta":{"timestamp":"2026-06-11T07:48:43.214Z","request_id":"e37c6431-e5e7-4ea5-ba4c-30ae419bf44b"},"status":"ok","message":"Conversion computed 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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"Rate for one pair (with inverse)","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Base ISO 4217 code","schema":{"type":"string"},"example":"GBP"},{"name":"to","in":"query","required":true,"description":"Quote ISO 4217 code","schema":{"type":"string"},"example":"JPY"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"JPY","from":"GBP","rate":214.659824,"source":"open.er-api.com","inverse":0.00465853,"last_update":"Thu, 11 Jun 2026 00:02:31 +0000","next_update":"Fri, 12 Jun 2026 00:15:41 +0000"},"meta":{"timestamp":"2026-06-11T07:48:43.321Z","request_id":"f46637b0-de61-49a3-9a4c-8d93eb4e3fb8"},"status":"ok","message":"Rate 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":["Latest"],"summary":"All latest rates for a base currency","description":"","parameters":[{"name":"base","in":"query","required":false,"description":"Base ISO 4217 code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"USD","count":166,"rates":{"AED":3.6725,"AFN":63.65262,"ALL":82.389172,"AMD":368.343288,"ANG":1.79,"AOA":924.18781,"ARS":1436.585,"AUD":1.427646,"AWG":1.79,"AZN":1.70039,"BAM":1.694932,"BBD":2,"BDT":122.796094,"BGN":1.694932,"BHD":0.376,"BIF":2986.749226,"BMD":1,"BND":1.287529,"BOB":6.927598,"BRL":5.177643,"BSD":1,"BTN":95.368757,"BWP":13.75985,"BYN":2.761446,"BZD":2,"CAD":1.393628,"CDF":2290.268959,"CHF":0.79938,"CLF":0.023219,"CLP":917.768614,"CNH":6.778247,"CNY":6.789317,"COP":3574.183634,"CRC":459.864392,"CUP":24,"CVE":95.556207,"CZK":20.953331,"DJF":177.721,"DKK":6.467987,"DOP":58.376638,"DZD":133.756244,"EGP":51.806516,"ERN":15,"ETB":157.940622,"EUR":0.866606,"FJD":2.221373,"FKP":0.747629,"FOK":6.468297,"GBP":0.74763,"GEL":2.654322,"GGP":0.747629,"GHS":11.538626,"GIP":0.747629,"GMD":74.119954,"GNF":8757.823847,"GTQ":7.625968,"GYD":209.02435,"HKD":7.836671,"HNL":26.74479,"HRK":6.529436,"HTG":130.717773,"HUF":308.604679,"IDR":17916.976082,"ILS":2.974761,"IMP":0.747629,"INR":95.368981,"IQD":1309.958791,"IRR":1349733.78454,"ISK":124.183227,"JEP":0.747629,"JMD":158.156411,"JOD":0.709,"JPY":160.470953,"KES":129.379229,"KGS":87.457806,"KHR":4026.806342,"KID":1.427643,"KMF":426.341741,"KRW":1522.511658,"KWD":0.308688,"KYD":0.833333,"KZT":488.182834,"LAK":21998.169406,"LBP":89500,"LKR":331.20059,"LRD":182.515309,"LSL":16.570186,"LYD":6.366012,"MAD":9.256779,"MDL":17.384477,"MGA":4202.073639,"MKD":53.24971,"MMK":2101.453805,"MNT":3555.007983,"MOP":8.071771,"MRU":40.196235,"MUR":47.857653,"MVR":15.457425,"MWK":1738.853136,"MXN":17.425597,"MYR":4.06831,"MZN":63.729523,"NAD":16.570186,"NGN":1360.040191,"NIO":36.813104,"NOK":9.474523,"NPR":152.590011,"NZD":1.723266,"OMR":0.384497,"PAB":1,"PEN":3.403321,"PGK":4.430462,"PHP":61.38431,"PKR":278.408287,"PLN":3.680262,"PYG":6154.102328,"QAR":3.64,"RON":4.532843,"RSD":101.661696,"RUB":72.14705,"RWF":1468.340207,"SAR":3.75,"SBD":8.038541,"SCR":14.069858,"SDG":543.61088,"SEK":9.507891,"SGD":1.287529,"SHP":0.747629,"SLE":24.562243,"SLL":24562.242624,"SOS":570.918523,"SRD":37.604936,"SSP":4712.679193,"STN":21.231824,"SYP":113.553229,"SZL":16.570186,"THB":32.936578,"TJS":9.326761,"TMT":3.498472,"TND":2.92384,"TOP":2.384835,"TRY":46.165427,"TTD":6.777783,"TVD":1.427643,"TWD":31.645155,"TZS":2615.232849,"UAH":45.004342,"UGX":3742.498456,"USD":1,"UYU":40.500979,"UZS":12090.727829,"VES":577.5461,"VND":26236.517073,"VUV":119.551444,"WST":2.718486,"XAF":568.455655,"XCD":2.7,"XCG":1.79,"XDR":0.733277,"XOF":568.455655,"XPF":103.413715,"YER":238.666337,"ZAR":16.56432,"ZMW":17.69039,"ZWG":26.7782,"ZWL":26.7782},"source":"open.er-api.com","last_update":"Thu, 11 Jun 2026 00:02:31 +0000","next_update":"Fri, 12 Jun 2026 00:14:21 +0000"},"meta":{"timestamp":"2026-06-11T07:48:43.396Z","request_id":"5d4fa3f0-7041-4bfc-ba53-c706225ed6c7"},"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/currencies":{"get":{"operationId":"get_v1_currencies","tags":["Currencies"],"summary":"List of supported currencies","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":166,"source":"open.er-api.com","currencies":["AED","AFN","ALL","AMD","ANG","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BGN","BHD","BIF","BMD","BND","BOB","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHF","CLF","CLP","CNH","CNY","COP","CRC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","FOK","GBP","GEL","GGP","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HRK","HTG","HUF","IDR","ILS","IMP","INR","IQD","IRR","ISK","JEP","JMD","JOD","JPY","KES","KGS","KHR","KID","KMF","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SLL","SOS","SRD","SSP","STN","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TVD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VES","VND","VUV","WST","XAF","XCD","XCG","XDR","XOF","XPF","YER","ZAR","ZMW","ZWG","ZWL"],"last_update":"Thu, 11 Jun 2026 00:02:31 +0000","next_update":"Fri, 12 Jun 2026 00:14:21 +0000"},"meta":{"timestamp":"2026-06-11T07:48:43.472Z","request_id":"7fbe823a-691c-4c02-99ce-4f14dc6d22fe"},"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"}}}},"/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":"Currency codes are ISO 4217 (USD, EUR, NGN…). Rates are quoted per one unit of the base currency. Data refreshes once a day; values are cached briefly to protect the keyless upstream.","source":"open.er-api.com (live, updated daily)","service":"currencyconverter-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"Rate for one pair, with the inverse (from=USD&to=EUR).","GET /v1/latest":"All rates for a base currency (base=USD).","GET /v1/convert":"Convert an amount between two currencies (from=USD&to=EUR&amount=100).","GET /v1/currencies":"List of supported currency codes."},"description":"Live foreign-exchange conversion across 160+ world currencies — latest rates for any base, convert an amount between any two currencies, the rate for a single pair, and the supported-currency list. Rates are read live from the open Exchange Rate API, covering far more currencies than ECB-only feeds (including emerging-market and exotic currencies). The everyday convert/latest utility, distinct from the FX analytics APIs (historical ranges, pip/position calculators, triangular-arbitrage maths, indices).","currency_count":166,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T07:48:43.548Z","request_id":"ebc83c7e-6588-45b1-b9c8-7d32f2822a54"},"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":30000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":740,"monthly_call_quota":420000,"rps_limit":10,"hard_limit":true},{"slug":"growth","name":"Growth","price_cents_month":2120,"monthly_call_quota":1900000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4950,"monthly_call_quota":6200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/currencyconverter-api"}