Securely Redirecting...

Connecting to Stripe

Back to API Index

Consumer Sentiment (USD)

A survey of consumer confidence levels.

Category: Economy

API Endpoint

/api/v1/announcements/usd/consumer_sentiment

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

FRED (UMich)

Official Series ID

UMCSENT

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": "USD",
    "indicator": "consumer_sentiment",
    "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 Sentiment data for USD starting from the beginning of 2023: 

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