China 10 Year Bond Yield

China 10 Year Bond Yield

You need the China 10-year government bond yield inside your models and dashboards, with clean JSON you can query for the latest print, a specific date, a rolling time series, intraday snapshots, country-vs-benchmark spreads, and the full Chinese yield curve to build term-structure analytics. By the end of this article, you’ll know exactly which Bonds API endpoints to call, how yields are formatted, how dates and timestamps are represented, and how to handle business days, caching, and error responses in production.

What the China 10-year yield represents and how Bonds API serves it

The China 10-year government bond yield is a key reference rate for CNY discount curves, rate expectations, mortgage and corporate borrowing benchmarks, and cross-market spread analysis versus U.S. Treasuries and other sovereigns. Bonds API exposes this yield (and other China maturities) over REST as JSON using a single authentication header. All endpoints are GET-only, returning yields as percentages (for example 4.52 means 4.52%).

Illustration: China 10 Year Bond Yield

Base URL (all endpoints): https://bonds-api.com/api/v1/. Authenticate with your API key via the X-API-Key header. Learn more at bonds-api.com, or get credentials here: Register. You can also explore metadata and tools at the MCP.

Latest China yields: pulling the current 10Y with optional multiple maturities

Use GET /latest to retrieve the most recent yields available for China (ISO2: CN). You can request a single maturity like 10Y, or multiple maturities to build a mini-curve snapshot in one request. The response includes yields (percentage), date (YYYY-MM-DD) and the data source label.

Endpoint

GET /api/v1/latest

  • Required: countries=CN (ISO2 code, comma-separated for multiple countries)
  • Optional: maturities (comma-separated, e.g., 2Y,10Y). Omit to return all available maturities for the requested country.

cURL

curl -s "https://bonds-api.com/api/v1/latest?countries=US&maturities=10Y&api_key=YOUR_API_KEY"

JSON response

{
    "success": true,
    "date": "2026-11-02",
    "rates": {
        "US_10Y": 4.929
    },
    "dates": {
        "US_10Y": "2026-11-02"
    },
    "currencies": {
        "US_10Y": "USD"
    },
    "meta": {
        "request_id": "508c0f13-1e9a-4a52-9a8b-44550c35b776",
        "timestamp": "2026-11-02T01:04:04+00:00"
    }
}

How to read this:

  • success: Boolean request status.
  • data.CN.10Y.yield: Yield in percent (4.52 means 4.52%).
  • date: Valuation date in YYYY-MM-DD, typically a recent business day for China markets.
  • source: Origin label (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': 'CN', 'maturities': '2Y,10Y'}
)
resp.raise_for_status()
data = resp.json()

cn_10y = data['data']['CN']['10Y']['yield']
cn_10y_date = data['data']['CN']['10Y']['date']
print('CN 10Y:', cn_10y, 'on', cn_10y_date)

JavaScript (fetch)

const url = new URL('https://bonds-api.com/api/v1/latest');
url.searchParams.set('countries', 'CN');
url.searchParams.set('maturities', '2Y,10Y');

fetch(url.toString(), {
method: 'GET',
headers: { 'X-API-Key': 'YOUR_API_KEY' }
})
.then(r => r.json())
.then(j => {
const y = j.data.CN['10Y'].yield;
const d = j.data.CN['10Y'].date;
console.log(`CN 10Y: ${y}% on ${d}`);
})
.catch(console.error);

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=CN&maturities=2Y,10Y';
$json = file_get_contents($url, false, $context);
$data = json_decode($json, true);
$yield = $data['data']['CN']['10Y']['yield'];
$date = $data['data']['CN']['10Y']['date'];
echo "CN 10Y: {$yield}% on {$date}\n";

Point-in-time yield: China 10Y on a specific historical date

Use GET /historical to pull the China 10Y yield for a particular date. This is useful for event studies, backtests, and valuations keyed to quarter-end or month-end dates.

Endpoint

GET /api/v1/historical

  • Required: country=CN
  • Required: maturity=10Y
  • Required: date=YYYY-MM-DD

cURL

JSON response

Fields:

  • yield: Percent yield (4.38 = 4.38%).
  • date: The requested valuation date; if it lands on a non-business day, ensure your application handles cases where no data exists (404 errors are possible).
  • source: Data origin tag.

Python (requests)

import requests

params = {'country': 'CN', '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)
r.raise_for_status()
j = r.json()
print(j['country'], j['maturity'], j['date'], j['yield'])

JavaScript (fetch)

const url = new URL('https://bonds-api.com/api/v1/historical');
url.searchParams.set('country', 'CN');
url.searchParams.set('maturity', '10Y');
url.searchParams.set('date', '2025-06-15');

fetch(url, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(console.log)
.catch(console.error);

PHP (file_get_contents)

<?php
$params = http_build_query([
'country' => 'CN',
'maturity' => '10Y',
'date' => '2025-06-15'
]);
$context = stream_context_create(['http' => [
'method' => 'GET',
'header' => "X-API-Key: YOUR_API_KEY\r\n"
]]);
$resp = file_get_contents('https://bonds-api.com/api/v1/historical?'.$params, false, $context);
echo $resp;

Time series: China 10Y between two dates

Use GET /timeseries to load daily yields for an interval. This is the building block for charting, rolling volatility, drawdown, and regression analyses.

Endpoint

GET /api/v1/timeseries

  • Required: country=CN
  • Required: maturity=10Y
  • Required: start=YYYY-MM-DD
  • Required: end=YYYY-MM-DD (end ≥ start)

cURL

JSON response

Fields:

  • series: Array of daily observations. Dates are YYYY-MM-DD; yields are percent.

Python (requests)

import requests

p = {'country': 'CN', 'maturity': '10Y', 'start': '2025-11-02', 'end': '2026-11-02'}
res = requests.get('https://bonds-api.com/api/v1/timeseries',
headers={'X-API-Key': 'YOUR_API_KEY'},
params=p)
ts = res.json()['series']
for row in ts[:3]:
print(row['date'], row['yield'])

JavaScript (fetch)

const u = new URL('https://bonds-api.com/api/v1/timeseries');
u.searchParams.set('country', 'CN');
u.searchParams.set('maturity', '10Y');
u.searchParams.set('start', '2025-11-02');
u.searchParams.set('end', '2026-11-02');

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

PHP (file_get_contents)

<?php
$query = http_build_query([
'country' => 'CN',
'maturity' => '10Y',
'start' => '2025-11-02',
'end' => '2026-11-02'
]);
$ctx = stream_context_create(['http' => [
'method' => 'GET',
'header' => "X-API-Key: YOUR_API_KEY\r\n"
]]);
echo file_get_contents('https://bonds-api.com/api/v1/timeseries?'.$query, false, $ctx);

Intraday snapshots: track China 10Y during the session

Use GET /intraday to retrieve multiple snapshots within a single date for a given maturity. This is helpful for monitoring live drift, session highs/lows, or syncing with exchange hours.

Endpoint

GET /api/v1/intraday

  • Required: country=CN
  • Required: maturity=10Y
  • Required: date=YYYY-MM-DD

cURL

JSON response

Fields:

  • snapshots[].yield: Percent.
  • snapshots[].fetched_at: ISO 8601 timestamp in UTC (Z suffix). Convert to local timezones in your UI.
  • count: Snapshot count returned for the day.
  • meta.timezone: Timezone for fetched_at values (UTC).

Python (requests)

import requests

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

JavaScript (fetch)

const iurl = new URL('https://bonds-api.com/api/v1/intraday');
iurl.searchParams.set('country', 'CN');
iurl.searchParams.set('maturity', '10Y');
iurl.searchParams.set('date', '2026-11-02');

fetch(iurl, { 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 (file_get_contents)

<?php
$q = http_build_query(['country' => 'CN', 'maturity' => '10Y', 'date' => '2026-11-02']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$raw = file_get_contents('https://bonds-api.com/api/v1/intraday?'.$q, false, $ctx);
echo $raw;

Spread vs benchmark: China 10Y relative to US 10Y

Use GET /spread to compute the country-vs-benchmark spread. This is returned in basis points (bps), with both legs’ yields included so you can display the absolute values and the spread.

Endpoint

GET /api/v1/spread

  • Required: country=CN
  • Required: benchmark=US
  • Optional: maturity (defaults to 10Y if omitted)

cURL

JSON response

Fields:

  • spread_bps: The CN 10Y yield minus US 10Y in basis points (1 bps = 0.01%).
  • country_yield and benchmark_yield: Both in percent.

Python (requests)

import requests

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

JavaScript (fetch)

const surl = new URL('https://bonds-api.com/api/v1/spread');
surl.searchParams.set('country', 'CN');
surl.searchParams.set('benchmark', 'US');
surl.searchParams.set('maturity', '10Y');

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

PHP (file_get_contents)

<?php
$params = http_build_query(['country' => 'CN', 'benchmark' => 'US', 'maturity' => '10Y']);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
echo file_get_contents('https://bonds-api.com/api/v1/spread?'.$params, false, $ctx);

Full China yield curve and building a 10Y-anchored curve

Use GET /curve to obtain the latest (or a specified date’s) curve for China across bill and bond maturities. Useful for curve fitting, bootstrapping, and relative value analysis. The response includes an inverted flag to quickly determine curve shape.

Endpoint

GET /api/v1/curve

  • Required: country=CN
  • Optional: date=YYYY-MM-DD (defaults to latest available)

cURL

JSON response

Fields:

  • curve: Map of maturity to yield in percent.
  • inverted: Boolean flag indicating whether short maturities exceed long maturities.
  • date: Curve valuation date.

To build analytics around the 10Y point, combine /curve with /spread (e.g., 10Y vs 2Y) or compute slope measures like 10s–30s from the returned map.

Python (requests)

import requests

j = requests.get('https://bonds-api.com/api/v1/curve',
headers={'X-API-Key': 'YOUR_API_KEY'},
params={'country': 'CN'}).json()
cn_curve = j['curve']
ten_thirty_slope = cn_curve['30Y'] - cn_curve['10Y']
print('10s30s slope (bp):', round(ten_thirty_slope*100, 1))

JavaScript (fetch)

const curl = new URL('https://bonds-api.com/api/v1/curve');
curl.searchParams.set('country', 'CN');

fetch(curl, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => {
const c = j.curve;
const slope = (c['30Y'] - c['10Y']) * 100; // bps
console.log('CN 10s30s (bps):', slope.toFixed(1));
});

PHP (file_get_contents)

<?php
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
$raw = file_get_contents('https://bonds-api.com/api/v1/curve?country=CN', false, $ctx);
echo $raw;

Fluctuation over a period: change, min, max for China 10Y

Use GET /fluctuation to summarize change, minimum, and maximum between two dates. This is handy for risk reports and monitoring dashboards without moving large series to the client.

Endpoint

GET /api/v1/fluctuation

  • Required: countries=CN (comma-separated for many)
  • Required: maturity=10Y
  • Required: start=YYYY-MM-DD
  • Required: end=YYYY-MM-DD

cURL

JSON response

Fields:

  • start_yield, end_yield: Percent yields at endpoints.
  • change: Absolute change in percentage points (end - start).
  • min, max: Extremes over the period.

Python (requests)

import requests

p = {'countries': 'CN', 'maturity': '10Y', 'start': '2025-11-02', 'end': '2026-11-02'}
j = requests.get('https://bonds-api.com/api/v1/fluctuation',
headers={'X-API-Key': 'YOUR_API_KEY'},
params=p).json()
cn = j['data']['CN']
print('Δ (bp):', round(cn['change']*100, 1), 'min:', cn['min'], 'max:', cn['max'])

JavaScript (fetch)

const furl = new URL('https://bonds-api.com/api/v1/fluctuation');
furl.searchParams.set('countries', 'CN');
furl.searchParams.set('maturity', '10Y');
furl.searchParams.set('start', '2025-11-02');
furl.searchParams.set('end', '2026-11-02');

fetch(furl, { headers: { 'X-API-Key': 'YOUR_API_KEY' } })
.then(r => r.json())
.then(j => {
const c = j.data.CN;
console.log('Change (bp):', (c.change*100).toFixed(1), 'Range:', c.min, '-', c.max);
});

PHP (file_get_contents)

<?php
$q = http_build_query([
'countries' => 'CN',
'maturity' => '10Y',
'start' => '2025-11-02',
'end' => '2026-11-02'
]);
$ctx = stream_context_create(['http' => ['method' => 'GET', 'header' => "X-API-Key: YOUR_API_KEY\r\n"]]);
echo file_get_contents('https://bonds-api.com/api/v1/fluctuation?'.$q, false, $ctx);

Operational details: maturities, business days, updates, caching, and errors

Maturities: China coverage spans standard money-market and bond tenors from bills (for example 1M, 3M, 6M) to 30Y (and may include 50Y where available). Use /curve to discover the full set on a date, or /latest with no maturities filter to fetch everything available.

Business days and holidays: If you query a non-trading day (weekends, PRC public holidays), /historical may return an error if no observation exists for that date. For time series, missing days are normal; your code should not assume a contiguous daily calendar.

Update frequency: Daily values typically update on each China market day. Intraday snapshots provide multiple points across a date and use UTC timestamps. Build UIs assuming asynchronous availability and avoid clock-based assumptions near market open/close.

Caching: For stable backtests, cache responses keyed by date, country, and maturity. For live dashboards, cache /latest for a short TTL (for example, a few minutes) and invalidate after the next expected market update or when you receive a material change. Include E2E monitoring to catch 429 (rate limit) and 500 (server) responses and back off appropriately.

Errors: The API returns a consistent shape for errors (success=false, error=message). Handle: - 401: Missing/invalid X-API-Key. Confirm header is sent; never put the key in query params. - 403: Quota exceeded. - 404: No data for the requested combination (often a non-business day or unavailable maturity/date). - 422: Invalid parameters (date format must be YYYY-MM-DD; country is ISO2 like CN). - 429: Rate limit exceeded; implement retry with exponential backoff. - 500: Server error; retry with jitter and monitoring.

Units and timestamps summary: - Yields are returned as percentages (e.g., 4.52 = 4.52%). - Spreads are returned in basis points (e.g., 215 = 2.15%). - Dates are YYYY-MM-DD. - Intraday fetched_at timestamps are ISO 8601 in UTC (Z suffix).

Explore more at bonds-api.com. To integrate programmatically, you only need GET requests with the X-API-Key header.

Real-world usage patterns for the China 10Y

  • Financial dashboards: Use /latest for real-time tiles showing CN 10Y, and /spread to show CN–US 10Y differentials in bps.
  • Risk and ALM tooling: Pull /timeseries for historical volatility and stress windows; /fluctuation to summarize ranges and regime changes.
  • Economic research: Use /historical for specific event dates (policy announcements, macro releases) to anchor charts and narratives.
  • Curve analytics: Use /curve to compute slopes (2s10s, 5s10s, 10s30s) and detect curve inversion signals for forward-looking risk models.
  • Intraday monitoring: Use /intraday to observe session dynamics and align fixed-income signals with equity/FX cross-asset frameworks.

Complete endpoint summary with copy-paste examples

Below is a concise recap of the seven endpoints touched above. All use GET and the X-API-Key header.

  • /latest: current yields by country and optional maturities filter.
  • /historical: yield for a specific date.
  • /timeseries: daily series between start and end.
  • /intraday: multiple snapshots within a date (UTC timestamps).
  • /spread: country vs benchmark in bps (includes both legs).
  • /curve: full yield curve for a country with inverted flag.
  • /fluctuation: change, min, max over a period.

You can register an API key here: Register for Bonds API and explore the developer console: Bonds API MCP. When you are ready to integrate in CI/CD, start with a small wrapper in your preferred language and centralize error handling and retries.

FAQ

Q: What units do yields and spreads use?
A: Yields are percentages (for example 4.52 = 4.52%). Spreads from /spread are basis points (for example 215 = 2.15%).

Q: How should I handle non-business days in China?
A: /historical on a non-trading date may 404 if no observation exists. For /timeseries, expect gaps for weekends and holidays. Align your analytics to a business-day calendar or forward/backfill with care.

Q: Can I build a China yield curve and compute slopes?
A: Yes. Use /curve to get all available tenors for CN on a date. Then compute spreads (for example 2s10s, 10s30s) directly from the returned map. The inverted flag quickly indicates broad curve shape.

Q: How are timestamps returned in intraday data?
A: Intraday uses fetched_at in ISO 8601 with UTC (Z). Convert to local timezones for display; do not assume exchange-local time in the payload.

Q: What is the recommended authentication mechanism?
A: Always send your API key via the X-API-Key header for every request. Do not include keys in query parameters or URLs for security reasons.

Ready to pull the China 10-year yield into your models? Start with the docs at bonds-api.com, then get your credentials with this quick link: Register. You can also Get started with Bonds API and browse tools on the MCP.

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.