Skip to content

API reference

Rates

nTZS reference rates, for exchanges and liquidity partners listing or pricing nTZS.

get/api/v1/rates

nTZS 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 fields
    • baseobject

      nTZS is the Tanzanian shilling 1:1; every mid is in nTZS.

    • symbolstring
    • fiatstring
    • pegnumber
    • referenceobject
    • namestring
    • urlstring
    • schedulestring
    • ratesobject[]
    • pairstring
    • chainstring

      basebnb

    • chainIdinteger
    • counterobject
    • symbolstring
    • addressstring
    • decimalsinteger
    • fiatstring
    • midnumber

      nTZS per 1 unit of the counter token.

    • inversenumber

      Counter-token units per 1 nTZS (1 / mid).

    • botobject | null

      BoT's mean and its publication date (dd-MMM-yy) from the last check; null before the first.

    • meannumber
    • publishedstring
    • vsBotPctnumber | null

      mid against BoT's mean, in percent.

    • updatedAtstring (date-time)

      When mid last changed.

    • sourcestring

      bot-feedmanualunset

    • statusstring

      livestale

    • generatedAtstring (date-time)
  • 429Rate limited. Respect Retry-After and back off exponentially.CodeError
  • 503Rates are temporarily unavailable. Retry shortly.CodeError
Request
curl "https://www.ntzs.co.tz/api/v1/rates"
Response · 200
{
  "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"
}
get/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

  • pairstringpathrequired

    ntzs- plus the counter token, lower case: ntzs-usdc, ntzs-usdt, ntzs-tgbp, ntzs-zarp, ntzs-cngn.

  • chainstringquery

Responses

  • 200The pair's current price.Show fields
    • pairstring
    • chainstring

      basebnb

    • chainIdinteger
    • pricenumber

      nTZS per 1 unit of the counter token.

    • inversenumber

      Counter-token units per 1 nTZS.

    • timestampstring (date-time)

      When this price was read.

    • unixinteger

      timestamp as unix seconds.

    • asOfstring | null

      The BoT publication date behind the mid.

    • rateUpdatedAtstring (date-time)

      When the mid last changed.

    • sourcestring

      bot-feedmanualunset

    • statusstring

      livestale

  • 400chain is not base or bnb.CodeError
  • 404No active pair by that name on the chain; the message lists the ones there are.CodeError
  • 429Rate limited. Respect Retry-After and back off exponentially.CodeError
  • 503Rates are temporarily unavailable. Retry shortly.CodeError
Request
curl "https://www.ntzs.co.tz/api/v1/rates/14e17d04-ec7f-4d99-91a3-dfbaca19fba1"
Response · 200
{
  "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"
}