Back to API Index

3年物国債利回り (CNY)

Reference information for 3-Year Government Bond Yield.

Category: Government Bond Yields

API Endpoint

/api/v1/announcements/cny/gov_bond_3y

Use the production OpenAPI schema for the authoritative REST route metadata.

https://fxmacrodata.com/api/openapi.json

Browse the full endpoint reference

Compare 3年物国債利回り across all supported currencies →

About 3年物国債利回り (CNY)

The 3-Year Government Bond Yield series for China is a key macroeconomic indicator published daily by the national statistics authority or the People's Bank of China. It is available via the FXMacroData API at /api/v1/announcements/cny/gov_bond_3y.

Why FX traders watch it

China's 3-Year Government Bond Yield is monitored by the People's Bank of China when assessing the health of the economy and calibrating monetary policy. Surprises relative to consensus can move the cny in the short term.

How to interpret the data

A reading above market expectations typically signals stronger-than-anticipated conditions and is broadly supportive of the cny. A miss versus consensus can shift rate expectations and weigh on the cny.

Historical 3年物国債利回り (CNY)

Source: NBS/PBoC  ·  Daily  ·  %

Chart data not available. Access the full historical series via the API endpoint above.

Data provided by FXMacroData via the /api/v1/announcements/cny/gov_bond_3y endpoint. For access, see pricing.

Data Source

Primary Source

NBS/PBoC

Official Series ID

ChinaBond 3Y

Data Format and Properties

Data Frequency

Daily

Unit of Measure

%

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

{
    "currency": "CNY",
    "indicator": "gov_bond_3y",
    "has_official_forecast": false,
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "data": [
        {
            "date": "2024-07-01",
            "val": 4.2,
            "announcement_datetime": 1722456000
        }
    ]
}

Request Parameters & Usage

Parameter Required Format Description
start_date NO YYYY-MM-DD Optional lower bound for the requested history.
end_date NO YYYY-MM-DD Optional upper bound. Defaults to the current date.
api_key CONDITIONAL string Required for non-USD announcement requests. USD announcement requests are public without an API key.

Example Usage

To retrieve 3年物国債利回り data for CNY from 2023: 

GET https://fxmacrodata.com/api/v1/announcements/cny/gov_bond_3y?start_date=2023-01-01&end_date=2023-12-31&api_key=YOUR_API_KEY

Frequently Asked Questions

Where can I access historical 3-Year Government Bond Yield data for China?
Historical 3-Year Government Bond Yield data for China is available at /api/v1/announcements/cny/gov_bond_3y.