Service metadata and endpoint catalog

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/hnb-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/hnb-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

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