Back to API Index

Foreign Exchange Reserves (CNY)

Assets held by the central bank in foreign currencies, used to support the exchange rate and manage monetary policy. Key indicator of a country's external financial position.

Category: Monetary Policy

API Endpoint

/api/v1/announcements/cny/foreign_reserves

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

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

Browse the full endpoint reference

Compare Foreign Exchange Reserves across all supported currencies →

About Foreign Exchange Reserves (CNY)

The foreign reserves of China encompass foreign currency holdings, special drawing rights (SDRs), IMF reserve positions, and gold held by the People's Bank of China. They represent the country's international liquidity buffer.

Why FX traders watch it

A large reserves buffer increases confidence in the cny by demonstrating the People's Bank of China's capacity to meet external obligations and intervene in FX markets. Reserves below 3 months of import cover are often cited as a vulnerability threshold.

How to interpret the data

Increasing foreign reserves are cny-positive as they signal financial strength and intervention capacity. A sustained draw-down of reserves can trigger speculative attacks on the cny.

Historical Foreign Exchange Reserves (CNY)

Source: NBS/PBoC  ·  Monthly  ·  USD bn

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

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

Data Source

Primary Source

NBS/PBoC

Official Series ID

SAFE Foreign Reserves

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

USD bn

JSON Response Structure

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

{
    "currency": "CNY",
    "indicator": "foreign_reserves",
    "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 Foreign Exchange Reserves data for CNY from 2023: 

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