{"openapi":"3.1.0","info":{"title":"Central Bank of Bosnia and Herzegovina (CBBH) FX API","version":"1.0.0","description":"Official convertible-mark (BAM) exchange rates from the Central Bank of Bosnia and Herzegovina (CBBH), with no key. Get the latest official buy/middle/sell rate for every quoted currency, a single-currency rate, a currency converter and the list of quoted currencies. The bank publishes a unit count (1 or 100) per currency, so every rate is normalised to a per-unit BAM value (middle ÷ units) and conversions are correct. The BAM is pegged to the euro at 1.95583. The Bosnia-FX layer for treasury, pricing and FX dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bosnia-fx-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 BAM","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source ISO code (or BAM)","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target ISO code (or BAM)","schema":{"type":"string"},"example":"BAM"},{"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":"BAM","base":"BAM","date":"2026-06-13","from":"USD","rate":1.690871,"amount":100,"result":169.0871},"meta":{"timestamp":"2026-06-15T11:15:31.772Z","request_id":"0775f202-fade-4f23-8f01-6c06a9ed3e6d"},"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 CBBH","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BAM","date":"2026-06-13","count":17,"currencies":["AUD","CAD","CHF","CNY","CZK","DKK","EUR","GBP","HUF","JPY","NOK","RSD","RUB","SEK","TRY","USD","XDR"]},"meta":{"timestamp":"2026-06-15T11:15:31.866Z","request_id":"95764784-fc85-47b1-9c6c-e04b0041d4e6"},"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 BAM rates (all or selected)","description":"","parameters":[{"name":"symbols","in":"query","required":false,"description":"Comma-separated ISO codes","schema":{"type":"string"},"example":"EUR,USD,GBP"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BAM","date":"2026-06-13","count":3,"rates":[{"buy":1.95583,"iso":"EUR","sell":1.95583,"units":1,"middle":1.95583,"country":"EMU","per_unit_bam":1.95583},{"buy":2.260519,"iso":"GBP","sell":2.271849,"units":1,"middle":2.266184,"country":"G.Britain","per_unit_bam":2.266184},{"buy":1.686644,"iso":"USD","sell":1.695098,"units":1,"middle":1.690871,"country":"USA","per_unit_bam":1.690871}]},"meta":{"timestamp":"2026-06-15T11:15:32.002Z","request_id":"34ec0637-f76d-45e8-b5f8-a59cb6166c7a"},"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 BAM rate","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"3-letter ISO code","schema":{"type":"string"},"example":"EUR"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"buy":1.95583,"iso":"EUR","base":"BAM","date":"2026-06-13","sell":1.95583,"units":1,"middle":1.95583,"country":"EMU","per_unit_bam":1.95583},"meta":{"timestamp":"2026-06-15T11:15:32.087Z","request_id":"af15f991-2e13-42fb-ab90-c24854f05cc2"},"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 Bosnia and Herzegovina (CBBH)","note":"per_unit_bam = middle / units; the BAM (convertible mark) is pegged to the euro at 1.95583. Conversions are correct even when a currency is quoted per 100 units.","source":"CBBH XML feed (cbbh.ba/CurrencyExchange/GetXml), keyless","country":"Bosnia and Herzegovina","examples":{"rate":"/v1/rate?symbol=USD","latest":"/v1/latest?symbols=EUR,USD,GBP","convert":"/v1/convert?from=USD&to=BAM&amount=100","currencies":"/v1/currencies"},"endpoints":{"/v1/rate":"single-currency rate with buy/middle/sell, units and per-unit BAM value (symbol=EUR)","/v1/latest":"latest official BAM buy/middle/sell rates for all (or selected) currencies (symbols optional)","/v1/convert":"convert an amount between any two quoted currencies via BAM (from, to, amount)","/v1/currencies":"all currencies quoted by the CBBH"},"cache_ttl_ms":300000,"base_currency":"BAM"},"meta":{"timestamp":"2026-06-15T11:15:32.175Z","request_id":"d7098ac0-e3e3-4f56-afee-1e3b3b2de301"},"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":1300,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":810,"monthly_call_quota":39800,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2490,"monthly_call_quota":161000,"rps_limit":14,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":5430,"monthly_call_quota":668000,"rps_limit":38,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bosnia-fx-api"}