{"openapi":"3.1.0","info":{"title":"Central Bank of Armenia (CBA) FX API","version":"1.0.0","description":"Official Armenian dram (AMD) exchange rates from the Central Bank of Armenia, with no key. Get the latest official rate for every quoted currency (ISO, quoted amount, published rate and day-over-day difference), a single-currency rate, a currency converter and the list of quoted currencies. Rates are normalised to a per-unit AMD value (Rate ÷ Amount), so conversions are correct even for currencies the CBA quotes per 10 or 100 units (e.g. JPY). The Armenian-FX layer for treasury, pricing and FX dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cba-api","description":"oanor gateway"}],"tags":[{"name":"FX"},{"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":["FX"],"summary":"Convert an amount between two currencies via AMD","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source ISO code (or AMD)","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target ISO code (or AMD)","schema":{"type":"string"},"example":"AMD"},{"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":"AMD","base":"AMD","date":"2026-06-12","from":"USD","rate":368.18,"amount":100,"result":36818},"meta":{"timestamp":"2026-06-15T11:15:46.096Z","request_id":"759613b8-aa5a-4165-bba7-fc476d8d6a7b"},"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":["FX"],"summary":"All currencies quoted by the CBA","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"AMD","date":"2026-06-12","count":30,"currencies":["AED","AUD","BRL","BYN","CAD","CHF","CNY","CZK","EUR","GBP","GEL","HKD","INR","IRR","JPY","KGS","KZT","NOK","NZD","PLN","RUB","SEK","SGD","TJS","UAH","USD","UZS","XAG","XAU","XDR"]},"meta":{"timestamp":"2026-06-15T11:15:46.186Z","request_id":"8ff19a7f-fff8-4ad9-b39d-72935e1a5830"},"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/latest":{"get":{"operationId":"get_v1_latest","tags":["FX"],"summary":"Latest official AMD rates (all or selected)","description":"","parameters":[{"name":"symbols","in":"query","required":false,"description":"Comma-separated ISO codes","schema":{"type":"string"},"example":"USD,EUR,RUB"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"AMD","date":"2026-06-12","count":3,"rates":[{"iso":"USD","rate":368.18,"amount":1,"difference":-0.24,"per_unit_amd":368.18},{"iso":"EUR","rate":426.09,"amount":1,"difference":1.19,"per_unit_amd":426.09},{"iso":"RUB","rate":5.0686,"amount":1,"difference":-0.0278,"per_unit_amd":5.0686}]},"meta":{"timestamp":"2026-06-15T11:15:46.267Z","request_id":"926ee921-4ddc-4a40-9a59-bf446042d9f8"},"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/rate":{"get":{"operationId":"get_v1_rate","tags":["FX"],"summary":"Single-currency AMD rate","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"3-letter ISO code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"iso":"USD","base":"AMD","date":"2026-06-12","rate":368.18,"amount":1,"difference":-0.24,"per_unit_amd":368.18},"meta":{"timestamp":"2026-06-15T11:15:46.348Z","request_id":"eb66e575-5614-4f22-acd9-ac92fbc0acce"},"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Bank metadata & endpoint guide","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bank":"Central Bank of Armenia (CBA)","note":"per_unit_amd = Rate / Amount, so conversions are correct even when the CBA quotes a currency per 10 or 100 units.","source":"Central Bank of Armenia SOAP service (api.cba.am/exchangerates.asmx), keyless","country":"Armenia","examples":{"rate":"/v1/rate?symbol=USD","latest":"/v1/latest?symbols=USD,EUR,RUB","convert":"/v1/convert?from=USD&to=AMD&amount=100","currencies":"/v1/currencies"},"endpoints":{"/v1/rate":"single-currency rate with amount, rate and per-unit AMD value (symbol=USD)","/v1/latest":"latest official AMD rates for all (or selected) currencies (symbols optional)","/v1/convert":"convert an amount between any two quoted currencies via AMD (from, to, amount)","/v1/currencies":"all currencies quoted by the CBA"},"cache_ttl_ms":300000,"base_currency":"AMD"},"meta":{"timestamp":"2026-06-15T11:15:46.446Z","request_id":"2bc48ab5-6439-43c5-8a00-29bba4b53405"},"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":1380,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":790,"monthly_call_quota":41800,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2460,"monthly_call_quota":168000,"rps_limit":14,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5280,"monthly_call_quota":695000,"rps_limit":38,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cba-api"}