{"openapi":"3.1.0","info":{"title":"National Bank of Ukraine API","version":"1.0.0","description":"Live official exchange-rate data from the National Bank of Ukraine (NBU), the central bank of Ukraine, for the hryvnia (UAH): the NBU official daily rate for every one of 45-plus currencies, a single currency's rate (hryvnia-per-unit and inverse), the daily time series of a currency's official rate over a date range and currency conversion between any two currencies (including UAH) cross-computed through the hryvnia at NBU rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbu-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 official rate, hryvnia-per-unit 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":"UAH","date":"2026-06-11","name":"Долар США","source":"National Bank of Ukraine","currency":"USD","code_numeric":840,"uah_per_unit":44.979,"unit_per_uah":0.0222326},"meta":{"timestamp":"2026-06-10T14:01:46.473Z","request_id":"be21b2d1-5ba1-4fc8-97b1-11bf0fc34dd3"},"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":"NBU official rate for every currency vs hryvnia","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"UAH","date":"2026-06-11","count":45,"rates":[{"date":"2026-06-11","name":"Дирхам ОАЕ","currency":"AED","code_numeric":784,"uah_per_unit":12.2458},{"date":"2026-06-11","name":"Австралійський долар","currency":"AUD","code_numeric":36,"uah_per_unit":31.4898},{"date":"2026-06-11","name":"Азербайджанський манат","currency":"AZN","code_numeric":944,"uah_per_unit":26.4645},{"date":"2026-06-11","name":"Така","currency":"BDT","code_numeric":50,"uah_per_unit":0.3665},{"date":"2026-06-11","name":"Канадський долар","currency":"CAD","code_numeric":124,"uah_per_unit":32.2812},{"date":"2026-06-11","name":"Швейцарський франк","currency":"CHF","code_numeric":756,"uah_per_unit":56.2765},{"date":"2026-06-11","name":"Юань Женьміньбі","currency":"CNY","code_numeric":156,"uah_per_unit":6.6333},{"date":"2026-06-11","name":"Чеська крона","currency":"CZK","code_numeric":203,"uah_per_unit":2.1448},{"date":"2026-06-11","name":"Данська крона","currency":"DKK","code_numeric":208,"uah_per_unit":6.9429},{"date":"2026-06-11","name":"Алжирський динар","currency":"DZD","code_numeric":12,"uah_per_unit":0.3367},{"date":"2026-06-11","name":"Єгипетський фунт","currency":"EGP","code_numeric":818,"uah_per_unit":0.8678},{"date":"2026-06-11","name":"Євро","currency":"EUR","code_numeric":978,"uah_per_unit":51.8945},{"date":"2026-06-11","name":"Фунт стерлінгів","currency":"GBP","code_numeric":826,"uah_per_unit":60.1819},{"date":"2026-06-11","name":"Ларі","currency":"GEL","code_numeric":981,"uah_per_unit":16.931},{"date":"2026-06-11","name":"Гонконгівський долар","currency":"HKD","code_numeric":344,"uah_per_unit":5.7393},{"date":"2026-06-11","name":"Форинт","currency":"HUF","code_numeric":348,"uah_per_unit":0.145511},{"date":"2026-06-11","name":"Рупія","currency":"IDR","code_numeric":360,"uah_per_unit":0.0025064},{"date":"2026-06-11","name":"Новий ізраїльський шекель","currency":"ILS","code_numeric":376,"uah_per_unit":15.0987},{"date":"2026-06-11","name":"Індійська рупія","currency":"INR","code_numeric":356,"uah_per_unit":0.47217},{"date":"2026-06-11","name":"Єна","currency":"JPY","code_numeric":392,"uah_per_unit":0.28026},{"date":"2026-06-11","name":"Вона","currency":"KRW","code_numeric":410,"uah_per_unit":0.029497},{"date":"2026-06-11","name":"Теньге","currency":"KZT","code_numeric":398,"uah_per_unit":0.092132},{"date":"2026-06-11","name":"Ліванський фунт","currency":"LBP","code_numeric":422,"uah_per_unit":0.000502},{"date":"2026-06-11","name":"Молдовський лей","currency":"MDL","code_numeric":498,"uah_per_unit":2.588},{"date":"2026-06-11","name":"Мексиканське песо","currency":"MXN","code_numeric":484,"uah_per_unit":2.5731},{"date":"2026-06-11","name":"Малайзійський ринггіт","currency":"MYR","code_numeric":458,"uah_per_unit":11.0524},{"date":"2026-06-11","name":"Норвезька крона","currency":"NOK","code_numeric":578,"uah_per_unit":4.7382},{"date":"2026-06-11","name":"Новозеландський долар","currency":"NZD","code_numeric":554,"uah_per_unit":26.1081},{"date":"2026-06-11","name":"Злотий","currency":"PLN","code_numeric":985,"uah_per_unit":12.2136},{"date":"2026-06-11","name":"Румунський лей","currency":"RON","code_numeric":946,"uah_per_unit":9.9088},{"date":"2026-06-11","name":"Сербський динар","currency":"RSD","code_numeric":941,"uah_per_unit":0.44225},{"date":"2026-06-11","name":"Саудівський ріял","currency":"SAR","code_numeric":682,"uah_per_unit":11.9819},{"date":"2026-06-11","name":"Шведська крона","currency":"SEK","code_numeric":752,"uah_per_unit":4.7331},{"date":"2026-06-11","name":"Сінгапурський долар","currency":"SGD","code_numeric":702,"uah_per_unit":34.9135},{"date":"2026-06-11","name":"Бат","currency":"THB","code_numeric":764,"uah_per_unit":1.36515},{"date":"2026-06-11","name":"Туніський динар","currency":"TND","code_numeric":788,"uah_per_unit":15.3397},{"date":"2026-06-11","name":"Турецька ліра","currency":"TRY","code_numeric":949,"uah_per_unit":0.9749},{"date":"2026-06-11","name":"Долар США","currency":"USD","code_numeric":840,"uah_per_unit":44.979},{"date":"2026-06-11","name":"Донг","currency":"VND","code_numeric":704,"uah_per_unit":0.0017089},{"date":"2026-06-11","name":"Срібло","currency":"XAG","code_numeric":961,"uah_per_unit":2873.33},{"date":"2026-06-11","name":"Золото","currency":"XAU","code_numeric":959,"uah_per_unit":186729.42},{"date":"2026-06-11","name":"СПЗ (спеціальні права запозичення)","currency":"XDR","code_numeric":960,"uah_per_unit":61.3303},{"date":"2026-06-11","name":"Паладій","currency":"XPD","code_numeric":964,"uah_per_unit":55348.01},{"date":"2026-06-11","name":"Платина","currency":"XPT","code_numeric":962,"uah_per_unit":74862.6},{"date":"2026-06-11","name":"Ренд","currency":"ZAR","code_numeric":710,"uah_per_unit":2.7087}],"source":"National Bank of Ukraine"},"meta":{"timestamp":"2026-06-10T14:01:46.657Z","request_id":"28d4d353-2d83-4517-8c31-da1c30f960bb"},"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","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":"UAH","from":"2026-05-01","name":"US Dollar","count":31,"source":"National Bank of Ukraine","currency":"USD","observations":[{"date":"2026-05-31","uah_per_unit":44.2653},{"date":"2026-05-30","uah_per_unit":44.2653},{"date":"2026-05-29","uah_per_unit":44.2653},{"date":"2026-05-28","uah_per_unit":44.2996},{"date":"2026-05-27","uah_per_unit":44.2767},{"date":"2026-05-26","uah_per_unit":44.2447},{"date":"2026-05-25","uah_per_unit":44.2619},{"date":"2026-05-24","uah_per_unit":44.2341},{"date":"2026-05-23","uah_per_unit":44.2341},{"date":"2026-05-22","uah_per_unit":44.2341},{"date":"2026-05-21","uah_per_unit":44.2271},{"date":"2026-05-20","uah_per_unit":44.153},{"date":"2026-05-19","uah_per_unit":44.1591},{"date":"2026-05-18","uah_per_unit":44.0724},{"date":"2026-05-17","uah_per_unit":43.9569},{"date":"2026-05-16","uah_per_unit":43.9569},{"date":"2026-05-15","uah_per_unit":43.9569},{"date":"2026-05-14","uah_per_unit":43.9694},{"date":"2026-05-13","uah_per_unit":43.9709},{"date":"2026-05-12","uah_per_unit":43.9584},{"date":"2026-05-11","uah_per_unit":43.855},{"date":"2026-05-10","uah_per_unit":43.8033},{"date":"2026-05-09","uah_per_unit":43.8033},{"date":"2026-05-08","uah_per_unit":43.8033},{"date":"2026-05-07","uah_per_unit":43.8528},{"date":"2026-05-06","uah_per_unit":43.9698},{"date":"2026-05-05","uah_per_unit":44},{"date":"2026-05-04","uah_per_unit":43.9129},{"date":"2026-05-03","uah_per_unit":43.963},{"date":"2026-05-02","uah_per_unit":43.963},{"date":"2026-05-01","uah_per_unit":43.963}]},"meta":{"timestamp":"2026-06-10T14:01:46.836Z","request_id":"5eb766f6-b651-4cf0-bbba-c94098df3b77"},"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 NBU 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-11","from":"USD","rate":0.86673925,"amount":100,"result":86.673925,"source":"National Bank of Ukraine","uah_per_to":51.8945,"uah_per_from":44.979},"meta":{"timestamp":"2026-06-10T14:01:47.032Z","request_id":"df9ccdc1-ce1a-441c-84c8-d22a540992f5"},"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 Ukraine statistics API (bank.gov.ua, live)","service":"nbu-api","usd_uah":44.979,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, hryvnia-per-unit and inverse (currency=USD).","GET /v1/rates":"The NBU official rate for every currency vs the hryvnia.","GET /v1/convert":"Convert an amount between two currencies at NBU rates (from=USD, to=EUR, amount=100).","GET /v1/history":"Daily time series of a currency's official rate (currency=USD, from, to)."},"description":"Live official exchange-rate data from the National Bank of Ukraine (NBU), the central bank of Ukraine, for the hryvnia (UAH), via its public statistics API. The rates endpoint returns the NBU's official daily rate for every one of 45-plus currencies against the hryvnia; the rate endpoint returns a single currency's official rate (hryvnia-per-unit and the inverse); the history endpoint returns the daily time series of a currency's official rate over a date range; the convert endpoint converts an amount between any two currencies (including UAH) at the NBU's official rates, cross-computed through the hryvnia. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR and Riksbank feeds and from market mid-rates — this is the National Bank of Ukraine's own official hryvnia exchange rate.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:47.185Z","request_id":"8fe3c7c4-ec41-4f69-8b2b-95751c7506ea"},"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":12000,"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":2100,"monthly_call_quota":1050000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5000,"monthly_call_quota":5500000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbu-api"}