Securely Redirecting...

Connecting to Stripe

Back to API Index

Consumer Confidence (JPY)

Survey-based measure of consumers' confidence in economic conditions, employment prospects, and personal finances.

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

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 and paid access. USD endpoints are available free without an API key.

Example Usage

To retrieve the Consumer Confidence data for JPY starting from the beginning of 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