# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-resbank-co-za-api-1704f4b9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-resbank-co-za-api-1704f4b9/get_cpi \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_current_market_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_exchange_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_gold_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_ppi \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_prime_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_prime_rate_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_repo_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_repo_rate_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_sabor_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_selected_historical_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-resbank-co-za-api-1704f4b9/get_zaronia_rate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```