# Bank of Zambia — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access historical and current 91-day treasury bill auction data from the Bank of Zambia, including tender results, bid amounts, prices, and yield rates spanning from 2014 to present. Search and retrieve structured tender information to analyze Zambia's treasury bill market trends and performance over time.

**Category:** Finance & Markets | **Website:** [www.boz.zm/treasury-bills-results.htm](https://www.boz.zm/treasury-bills-results.htm) | **Docs:** [parse.bot/marketplace/73928735-f433-4861-8f25-845652d98171/boz-zm-api](https://parse.bot/marketplace/73928735-f433-4861-8f25-845652d98171/boz-zm-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/bank-of-zambia/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get tbill auction data

Retrieve treasury bill auction results for a specified tenor (91, 182, 273, or 364 days). Returns auction dates, tender numbers, ISINs, discount rates, yield rates, and PDF URLs. Data availability: 2026 records include full rate data (ISIN, discount rate, yield rate); older migrated records (2014-2025) include auction date, tender number, and PDF URL but may lack rate fields. Results sorted by auction date descending. Paginates through all matching records automatically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tenor` | string | No | Treasury bill tenor in days. |
| `year` | string | No | Year(s) to retrieve data for. Single year (e.g. '2026'), comma-separated years (e.g. '2025,2026'), or 'all' for all available years (2014-present). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bank-of-zambia/get-tbill-auction-data \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"tenor":"<string>","year":"<string>"}'
```

### List tender pdfs

List all treasury bill tender result PDF URLs organized by year. Returns PDF download URLs for tender result documents from the Bank of Zambia website. Each year group includes a count and the full list of URLs. Results cover all tenors combined for the given year(s).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Year(s) to list PDFs for. Single year (e.g. '2026'), comma-separated years (e.g. '2025,2026'), or 'all' for all available years (2014-present). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/bank-of-zambia/list-tender-pdfs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.