Service metadata and endpoint catalog

Code snippets

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

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

$ch = curl_init("https://api.oanor.com/nbk-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/nbk-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 Kazakhstan rate feed (nationalbank.kz, live)",
        "service": "nbk-api",
        "usd_kzt": 490.21,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rate": "One currency's official rate, tenge-per-unit and inverse, plus change (currency=USD).",
            "GET /v1/rates": "The NBK official rate for every currency vs the tenge, with change and direction.",
            "GET /v1/convert": "Convert an amount between two currencies at NBK rates (from=USD, to=EUR, 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 National Bank of the Republic of Kazakhstan (NBK), the central bank of Kazakhstan, for the tenge (KZT), via its public rate feed — each rate with its direction (rose or fell) and the day's change. The rates endpoint returns the NBK's official rate for every published currency against the tenge, normalised to one unit, with the day's change and direction; the rate endpoint returns a single currency's official rate (tenge-per-unit and the inverse) plus the change; 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 KZT) at the NBK's official rates, cross-computed through the tenge. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI and other central-bank feeds and from market mid-rates — this is the National Bank of Kazakhstan's own official tenge exchange rate with daily change and direction.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T14:00:06.680Z",
        "request_id": "3b4ec67f-7ee8-4709-bf65-a3e4c49f6ef9"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}