{"openapi":"3.1.0","info":{"title":"National Bank of Kazakhstan (NBK) FX API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbkz-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Currency"},{"name":"Convert"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"Full official KZT board for a date","description":"","parameters":[{"name":"date","in":"query","required":false,"description":"Date DD.MM.YYYY or YYYY-MM-DD (default today)","schema":{"type":"string"},"example":"2026-06-01"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","change":0,"nominal":1,"name_local":"БРАЗИЛЬСКИЙ РЕАЛ"},{"code":"HUF","rate":15.98,"trend":"flat","change":0,"nominal":10,"name_local":"ВЕНГЕРСКИХ ФОРИНТОВ"},{"code":"HKD","name":"Hong Kong Dollar","rate":62.03,"trend":"flat","change":0,"nominal":1,"name_local":"ГОНКОНГСКИЙ ДОЛЛАР"},{"code":"GEL","name":"Georgian Lari","rate":184.63,"trend":"flat","change":0,"nominal":1,"name_local":"ГРУЗИНСКИЙ ЛАРИ"},{"code":"DKK","name":"Danish Krone","rate":75.71,"trend":"flat","change":0,"nominal":1,"name_local":"ДАТСКАЯ КРОНА"},{"code":"AED","name":"UAE Dirham","rate":132.32,"trend":"flat","change":0,"nominal":1,"name_local":"ДИРХАМ ОАЭ"},{"code":"USD","name":"US Dollar","rate":485.95,"trend":"flat","change":0,"nominal":1,"name_local":"ДОЛЛАР США"},{"code":"EUR","name":"Euro","rate":565.74,"trend":"flat","change":0,"nominal":1,"name_local":"ЕВРО"},{"code":"INR","name":"Indian Rupee","rate":5.12,"trend":"flat","change":0,"nominal":1,"name_local":"ИНДИЙСКАЯ РУПИЯ"},{"code":"IRR","name":"Iranian Rial","rate":0.36,"trend":"flat","change":0,"nominal":1000,"name_local":"ИРАНСКИЙ РИАЛ"},{"code":"CAD","name":"Canadian Dollar","rate":351.91,"trend":"flat","change":0,"nominal":1,"name_local":"КАНАДСКИЙ ДОЛЛАР"},{"code":"CNY","name":"Chinese Yuan","rate":71.81,"trend":"flat","change":0,"nominal":1,"name_local":"КИТАЙСКИЙ ЮАНЬ"},{"code":"KWD","name":"Kuwaiti Dinar","rate":1584.71,"trend":"flat","change":0,"nominal":1,"name_local":"КУВЕЙТСКИЙ ДИНАР"},{"code":"KGS","name":"Kyrgyzstani Som","rate":5.56,"trend":"down","change":0,"nominal":1,"name_local":"КЫРГЫЗСКИЙ СОМ"},{"code":"MYR","name":"Malaysian Ringgit","rate":122.62,"trend":"flat","change":0,"nominal":1,"name_local":"МАЛАЗИЙСКИЙ РИНГГИТ"},{"code":"MXN","rate":28.03,"trend":"flat","change":0,"nominal":1,"name_local":"МЕКСИКАНСКИЙ ПЕСО"},{"code":"MDL","name":"Moldovan Leu","rate":28.3,"trend":"flat","change":0,"nominal":1,"name_local":"МОЛДАВСКИЙ ЛЕЙ"},{"code":"NOK","name":"Norwegian Krone","rate":52.54,"trend":"flat","change":0,"nominal":1,"name_local":"НОРВЕЖСКАЯ КРОНА"},{"code":"PLN","name":"Polish Zloty","rate":133.81,"trend":"flat","change":0,"nominal":1,"name_local":"ПОЛЬСКИЙ ЗЛОТЫЙ"},{"code":"SAR","name":"Saudi Riyal","rate":129.5,"trend":"flat","change":0,"nominal":1,"name_local":"РИЯЛ САУДОВСКОЙ АРАВИИ"},{"code":"RUB","name":"Russian Ruble","rate":6.83,"trend":"flat","change":0,"nominal":1,"name_local":"РОССИЙСКИЙ РУБЛЬ"},{"code":"XDR","name":"Special Drawing Rights","rate":664.14,"trend":"flat","change":0,"nominal":1,"name_local":"СДР"},{"code":"SGD","name":"Singapore Dollar","rate":380.39,"trend":"flat","change":0,"nominal":1,"name_local":"СИНГАПУРСКИЙ ДОЛЛАР"},{"code":"TJS","name":"Tajikistani Somoni","rate":52.94,"trend":"flat","change":0,"nominal":1,"name_local":"ТАДЖИКСКИЙ СОМОНИ"},{"code":"THB","name":"Thai Baht","rate":14.93,"trend":"flat","change":0,"nominal":1,"name_local":"ТАЙСКИЙ БАТ"},{"code":"TRY","name":"Turkish Lira","rate":10.59,"trend":"flat","change":0,"nominal":1,"name_local":"ТУРЕЦКАЯ ЛИРА"},{"code":"UZS","name":"Uzbekistani Som","rate":4.06,"trend":"flat","change":0,"nominal":100,"name_local":"УЗБЕКСКИХ СУМОВ"},{"code":"UAH","name":"Ukrainian Hryvnia","rate":10.97,"trend":"flat","change":0,"nominal":1,"name_local":"УКРАИНСКАЯ ГРИВНА"},{"code":"GBP","name":"Pound Sterling","rate":652.05,"trend":"flat","change":0,"nominal":1,"name_local":"ФУНТ СТЕРЛИНГОВ СОЕДИНЕННОГО КОРОЛЕВСТВА"},{"code":"CZK","name":"Czech Koruna","rate":23.31,"trend":"flat","change":0,"nominal":1,"name_local":"ЧЕШСКАЯ КРОНА"},{"code":"SEK","name":"Swedish Krona","rate":52.52,"trend":"flat","change":0,"nominal":1,"name_local":"ШВЕДСКАЯ КРОНА"},{"code":"CHF","name":"Swiss Franc","rate":620.94,"trend":"flat","change":0,"nominal":1,"name_local":"ШВЕЙЦАРСКИЙ ФРАНК"},{"code":"ZAR","name":"South African Rand","rate":29.95,"trend":"flat","change":0,"nominal":1,"name_local":"ЮЖНО-АФРИКАНСКИЙ РАНД"},{"code":"KRW","name":"South Korean Won","rate":32.23,"trend":"flat","change":0,"nominal":100,"name_local":"ЮЖНО-КОРЕЙСКИХ ВОН"},{"code":"JPY","name":"Japanese Yen","rate":3.05,"trend":"flat","change":0,"nominal":1,"name_local":"ЯПОНСКАЯ ЙЕНА"}],"source":"NBK"},"meta":{"timestamp":"2026-06-11T16:46:54.447Z","request_id":"3b90c26d-9de7-4c18-9818-81ac56a818cb"},"status":"ok","message":"Rates retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/currency":{"get":{"operationId":"get_v1_currency","tags":["Currency"],"summary":"One currency official rate","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"ISO currency code","schema":{"type":"string"},"example":"USD"},{"name":"date","in":"query","required":false,"description":"Date (default today)","schema":{"type":"string"},"example":"2026-06-01"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert between KZT and a currency","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"From currency (one side must be KZT)","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"To currency (one side must be KZT)","schema":{"type":"string"},"example":"KZT"},{"name":"amount","in":"query","required":true,"description":"Amount to convert","schema":{"type":"string"},"example":"100"},{"name":"date","in":"query","required":false,"description":"Date (default today)","schema":{"type":"string"},"example":"2026-06-01"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":22000,"rps_limit":3,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":665,"monthly_call_quota":260000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1985,"monthly_call_quota":1050000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4730,"monthly_call_quota":3600000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbkz-api"}