Building fixed-income tools often starts with a simple requirement: get the current and historical yield of the Czech Republic 10-year government bond (CZ 10Y), then integrate it into dashboards, models, and alerts. By the end of this guide you will query, cache, and interpret Czech sovereign yields—current, intraday, historical, spreads, and full curves—using the Bonds API, and integrate them into production code with cURL, Python, JavaScript, and PHP.
What you will build and how the Czech 10Y fits in
The CZ 10Y is a core reference point for pricing, macro views, and duration risk in Czech koruna (CZK). You will fetch:
- Current Czech 10Y yield (percent) and intraday snapshots
- Historical daily yields and time series for backtests
- Spreads vs. a benchmark (e.g., U.S. Treasuries)
- A full CZ yield curve to interpolate discount factors
- Fluctuations (change/min/max) across periods
All data in this article comes from bonds-api.com. Every endpoint is a GET request under the base URL https://bonds-api.com/api/v1/ and uses an API key. You can browse the models in the MCP and Register for an API key when ready.
Data shape, units, dates, and caching
Yields are expressed in percent (e.g., 4.52 means 4.52%). When an endpoint returns spreads, the field spread_bps is in basis points (1 bp = 0.01%). Dates in daily data use YYYY-MM-DD and are on business days; weekends and Czech market holidays have no new official daily values. Intraday snapshots include fetched_at timestamps in UTC. Cache daily endpoints per country/maturity/date; for intraday, respect the frequency your application needs, and implement client-side throttling and conditional refresh.
Quick check: a live-style sample for CZ 10Y
The following sample shows a compact CZ 10Y latest response. Copy it verbatim for a quick smoke test of your environment.
curl -s "https://bonds-api.com/api/v1/latest?countries=CZ&maturities=10Y&api_key=YOUR_API_KEY"
{
"success": true,
"date": "2026-11-09",
"rates": {
"CZ_10Y": 5.125
},
"dates": {
"CZ_10Y": "2026-11-09"
},
"currencies": {
"CZ_10Y": "CZK"
},
"meta": {
"request_id": "798e0875-0b17-48d1-a08a-cf3caf9eff6e",
"timestamp": "2026-11-09T00:05:29+00:00"
}
}
How to read it: rates.CZ_10Y is the 10-year yield in percent. dates.CZ_10Y echoes the valuation date. currencies.CZ_10Y indicates pricing currency (CZK). meta.timestamp is the server-side fetch time in ISO-8601 UTC.
Endpoint: Latest yields for CZ (including 10Y)
Use this when you need the current Czech yields for the 10Y or multiple maturities. This endpoint is updated on business days; if the market is closed, it returns the last available official day.
cURL
JSON response
How to read it: yields are in percent; date is the valuation date (YYYY-MM-DD). source indicates the provenance (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": "CZ", "maturities": "2Y,10Y"}
)
resp.raise_for_status()
data = resp.json()
cz_10y = data["data"]["CZ"]["10Y"]["yield"]
cz_10y_date = data["data"]["CZ"]["10Y"]["date"]
print("CZ 10Y:", cz_10y, "on", cz_10y_date)
JavaScript (fetch)
const url = new URL("https://bonds-api.com/api/v1/latest");
url.searchParams.set("countries", "CZ");
url.searchParams.set("maturities", "2Y,10Y");
fetch(url.toString(), {
method: "GET",
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(json => {
const y = json.data.CZ["10Y"].yield;
const d = json.data.CZ["10Y"].date;
console.log(`CZ 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=CZ&maturities=2Y,10Y";
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
$y = $data["data"]["CZ"]["10Y"]["yield"];
$d = $data["data"]["CZ"]["10Y"]["date"];
echo "CZ 10Y $y% on $d";
Endpoint: Historical yield for CZ 10Y on a specific date
Use this for event studies and point-in-time backfills. If the requested date is a weekend or holiday, plan to retry adjacent business days or handle a 404 gracefully.
cURL
JSON response
How to read it: yield is percent; date is the valuation date requested. If no data exists for the exact date, handle a possible 404 error (see error section below).
Python (requests)
import requests
params = {"country": "CZ", "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)
if r.status_code == 404:
print("No data for that day (weekend/holiday?)")
else:
r.raise_for_status()
j = r.json()
print(f"CZ 10Y on {j['date']}: {j['yield']}%")
JavaScript (fetch)
const params = new URLSearchParams({
country: "CZ",
maturity: "10Y",
date: "2025-06-15"
});
fetch(`https://bonds-api.com/api/v1/historical?${params.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(async r => {
if (r.status === 404) throw new Error("No data for requested combination");
const j = await r.json();
console.log(`CZ 10Y ${j.yield}% on ${j.date}`);
});
PHP (file_get_contents)
<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$url = "https://bonds-api.com/api/v1/historical?country=CZ&maturity=10Y&date=2025-06-15";
$resp = @file_get_contents($url, false, $ctx);
if ($resp === false) {
echo "Error fetching historical yield";
exit;
}
$j = json_decode($resp, true);
echo "CZ 10Y {$j['yield']}% on {$j['date']}";
Endpoint: Time series for CZ 10Y
Pull daily yields between start and end (inclusive) to backtest strategies, compute realized volatility, or build rolling analytics. Data points exist for business days with reported yields.
cURL
JSON response
How to read it: series is an ordered list of daily points. Yields are in percent; dates are YYYY-MM-DD on business days.
Python (requests)
import requests
import statistics
p = {
"country": "CZ",
"maturity": "10Y",
"start": "2025-11-09",
"end": "2026-11-09"
}
r = requests.get("https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"}, params=p)
r.raise_for_status()
j = r.json()
ys = [pt["yield"] for pt in j["series"]]
print("Obs:", len(ys), "Mean:", sum(ys)/len(ys), "Stdev:", statistics.pstdev(ys))
JavaScript (fetch)
const qs = new URLSearchParams({
country: "CZ",
maturity: "10Y",
start: "2025-11-09",
end: "2026-11-09"
});
fetch(`https://bonds-api.com/api/v1/timeseries?${qs.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => {
const last = j.series[j.series.length - 1];
console.log(`Last CZ 10Y point: ${last.yield}% on ${last.date}`);
});
PHP (file_get_contents)
<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$q = http_build_query([
"country" => "CZ",
"maturity" => "10Y",
"start" => "2025-11-09",
"end" => "2026-11-09"
]);
$resp = file_get_contents("https://bonds-api.com/api/v1/timeseries?$q", false, $ctx);
$j = json_decode($resp, true);
$series = $j["series"];
$first = $series[0];
$last = end($series);
echo "From {$first['date']} ({$first['yield']}%) to {$last['date']} ({$last['yield']}%)";
Endpoint: Spread vs. benchmark (CZ 10Y vs. US 10Y)
Use spreads to normalize levels across currencies and regimes. The spread endpoint returns the maturity-aligned difference in basis points and the underlying yields for both legs.
cURL
JSON response
How to read it: spread_bps is CZ 10Y minus US 10Y in basis points (215 bps = 2.15%). The individual yields are in percent. This is useful for cross-market relative value and macro monitors.
Python (requests)
import requests
params = {"country": "CZ", "benchmark": "US", "maturity": "10Y"}
r = requests.get("https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"}, params=params)
r.raise_for_status()
j = r.json()
print(f"CZ-US 10Y spread: {j['spread_bps']} bps (CZ {j['country_yield']}% vs US {j['benchmark_yield']}%)")
JavaScript (fetch)
const qp = new URLSearchParams({ country: "CZ", benchmark: "US", maturity: "10Y" });
fetch(`https://bonds-api.com/api/v1/spread?${qp.toString()}`, {
headers: { "X-API-Key": "YOUR_API_KEY" }
})
.then(r => r.json())
.then(j => console.log(`Spread: ${j.spread_bps} bps`));
PHP (file_get_contents)
<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$qs = http_build_query(["country" => "CZ", "benchmark" => "US", "maturity" => "10Y"]);
$j = json_decode(file_get_contents("https://bonds-api.com/api/v1/spread?$qs", false, $ctx), true);
echo "CZ-US 10Y spread: {$j['spread_bps']} bps";
Endpoint: Full CZ yield curve
To price cash flows or compute DV01 across buckets, build the curve. If you omit the date parameter, you get the latest available curve. The inverted flag helps detect curve inversions.
cURL
JSON response
How to read it: curve is a map of maturity buckets to yields in percent. Use it for interpolation (e.g., linear-on-yield, cubic spline, or NSS fitting) to construct a continuous curve. inverted=false indicates short tenors are not meaningfully above long tenors overall.
Python (requests)
import requests
r = requests.get("https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "CZ"})
r.raise_for_status()
j = r.json()
cz_curve = j["curve"]
tenors = ["1M","3M","6M","1Y","2Y","5Y","10Y","30Y"]
points = [(t, cz_curve.get(t)) for t in tenors if t in cz_curve]
print("CZ curve:", points)
JavaScript (fetch)
const params = new URLSearchParams({ country: "CZ" });
fetch(`https://bonds-api.com/api/v1/curve?${params}`, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(j => {
const c = j.curve;
console.log(`CZ 10Y: ${c["10Y"]}% | 30Y: ${c["30Y"]}% on ${j.date}`);
});
PHP (file_get_contents)
<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$resp = file_get_contents("https://bonds-api.com/api/v1/curve?country=CZ", false, $ctx);
$j = json_decode($resp, true);
echo "CZ curve date {$j['date']}, 10Y={$j['curve']['10Y']}%, 30Y={$j['curve']['30Y']}%";
Endpoint: Intraday snapshots for CZ 10Y
For trading dashboards and alerting, query intraday snapshots. Timestamps are UTC. Snapshots reflect market-sourced ticks collected during the day.
cURL
JSON response
How to read it: yield is percent; fetched_at is ISO-8601 UTC. count is the number of snapshots returned. Cache cautiously; this data can change intra-session.
Python (requests)
import requests
from datetime import datetime
p = {"country": "CZ", "maturity": "10Y", "date": "2026-11-09"}
r = requests.get("https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"}, params=p)
r.raise_for_status()
j = r.json()
latest = max(j["snapshots"], key=lambda s: s["fetched_at"])
ts = datetime.fromisoformat(latest["fetched_at"].replace("Z","+00:00"))
print(f"Latest {j['maturity']} at {ts.isoformat()} UTC: {latest['yield']}%")
JavaScript (fetch)
const qp = new URLSearchParams({ country: "CZ", maturity: "10Y", date: "2026-11-09" });
fetch(`https://bonds-api.com/api/v1/intraday?${qp}`, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(j => {
const last = j.snapshots[j.snapshots.length - 1];
console.log(`CZ 10Y last snapshot: ${last.yield}% at ${last.fetched_at} UTC`);
});
PHP (file_get_contents)
<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$q = http_build_query(["country" => "CZ", "maturity" => "10Y", "date" => "2026-11-09"]);
$j = json_decode(file_get_contents("https://bonds-api.com/api/v1/intraday?$q", false, $ctx), true);
$last = end($j["snapshots"]);
echo "CZ 10Y intraday last: {$last['yield']}% at {$last['fetched_at']} UTC";
Endpoint: Fluctuation for CZ 10Y over a period
Summarize a period with start, end, absolute change, and extremes. Useful for weekly reports and risk digests.
cURL
JSON response
How to read it: start_yield and end_yield are percent; change is the absolute difference in percentage points (not basis points). min and max are the extremes over the window.
Python (requests)
import requests
p = {"countries": "CZ", "maturity": "10Y", "start": "2025-11-09", "end": "2026-11-09"}
r = requests.get("https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"}, params=p)
r.raise_for_status()
j = r.json()
cz = j["data"]["CZ"]
print(f"CZ 10Y Δ: {cz['change']} pts (min {cz['min']}%, max {cz['max']}%)")
JavaScript (fetch)
const qs = new URLSearchParams({ countries: "CZ", maturity: "10Y", start: "2025-11-09", end: "2026-11-09" });
fetch(`https://bonds-api.com/api/v1/fluctuation?${qs}`, { headers: { "X-API-Key": "YOUR_API_KEY" } })
.then(r => r.json())
.then(j => {
const cz = j.data.CZ;
console.log(`Start ${cz.start_yield}% → End ${cz.end_yield}% | Change ${cz.change} pts`);
});
PHP (file_get_contents)
<?php
$ctx = stream_context_create(["http" => ["header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$q = http_build_query(["countries" => "CZ", "maturity" => "10Y", "start" => "2025-11-09", "end" => "2026-11-09"]);
$j = json_decode(file_get_contents("https://bonds-api.com/api/v1/fluctuation?$q", false, $ctx), true);
$cz = $j["data"]["CZ"];
echo "CZ 10Y change {$cz['change']} pts (min {$cz['min']}%, max {$cz['max']}%)";
Reading the curve to build a yield curve, a CZK discount function, and spreads
When you receive the curve map, you can:
- Interpolate at non-standard tenors (e.g., 7Y) for pricing.
- Construct discount factors using day-count conventions under your model, after converting yields to continuously compounded or simple rates as needed.
- Compute key-rate DV01 by bumping specific buckets (2Y, 5Y, 10Y, 30Y) and revaluing.
- Pair the CZ curve with the spread endpoint to monitor cross-market risk (e.g., CZ vs. US 10Y or CZ vs. DE Bund 10Y).
If you run a dashboard, combine /api/v1/latest for card summaries, /api/v1/curve for charts, and /api/v1/intraday for sparkline updates. For backtests and research, prefer /api/v1/timeseries and /api/v1/fluctuation.
Business days, holidays, update frequency, and error handling
Daily yields update on business days; weekends and Czech market holidays will not produce new official daily records. Time series and historical calls reflect this; plan to handle missing dates gracefully. Intraday snapshots reflect UTC timestamps and can appear during trading hours; set polling intervals based on your UI needs and rate-limiting strategy.
Errors follow a common shape with success=false and an error message. Typical HTTP statuses:
- 401 Missing or invalid API key
- 403 Quota exceeded
- 404 No data for requested country/maturity/date
- 422 Invalid parameter (e.g., bad date format)
- 429 Rate limit exceeded
- 500 Server error
Implement retries with backoff on 429/500, and do not retry 4xx except transient 401 after key refresh. Cache daily results per (country, maturity, date); for intraday, cache short-lived snapshots but respect your staleness budget.
Sovereign bond fundamentals that matter for integration
Czech sovereign bonds are CZK-denominated obligations issued by the government. The 10-year yield is commonly used for macro policy assessment, mortgage rate proxies, and relative value. Because yields are quoted in percent, treat 4.52 as 0.0452 in decimal math when discounting. Spreads in basis points help compare different countries directly.
Putting it together: a CZ 10Y mini-pipeline
- Fetch /api/v1/latest for CZ 10Y and short tenors (e.g., 2Y) for a top-level card and spread tile.
- Call /api/v1/curve to build a line chart and interpolate to the maturities you hedge.
- Call /api/v1/intraday for a 1-day sparkline and alerts on threshold moves.
- Backfill with /api/v1/timeseries for your historical panel and performance metrics.
- Compute CZ vs. US spread via /api/v1/spread for macro context.
- Use /api/v1/fluctuation in weekly and monthly digest emails.
Explore more capabilities at bonds-api.com, and inspect model definitions in the MCP.
FAQ
How are yields expressed?
All yields are in percent. For example, 4.52 means 4.52%, which is 0.0452 in decimal when computing discount factors. Fields named spread_bps are in basis points (1 bp = 0.01%).
What timezone do timestamps use?
Daily dates are YYYY-MM-DD with no timezone attached. Intraday snapshots include fetched_at in ISO-8601 UTC (Z). Treat all intraday logic in UTC to avoid DST drift.
What happens on weekends or Czech holidays?
Daily endpoints return the last available business day’s data; historical on an exact holiday may return 404. Handle this by checking adjacent business days or by caching the last successful value for display.
Can I request multiple maturities at once?
Yes. Use /api/v1/latest with the maturities parameter (e.g., 2Y,5Y,10Y) or use /api/v1/curve for a complete country curve on a given date.
How should I cache these endpoints?
Cache daily endpoints by (country, maturity, date) for at least the trading day; invalidate when a new business day begins. For intraday, use short TTLs aligned with your update cadence and respect 429 rate-limit responses.
Ready to integrate the Czech Republic 10 Year Bond Yield into your stack? Use the endpoints above to ship a reliable CZ 10Y panel today, and expand to full curves and spreads as you iterate. Register to get your API key and start building. If you prefer a direct jump-off, you can also Get started with Bonds API now.