# South African Reserve Bank (SARB) API
> Live headline economic and financial indicators from the South African Reserve Bank (SARB), the central bank of South Africa — read straight from the SARB public web-indicators feed, no key, nothing stored. The dashboard endpoint returns the bank's full headline board exactly as published on its home page: the policy repo rate, prime lending rate, Sabor and Zaronia money-market rates, benchmark government-bond closing yields, the rand exchange rates and the latest inflation prints. The fx endpoint isolates the rand exchange rates — rand per US dollar, British pound, euro and Japanese yen — plus the nominal effective exchange rate. The interest endpoint returns the policy and lending rates with the benchmark bond yields. The inflation endpoint returns the latest CPI and PPI. The marketrates endpoint returns the fuller current money-market rate list. Every indicator carries its own as-of date and a direction versus the prior print. This is South-African central-bank data (ZAR rates, yields and inflation) — distinct from the crypto ZAR exchange-ticker and the other central-bank APIs in the catalogue.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/sarb-api/..."
```

## Pricing
- **Free** (Free) — 18,000 calls/Mo, 3 req/s
- **Desk** ($8/Mo) — 210,000 calls/Mo, 10 req/s
- **Pro** ($24/Mo) — 880,000 calls/Mo, 28 req/s
- **Scale** ($57/Mo) — 3,100,000 calls/Mo, 60 req/s

## Endpoints

### Dashboard

#### `GET /v1/dashboard` — Full SARB headline board

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sarb-api/v1/dashboard"
```

**Response:**
```json
{
    "data": {
        "bank": "South African Reserve Bank",
        "count": 13,
        "source": "SARB",
        "country": "ZA",
        "indicators": [
            {
                "code": "CPI1000F",
                "date": "2026-04-30",
                "name": "CPI",
                "trend": "up",
                "value": 4,
                "section": "Inflation rates"
            },
            {
                "code": "PPI1000F",
                "date": "2026-04-30",
                "name": "PPI",
                "trend": "up",
                "value": 4.7712,
                "section": "Inflation rates"
            },
            {
                "code": "MMRD002A",
                "date": "2026-06-11",
                "name": "SARB Policy Rate",
                "trend": "flat",
                "value": 7,
                "section": "Interest rates"
            },
            {
                "code": "MMRD000A",
                "date": "2026-06-11",
                "name": "Prime lending rate",
                "trend": "flat",
                "value": 10.5,
                "section": "Interest rates"
            },
            {
                "code": "MMRD708A",
                "date": "2026-06-10",
                "name": "8.00% 2030 (R2030) (closing yields)",
                "trend": "up",
                "value": 8.05,
                "section": "Interest rates"
            },
            {
                "code": "MMRD709A",
                "date": "2026-
…(truncated, see openapi.json for full schema)
```

### FX

#### `GET /v1/fx` — Rand exchange rates and nominal effective rate

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sarb-api/v1/fx"
```

**Response:**
```json
{
    "data": {
        "bank": "South African Reserve Bank",
        "base": "ZAR",
        "note": "Values are rand per unit of the named foreign currency (e.g. rand per US dollar).",
        "count": 5,
        "source": "SARB",
        "exchange_rates": [
            {
                "code": "EXCX135D",
                "date": "2026-06-11",
                "name": "Rand per US Dollar",
                "trend": "up",
                "value": 16.5422,
                "section": "Exchange rates"
            },
            {
                "code": "EXCZ001D",
                "date": "2026-06-11",
                "name": "Rand per British Pound",
                "trend": "down",
                "value": 22.1211,
                "section": "Exchange rates"
            },
            {
                "code": "EXCZ002D",
                "date": "2026-06-11",
                "name": "Rand per Euro",
                "trend": "down",
                "value": 19.0897,
                "section": "Exchange rates"
            },
            {
                "code": "EXCZ120D",
                "date": "2026-06-11",
                "name": "Rand per Japanese Yen",
                "trend": "flat",
                "value": 0.1031,
                "section": "Exchange rates"
            }
        ],
        "nominal_effective": [
            {
                "code": "EER4504A",
                "date": "2026-06-11",
                "name": "Nominal effective exchange rate",
             
…(truncated, see openapi.json for full schema)
```

### Rates

#### `GET /v1/interest` — Policy, prime, Sabor, Zaronia and bond yields

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sarb-api/v1/interest"
```

**Response:**
```json
{
    "data": {
        "bank": "South African Reserve Bank",
        "count": 6,
        "rates": [
            {
                "code": "MMRD002A",
                "date": "2026-06-11",
                "name": "SARB Policy Rate",
                "trend": "flat",
                "value": 7,
                "section": "Interest rates"
            },
            {
                "code": "MMRD000A",
                "date": "2026-06-11",
                "name": "Prime lending rate",
                "trend": "flat",
                "value": 10.5,
                "section": "Interest rates"
            },
            {
                "code": "MMRD708A",
                "date": "2026-06-10",
                "name": "8.00% 2030 (R2030) (closing yields)",
                "trend": "up",
                "value": 8.05,
                "section": "Interest rates"
            },
            {
                "code": "MMRD709A",
                "date": "2026-06-10",
                "name": "6.25% 2036 (R209) (closing yields)",
                "trend": "up",
                "value": 8.79,
                "section": "Interest rates"
            },
            {
                "code": "MMRD851A",
                "date": "2026-06-10",
                "name": "Sabor",
                "trend": "down",
                "value": 6.907,
                "section": "Interest rates"
            },
            {
                "code": "MMRD855A",
                "date": "2026-06-10",
              
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/marketrates` — Fuller current money-market rate list

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sarb-api/v1/marketrates"
```

**Response:**
```json
{
    "data": {
        "bank": "South African Reserve Bank",
        "count": 24,
        "rates": [
            {
                "code": "MMRD002A",
                "date": "2026-06-11",
                "name": "SARB Policy Rate",
                "trend": "flat",
                "value": 7,
                "section": "Money Market Rates"
            },
            {
                "code": "MMRD851A",
                "date": "2026-06-10",
                "name": "Sabor",
                "trend": "down",
                "value": 6.907,
                "section": "Money Market Rates"
            },
            {
                "code": "MMRD855A",
                "date": "2026-06-10",
                "name": "Zaronia",
                "trend": "up",
                "value": 6.853,
                "section": "Money Market Rates"
            },
            {
                "code": "MMRD853A",
                "date": "2026-06-10",
                "name": "Overnight FX rate",
                "trend": "down",
                "value": 6.8,
                "section": "Money Market Rates"
            },
            {
                "code": "MMRD203A",
                "date": "2026-06-10",
                "name": "Treasury bills - 91 day (tender rates)",
                "trend": "flat",
                "value": 7.13,
                "section": "Money Market Rates"
            },
            {
                "code": "MMRD206A",
                "date": "2026-06-10",
                
…(truncated, see openapi.json for full schema)
```

### Inflation

#### `GET /v1/inflation` — Latest CPI and PPI prints

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sarb-api/v1/inflation"
```

**Response:**
```json
{
    "data": {
        "bank": "South African Reserve Bank",
        "count": 2,
        "source": "SARB",
        "country": "ZA",
        "inflation": [
            {
                "code": "CPI1000F",
                "date": "2026-04-30",
                "name": "CPI",
                "trend": "up",
                "value": 4,
                "section": "Inflation rates"
            },
            {
                "code": "PPI1000F",
                "date": "2026-04-30",
                "name": "PPI",
                "trend": "up",
                "value": 4.7712,
                "section": "Inflation rates"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-11T16:46:58.814Z",
        "request_id": "7419866f-eaef-4a3a-8594-a7788391a316"
    },
    "status": "ok",
    "message": "Inflation retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sarb-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Exchange rates are rand per unit of foreign currency. trend is the direction vs the prior print (up/down/flat). Each indicator carries its own as-of date; rates update daily, inflation monthly.",
        "source": "SARB web indicators (custom.resbank.co.za/SarbWebApi/WebIndicators, live)",
        "service": "sarb-api",
        "endpoints": {
            "GET /v1/fx": "Rand exchange rates (per USD, GBP, EUR, JPY) and the nominal effective exchange rate.",
            "GET /v1/meta": "This document.",
            "GET /v1/interest": "Policy repo rate, prime rate, Sabor, Zaronia and benchmark bond yields.",
            "GET /v1/dashboard": "Full SARB headline board — every published indicator.",
            "GET /v1/inflation": "Latest CPI and PPI prints.",
            "GET /v1/marketrates": "Fuller current money-market rate list."
        },
        "description": "Live headline economic and financial indicators from the South African Reserve Bank (SARB), the central bank of South Africa. The dashboard endpoint returns the bank's full headline board (policy and money-market rates, bond closing yields, rand exchange rates, inflation); the fx endpoint returns the rand exchange rates (rand per USD, GBP, EUR, JPY) plus the nominal effective exchange rate; the interest endpoint returns the policy repo rate, prime rate, Sabor, Zaronia and benchmark bond yields; the inflation endpoint returns the latest CPI and PPI; the marketrates endpoint returns 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/sarb-api
OpenAPI spec: https://www.oanor.com/api/sarb-api/openapi.json