bot.go.tz APIbot.go.tz ↗
Access Bank of Tanzania government bond auction results via API. Retrieve ISIN, bid-to-cover ratios, yields, and amounts issued in reverse chronological order.
curl -X GET 'https://api.parse.bot/scraper/1ace4810-0870-4cd0-8059-ac583c0c68f0/scrape_bonds' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve bond auction results from the Bank of Tanzania (bot.go.tz). Returns detailed data for each auction including dates, bond types, amounts issued, bid-to-cover ratios, and interest rates. Results are returned in reverse chronological order (most recent first).
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of auction details to fetch. Each auction requires a separate request so higher values increase response time. |
{
"type": "object",
"fields": {
"count": "integer, number of auctions returned",
"auctions": "array of auction result objects with bond_title, isin, auction_date, amount_offered_tzs_m, total_tendered_tzs_m, amount_issued_tzs_m, bid_to_cover_ratio, weighted_average_yield, weighted_average_coupon_yield, redemption_date, and raw_summary"
},
"sample": {
"data": {
"count": 3,
"auctions": [
{
"isin": "TZ1996105965",
"bond_title": "10.25% 5-YEAR TREASURY BOND NUMBER 700 ISSUE 93",
"raw_summary": {
"REDEMPTION DATE": "30/04/2031",
"NUMBER OF BIDS RECEIVED": "83",
"NUMBER OF SUCCESSFUL BIDS": "45",
"AMOUNT OFFERED TZS(000,000)": "157,000.00",
"TOTAL TENDERED TZS(000,000)": "257,560.90",
"SUCCESSFUL BIDS TZS(000,000)": "166,000.00"
},
"auction_date": "April 29, 2026",
"auction_number": "700",
"redemption_date": "30/04/2031",
"bid_to_cover_ratio": 1.6405,
"amount_issued_tzs_m": "166000.00",
"amount_offered_tzs_m": "157000.00",
"total_tendered_tzs_m": "257560.90",
"weighted_average_yield": "9.5385",
"weighted_average_coupon_yield": "9.9755"
}
]
},
"status": "success"
}
}About the bot.go.tz API
The bot.go.tz API exposes government bond auction results from the Bank of Tanzania through a single scrape_bonds endpoint that returns up to the requested number of auction records, each containing 7 structured fields including ISIN codes, auction dates, amounts offered and issued in Tanzanian shillings, total bids tendered, and bond titles. It covers Treasury bond issuances tracked by Tanzania's central bank.
What the API Returns
The scrape_bonds endpoint returns an array of auction result objects from the Bank of Tanzania's bond auction registry. Each object in the auctions array includes bond_title, isin, auction_date, amount_offered_tzs_m, total_tendered_tzs_m, and amount_issued_tzs. The top-level count field confirms how many auctions were returned in the response. Results are ordered most-recent-first, so index 0 is always the latest completed auction.
Filtering and Pagination
The single supported input parameter is limit (integer, optional), which caps the number of auction records returned. Because each auction record requires a separate lookup, higher limit values result in proportionally longer response times. If you only need the most recent auction, pass limit=1 to minimize latency. There is no offset or cursor parameter currently; to page through historical data you must request a larger limit in one call.
Data Coverage
All monetary fields — amount_offered_tzs_m, total_tendered_tzs_m, and amount_issued_tzs — are denominated in Tanzanian shillings. The isin field provides the internationally recognized security identifier for each bond, making it straightforward to cross-reference with other fixed-income data sources. The auction_date field enables time-series analysis of issuance trends and bid demand over time.
- Track bid-to-cover ratios over time by comparing
total_tendered_tzs_mtoamount_offered_tzs_macross auctions - Monitor the volume of government debt issued in Tanzania by aggregating
amount_issued_tzsvalues - Build a fixed-income dashboard for East African markets using ISIN codes and auction dates
- Alert on new Treasury bond auctions by polling
scrape_bondswithlimit=1and comparing the latestauction_date - Analyze auction demand trends by charting total tendered amounts against offered amounts across bond titles
- Cross-reference Tanzania government bond ISINs with international fixed-income databases for yield curve analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does the Bank of Tanzania provide an official developer API for bond auction data?+
What exactly does the `scrape_bonds` endpoint return for each auction?+
bond_title (the name/type of the bond), isin (international security identifier), auction_date, amount_offered_tzs_m (offered amount in millions of TZS), total_tendered_tzs_m (total bids received in millions of TZS), and amount_issued_tzs (actual amount issued). The response also includes a top-level count of records returned.Are yield or coupon rate fields included in auction results?+
How far back does the historical auction data go?+
limit parameter controls how many are fetched, but there is no documented cutoff date. The depth of historical coverage depends on what the Bank of Tanzania's site makes available. For very large historical pulls, note that higher limit values increase response time since each auction requires a separate request.