{"openapi":"3.1.0","info":{"title":"NBKR Kyrgyzstan FX API","version":"1.0.0","description":"Live official foreign-exchange reference rates from the National Bank of the Kyrgyz Republic (NBKR), read straight from the bank's published fixing — no key on the data, nothing cached, nothing stored. Get every currency the NBKR fixes against the Kyrgyzstani som (KGS) for the day, each normalized to a clean per-unit rate; look one currency up on its own; pull the separate weekly accounting rates (valid for seven days); or convert any amount between two listed currencies by crossing through the som. The som is the base and rates carry the NBKR fixing date. This is the Kyrgyzstan national-central-bank feed specifically — a distinct official source, separate from the other FX, central-bank and market APIs in the catalogue, so treasury, invoicing, payroll and accounting workflows that need the legally-referenced KGS rate can read it directly.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbkr-api","description":"oanor gateway"}],"tags":[{"name":"Rates"},{"name":"Rate"},{"name":"Weekly"},{"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":"All daily KGS reference rates","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"KGS","date":"11.06.2026","count":5,"rates":[{"code":"CNY","value":12.9016,"nominal":1,"per_unit":12.9016},{"code":"EUR","value":101.0387,"nominal":1,"per_unit":101.0387},{"code":"KZT","value":0.1789,"nominal":1,"per_unit":0.1789},{"code":"RUB","value":1.218,"nominal":1,"per_unit":1.218},{"code":"USD","value":87.4491,"nominal":1,"per_unit":87.4491}],"source":"NBKR"},"meta":{"timestamp":"2026-06-11T07:48:52.566Z","request_id":"8c76544e-6b06-4d95-bcfe-f2538b5422dd"},"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/rate":{"get":{"operationId":"get_v1_rate","tags":["Rate"],"summary":"One currency's daily rate","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"ISO 4217 currency code","schema":{"type":"string"},"example":"USD"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"KGS","code":"USD","date":"11.06.2026","value":87.4491,"source":"NBKR","nominal":1,"per_unit":87.4491},"meta":{"timestamp":"2026-06-11T07:48:52.730Z","request_id":"57663bb3-3d06-462e-bcf3-9b567284fb43"},"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/weekly":{"get":{"operationId":"get_v1_weekly","tags":["Weekly"],"summary":"Weekly accounting rates (valid seven days)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"KGS","count":40,"rates":[{"code":"AED","value":23.8108,"nominal":1,"per_unit":23.8108,"valid_for_days":7},{"code":"AFN","value":1.3709,"nominal":1,"per_unit":1.3709,"valid_for_days":7},{"code":"AMD","value":2.3726,"nominal":10,"per_unit":0.23726,"valid_for_days":7},{"code":"AUD","value":62.3562,"nominal":1,"per_unit":62.3562,"valid_for_days":7},{"code":"AZN","value":51.4412,"nominal":1,"per_unit":51.4412,"valid_for_days":7},{"code":"BRL","value":17.2673,"nominal":1,"per_unit":17.2673,"valid_for_days":7},{"code":"BYN","value":30.9295,"nominal":1,"per_unit":30.9295,"valid_for_days":7},{"code":"BYR","value":0.3402,"nominal":100,"per_unit":0.003402,"valid_for_days":7},{"code":"CAD","value":62.9612,"nominal":1,"per_unit":62.9612,"valid_for_days":7},{"code":"CHF","value":110.9349,"nominal":1,"per_unit":110.9349,"valid_for_days":7},{"code":"CZK","value":4.2086,"nominal":1,"per_unit":4.2086,"valid_for_days":7},{"code":"DKK","value":13.6143,"nominal":1,"per_unit":13.6143,"valid_for_days":7},{"code":"GBP","value":117.6596,"nominal":1,"per_unit":117.6596,"valid_for_days":7},{"code":"GEL","value":32.818,"nominal":1,"per_unit":32.818,"valid_for_days":7},{"code":"HKD","value":11.1632,"nominal":1,"per_unit":11.1632,"valid_for_days":7},{"code":"HUF","value":2.8731,"nominal":10,"per_unit":0.28731,"valid_for_days":7},{"code":"IDR","value":0.0485,"nominal":10,"per_unit":0.00485,"valid_for_days":7},{"code":"INR","value":0.9202,"nominal":1,"per_unit":0.9202,"valid_for_days":7},{"code":"IRR","value":0.0006,"nominal":10,"per_unit":6.0e-5,"valid_for_days":7},{"code":"JPY","value":5.4675,"nominal":10,"per_unit":0.54675,"valid_for_days":7},{"code":"KRW","value":0.0568,"nominal":1,"per_unit":0.0568,"valid_for_days":7},{"code":"KWD","value":284.8998,"nominal":1,"per_unit":284.8998,"valid_for_days":7},{"code":"MDL","value":5.058,"nominal":1,"per_unit":5.058,"valid_for_days":7},{"code":"MNT","value":0.0244,"nominal":1,"per_unit":0.0244,"valid_for_days":7},{"code":"MYR","value":21.7078,"nominal":1,"per_unit":21.7078,"valid_for_days":7},{"code":"NOK","value":9.3806,"nominal":1,"per_unit":9.3806,"valid_for_days":7},{"code":"NZD","value":51.3419,"nominal":1,"per_unit":51.3419,"valid_for_days":7},{"code":"OMR","value":227.1311,"nominal":1,"per_unit":227.1311,"valid_for_days":7},{"code":"PKR","value":0.3142,"nominal":1,"per_unit":0.3142,"valid_for_days":7},{"code":"PLN","value":24.0244,"nominal":1,"per_unit":24.0244,"valid_for_days":7},{"code":"SAR","value":23.2905,"nominal":1,"per_unit":23.2905,"valid_for_days":7},{"code":"SEK","value":9.3517,"nominal":1,"per_unit":9.3517,"valid_for_days":7},{"code":"SGD","value":68.1075,"nominal":1,"per_unit":68.1075,"valid_for_days":7},{"code":"TJS","value":9.4234,"nominal":1,"per_unit":9.4234,"valid_for_days":7},{"code":"TMT","value":24.9857,"nominal":1,"per_unit":24.9857,"valid_for_days":7},{"code":"TRY","value":1.8976,"nominal":1,"per_unit":1.8976,"valid_for_days":7},{"code":"TWD","value":2.7765,"nominal":1,"per_unit":2.7765,"valid_for_days":7},{"code":"UAH","value":1.9705,"nominal":1,"per_unit":1.9705,"valid_for_days":7},{"code":"UZS","value":0.0073,"nominal":1,"per_unit":0.0073,"valid_for_days":7},{"code":"XDR","value":119.6323,"nominal":1,"per_unit":119.6323,"valid_for_days":7}],"fixing":"weekly","source":"NBKR","effective_date":"06.06.2026"},"meta":{"timestamp":"2026-06-11T07:48:52.876Z","request_id":"ba3e3a86-523c-4a02-ae29-6e367e160ea4"},"status":"ok","message":"Weekly 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/convert":{"get":{"operationId":"get_v1_convert","tags":["Convert"],"summary":"Convert an amount between two currencies via the som","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Source ISO 4217 code","schema":{"type":"string"},"example":"USD"},{"name":"to","in":"query","required":true,"description":"Target ISO 4217 code","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","base":"KGS","date":"11.06.2026","from":"USD","rate":0.86550104,"amount":100,"result":86.550104,"source":"NBKR","amount_in_kgs":8744.91},"meta":{"timestamp":"2026-06-11T07:48:53.043Z","request_id":"ebf718e4-03a7-4c45-b475-369e0405c401"},"status":"ok","message":"Conversion computed 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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Base currency is the Kyrgyzstani som (KGS). per_unit is the value in KGS of one unit of the foreign currency (value divided by the NBKR Nominal). Dates are the NBKR fixing date (DD.MM.YYYY).","source":"NBKR published XML (nbkr.kg/XML, live)","service":"nbkr-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's daily rate (code=USD).","GET /v1/rates":"All daily KGS reference rates with per-unit values (no params).","GET /v1/weekly":"Weekly accounting rates, valid seven days (no params).","GET /v1/convert":"Convert an amount between two currencies via the som (from=USD&to=EUR&amount=100)."},"description":"Live official foreign-exchange reference rates from the National Bank of the Kyrgyz Republic (NBKR). The rates endpoint returns every currency the NBKR fixes against the Kyrgyzstani som (KGS) for the day, normalized to a per-unit rate; the rate endpoint returns one currency; the weekly endpoint returns the NBKR's weekly accounting rates (valid seven days); the convert endpoint converts an amount between any two listed currencies by crossing through the som. Live, no key, nothing stored. A distinct national central-bank feed, separate from the other FX and central-bank APIs.","latest_date":"11.06.2026","currency_count":5,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T07:48:53.226Z","request_id":"9236eec2-b8d3-48bb-bf80-572587e04c20"},"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":25000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":645,"monthly_call_quota":320000,"rps_limit":10,"hard_limit":true},{"slug":"growth","name":"Growth","price_cents_month":1855,"monthly_call_quota":1350000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4380,"monthly_call_quota":4900000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbkr-api"}