{"openapi":"3.1.0","info":{"title":"National Bank of Belarus API","version":"1.0.0","description":"Live official exchange-rate data from the National Bank of the Republic of Belarus (NBRB), the central bank of Belarus, for the Belarusian rouble (BYN): the NBRB official rate for every published currency (normalised to one unit), a single currency's rouble-per-unit rate and inverse, the daily time series of a currency's official rate over a full date range, and currency conversion between any two published currencies (including BYN) cross-computed through the rouble at NBRB rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbrb-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"History"},{"name":"Convert"},{"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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rates"],"summary":"One currency rouble-per-unit rate and inverse","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BYN","date":"2026-06-10","name":"Доллар США","scale":1,"source":"National Bank of Belarus","currency":"USD","byn_per_unit":2.7671,"unit_per_byn":0.36138918,"official_rate":2.7671},"meta":{"timestamp":"2026-06-10T14:01:34.308Z","request_id":"ac5febd2-425c-4b3c-9c0e-273ad1c33860"},"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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"NBRB official rate for every currency vs the rouble","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BYN","date":"2026-06-10","count":30,"rates":[{"date":"2026-06-10","name":"Дирхамов ОАЭ","scale":10,"cur_id":513,"currency":"AED","byn_per_unit":0.75346,"official_rate":7.5346},{"date":"2026-06-10","name":"Армянских драмов","scale":1000,"cur_id":510,"currency":"AMD","byn_per_unit":0.0075085,"official_rate":7.5085},{"date":"2026-06-10","name":"Австралийский доллар","scale":1,"cur_id":440,"currency":"AUD","byn_per_unit":1.9514,"official_rate":1.9514},{"date":"2026-06-10","name":"Бразильских реалов","scale":10,"cur_id":514,"currency":"BRL","byn_per_unit":0.53336,"official_rate":5.3336},{"date":"2026-06-10","name":"Канадский доллар","scale":1,"cur_id":371,"currency":"CAD","byn_per_unit":1.9854,"official_rate":1.9854},{"date":"2026-06-10","name":"Швейцарский франк","scale":1,"cur_id":426,"currency":"CHF","byn_per_unit":3.4745,"official_rate":3.4745},{"date":"2026-06-10","name":"Китайских юаней","scale":10,"cur_id":462,"currency":"CNY","byn_per_unit":0.40827,"official_rate":4.0827},{"date":"2026-06-10","name":"Чешских крон","scale":100,"cur_id":463,"currency":"CZK","byn_per_unit":0.132272,"official_rate":13.2272},{"date":"2026-06-10","name":"Датских крон","scale":10,"cur_id":450,"currency":"DKK","byn_per_unit":0.42801,"official_rate":4.2801},{"date":"2026-06-10","name":"Евро","scale":1,"cur_id":451,"currency":"EUR","byn_per_unit":3.1995,"official_rate":3.1995},{"date":"2026-06-10","name":"Фунт стерлингов","scale":1,"cur_id":429,"currency":"GBP","byn_per_unit":3.705,"official_rate":3.705},{"date":"2026-06-10","name":"Индийских рупий","scale":100,"cur_id":511,"currency":"INR","byn_per_unit":0.029063,"official_rate":2.9063},{"date":"2026-06-10","name":"Иранских риалов","scale":100000,"cur_id":461,"currency":"IRR","byn_per_unit":2.01e-6,"official_rate":0.2012},{"date":"2026-06-10","name":"Исландских крон","scale":100,"cur_id":453,"currency":"ISK","byn_per_unit":0.022307,"official_rate":2.2307},{"date":"2026-06-10","name":"Иен","scale":100,"cur_id":508,"currency":"JPY","byn_per_unit":0.017274,"official_rate":1.7274},{"date":"2026-06-10","name":"Сомов","scale":100,"cur_id":458,"currency":"KGS","byn_per_unit":0.031642,"official_rate":3.1642},{"date":"2026-06-10","name":"Кувейтский динар","scale":1,"cur_id":394,"currency":"KWD","byn_per_unit":8.9521,"official_rate":8.9521},{"date":"2026-06-10","name":"Тенге","scale":1000,"cur_id":459,"currency":"KZT","byn_per_unit":0.005673,"official_rate":5.673},{"date":"2026-06-10","name":"Молдавских леев","scale":10,"cur_id":454,"currency":"MDL","byn_per_unit":0.15912,"official_rate":1.5912},{"date":"2026-06-10","name":"Норвежских крон","scale":10,"cur_id":455,"currency":"NOK","byn_per_unit":0.2923,"official_rate":2.923},{"date":"2026-06-10","name":"Новозеландский доллар","scale":1,"cur_id":448,"currency":"NZD","byn_per_unit":1.6135,"official_rate":1.6135},{"date":"2026-06-10","name":"Злотых","scale":10,"cur_id":452,"currency":"PLN","byn_per_unit":0.75527,"official_rate":7.5527},{"date":"2026-06-10","name":"Российских рублей","scale":100,"cur_id":456,"currency":"RUB","byn_per_unit":0.038581,"official_rate":3.8581},{"date":"2026-06-10","name":"Шведских крон","scale":10,"cur_id":464,"currency":"SEK","byn_per_unit":0.29361,"official_rate":2.9361},{"date":"2026-06-10","name":"Сингапурcкий доллар","scale":1,"cur_id":421,"currency":"SGD","byn_per_unit":2.1522,"official_rate":2.1522},{"date":"2026-06-10","name":"Турецких лир","scale":10,"cur_id":460,"currency":"TRY","byn_per_unit":0.06,"official_rate":0.6},{"date":"2026-06-10","name":"Гривен","scale":100,"cur_id":449,"currency":"UAH","byn_per_unit":0.062041,"official_rate":6.2041},{"date":"2026-06-10","name":"Доллар США","scale":1,"cur_id":431,"currency":"USD","byn_per_unit":2.7671,"official_rate":2.7671},{"date":"2026-06-10","name":"Донгов","scale":100000,"cur_id":512,"currency":"VND","byn_per_unit":0.00010509,"official_rate":10.5087},{"date":"2026-06-10","name":"СДР (Специальные права заимствования)","scale":1,"cur_id":457,"currency":"XDR","byn_per_unit":3.7711,"official_rate":3.7711}],"source":"National Bank of Belarus"},"meta":{"timestamp":"2026-06-10T14:01:34.433Z","request_id":"47e7ef6c-b494-483c-b147-e2c847fdf85d"},"status":"ok","message":"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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Daily time series of a currency official rate over a date range","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"},{"name":"from","in":"query","required":false,"description":"Start date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-01"},{"name":"to","in":"query","required":false,"description":"End date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-31"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"2026-05-31","base":"BYN","from":"2026-05-01","name":"Доллар США","count":31,"scale":1,"source":"National Bank of Belarus","currency":"USD","observations":[{"date":"2026-05-31","byn_per_unit":2.7596,"official_rate":2.7596},{"date":"2026-05-30","byn_per_unit":2.7596,"official_rate":2.7596},{"date":"2026-05-29","byn_per_unit":2.7596,"official_rate":2.7596},{"date":"2026-05-28","byn_per_unit":2.7638,"official_rate":2.7638},{"date":"2026-05-27","byn_per_unit":2.7703,"official_rate":2.7703},{"date":"2026-05-26","byn_per_unit":2.7549,"official_rate":2.7549},{"date":"2026-05-25","byn_per_unit":2.7506,"official_rate":2.7506},{"date":"2026-05-24","byn_per_unit":2.7315,"official_rate":2.7315},{"date":"2026-05-23","byn_per_unit":2.7315,"official_rate":2.7315},{"date":"2026-05-22","byn_per_unit":2.7315,"official_rate":2.7315},{"date":"2026-05-21","byn_per_unit":2.7304,"official_rate":2.7304},{"date":"2026-05-20","byn_per_unit":2.7293,"official_rate":2.7293},{"date":"2026-05-19","byn_per_unit":2.7473,"official_rate":2.7473},{"date":"2026-05-18","byn_per_unit":2.7535,"official_rate":2.7535},{"date":"2026-05-17","byn_per_unit":2.7697,"official_rate":2.7697},{"date":"2026-05-16","byn_per_unit":2.7697,"official_rate":2.7697},{"date":"2026-05-15","byn_per_unit":2.7697,"official_rate":2.7697},{"date":"2026-05-14","byn_per_unit":2.7772,"official_rate":2.7772},{"date":"2026-05-13","byn_per_unit":2.7938,"official_rate":2.7938},{"date":"2026-05-12","byn_per_unit":2.7984,"official_rate":2.7984},{"date":"2026-05-11","byn_per_unit":2.8073,"official_rate":2.8073},{"date":"2026-05-10","byn_per_unit":2.8186,"official_rate":2.8186},{"date":"2026-05-09","byn_per_unit":2.8186,"official_rate":2.8186},{"date":"2026-05-08","byn_per_unit":2.8186,"official_rate":2.8186},{"date":"2026-05-07","byn_per_unit":2.8258,"official_rate":2.8258},{"date":"2026-05-06","byn_per_unit":2.8305,"official_rate":2.8305},{"date":"2026-05-05","byn_per_unit":2.8315,"official_rate":2.8315},{"date":"2026-05-04","byn_per_unit":2.8267,"official_rate":2.8267},{"date":"2026-05-03","byn_per_unit":2.823,"official_rate":2.823},{"date":"2026-05-02","byn_per_unit":2.823,"official_rate":2.823},{"date":"2026-05-01","byn_per_unit":2.823,"official_rate":2.823}]},"meta":{"timestamp":"2026-06-10T14:01:34.693Z","request_id":"c253e427-b50e-4e17-b470-a6b562071441"},"status":"ok","message":"History 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":["Convert"],"summary":"Convert an amount between two currencies at NBRB rates","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency","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","date":"2026-06-10","from":"USD","rate":0.86485388,"amount":100,"result":86.485388,"source":"National Bank of Belarus","byn_per_to":3.1995,"byn_per_from":2.7671},"meta":{"timestamp":"2026-06-10T14:01:34.856Z","request_id":"a7631654-902a-4aa2-921c-27c046c4e1c1"},"status":"ok","message":"Conversion completed 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 and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"National Bank of Belarus API (api.nbrb.by, live)","service":"nbrb-api","usd_byn":2.7671,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, rouble-per-unit and inverse (currency=USD).","GET /v1/rates":"The NBRB official rate for every currency vs the rouble.","GET /v1/convert":"Convert an amount between two currencies at NBRB rates (from=USD, to=EUR, amount=100).","GET /v1/history":"Daily time series of a currency's official rate over a date range (currency=USD, from, to)."},"description":"Live official exchange-rate data from the National Bank of the Republic of Belarus (NBRB), the central bank of Belarus, for the Belarusian rouble (BYN), via its public API. The rates endpoint returns the NBRB's official rate for every published currency against the rouble, normalised to one unit; the rate endpoint returns a single currency's official rate (rouble-per-unit and the inverse); the history endpoint returns the daily time series of a currency's official rate over a full date range; the convert endpoint converts an amount between any two published currencies (including BYN) at the NBRB's official rates, cross-computed through the rouble. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR, Riksbank, NBU, HNB and NBG feeds and from market mid-rates — this is the National Bank of Belarus's own official rouble exchange rate with a full date-range history.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:34.968Z","request_id":"b723e123-60f1-41be-8b71-822860ca509b"},"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":13000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":170000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":1060000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5300,"monthly_call_quota":5600000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbrb-api"}