Back to API Index

소비자 신뢰 (JPY)

KOF 선행 지수 / 소비자 신뢰 지수.

Latest reading: 32.2 Index · Last updated: · Source: BoJ/Statistics Japan

Category: Economy

API Endpoint

/api/v1/announcements/jpy/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 소비자 신뢰 across all supported currencies →

About 소비자 신뢰 (JPY)

The consumer confidence index for Japan 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 jpy as it implies sustained consumer spending and economic momentum. A collapse in confidence may prompt fiscal or monetary stimulus, weighing on the jpy.

Historical 소비자 신뢰 (JPY)

Source: BoJ/Statistics Japan  ·  Monthly  ·  Index

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

Data Source

Primary Source

BoJ/Statistics Japan

Official Series ID

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": "JPY",
    "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 소비자 신뢰 data for JPY from 2023: 

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

Frequently Asked Questions

How often is Japan Consumer Confidence updated?
Consumer Confidence for Japan is released on a monthly schedule by Bank of Japan (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 Consumer Confidence reported in?
The series is published in Index. The exact unit is also returned on every API response under the indicator metadata.
Where does FXMacroData source Japan Consumer Confidence data?
Data is fetched directly from Bank of Japan or the official national statistics publication for Japan. 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 Consumer Confidence for Japan via the API?
Issue a GET request to /api/v1/announcements/jpy/consumer_confidence?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.