South Africa 10 Year Bond Yield

South Africa 10 Year Bond Yield

You need accurate, machine-readable data for the South Africa 10-year government bond to power risk models, dashboards, and research notebooks. By the end of this guide, you’ll query the Bonds API for the ZA 10Y’s latest print, historical values, intraday snapshots, full yield curve, and spreads, and you’ll know how to handle business days, caching, and error responses in production.

Why the South Africa 10Y matters and how Bonds API serves it

The South Africa 10-year bond (ZA 10Y) is a core reference for ZAR fixed income, used as a discounting anchor, a benchmark in relative value trades, and a macro risk barometer. Bonds-API provides sovereign bond yields as JSON over REST for 60+ countries, including South Africa (ISO2: ZA), across maturities from short T-bills to long bonds. Yields are returned in percentage points unless stated otherwise; spreads are returned in basis points.

Illustration: South Africa 10 Year Bond Yield

If you are evaluating how ZA duration risk evolves, need a clean ZA vs US 10Y spread, or want to build a daily yield curve across multiple maturities, you can do it with a few GET requests to https://bonds-api.com. To start building, see the MCP or Register for an API key.

Quick check: ZA 10Y latest yield (official sample)

The following official sample shows a live-style response for the latest ZA 10Y. Copy it to verify your environment can reach the API. The response includes a global date, a per-symbol rate, per-symbol date, and a timestamp.

curl -s "https://bonds-api.com/api/v1/latest?countries=ZA&maturities=10Y&api_key=YOUR_API_KEY"
{
    "success": true,
    "date": "2026-11-19",
    "rates": {
        "ZA_10Y": 8.855
    },
    "dates": {
        "ZA_10Y": "2026-11-19"
    },
    "currencies": {
        "ZA_10Y": "ZAR"
    },
    "meta": {
        "request_id": "c2220ce4-0f0e-4670-8a57-71e4e6df8228",
        "timestamp": "2026-11-19T00:04:05+00:00"
    }
}

How to read it:

  • rates.ZA_10Y is the 10-year yield expressed in percent (e.g., 8.855 means 8.855%).
  • dates.ZA_10Y is the reference date in YYYY-MM-DD.
  • meta.timestamp is ISO 8601 in UTC for when the API processed the request.
  • currencies.ZA_10Y indicates the bond’s currency (ZAR). Yield itself is a percentage, not a price.

Production integration: endpoints, payloads, and code

This section covers the seven Bonds-API endpoints relevant for South Africa yields, with canonical request formats, JSON fields, and code in cURL, Python, JavaScript, and PHP. All Bonds API requests use the base URL https://bonds-api.com/api/v1/ and the X-API-Key header for authentication in production code. Dates are YYYY-MM-DD. Timestamps are ISO 8601 in UTC.

1) Latest — current yields

Use this to fetch the most recent available ZA yields. You can request all maturities or filter to specific ones.

cURL (GET):

JSON response (example):

Field notes:

  • yield: percentage points (e.g., 4.52 means 4.52%).
  • date: reference day for that maturity (YYYY-MM-DD).
  • source: origin tag (e.g., “official”).

Python (requests):

import requests

resp = requests.get(
'https://bonds-api.com/api/v1/latest',
headers={'X-API-Key': 'YOUR_API_KEY'},
params={'countries': 'ZA', 'maturities': '2Y,10Y'}
)
data = resp.json()
za_10y = data['data']['ZA']['10Y']['yield']
za_10y_date = data['data']['ZA']['10Y']['date']
print('ZA 10Y:', za_10y, 'on', za_10y_date)

JavaScript (fetch):

const url = new URL('https://bonds-api.com/api/v1/latest');
url.search = new URLSearchParams({ countries: 'ZA', maturities: '2Y,10Y' }).toString();

fetch(url, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(json => {
const y = json.data.ZA['10Y'].yield; // percent
const d = json.data.ZA['10Y'].date; // YYYY-MM-DD
console.log('ZA 10Y', y, 'on', d);
});

PHP (file_get_contents):

<?php
$context = stream_context_create([
'http' => [
'method' => 'GET',
'header' => "X-API-Key: YOUR_API_KEY\r\n"
]
]);
$url = 'https://bonds-api.com/api/v1/latest?countries=ZA&maturities=2Y,10Y';
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
echo 'ZA 10Y: ' . $data['data']['ZA']['10Y']['yield'] . PHP_EOL;

2) Historical — yield on a specific date

Fetch the 10Y yield for a given day. Useful for end-of-day backfills, point-in-time charts, or verifying events.

cURL (GET):

JSON response (example):

Field notes:

  • yield: percent on the requested date (if the date is a non-business day, the API may return no data for that day; handle 404 accordingly).

Python:

import requests

params = {'country': 'ZA', 'maturity': '10Y', 'date': '2025-06-15'}
r = requests.get('https://bonds-api.com/api/v1/historical',
headers={'X-API-Key': 'YOUR_API_KEY'},
params=params)
hist = r.json()
print(hist['maturity'], hist['yield'], 'on', hist['date'])

JavaScript:

const params = { country: 'ZA', maturity: '10Y', date: '2025-06-15' };
const u = new URL('https://bonds-api.com/api/v1/historical');
u.search = new URLSearchParams(params).toString();

fetch(u, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => console.log(`${j.country} ${j.maturity}: ${j.yield}% on ${j.date}`));

PHP:

<?php
$q = http_build_query(['country' => 'ZA', 'maturity' => '10Y', 'date' => '2025-06-15']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/historical?$q", false, $ctx);
$h = json_decode($json, true);
echo "{$h['country']} {$h['maturity']} {$h['yield']}% on {$h['date']}\n";

3) Timeseries — yields between two dates

Retrieves a date-indexed series for a maturity. Missing days typically correspond to weekends or market holidays; program defensively by stitching business days or forward-filling when appropriate for your model.

cURL (GET):

JSON response (example):

Python:

import requests

params = {'country': 'ZA', 'maturity': '10Y', 'start': '2025-11-19', 'end': '2026-11-19'}
r = requests.get('https://bonds-api.com/api/v1/timeseries',
headers={'X-API-Key': 'YOUR_API_KEY'},
params=params)
ts = r.json()['series']
# Convert to a dict: date -> yield
curve = {row['date']: row['yield'] for row in ts}
print(len(curve), 'observations')

JavaScript:

const p = { country: 'ZA', maturity: '10Y', start: '2025-11-19', end: '2026-11-19' };
const tsUrl = new URL('https://bonds-api.com/api/v1/timeseries');
tsUrl.search = new URLSearchParams(p).toString();

fetch(tsUrl, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => {
j.series.forEach(pt => console.log(pt.date, pt.yield));
});

PHP:

<?php
$params = http_build_query(['country' => 'ZA', 'maturity' => '10Y', 'start' => '2025-11-19', 'end' => '2026-11-19']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/timeseries?$params", false, $ctx);
$data = json_decode($json, true);
foreach ($data['series'] as $row) {
echo $row['date'] . ' ' . $row['yield'] . PHP_EOL;
}

4) Spread — ZA vs benchmark in basis points

Computes the yield spread relative to a benchmark country at a selected maturity (defaults to 10Y). Spread is returned in basis points (1 bp = 0.01%).

cURL (GET):

JSON response (example):

Field notes:

  • spread_bps: basis-point difference (ZA – benchmark). 215 means ZA 10Y is 2.15% above the benchmark.

Python:

import requests

r = requests.get('https://bonds-api.com/api/v1/spread',
headers={'X-API-Key': 'YOUR_API_KEY'},
params={'country': 'ZA', 'benchmark': 'US', 'maturity': '10Y'})
s = r.json()
print('ZA-UST 10Y spread:', s['spread_bps'], 'bps')

JavaScript:

const sp = new URL('https://bonds-api.com/api/v1/spread');
sp.search = new URLSearchParams({ country: 'ZA', benchmark: 'US', maturity: '10Y' }).toString();

fetch(sp, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => console.log('Spread (bps):', j.spread_bps));

PHP:

<?php
$q = http_build_query(['country' => 'ZA', 'benchmark' => 'US', 'maturity' => '10Y']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/spread?$q", false, $ctx);
$d = json_decode($json, true);
echo "ZA-US 10Y spread: {$d['spread_bps']} bps\n";

5) Curve — full yield curve for South Africa

Returns a snapshot of the entire ZA curve for a given date (or the latest available). Use this to build curve visualizations, interpolations, or multi-maturity risk factors.

cURL (GET):

JSON response (example):

Field notes:

  • curve: key-value pairs of maturity to yield (percent). The set may vary by country coverage and availability.
  • inverted: boolean indicating whether the curve shape is inverted on that date.

Typical maturities returned in this example:

MaturityYield (percent)
1M5.31
3M5.27
6M5.18
1Y4.98
2Y4.25
5Y4.39
10Y4.52
30Y4.71

Python:

import requests

r = requests.get('https://bonds-api.com/api/v1/curve',
headers={'X-API-Key': 'YOUR_API_KEY'},
params={'country': 'ZA'})
curve = r.json()
za10 = curve['curve'].get('10Y')
print('ZA curve date', curve['date'], '10Y', za10, 'inverted?', curve['inverted'])

JavaScript:

const cUrl = new URL('https://bonds-api.com/api/v1/curve');
cUrl.search = new URLSearchParams({ country: 'ZA' }).toString();

fetch(cUrl, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => console.log('Curve date:', j.date, '10Y:', j.curve['10Y'], 'inverted:', j.inverted));

PHP:

<?php
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/curve?country=ZA", false, $ctx);
$j = json_decode($json, true);
echo "Date: {$j['date']} 10Y: {$j['curve']['10Y']} inverted? ";
echo $j['inverted'] ? 'true' : 'false';
echo PHP_EOL;

6) Intraday — yield snapshots within a day

For market hours analysis, pull intraday snapshots for a given date and maturity. Timestamps are in UTC.

cURL (GET):

JSON response (example):

Field notes:

  • snapshots[].yield: percent at each snapshot time.
  • snapshots[].fetched_at: ISO 8601 UTC timestamp for the observation.

Python:

import requests

r = requests.get('https://bonds-api.com/api/v1/intraday',
headers={'X-API-Key': 'YOUR_API_KEY'},
params={'country': 'ZA', 'maturity': '10Y', 'date': '2026-11-19'})
j = r.json()
for s in j['snapshots']:
print(s['fetched_at'], s['yield'])

JavaScript:

const iu = new URL('https://bonds-api.com/api/v1/intraday');
iu.search = new URLSearchParams({ country: 'ZA', maturity: '10Y', date: '2026-11-19' }).toString();

fetch(iu, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => j.snapshots.forEach(s => console.log(s.fetched_at, s.yield)));

PHP:

<?php
$q = http_build_query(['country' => 'ZA', 'maturity' => '10Y', 'date' => '2026-11-19']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/intraday?$q", false, $ctx);
$d = json_decode($json, true);
foreach ($d['snapshots'] as $s) {
echo $s['fetched_at'] . ' ' . $s['yield'] . PHP_EOL;
}

7) Fluctuation — change, min, max over a window

Summarize the ZA 10Y movement between two dates, including start/end yields, net change, and extrema. Helpful for monitoring risk thresholds and alerting.

cURL (GET):

JSON response (example):

Field notes:

  • All yields are in percent. change is end_yield – start_yield in percentage points.

Python:

import requests

params = {'countries': 'ZA', 'maturity': '10Y', 'start': '2025-11-19', 'end': '2026-11-19'}
r = requests.get('https://bonds-api.com/api/v1/fluctuation',
headers={'X-API-Key': 'YOUR_API_KEY'},
params=params)
f = r.json()['data']['ZA']
print('Δ:', f['change'], 'pp; min:', f['min'], 'max:', f['max'])

JavaScript:

const fu = new URL('https://bonds-api.com/api/v1/fluctuation');
fu.search = new URLSearchParams({ countries: 'ZA', maturity: '10Y', start: '2025-11-19', end: '2026-11-19' }).toString();

fetch(fu, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => {
const z = j.data.ZA;
console.log('Change:', z.change, 'pp, range:', z.min, '-', z.max);
});

PHP:

<?php
$qs = http_build_query(['countries' => 'ZA', 'maturity' => '10Y', 'start' => '2025-11-19', 'end' => '2026-11-19']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$json = file_get_contents("https://bonds-api.com/api/v1/fluctuation?$qs", false, $ctx);
$j = json_decode($json, true);
$z = $j['data']['ZA'];
echo "Change: {$z['change']} pp; Min: {$z['min']}; Max: {$z['max']}\n";

Reading dates, timestamps, and units

  • Yield fields are in percentage points. For portfolio math, convert percent to decimal (e.g., 4.52% → 0.0452) if needed.
  • Spread fields are in basis points (bps). 100 bps = 1.00%.
  • Dates are YYYY-MM-DD. For intraday, fetched_at is ISO 8601 UTC (e.g., 2026-11-19T12:00:00Z).

Business days, holidays, and update cadence

Bonds trade on business days; you may see no updates on weekends and public holidays in South Africa. Latest endpoints return the most recent available session. For timeseries, expect gaps on non-trading days; fill forward only if your model requires continuity. Intraday snapshots are time-stamped in UTC; align them to your local timezone in the client.

Practical tips:

  • Cache latest and curve responses for the trading day; refresh after local market close or when your app needs live checks.
  • For intraday dashboards, consider polling at a modest cadence and debouncing UI updates.
  • On 404 for a specific historical date, verify if the requested day is a holiday or weekend and adjust logic accordingly.

Building a ZA yield curve and spreads in your app

There are two common approaches:

  • Single-call curve: Use /curve?country=ZA to get a snapshot across maturities when you need breadth, not custom date logic.
  • Multi-symbol or focused pulls: For latency or dependency reasons, combine /latest with maturities filters (e.g., 2Y, 5Y, 10Y) and stitch a partial curve that matters to your analytics.

For cross-market analytics (e.g., ZA-UST spread), use /spread for 10Y or your preferred maturity. If you need a spread series, fetch parallel timeseries from /timeseries and compute or store the delta across dates, noting business-day alignment between markets.

Error handling and resiliency

All error responses share this shape: success=false with an error message. Handle HTTP status codes as follows:

  • 401: Missing or invalid X-API-Key. Verify the header is present and correct.
  • 403: Quota exceeded. Back off and alert.
  • 404: No data for the requested country/maturity/date. Check parameters and business days.
  • 422: Invalid parameter (e.g., date format or ISO2 code). Validate inputs before calling.
  • 429: Rate limit exceeded. Implement client-side rate limiting and retries with jitter.
  • 500: Server error. Retry with exponential backoff and circuit breaking.

For all endpoints, prefer idempotent GET with query params and the X-API-Key header. Log request URLs and correlation IDs when available (e.g., request_id in meta where present) to accelerate support diagnostics.

Use cases for ZA 10Y in production

  • Financial dashboards: Show ZA 10Y alongside intraday moves, the daily range, and the ZA-UST spread.
  • Portfolio risk tools: Feed the daily or intraday 10Y into duration and DV01 monitors; alert when fluctuation exceeds thresholds from /fluctuation.
  • Economic research: Retrieve multi-year /timeseries for regressions with macro variables; construct curves for term premium studies using /curve.
  • Fintech apps: Normalize yields to percent and standardize timestamps in UTC for consistency across regions.

Putting it together: recommended client patterns

  • Normalization: Convert yields to standardized numeric types; store date as YYYY-MM-DD and intraday timestamps as UTC instants.
  • Caching:
    • latest/curve: cache until next expected market update; invalidate on manual refresh or scheduled task.
    • timeseries/historical: cache indefinitely for immutable dates.
    • intraday: cache per snapshot window; avoid over-polling.
  • Fallbacks: If curve is temporarily missing a node, consider interpolating from adjacent maturities or backfilling with the last good observation, but flag data provenance in your UI.
  • Testing: Verify weekend/holiday behavior and country code handling (ZA) in your CI with mock responses.

Where to go next

Explore more sovereigns, maturities, and analytics at bonds-api.com. For endpoint references and interactive exploration, open the MCP. To integrate South Africa’s yield curve and spreads into your stack, Register for an API key.

You can also visit Bonds API and start coding in minutes. Register for Bonds API or Get started with Bonds API.

FAQ

How are yields expressed?
All yield fields are in percentage points (e.g., 4.52 means 4.52%). Spreads are in basis points (e.g., 215 means 2.15%).

What timezone are timestamps in?
Dates are in YYYY-MM-DD without timezone, representing the reference trading day. Intraday timestamps (fetched_at) and meta.timestamp fields are ISO 8601 in UTC (Z).

How should I handle weekends and South African public holidays?
Expect no updates on non-trading days. Use the previous business day’s latest where appropriate, or display “No new data” to users. For timeseries, gaps are normal on non-business days.

Can I get multiple ZA maturities in one call?
Yes. Use /latest with countries=ZA and a comma-separated maturities list (e.g., 2Y,5Y,10Y), or use /curve for a full snapshot on a date.

What about errors and rate limiting?
Handle 401/403/429 explicitly. Implement retries with exponential backoff for 429/500 and validate inputs to avoid 422. Log error payloads which include success=false and an error message.

Start building with bond data today

Get your API key and access sovereign bond yields across 60+ countries. 7-day free trial, no credit card required.