# National Bank of Kazakhstan (NBK) FX API > Live official exchange rates from the National Bank of the Republic of Kazakhstan (NBK), the central bank that sets the tenge (KZT) reference rate — read straight from the bank's public rates feed, no key, nothing stored. The rates endpoint returns the full official board for any date: every foreign currency the bank quotes against the tenge with its rate, the nominal it is quoted per, the daily direction (up / down / flat) and the change. The currency endpoint returns a single currency's official rate, for today or any past date. The convert endpoint converts an amount between the tenge and any quoted currency at the official rate — both directions. Look up the tenge value of the US dollar, euro, Russian ruble, Chinese yuan and 35 more currencies, or pull a historical board by date. This is the Kazakhstani central-bank FX cut (KZT reference rates) — distinct from the crypto exchange-ticker and the other central-bank APIs in the catalogue. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/nbkz-api/..." ``` ## Pricing - **Free** (Free) — 22,000 calls/Mo, 3 req/s - **Desk** ($7/Mo) — 260,000 calls/Mo, 10 req/s - **Pro** ($20/Mo) — 1,050,000 calls/Mo, 28 req/s - **Scale** ($47/Mo) — 3,600,000 calls/Mo, 60 req/s ## Endpoints ### Rates #### `GET /v1/rates` — Full official KZT board for a date **Parameters:** - `date` (query, optional, string) — Date DD.MM.YYYY or YYYY-MM-DD (default today) Example: `2026-06-01` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/nbkz-api/v1/rates?date=2026-06-01" ``` **Response:** ```json { "data": { "bank": "National Bank of Kazakhstan", "base": "KZT", "date": "01.06.2026", "count": 39, "rates": [ { "code": "AUD", "name": "Australian Dollar", "rate": 347.79, "trend": "flat", "change": 0, "nominal": 1, "name_local": "АВСТРАЛИЙСКИЙ ДОЛЛАР" }, { "code": "AZN", "name": "Azerbaijani Manat", "rate": 286.7, "trend": "flat", "change": 0, "nominal": 1, "name_local": "АЗЕРБАЙДЖАНСКИЙ МАНАТ" }, { "code": "AMD", "name": "Armenian Dram", "rate": 13.24, "trend": "flat", "change": 0, "nominal": 10, "name_local": "АРМЯНСКИЙ ДРАМ" }, { "code": "BYN", "name": "Belarusian Ruble", "rate": 177.65, "trend": "flat", "change": 0, "nominal": 1, "name_local": "БЕЛОРУССКИЙ РУБЛЬ" }, { "code": "BRL", "name": "Brazilian Real", "rate": 96.33, "trend": "flat", …(truncated, see openapi.json for full schema) ``` ### Currency #### `GET /v1/currency` — One currency official rate **Parameters:** - `currency` (query, required, string) — ISO currency code Example: `USD` - `date` (query, optional, string) — Date (default today) Example: `2026-06-01` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/nbkz-api/v1/currency?currency=USD&date=2026-06-01" ``` **Response:** ```json { "data": { "bank": "National Bank of Kazakhstan", "base": "KZT", "code": "USD", "date": "01.06.2026", "name": "US Dollar", "rate": 485.95, "trend": "flat", "change": 0, "source": "NBK", "nominal": 1, "name_local": "ДОЛЛАР США" }, "meta": { "timestamp": "2026-06-11T16:46:54.551Z", "request_id": "b0caa06e-376a-4ab3-b10f-f934840e0101" }, "status": "ok", "message": "Currency retrieved successfully", "success": true } ``` ### Convert #### `GET /v1/convert` — Convert between KZT and a currency **Parameters:** - `from` (query, required, string) — From currency (one side must be KZT) Example: `USD` - `to` (query, required, string) — To currency (one side must be KZT) Example: `KZT` - `amount` (query, required, string) — Amount to convert Example: `100` - `date` (query, optional, string) — Date (default today) Example: `2026-06-01` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/nbkz-api/v1/convert?from=USD&to=KZT&amount=100&date=2026-06-01" ``` **Response:** ```json { "data": { "to": "KZT", "bank": "National Bank of Kazakhstan", "date": "01.06.2026", "from": "USD", "note": "Official NBK rate; one tenge side. rate is units of `to` per 1 unit of `from`.", "rate": 485.95, "amount": 100, "result": 48595, "source": "NBK" }, "meta": { "timestamp": "2026-06-11T16:46:54.656Z", "request_id": "42a803cb-bd5a-4a89-adfe-fd72902c6d2b" }, "status": "ok", "message": "Conversion successful", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/nbkz-api/v1/meta" ``` **Response:** ```json { "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-1 …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/nbkz-api OpenAPI spec: https://www.oanor.com/api/nbkz-api/openapi.json