Service metadata

Extraits de code

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

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

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

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "date": "11.06.2026",
        "note": "Each rate is the tenge value of `nominal` units of the foreign currency. date accepts DD.MM.YYYY or YYYY-MM-DD (default today). For convert, one of from/to must be KZT.",
        "source": "National Bank of Kazakhstan (nationalbank.kz/rss/get_rates.cfm, live XML)",
        "service": "nbkz-api",
        "usd_kzt": 488.59,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/rates": "Full official board for a date (date optional, default today).",
            "GET /v1/convert": "Convert between KZT and a quoted currency (from=USD&to=KZT&amount=100).",
            "GET /v1/currency": "One currency's official rate (currency=USD, date optional)."
        },
        "description": "Live official exchange rates from the National Bank of the Republic of Kazakhstan, the central bank that sets the tenge (KZT) reference rate. The rates endpoint returns the full official board for a date (every quoted currency with rate, nominal, direction and change); the currency endpoint returns one currency's official rate, optionally for a past date; the convert endpoint converts an amount between the tenge and any quoted currency at the official rate. Live, no key, nothing stored. The Kazakhstani central-bank FX cut (KZT reference rates) — distinct from the crypto exchange-ticker and the other central-bank APIs.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:55.078Z",
        "request_id": "a4aec478-eab9-4708-b68a-e68c063aa7b6"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}