{"uid":"cap_nEtHmuX-wVmXO0gM2kjPB","slug":"stationfx-university-of-michigan-consumer-sentiment-fe60761c","name":"StationFX University of Michigan Consumer Sentiment","description":"University of Michigan monthly survey of consumer attitudes toward finances, business conditions, and buying conditions. Leading indicator of consumer spending. Sharp drops often precede spending slowdowns. Monthly frequency with full derived metrics and history back to 1952.","url":"https://stationfx.com/economic-data/sentiment/university-of-michigan-consumer-sentiment?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http","description":"Always \"http\" for HTTP endpoints"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string","description":"HTTP method. Always GET for StationFX query endpoints"},"queryParams":{"type":"object","properties":{"fmt":{"enum":["json","toon"],"type":"string","description":"Response format. Use toon for compact agent-friendly output."},"fields":{"type":"string","description":"Comma-separated metric names"},"date_to":{"type":"string","description":"End date YYYY-MM-DD"},"date_from":{"type":"string","description":"Start date YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Response format. Always \"json\" (or \"toon\" if fmt=toon was requested)"},"example":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Observation date YYYY-MM-DD"},"value":{"type":"number","description":"Raw observed value in series units"},"mom_pct":{"type":"number","description":"Month-over-month % change"},"yoy_pct":{"type":"number","description":"Year-over-year % change"},"zscore_5y":{"type":"number","description":"Z-score relative to trailing 5 years"},"mom_change":{"type":"number","description":"Month-over-month absolute change"},"yoy_change":{"type":"number","description":"Year-over-year absolute change"},"zscore_12m":{"type":"number","description":"Z-score relative to trailing 12 months"},"above_trend":{"type":"integer","description":"1 if value is above long-run trend, else 0"},"pct_rank_5y":{"type":"number","description":"Percentile rank over trailing 5 years (0-100)"},"rolling_3m_avg":{"type":"number","description":"3-month rolling average"},"rolling_12m_avg":{"type":"number","description":"12-month rolling average"},"trend_direction":{"type":"integer","description":"Trend: 1 rising, -1 falling, 0 flat"}}},"description":"Observations ordered by date ascending"},"meta":{"type":"object","description":"Series metadata: source_key (FRED series ID), units, frequency (D/W/M/Q/A), date_from, date_to, fields"}},"description":"Station f(x) response with metadata and pre-computed derived metrics"},"example":{"data":[{"date":"2024-01-01","value":5.33,"mom_pct":0,"yoy_change":0.5,"zscore_12m":1.2,"trend_direction":1}],"meta":{"frequency":"M","source_key":"UMCSENT"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ESwXtjeyzVAxMmsp5C2tn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the University of Michigan monthly consumer sentiment survey data with derived metrics and historical observations back to 1952.","exampleAgentPrompt":"Pull the University of Michigan consumer sentiment readings for the last 12 months in JSON format, including the month-over-month percent change and 5-year z-score for each observation.","exampleUseCases":[{"title":"Recession early warning monitor","prompt":"Get me the University of Michigan consumer sentiment data for the past 6 months and tell me if it's been dropping — I want to know if we're seeing the kind of sharp decline that typically precedes a spending slowdown."},{"title":"Macro dashboard data feed","prompt":"Fetch the latest UMich consumer sentiment reading along with its year-over-year change and 5-year percentile rank so I can update my economic dashboard."},{"title":"Historical trend analysis","prompt":"Pull University of Michigan consumer sentiment data from January 2000 to December 2010 in JSON format with rolling 12-month averages so I can study how sentiment behaved through the 2008 financial crisis."}],"resultDescription":"Returns an array of monthly observations, each containing the raw sentiment index value, month-over-month and year-over-year absolute and percentage changes, 12-month and 5-year z-scores, 5-year percentile rank, 3-month and 12-month rolling averages, and a flag indicating whether the value is above or below long-run trend. Data covers history back to 1952.","failureModes":["Invalid date format in date_from or date_to returns an error","Requesting fields not in the available metric set returns an error or empty values","Date range outside available history (pre-1952) may return empty data","Invalid fmt enum value returns a format error","Network or payment authorization failure returns a 402 or 4xx response"],"whenToPreferThis":"Choose this endpoint when you need the University of Michigan Consumer Sentiment Index specifically — the gold-standard monthly survey of U.S. consumer attitudes — with pre-computed derived metrics (z-scores, percentile ranks, rolling averages, trend flags) included in the response, avoiding the need to compute those yourself. Prefer it over raw FRED data pulls when you need ready-to-use analytical metrics, or over Conference Board Consumer Confidence when UMich's longer history (back to 1952) or its specific survey methodology is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:46:54.259Z","isFirstParty":false,"canonicalSlug":"stationfx-university-of-michigan-consumer-sentiment-fe60761c"}