Service metadata and endpoint catalog

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/nbrb-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/nbrb-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": "National Bank of Belarus API (api.nbrb.by, live)",
        "service": "nbrb-api",
        "usd_byn": 2.7671,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's official rate, rouble-per-unit and inverse (currency=USD).",
            "GET /v1/rates": "The NBRB official rate for every currency vs the rouble.",
            "GET /v1/convert": "Convert an amount between two currencies at NBRB rates (from=USD, to=EUR, amount=100).",
            "GET /v1/history": "Daily time series of a currency's official rate over a date range (currency=USD, from, to)."
        },
        "description": "Live official exchange-rate data from the National Bank of the Republic of Belarus (NBRB), the central bank of Belarus, for the Belarusian rouble (BYN), via its public API. The rates endpoint returns the NBRB's official rate for every published currency against the rouble, normalised to one unit; the rate endpoint returns a single currency's official rate (rouble-per-unit and the inverse); the history endpoint returns the daily time series of a currency's official rate over a full date range; the convert endpoint converts an amount between any two published currencies (including BYN) at the NBRB's official rates, cross-computed through the rouble. Live, no key, nothing stored. Distinct from the ECB, SNB, Bank of Canada, Norges Bank, NBP, CNB, BCB, CBR, Riksbank, NBU, HNB and NBG feeds and from market mid-rates — this is the National Bank of Belarus's own official rouble exchange rate with a full date-range history.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T14:01:34.968Z",
        "request_id": "b723e123-60f1-41be-8b71-822860ca509b"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}