{"openapi":"3.1.0","info":{"title":"Croatian National Bank API","version":"1.0.0","description":"Live official exchange-rate data from the Croatian National Bank (Hrvatska narodna banka, HNB), the central bank of Croatia, against the euro — uniquely with three rates per currency (buying, selling and middle): the official rate for every published currency, a single currency's buying/selling/middle rate plus the inverse, a currency's official rate on a specific past date, and currency conversion between any two published currencies (including the euro) cross-computed through the euro at HNB middle rates.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/hnb-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 buying, selling and middle rate","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":"EUR","date":"2026-06-10","source":"Croatian National Bank","country":"SAD","currency":"USD","buy_per_eur":1.159,"mid_per_eur":1.1573,"code_numeric":840,"eur_per_unit":0.86408019,"sell_per_eur":1.1556},"meta":{"timestamp":"2026-06-10T14:01:41.858Z","request_id":"aedcc491-3221-447f-b0c9-48323d06f8d7"},"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":"HNB official rate for every currency vs the euro","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"EUR","date":"2026-06-10","note":"units of the listed currency per 1 EUR","count":13,"rates":[{"buy":1.6416,"mid":1.6391,"date":"2026-06-10","sell":1.6366,"country":"Australija","currency":"AUD","country_iso":"AUS","code_numeric":36},{"buy":1.95876,"mid":1.95583,"date":"2026-06-10","sell":1.9529,"country":"Bosna i Hercegovina","currency":"BAM","country_iso":"BIH","code_numeric":977},{"buy":1.6135,"mid":1.6111,"date":"2026-06-10","sell":1.6087,"country":"Kanada","currency":"CAD","country_iso":"CAN","code_numeric":124},{"buy":0.922,"mid":0.9206,"date":"2026-06-10","sell":0.9192,"country":"Švicarska","currency":"CHF","country_iso":"CHE","code_numeric":756},{"buy":24.204,"mid":24.168,"date":"2026-06-10","sell":24.132,"country":"Češka","currency":"CZK","country_iso":"CZE","code_numeric":203},{"buy":7.4854,"mid":7.4742,"date":"2026-06-10","sell":7.463,"country":"Danska","currency":"DKK","country_iso":"DNK","code_numeric":208},{"buy":0.8647,"mid":0.8634,"date":"2026-06-10","sell":0.8621,"country":"Velika Britanija","currency":"GBP","country_iso":"GBR","code_numeric":826},{"buy":355.86,"mid":355.33,"date":"2026-06-10","sell":354.8,"country":"Mađarska","currency":"HUF","country_iso":"HUN","code_numeric":348},{"buy":185.63,"mid":185.35,"date":"2026-06-10","sell":185.07,"country":"Japan","currency":"JPY","country_iso":"JPN","code_numeric":392},{"buy":10.9509,"mid":10.9345,"date":"2026-06-10","sell":10.9181,"country":"Norveška","currency":"NOK","country_iso":"NOR","code_numeric":578},{"buy":4.2437,"mid":4.2373,"date":"2026-06-10","sell":4.2309,"country":"Poljska","currency":"PLN","country_iso":"POL","code_numeric":985},{"buy":10.9013,"mid":10.885,"date":"2026-06-10","sell":10.8687,"country":"Švedska","currency":"SEK","country_iso":"SWE","code_numeric":752},{"buy":1.159,"mid":1.1573,"date":"2026-06-10","sell":1.1556,"country":"SAD","currency":"USD","country_iso":"USA","code_numeric":840}],"source":"Croatian National Bank"},"meta":{"timestamp":"2026-06-10T14:01:42.019Z","request_id":"e312301a-b0a1-4b54-ae40-4ae0604a0837"},"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":"A currency official rate on a specific past date","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"},{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"EUR","date":"2026-05-15","source":"Croatian National Bank","currency":"USD","buy_per_eur":1.172,"mid_per_eur":1.1702,"eur_per_unit":0.85455478,"sell_per_eur":1.1684},"meta":{"timestamp":"2026-06-10T14:01:42.177Z","request_id":"75ddb5db-be7a-4135-ac19-2c85b8203387"},"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 HNB 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":"GBP"},{"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":"GBP","date":"2026-06-10","from":"USD","rate":0.74604683,"amount":100,"result":74.604683,"source":"Croatian National Bank","eur_per_to":1.15821172,"eur_per_from":0.86408019},"meta":{"timestamp":"2026-06-10T14:01:42.335Z","request_id":"fa709753-86f5-43c2-9581-9eb62a5e9117"},"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":"Croatian National Bank API (api.hnb.hr, live)","service":"hnb-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's buying, selling and middle rate and inverse (currency=USD).","GET /v1/rates":"The HNB official rate for every published currency vs the euro.","GET /v1/convert":"Convert an amount between two currencies at HNB middle rates (from=USD, to=GBP, amount=100).","GET /v1/history":"A currency's official rate on a specific past date (currency=USD, date=2026-05-15)."},"description":"Live official exchange-rate data from the Croatian National Bank (Hrvatska narodna banka, HNB), the central bank of Croatia, via its public API. Since Croatia adopted the euro, the HNB publishes official daily rates against the euro, uniquely with three rates per currency: buying, selling and middle. The rates endpoint returns the official rate for every published currency against the euro; the rate endpoint returns a single currency's buying, selling and middle rate plus the inverse; the history endpoint returns a currency's official rate on a specific past date; the convert endpoint converts an amount between any two published currencies (including the euro) at the HNB's middle rates, cross-computed through the euro. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR, Riksbank and NBU feeds and from market mid-rates — this is the Croatian National Bank's own official euro exchange rate with buying, selling and middle quotes.","usd_per_eur":1.1573,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:42.500Z","request_id":"764169a1-3906-4083-bcb9-bf0a50275d5b"},"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":11000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":160000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":1000000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4800,"monthly_call_quota":5300000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/hnb-api"}