{"uid":"cap_rmJT8ZrLvEzMjyyG2l5Zd","slug":"stationfx-cpi-all-urban-consumers-all-items-0abe294b","name":"StationFX CPI All Urban Consumers (All Items)","description":"Broadest measure of U.S. consumer price inflation, covering all urban consumers. The headline number reported in major economic releases. Use for inflation trend analysis, YoY comparison, and historical regime identification. Monthly frequency from 1947, includes MoM and YoY derived metrics.","url":"https://stationfx.com/economic-data/inflation/consumer-price-index-for-all-urban-consumers-all-items-in-u-s-city-average?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":"CPIAUCSL"}}},"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_17GYSz0SRI4VDDZJmrT2i","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":"Returns monthly U.S. headline CPI data for all urban consumers, including MoM/YoY changes, z-scores, rolling averages, and trend indicators from 1947 to present.","exampleAgentPrompt":"Pull the headline U.S. CPI data for all urban consumers from January 2020 through December 2023, including year-over-year and month-over-month percent changes, and give me the results in compact agent-friendly format.","exampleUseCases":[{"title":"Inflation regime analysis for research","prompt":"Get me the monthly headline CPI data from January 2000 to December 2023, including YoY percent change and the 5-year z-score, so I can identify distinct inflation regimes over the last two decades."},{"title":"Monitoring recent inflation trend","prompt":"What's the latest headline CPI reading for all urban consumers? Show me the last 6 months with month-over-month and year-over-year changes so I can see whether inflation is accelerating or cooling off."},{"title":"Historical context for economic report","prompt":"I need CPI all-items data going back to 1947 with rolling 12-month averages and the above-trend indicator — I'm trying to put today's inflation numbers in historical context for a report I'm writing."}],"resultDescription":"Returns a JSON array of monthly observations, each containing the raw CPI index value, month-over-month and year-over-year absolute and percent changes, 5-year and 12-month z-scores, 3-month and 12-month rolling averages, 5-year percentile rank, and a binary above-trend flag. Data covers all urban consumers for all items in the U.S. city average, monthly from 1947 onward.","failureModes":["Invalid date format (not YYYY-MM-DD) returns a parsing error","Requesting a date range before 1947 may return empty or partial data","Invalid field names in the fields parameter are silently ignored or cause a validation error","Unsupported fmt value returns an error","Payment failure (insufficient USDC balance or x402 protocol error) blocks the request"],"whenToPreferThis":"Choose this endpoint when you need the broadest, most widely reported U.S. inflation measure — the all-items CPI for all urban consumers — which is the headline number cited in major economic releases and media. Prefer this over core CPI when you want total inflation including food and energy, or when benchmarking against official headline figures. It offers the longest historical data (back to 1947) and pre-computed derived metrics (MoM, YoY, z-scores, rolling averages) so you don't need to calculate them yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T06:47:19.868Z","isFirstParty":false,"canonicalSlug":"stationfx-cpi-all-urban-consumers-all-items-0abe294b"}