You need reliable, machine-readable yields for Russian government bonds to power dashboards, risk models, and research. By the end of this guide you’ll be able to pull Russia (RU) sovereign yields—latest levels, historical points, time series, intraday snapshots, spreads, and the full curve—directly into your code using the Bonds API, and understand how to interpret the fields, units, timestamps, and edge cases such as market holidays.
What this API provides and how yields are expressed
Bonds API delivers sovereign bond yields as JSON over HTTPS from https://bonds-api.com. Coverage includes 60+ countries and maturities from 1-month bills to 50-year bonds. In this article we focus on Russia (ISO2 code: RU).
Across all endpoints in this guide:
- Yields are expressed in percent (for example, 4.52 means 4.52%).
- Spreads are expressed in basis points (bps). For instance, 215 means 2.15 percentage points.
- Dates use the Y-m-d format (e.g., 2026-11-08). Timestamps use ISO 8601 in UTC where provided (e.g., 2026-11-08T12:00:00Z).
- All requests are GET and authenticated with the X-API-Key header.
Production base URL for all requests in this article: https://bonds-api.com/api/v1/
To obtain an API key, visit Register and Get started with Bonds API. You can also explore operational status and tooling via the MCP.
Quick note: Live sample block
The following live sample block shows a real cURL and JSON that you can copy-paste as-is. It uses a query parameter for the key and a US symbol payload shape. Keep it verbatim for testing the live sample, then use the header-based authentication patterns throughout the rest of this article for production integration.
curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"
{
"success": true,
"date": "2026-11-06",
"rates": {
"US_10Y": 4.86
},
"dates": {
"US_10Y": "2026-11-06"
},
"currencies": {
"US_10Y": "USD"
},
"meta": {
"request_id": "82b51091-037b-42dd-ad34-b6b816df650b",
"timestamp": "2026-11-08T00:04:06+00:00"
}
}
Endpoint 1: Latest yields for Russia
Use this endpoint to retrieve the most recent available yields for one or more Russian maturities. If you omit maturities, you’ll get all available standard points.
Request
Python (requests)
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"countries": "RU", "maturities": "2Y,10Y"}
)
data = resp.json()
# Access yields:
# data["data"]["RU"]["2Y"]["yield"], data["data"]["RU"]["10Y"]["yield"]
JavaScript (fetch)
async function fetchLatestRU() {
const res = await fetch(
"https://bonds-api.com/api/v1/latest?countries=RU&maturities=2Y,10Y",
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const json = await res.json();
return json;
}
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=RU&maturities=2Y,10Y";
$response = file_get_contents($url, false, $context);
$data = json_decode($response, true);
?>
Sample JSON
How to read it
- yield: numeric percent (4.25 means 4.25%).
- date: last business date when this maturity had an official close.
- source: “official” typically indicates a primary publication source.
Endpoint 2: Historical yield for a specific date
Fetch the yield for a single Russian maturity on a given date (Y-m-d). If the date is a market holiday or weekend without publication, expect a 404.
Request
Python
import requests
params = {"country": "RU", "maturity": "10Y", "date": "2025-06-15"}
resp = requests.get(
"https://bonds-api.com/api/v1/historical",
headers={"X-API-Key": "YOUR_API_KEY"},
params=params
)
point = resp.json()
JavaScript
async function getRUHistorical() {
const url = new URL("https://bonds-api.com/api/v1/historical");
url.search = new URLSearchParams({
country: "RU",
maturity: "10Y",
date: "2025-06-15"
}).toString();
const res = await fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" }});
return res.json();
}
PHP
<?php
$query = http_build_query([
"country" => "RU",
"maturity" => "10Y",
"date" => "2025-06-15"
]);
$opts = ["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]];
$ctx = stream_context_create($opts);
$json = file_get_contents("https://bonds-api.com/api/v1/historical?$query", false, $ctx);
$data = json_decode($json, true);
?>
Sample JSON
How to read it
- yield: percent on the requested calendar day.
- source: helps you trace provenance (e.g., “official”).
Endpoint 3: Time series between two dates
Retrieve a continuous series for one Russian maturity between two dates, inclusive. The series respects business days; dates without publications are omitted.
Request
Python
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/timeseries",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "RU", "maturity": "10Y", "start": "2025-11-08", "end": "2026-11-08"}
)
series = resp.json()
JavaScript
async function fetchRUTimeseries() {
const params = new URLSearchParams({
country: "RU",
maturity: "10Y",
start: "2025-11-08",
end: "2026-11-08"
});
const res = await fetch(
`https://bonds-api.com/api/v1/timeseries?${params.toString()}`,
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
return res.json();
}
PHP
<?php
$params = http_build_query([
"country" => "RU",
"maturity" => "10Y",
"start" => "2025-11-08",
"end" => "2026-11-08"
]);
$context = stream_context_create(["http" => ["method" => "GET", "header" => "X-API-Key: YOUR_API_KEY\r\n"]]);
$response = file_get_contents("https://bonds-api.com/api/v1/timeseries?$params", false, $context);
$data = json_decode($response, true);
?>
Sample JSON
How to read it
- series: array of daily closes with date (Y-m-d) and yield in percent.
Endpoint 4: Spread versus a benchmark
Compute the bond yield spread between Russia and a benchmark market (e.g., US Treasuries), typically at 10Y unless you pass an explicit maturity. Spreads are returned in basis points.
Request
Python
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "RU", "benchmark": "US", "maturity": "10Y"}
)
spread = resp.json()
JavaScript
async function getRUSpread() {
const res = await fetch(
"https://bonds-api.com/api/v1/spread?country=RU&benchmark=US&maturity=10Y",
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
return res.json();
}
PHP
<?php
$params = http_build_query([
"country" => "RU",
"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?$params", false, $ctx);
$data = json_decode($json, true);
?>
Sample JSON
How to read it
- spread_bps: basis points (e.g., 215 = 2.15%).
- country_yield, benchmark_yield: percent yields aligned by maturity.
Endpoint 5: Full yield curve for Russia
Pull the entire RU yield curve for the latest available date or a specific historical date. Use this to build yield curve visualizations or to boot a curve model.
Request
Python
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "RU"}
)
curve = resp.json()
JavaScript
async function getRUCurve(date) {
const params = new URLSearchParams({ country: "RU" });
if (date) params.set("date", date);
const res = await fetch(
`https://bonds-api.com/api/v1/curve?${params.toString()}`,
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
return res.json();
}
PHP
<?php
$params = http_build_query(["country" => "RU"]);
$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?$params", false, $ctx);
$data = json_decode($json, true);
?>
Sample JSON
How to read it
- inverted: true if short-term yields exceed longer maturities across standard points.
- curve: keys are standard maturities; values are yields in percent.
Curve points at a glance
| Maturity | Yield (%) |
|---|---|
| 1M | 5.31 |
| 3M | 5.27 |
| 6M | 5.18 |
| 1Y | 4.98 |
| 2Y | 4.25 |
| 5Y | 4.39 |
| 10Y | 4.52 |
| 30Y | 4.71 |
Endpoint 6: Intraday yield snapshots
For same-day monitoring, request intraday snapshots for a given maturity and date. Useful for trading dashboards and alerting, with timestamps in UTC.
Request
Python
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/intraday",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"country": "RU", "maturity": "10Y", "date": "2026-11-08"}
)
intraday = resp.json()
JavaScript
async function ruIntraday(dateStr = "2026-11-08") {
const url = `https://bonds-api.com/api/v1/intraday?country=RU&maturity=10Y&date=${encodeURIComponent(dateStr)}`;
const res = await fetch(url, { headers: { "X-API-Key": "YOUR_API_KEY" }});
return res.json();
}
PHP
<?php
$params = http_build_query([
"country" => "RU",
"maturity" => "10Y",
"date" => "2026-11-08"
]);
$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?$params", false, $ctx);
$data = json_decode($json, true);
?>
Sample JSON
How to read it
- snapshots: array of point-in-time yields with fetched_at in UTC.
- count: number of snapshots returned.
Endpoint 7: Fluctuation over a window
Summarize change in yields over a period for RU, including start, end, min, and max. Ideal for performance and risk summaries.
Request
Python
import requests
resp = requests.get(
"https://bonds-api.com/api/v1/fluctuation",
headers={"X-API-Key": "YOUR_API_KEY"},
params={
"countries": "RU",
"maturity": "10Y",
"start": "2025-11-08",
"end": "2026-11-08"
}
)
fl = resp.json()
JavaScript
async function ruFluctuation() {
const q = new URLSearchParams({
countries: "RU",
maturity: "10Y",
start: "2025-11-08",
end: "2026-11-08"
});
const res = await fetch(
`https://bonds-api.com/api/v1/fluctuation?${q.toString()}`,
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
return res.json();
}
PHP
<?php
$params = http_build_query([
"countries" => "RU",
"maturity" => "10Y",
"start" => "2025-11-08",
"end" => "2026-11-08"
]);
$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?$params", false, $ctx);
$data = json_decode($json, true);
?>
Sample JSON
How to read it
- change: end_yield - start_yield in percentage points (not bps).
- min/max: extrema over the requested window.
Building a Russia yield curve and spreads in your app
For a complete curve visualization, call /curve for RU and plot maturities on the x-axis versus yields on the y-axis. If you require curve points not present in the payload, you can interpolate between reported tenors outside the API.
For cross-market analysis, use /spread with RU versus a benchmark (e.g., US) at the same maturity. Store spreads in bps in your database for arithmetic convenience; convert to percent by dividing by 100 if needed.
- Dashboard tiles: combine /latest for headline 2Y, 5Y, 10Y; /spread for RU-10Y vs US-10Y.
- Backtests: use /timeseries to compute rolling term premium proxies or momentum signals.
- Risk monitors: call /fluctuation nightly to refresh drawdowns and range statistics.
- Intraday monitors: call /intraday every few minutes and cache results to avoid rate limits.
Operational details: dates, updates, caching, and errors
Business days and holidays
- Daily endpoints (/latest, /historical, /timeseries, /curve, /spread, /fluctuation) align to market business days. If a requested date has no publication (weekend/holiday), expect either an omission in series or a 404 for single-day requests.
Update frequency
- /latest reflects the latest available day with published data; it may not be “today” on weekends or holidays.
- /intraday provides multiple snapshots throughout the requested date, with fetched_at in UTC for sequencing.
Caching guidance
- Immutable by date: responses keyed by a past date (e.g., /historical?date=YYYY-MM-DD) rarely change; cache them strongly in your app.
- Revalidating latest: for /latest and same-day /intraday, use short TTLs (e.g., 1–5 minutes) and stagger refresh to smooth traffic.
- Curve reuse: if your app shows term structure and spot tiles, fetch /curve once and reuse points across tiles.
Error handling
- 401: Missing or invalid X-API-Key. Ensure you pass the header exactly as X-API-Key.
- 403: Quota exceeded. Back off and retry after sufficient delay.
- 404: No data for the requested combination. Check ISO2 code (RU), maturity, and date.
- 422: Invalid parameter format (e.g., wrong date format). Validate on the client before calling.
- 429: Rate limit exceeded. Implement exponential backoff and caching.
- 500: Server error. Retry with jitter; log request IDs if available.
Sovereign bonds and Russian term structure: why this matters
Sovereign bonds are debt issued by national governments. Yields embed expectations for inflation, monetary policy, and country risk. Russian term structure dynamics—how 3M, 2Y, 10Y, and 30Y relate—inform carry/roll strategies, curve trades, and macro views.
Practical insights from these endpoints:
- Term premium: compare 10Y vs 2Y via /latest or directly from /curve.
- Momentum: compute trailing changes using /timeseries or /fluctuation.
- Cross-market risk: evaluate RU vs US with /spread at consistent maturities.
- Intraday risk: track rapid changes with /intraday for alerting or execution timing.
Putting it together: minimal code to ship
1) Latest RU 2Y and 10Y in one call
Python
import requests, datetime
def latest_ru_2y_10y(api_key):
r = requests.get(
"https://bonds-api.com/api/v1/latest",
headers={"X-API-Key": api_key},
params={"countries": "RU", "maturities": "2Y,10Y"}
)
j = r.json()
ru = j["data"]["RU"]
return {
"as_of": ru["10Y"]["date"], # same date for 2Y/10Y in most cases
"ru_2y": ru["2Y"]["yield"],
"ru_10y": ru["10Y"]["yield"]
}
2) Build a curve and compute a simple slope
import requests
def ru_curve_slope_10s2s(api_key):
r = requests.get(
"https://bonds-api.com/api/v1/curve",
headers={"X-API-Key": api_key},
params={"country": "RU"}
)
j = r.json()
c = j["curve"]
return {
"date": j["date"],
"slope_10s2s": c["10Y"] - c["2Y"] # percent points
}
3) Compare RU 10Y vs US 10Y spread (bps)
import requests
def ru_us_10y_spread_bps(api_key):
r = requests.get(
"https://bonds-api.com/api/v1/spread",
headers={"X-API-Key": api_key},
params={"country": "RU", "benchmark": "US", "maturity": "10Y"}
)
j = r.json()
return {
"spread_bps": j["spread_bps"],
"ru_yield": j["country_yield"],
"us_yield": j["benchmark_yield"]
}
Maturities, market calendars, and data hygiene
Maturities
- Standard keys include money markets (1M, 3M, 6M) and benchmark notes/bonds (1Y, 2Y, 5Y, 10Y, 30Y). Availability can vary; rely on the /curve payload for the definitive set for a date.
Calendars
- On local market holidays, yields won’t update; /latest will continue returning the most recent business day.
- /historical on non-business dates may return 404; validate or pre-check calendars in your app.
Data hygiene
- Units: Always treat yield fields as percent, not decimals or bps.
- Timezones: Intraday fetched_at is UTC; align to your UI’s timezone client-side.
- Missing points: When stitching curves, check for missing maturities and fall back to interpolation as needed.
Error response patterns and defensive coding
All errors follow a common shape with success=false and an error message:
- 401: Verify you’re sending X-API-Key.
- 422: Validate date formats as YYYY-MM-DD before calling.
- 429: Respect backoff; cache aggressively on your side for repeat views.
Implement retry-with-jitter for 500s and log request-level context as needed. Keep your API key out of client-side code in public websites; proxy via a backend where possible.
Use cases for fixed-income teams
- Portfolio risk: Nightly batch pulling /curve and /fluctuation to refresh DV01 approximations and scenario dashboards.
- Macro research: Use /timeseries to compute rolling correlations between RU curve points and macro indicators in your own stack.
- Execution monitoring: /intraday for 10Y to trigger spread-tightening alerts vs US benchmarks using /spread.
Explore more on bonds-api.com and operational resources via the MCP.
FAQ
What units are yields and spreads returned in?
Yields are in percent (e.g., 4.52 means 4.52%). Spreads are in basis points (bps), where 100 bps equals 1 percentage point.
Why does /latest return yesterday’s date on some days?
On weekends or market holidays, the latest available publication remains the most recent business day. Use /intraday to monitor same-day activity where available.
How should I cache results?
Cache date-stamped responses (e.g., /historical for a fixed date) strongly since they’re effectively immutable. Use short TTLs for /latest and /intraday and avoid polling more frequently than needed.
How do I build a yield curve?
Use /curve for RU to get standardized points. If your model requires additional tenors, interpolate client-side from the returned maturities.
What’s the recommended authentication method?
Send your API key in the X-API-Key header on all GET requests. Keep keys on the server side for web apps.
Ready to integrate Russian sovereign yields into your models and dashboards? Start with your API key here: Register. For direct navigation, visit bonds-api.com and Get started with Bonds API.