Back to API Index

Muinín Tomhaltóirí (CNY)

Príomhtháscaire KOF / Innéacs Muiníne Tomhaltóirí.

Category: Economy

API Endpoint

/api/v1/announcements/cny/consumer_confidence

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

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

Browse the full endpoint reference

Compare Muinín Tomhaltóirí across all supported currencies →

About Muinín Tomhaltóirí (CNY)

The consumer confidence index for China surveys households on their assessment of current and future economic conditions. It is a leading indicator of consumer spending and broader activity.

Why FX traders watch it

Confident consumers are more likely to spend and borrow, supporting near-term GDP growth. A deterioration in confidence often precedes spending weakness by 1–3 months, giving an early signal for the economic outlook.

How to interpret the data

Above-consensus consumer confidence supports the cny as it implies sustained consumer spending and economic momentum. A collapse in confidence may prompt fiscal or monetary stimulus, weighing on the cny.

Historical Muinín Tomhaltóirí (CNY)

Source: NBS/PBoC  ·  Monthly  ·  Index

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

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

Data Source

Primary Source

NBS/PBoC

Official Series ID

NBS Consumer Confidence

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

Index

JSON Response Structure

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

{
    "currency": "CNY",
    "indicator": "consumer_confidence",
    "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 Muinín Tomhaltóirí data for CNY from 2023: 

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