{"openapi":"3.1.0","info":{"title":"National Bank of Tajikistan API","version":"1.0.0","description":"Live official exchange-rate data from the National Bank of Tajikistan (NBT), the central bank of the Republic of Tajikistan, for the somoni (TJS): the NBT official rate for every published currency (normalised to one unit), a single currency's somoni-per-unit rate and inverse, a currency's official rate on a specific past date, and currency conversion between any two published currencies (including TJS) cross-computed through the somoni.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nbt-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 somoni-per-unit rate and inverse","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":"TJS","date":"2026-06-10","name":"US Dollar","source":"National Bank of Tajikistan","nominal":1,"currency":"USD","tjs_per_unit":9.3537,"unit_per_tjs":0.10690957},"meta":{"timestamp":"2026-06-10T13:59:53.854Z","request_id":"a04e5eb1-1165-42ab-857a-a193fbe71127"},"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":"NBT official rate for every currency vs the somoni","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"TJS","date":"2026-06-10","count":36,"rates":[{"name":"UAE Dirham","value":2.5464,"nominal":1,"currency":"AED","tjs_per_unit":2.5464},{"name":"Afghanian Afghani","value":1.454,"nominal":10,"currency":"AFN","tjs_per_unit":0.1454},{"name":"Armenian Dram","value":2.5381,"nominal":100,"currency":"AMD","tjs_per_unit":0.025381},{"name":"Australian Dollar","value":6.6037,"nominal":1,"currency":"AUD","tjs_per_unit":6.6037},{"name":"Azeri Manat","value":5.5022,"nominal":1,"currency":"AZN","tjs_per_unit":5.5022},{"name":"New Belarusian Ruble","value":3.4047,"nominal":1,"currency":"BYN","tjs_per_unit":3.4047},{"name":"Canadian Dollar","value":6.7143,"nominal":1,"currency":"CAD","tjs_per_unit":6.7143},{"name":"Swiss Frank","value":11.7524,"nominal":1,"currency":"CHF","tjs_per_unit":11.7524},{"name":"Chinese Yuan","value":1.3814,"nominal":1,"currency":"CNY","tjs_per_unit":1.3814},{"name":"Danish Krone","value":1.4479,"nominal":1,"currency":"DKK","tjs_per_unit":1.4479},{"name":"EURO","value":10.8232,"nominal":1,"currency":"EUR","tjs_per_unit":10.8232},{"name":"British Pound Sterling","value":12.5349,"nominal":1,"currency":"GBP","tjs_per_unit":12.5349},{"name":"Georgian Lari","value":3.5131,"nominal":1,"currency":"GEL","tjs_per_unit":3.5131},{"name":"Indian Rupee","value":0.9809,"nominal":10,"currency":"INR","tjs_per_unit":0.09809},{"name":"Iranian Rial","value":0.0068,"nominal":1000,"currency":"IRR","tjs_per_unit":7.0e-6},{"name":"Iceland Krona","value":0.7529,"nominal":10,"currency":"ISK","tjs_per_unit":0.07529},{"name":"Japanese Yen","value":0.5839,"nominal":10,"currency":"JPY","tjs_per_unit":0.05839},{"name":"Kyrgyzstan Som","value":1.0696,"nominal":10,"currency":"KGS","tjs_per_unit":0.10696},{"name":"South Korean won","value":0.6136,"nominal":100,"currency":"KRW","tjs_per_unit":0.006136},{"name":"Kuwaiti Dinar","value":30.4383,"nominal":1,"currency":"KWD","tjs_per_unit":30.4383},{"name":"Kazakhstan Tenge","value":0.1908,"nominal":10,"currency":"KZT","tjs_per_unit":0.01908},{"name":"Moldovan Leu","value":0.5359,"nominal":1,"currency":"MDL","tjs_per_unit":0.5359},{"name":"Malaysian Ringgit","value":2.3016,"nominal":1,"currency":"MYR","tjs_per_unit":2.3016},{"name":"Norwegian Krone","value":0.9896,"nominal":1,"currency":"NOK","tjs_per_unit":0.9896},{"name":"Pakistan Rupee","value":0.336,"nominal":10,"currency":"PKR","tjs_per_unit":0.0336},{"name":"Poland Zloty","value":2.5535,"nominal":1,"currency":"PLN","tjs_per_unit":2.5535},{"name":"Russian Ruble","value":0.1301,"nominal":1,"currency":"RUB","tjs_per_unit":0.1301},{"name":"Saudi Arabian Riyal","value":2.4911,"nominal":1,"currency":"SAR","tjs_per_unit":2.4911},{"name":"Swedish Krona","value":0.9944,"nominal":1,"currency":"SEK","tjs_per_unit":0.9944},{"name":"Singapore Dollar","value":7.2757,"nominal":1,"currency":"SGD","tjs_per_unit":7.2757},{"name":"Thai Baht","value":0.2848,"nominal":1,"currency":"THB","tjs_per_unit":0.2848},{"name":"New Turkmenistan Manat","value":2.6725,"nominal":1,"currency":"TMT","tjs_per_unit":2.6725},{"name":"Turkish Lira","value":0.2028,"nominal":1,"currency":"TRY","tjs_per_unit":0.2028},{"name":"Ukrainian Grivna","value":0.2083,"nominal":1,"currency":"UAH","tjs_per_unit":0.2083},{"name":"US Dollar","value":9.3537,"nominal":1,"currency":"USD","tjs_per_unit":9.3537},{"name":"Uzbekistan Sum","value":0.0777,"nominal":100,"currency":"UZS","tjs_per_unit":0.000777}],"source":"National Bank of Tajikistan"},"meta":{"timestamp":"2026-06-10T13:59:54.174Z","request_id":"f1e153ee-095e-462a-ba51-21f5ea472eeb"},"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":"TJS","date":"2026-05-15","name":"US Dollar","source":"National Bank of Tajikistan","nominal":1,"currency":"USD","tjs_per_unit":9.352,"unit_per_tjs":0.106929},"meta":{"timestamp":"2026-06-10T13:59:54.915Z","request_id":"1b6910df-f8fe-4895-92ac-635455f03132"},"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 NBT 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.86422685,"amount":100,"result":86.422685,"source":"National Bank of Tajikistan","tjs_per_to":10.8232,"tjs_per_from":9.3537},"meta":{"timestamp":"2026-06-10T13:59:55.226Z","request_id":"b4128f05-5d49-4cd8-96cf-a4a09386778c"},"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 Tajikistan daily rate file (nbt.tj, live)","service":"nbt-api","usd_tjs":9.3537,"endpoints":{"GET /v1/meta":"This document.","GET /v1/rate":"One currency's official rate, somoni-per-unit and inverse (currency=USD).","GET /v1/rates":"The NBT official rate for every currency vs the somoni.","GET /v1/convert":"Convert an amount between two currencies at NBT 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 Tajikistan (NBT), the central bank of the Republic of Tajikistan, for the somoni (TJS), via its public daily rate file. The rates endpoint returns the NBT's official rate for every published currency against the somoni, normalised to one unit; the rate endpoint returns a single currency's official rate (somoni-per-unit and the inverse); 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 TJS) at the NBT's official rates, cross-computed through the somoni. Live, no key, nothing stored. Distinct from the ECB, SNB, NBU, HNB, NBG, NBRB, CBU, CBAR, BOI, NBK, BNM and other central-bank feeds and from market mid-rates — this is the National Bank of Tajikistan's own official somoni exchange rate.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T13:59:55.573Z","request_id":"43be3d4e-4569-4675-979f-1700efcd50bc"},"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":11000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":700,"monthly_call_quota":162000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":1010000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5000,"monthly_call_quota":5300000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nbt-api"}