# Resbank — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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 real-time and historical financial data from South Africa's central bank, including prime rates, repo rates, exchange rates, inflation metrics (CPI and PPI), and commodity prices like gold. Track key interest rate benchmarks such as SABOR and ZARONIA rates, and monitor market rates to stay informed on South African economic indicators.

**Category:** Finance & Markets | **Website:** [resbank.co.za/](https://resbank.co.za/) | **Docs:** [parse.bot/marketplace/1704f4b9-011d-4ef8-b01f-7cfeab567755/resbank-co-za-api](https://parse.bot/marketplace/1704f4b9-011d-4ef8-b01f-7cfeab567755/resbank-co-za-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/resbank/`
**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 cpi

Returns the Consumer Price Index (CPI) — headline inflation rate for all urban areas. Includes the value, period date, direction indicator, and timeseries code. Updated monthly.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-cpi \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get current market rates

Returns all current market rate indicators in one call, including money market rates, capital market rates, exchange rates, and gold prices. Each rate includes name, section grouping, timeseries code, date, value, direction indicator, and format metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-current-market-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get exchange rates

Returns current exchange rates for ZAR against major currencies (USD, GBP, EUR, JPY) and the nominal effective exchange rate index. Each rate includes name, timeseries code, date, value, direction indicator, and format metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-exchange-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get gold price

Returns the London gold price per fine ounce in both USD and ZAR (average of the day's AM and PM price fixings). Each entry includes name, timeseries code, date, value, direction indicator, and format metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-gold-price \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ppi

Returns the Producer Price Index (PPI) — 12-month percentage change. Includes the value, period date, direction indicator, and timeseries code. Updated monthly.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-ppi \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get prime rate

Returns the most recent prime lending rate, including the value, date, timeseries code, and formatted percentage string. The prime rate is the benchmark rate at which private banks lend to the public. Updated daily on business days.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-prime-rate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get prime rate history

Returns historical daily prime lending rate observations, ordered from most recent to oldest. Each observation contains the period date, timeseries name, description, value, and format metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-prime-rate-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get repo rate

Returns the most recent SARB Policy Rate (repo/repurchase rate), including the value, date, timeseries code, and formatted percentage string. The repo rate is the interest rate set by the Monetary Policy Committee (MPC) to achieve the inflation target.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-repo-rate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get repo rate history

Returns historical daily SARB Policy Rate (repo rate) observations, ordered from most recent to oldest. Each observation contains the period date, timeseries name, description, value, and format metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-repo-rate-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get sabor rate

Returns the current South African Benchmark Overnight Rate (SABOR). Includes the value, date, direction indicator, timeseries code, and format metadata. Updated daily on business days.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-sabor-rate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get selected historical rates

Returns daily and monthly historical rates including selected exchange rates and effective indices. Daily rates include ZAR per USD, GBP, and EUR. Monthly indicators include nominal and real effective exchange rate indices and the real prime lending rate.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-selected-historical-rates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get zaronia rate

Returns the current ZARONIA (South African Rand Overnight Index Average) rate. Includes the value, date, direction indicator, timeseries code, and format metadata. Updated daily on business days.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/resbank/get-zaronia-rate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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