Bank metadata & endpoint guide

Code snippets

curl "https://api.oanor.com/bosnia-fx-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/bosnia-fx-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/bosnia-fx-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/bosnia-fx-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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
}