API reference
Rates
nTZS reference rates, for exchanges and liquidity partners listing or pricing nTZS.
/api/v1/ratesnTZS reference rates against every counter token
Public, no API key required. Every pair's mid is the Bank of Tanzania's published mean exchange rate (TZS per unit of the counter token's fiat), synced four times a day; BoT publishes on business days. Each row carries BoT's own figure and publication date (bot) so you can check the source, plus status: a stale pair has missed its refresh window and swaps against it are refused until it is updated. A reference, not an executable price: quote a swap with GET /api/v1/swap/rate. Throttled per source address (60/min by default) and cached for about a minute: poll every minute or slower.
Public, no API key required
Responses
200Reference rates.Show fieldsHide
baseobjectnTZS is the Tanzanian shilling 1:1; every
midis in nTZS.symbolstringfiatstringpegnumberreferenceobjectnamestringurlstringschedulestringratesobject[]pairstringchainstringbasebnbchainIdintegercounterobjectsymbolstringaddressstringdecimalsintegerfiatstringmidnumbernTZS per 1 unit of the counter token.
inversenumberCounter-token units per 1 nTZS (1 / mid).
botobject | nullBoT's mean and its publication date (dd-MMM-yy) from the last check; null before the first.
meannumberpublishedstringvsBotPctnumber | nullmidagainst BoT's mean, in percent.updatedAtstring (date-time)When
midlast changed.sourcestringbot-feedmanualunsetstatusstringlivestalegeneratedAtstring (date-time)
- 429Rate limited. Respect
Retry-Afterand back off exponentially.CodeError - 503Rates are temporarily unavailable. Retry shortly.CodeError
curl "https://www.ntzs.co.tz/api/v1/rates"{
"base": {
"symbol": "nTZS",
"fiat": "TZS",
"peg": 1
},
"reference": {
"name": "…",
"url": "https://yourapp.com/callback",
"schedule": "…"
},
"rates": [
{
"pair": "nTZS/USDC",
"chain": "base",
"chainId": 8453,
"counter": {
"symbol": "…",
"address": "0x531B87EfdEBD19bfd05700DF6218d4786Cf2201C",
"decimals": 1
},
"fiat": "USD",
"mid": 2644.9013,
"inverse": 1,
"bot": {
"mean": 1,
"published": "27-Oct-26"
},
"vsBotPct": 1,
"updatedAt": "2026-10-27T09:00:00Z",
"source": "bot-feed",
"status": "live"
}
],
"generatedAt": "2026-10-27T09:00:00Z"
}/api/v1/rates/{pair}One nTZS pair as a price feed
Public, no API key required. Built for a market maker's bot: price is the mid SimpleFX quotes right now (nTZS per 1 unit of the counter token) and timestamp is when it was read, never more than about 90 seconds old. The mid itself follows the Bank of Tanzania's official mean, a daily fix: asOf is the BoT publication date behind it and rateUpdatedAt when it last changed. Halt on status: "stale", which is exactly when SimpleFX swaps against the pair are refused. Throttled per source address (60/min by default).
Public, no API key required
Parameters
pairstringpathrequiredntzs-plus the counter token, lower case:ntzs-usdc,ntzs-usdt,ntzs-tgbp,ntzs-zarp,ntzs-cngn.chainstringquery
Responses
200The pair's current price.Show fieldsHide
pairstringchainstringbasebnbchainIdintegerpricenumbernTZS per 1 unit of the counter token.
inversenumberCounter-token units per 1 nTZS.
timestampstring (date-time)When this price was read.
unixintegertimestampas unix seconds.asOfstring | nullThe BoT publication date behind the mid.
rateUpdatedAtstring (date-time)When the mid last changed.
sourcestringbot-feedmanualunsetstatusstringlivestale
- 400
chainis notbaseorbnb.CodeError - 404No active pair by that name on the chain; the message lists the ones there are.CodeError
- 429Rate limited. Respect
Retry-Afterand back off exponentially.CodeError - 503Rates are temporarily unavailable. Retry shortly.CodeError
curl "https://www.ntzs.co.tz/api/v1/rates/14e17d04-ec7f-4d99-91a3-dfbaca19fba1"{
"pair": "nTZS/USDT",
"chain": "base",
"chainId": 8453,
"price": 2644.9013,
"inverse": 1,
"timestamp": "2026-10-27T09:00:00Z",
"unix": 1,
"asOf": "…",
"rateUpdatedAt": "2026-10-27T09:00:00Z",
"source": "bot-feed",
"status": "live"
}