{"openapi":"3.1.0","info":{"title":"National Bank of Kazakhstan API","version":"1.0.0","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) — each rate with its direction (rose or fell) and the day's change: the NBK official rate for every published currency (normalised to one unit) with the day's change and direction, a single currency's tenge-per-unit rate and inverse plus change, a currency's official rate on a specific past date, and currency conversion between any two published currencies (including KZT) cross-computed through the tenge.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbk-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"History"},{"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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rates"],"summary":"One currency tenge-per-unit rate, inverse, change and direction","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"KZT","date":"2026-06-10","name":"ДОЛЛАР США","change":5.43,"source":"National Bank of Kazakhstan","nominal":1,"currency":"USD","direction":"up","kzt_per_unit":490.21,"unit_per_kzt":0.00203994},"meta":{"timestamp":"2026-06-10T14:00:05.229Z","request_id":"1cf420fe-afba-4b93-afe4-886afc7ef10a"},"status":"ok","message":"Rate 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/rates":{"get":{"operationId":"get_v1_rates","tags":["Rates"],"summary":"NBK official rate for every currency vs the tenge","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"KZT","date":"2026-06-10","count":39,"rates":[{"name":"ДИРХАМ ОАЭ","rate":133.47,"change":1.47,"nominal":1,"currency":"AED","direction":"up","kzt_per_unit":133.47},{"name":"АРМЯНСКИЙ ДРАМ","rate":13.39,"change":0.14,"nominal":10,"currency":"AMD","direction":"up","kzt_per_unit":1.339},{"name":"АВСТРАЛИЙСКИЙ ДОЛЛАР","rate":345.89,"change":3.73,"nominal":1,"currency":"AUD","direction":"up","kzt_per_unit":345.89},{"name":"АЗЕРБАЙДЖАНСКИЙ МАНАТ","rate":289.21,"change":3.2,"nominal":1,"currency":"AZN","direction":"up","kzt_per_unit":289.21},{"name":"БРАЗИЛЬСКИЙ РЕАЛ","rate":94.41,"change":0.67,"nominal":1,"currency":"BRL","direction":"up","kzt_per_unit":94.41},{"name":"БЕЛОРУССКИЙ РУБЛЬ","rate":177.93,"change":4.82,"nominal":1,"currency":"BYN","direction":"up","kzt_per_unit":177.93},{"name":"КАНАДСКИЙ ДОЛЛАР","rate":351.86,"change":4.15,"nominal":1,"currency":"CAD","direction":"up","kzt_per_unit":351.86},{"name":"ШВЕЙЦАРСКИЙ ФРАНК","rate":615.76,"change":7.66,"nominal":1,"currency":"CHF","direction":"up","kzt_per_unit":615.76},{"name":"КИТАЙСКИЙ ЮАНЬ","rate":72.39,"change":0.93,"nominal":1,"currency":"CNY","direction":"up","kzt_per_unit":72.39},{"name":"ЧЕШСКАЯ КРОНА","rate":23.46,"change":0.4,"nominal":1,"currency":"CZK","direction":"up","kzt_per_unit":23.46},{"name":"ДАТСКАЯ КРОНА","rate":75.86,"change":1.1,"nominal":1,"currency":"DKK","direction":"up","kzt_per_unit":75.86},{"name":"ЕВРО","rate":566.93,"change":8.27,"nominal":1,"currency":"EUR","direction":"up","kzt_per_unit":566.93},{"name":"ФУНТ СТЕРЛИНГОВ СОЕДИНЕННОГО КОРОЛЕВСТВА","rate":656.59,"change":9.89,"nominal":1,"currency":"GBP","direction":"up","kzt_per_unit":656.59},{"name":"ГРУЗИНСКИЙ ЛАРИ","rate":186.89,"change":2.21,"nominal":1,"currency":"GEL","direction":"up","kzt_per_unit":186.89},{"name":"ГОНКОНГСКИЙ ДОЛЛАР","rate":62.55,"change":0.68,"nominal":1,"currency":"HKD","direction":"up","kzt_per_unit":62.55},{"name":"ВЕНГЕРСКИХ ФОРИНТОВ","rate":15.97,"change":0.3,"nominal":10,"currency":"HUF","direction":"up","kzt_per_unit":1.597},{"name":"ИНДИЙСКАЯ РУПИЯ","rate":5.14,"change":0.07,"nominal":1,"currency":"INR","direction":"up","kzt_per_unit":5.14},{"name":"ИРАНСКИЙ РИАЛ","rate":0.36,"change":0.01,"nominal":1000,"currency":"IRR","direction":"up","kzt_per_unit":0.00036},{"name":"ЯПОНСКАЯ ЙЕНА","rate":3.06,"change":0.03,"nominal":1,"currency":"JPY","direction":"up","kzt_per_unit":3.06},{"name":"КЫРГЫЗСКИЙ СОМ","rate":5.61,"change":0.07,"nominal":1,"currency":"KGS","direction":"up","kzt_per_unit":5.61},{"name":"ЮЖНО-КОРЕЙСКИХ ВОН","rate":32.17,"change":0.57,"nominal":100,"currency":"KRW","direction":"up","kzt_per_unit":0.3217},{"name":"КУВЕЙТСКИЙ ДИНАР","rate":1595.74,"change":17.68,"nominal":1,"currency":"KWD","direction":"up","kzt_per_unit":1595.74},{"name":"МОЛДАВСКИЙ ЛЕЙ","rate":28.48,"change":0.41,"nominal":1,"currency":"MDL","direction":"up","kzt_per_unit":28.48},{"name":"МЕКСИКАНСКИЙ ПЕСО","rate":28.18,"change":0.37,"nominal":1,"currency":"MXN","direction":"up","kzt_per_unit":28.18},{"name":"МАЛАЗИЙСКИЙ РИНГГИТ","rate":120.8,"change":1.69,"nominal":1,"currency":"MYR","direction":"up","kzt_per_unit":120.8},{"name":"НОРВЕЖСКАЯ КРОНА","rate":51.89,"change":0.68,"nominal":1,"currency":"NOK","direction":"up","kzt_per_unit":51.89},{"name":"ПОЛЬСКИЙ ЗЛОТЫЙ","rate":133.82,"change":2.19,"nominal":1,"currency":"PLN","direction":"up","kzt_per_unit":133.82},{"name":"РОССИЙСКИЙ РУБЛЬ","rate":6.81,"change":0.21,"nominal":1,"currency":"RUB","direction":"up","kzt_per_unit":6.81},{"name":"РИЯЛ САУДОВСКОЙ АРАВИИ","rate":130.59,"change":1.5,"nominal":1,"currency":"SAR","direction":"up","kzt_per_unit":130.59},{"name":"ШВЕДСКАЯ КРОНА","rate":52.07,"change":0.76,"nominal":1,"currency":"SEK","direction":"up","kzt_per_unit":52.07},{"name":"СИНГАПУРСКИЙ ДОЛЛАР","rate":381.4,"change":5.13,"nominal":1,"currency":"SGD","direction":"up","kzt_per_unit":381.4},{"name":"ТАЙСКИЙ БАТ","rate":14.93,"change":0.16,"nominal":1,"currency":"THB","direction":"up","kzt_per_unit":14.93},{"name":"ТАДЖИКСКИЙ СОМОНИ","rate":52.82,"change":0.86,"nominal":1,"currency":"TJS","direction":"up","kzt_per_unit":52.82},{"name":"ТУРЕЦКАЯ ЛИРА","rate":10.63,"change":0.1,"nominal":1,"currency":"TRY","direction":"up","kzt_per_unit":10.63},{"name":"УКРАИНСКАЯ ГРИВНА","rate":10.92,"change":0.06,"nominal":1,"currency":"UAH","direction":"up","kzt_per_unit":10.92},{"name":"ДОЛЛАР США","rate":490.21,"change":5.43,"nominal":1,"currency":"USD","direction":"up","kzt_per_unit":490.21},{"name":"УЗБЕКСКИХ СУМОВ","rate":4.08,"change":0.03,"nominal":100,"currency":"UZS","direction":"up","kzt_per_unit":0.0408},{"name":"СДР","rate":668.08,"change":4.54,"nominal":1,"currency":"XDR","direction":"up","kzt_per_unit":668.08},{"name":"ЮЖНО-АФРИКАНСКИЙ РАНД","rate":29.81,"change":0.46,"nominal":1,"currency":"ZAR","direction":"up","kzt_per_unit":29.81}],"source":"National Bank of Kazakhstan"},"meta":{"timestamp":"2026-06-10T14:00:05.533Z","request_id":"8b5ce3da-aed6-412b-bfc7-23834573b920"},"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/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"A currency official rate on a specific past date","description":"","parameters":[{"name":"currency","in":"query","required":true,"description":"3-letter ISO currency code","schema":{"type":"string"},"example":"USD"},{"name":"date","in":"query","required":true,"description":"Date YYYY-MM-DD","schema":{"type":"string"},"example":"2026-05-15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"KZT","date":"2026-05-15","name":"ДОЛЛАР США","change":6.41,"source":"National Bank of Kazakhstan","nominal":1,"currency":"USD","direction":"up","kzt_per_unit":474.04,"unit_per_kzt":0.00210953},"meta":{"timestamp":"2026-06-10T14:00:05.835Z","request_id":"c7ba09b8-4557-430c-8a7d-96a63c53fd22"},"status":"ok","message":"History 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 an amount between two currencies at NBK rates","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source currency","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target currency","schema":{"type":"string"},"example":"EUR"},{"name":"amount","in":"query","required":false,"description":"Amount to convert","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":"EUR","date":"2026-06-10","from":"USD","rate":0.86467465,"amount":100,"result":86.467465,"source":"National Bank of Kazakhstan","kzt_per_to":566.93,"kzt_per_from":490.21},"meta":{"timestamp":"2026-06-10T14:00:06.152Z","request_id":"ad8b0806-1608-4e44-99b9-5e9145246ad6"},"status":"ok","message":"Conversion completed 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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":12000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":167000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2000,"monthly_call_quota":1040000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4600,"monthly_call_quota":5500000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbk-api"}