Retail Sales (CNY)

Measures change in the total value of sales at the retail level.

Category: Economy

API Endpoint

/api/v1/announcements/cny/retail_sales

About Retail Sales (CNY)

Retail sales for China measures the total receipts at retail stores, capturing consumer spending on goods. It is a high-frequency proxy for consumer demand and GDP growth.

Why FX traders watch it

Consumer spending accounts for 60–70% of GDP in most developed economies. Strong retail sales indicate healthy household finances and tend to support the cny by reducing the probability of rate cuts.

How to interpret the data

A beat on retail sales is cny-positive and may delay rate cuts. A sustained decline in retail sales signals consumer stress, which could prompt the People's Bank of China to ease, weakening the cny.

Historical Retail Sales (CNY)

Source: NBS/PBoC  ·  Monthly  ·  %YoY

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

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

Data Source

Primary Source

NBS/PBoC

Official Series ID

NBS/A140101_zb

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

%YoY

JSON Response Structure

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

{
    "currency": "CNY",
    "indicator": "retail_sales",
    "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 Retail Sales data for CNY from 2023:

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

Frequently Asked Questions

How often is China Retail Sales updated?
Retail Sales for China is released on a monthly schedule by People's Bank of China (or the relevant national statistics agency). FXMacroData ingests each new value within seconds of the official publication and exposes the exact announcement timestamp on every record.
What unit is Retail Sales reported in?
The series is published in %YoY. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source China Retail Sales data?
Data is fetched directly from People's Bank of China or the official national statistics publication for China. The source URL is preserved on every announcement record so downstream consumers can trace the value back to its primary release.
How do I query Retail Sales for China via the API?
Issue a GET request to /api/v1/announcements/cny/retail_sales?api_key=YOUR_API_KEY. The response contains a chronological list of observations with values, release dates, and announcement timestamps. USD announcement data is public; other currencies require a Professional API key.