# Consumption Monthly

Monthly snapshot of US consumer spending and saving behavior, consolidating four of the most closely watched consumption indicators into a single API call. Sourced from the Bureau of Economic Analysis (BEA) and US Census Bureau via FRED, this dataset covers personal consumption expenditures, retail sales, and the personal saving rate — providing a comprehensive read on the health and trajectory of the US consumer. Date field reflects the first day of the reference month.

Fields: `pce` · `pceMoMChgPc` · `retailSales` · `retailSalesMoMChgPc` · `personalSavingRate`

Units: `pce` and `retailSales` in millions of USD; `pceMoMChgPc` and `retailSalesMoMChgPc` as month-over-month percentage change; `personalSavingRate` as a percentage of disposable income.

- **Category:** Economic Indicators
- **Type:** historical
- **Workspace:** viaNexus
- **Dataset Id:** CONSUMPTION_MONTHLY
- **Region:** US
- **Records:** 236
- **Newest Record:** 2026-09-01
- **Oldest Record:** 2007-02-01
- **Updated At:** 2026-11-20

**Access:** [Get access](https://console.vianexus.com/console/marketplace) · [Start free trial](https://console.vianexus.com/auth/register)

## Use Cases

Consumer sector equity research (retail, discretionary, staples), GDP growth forecasting, Fed inflation monitoring (PCE is the Fed's preferred inflation gauge), personal saving rate as a consumer stress/resilience indicator, retail sales trend analysis for earnings previews, cross-referencing wage growth against spending to assess real purchasing power, recession monitoring via sustained spending contraction, and alert triggers on MoM retail sales or PCE threshold moves.

## Highlights

The CONSUMPTION\_MONTHLY dataset brings together the two most important measures of US consumer activity — Personal Consumption Expenditures (PCE) and Retail Sales — alongside the personal saving rate, in a single monthly API call. PCE is the Federal Reserve's preferred inflation and spending benchmark, making it essential for rate policy analysis. Retail sales provides a higher-frequency read on goods spending, while the saving rate signals whether consumers are drawing down buffers or rebuilding them. Together, these three indicators paint a complete picture of consumer health — from aggregate spending levels and momentum to the underlying financial resilience of US households.

## Provider

Published by viaNexus

Website: https://fred.stlouisfed.org/

## Methods

### Batch API

- `https://api.blueskyapi.com/v1/data/CORE/CONSUMPTION_MONTHLY`
- `https://api.blueskyapi.com/v1/data/CORE/CONSUMPTION_MONTHLY/:country`

Example API request: `https://api.blueskyapi.com/v1/data/CORE/CONSUMPTION_MONTHLY?last=1`

#### Time Series Query Parameters

You can use any time series query parameters with this dataset. [Full documentation](https://console.vianexus.com/docs/api-basics/time-series-data)

## Response Attributes

Key          | Type   | Description
-------------|--------|-------------
__country\*__ `key` | string | 
__date\*__ `index` | string | 
__pce__  | number, null | 
__pceMoMChgPc__  | number, null | 
__personalSavingRate__  | number, null | 
__retailSales__  | number, null | 
__retailSalesMoMChgPc__  | number, null | 
    
\* required

###

| Field               | Type   | Unit              | Description                                                        |
| ------------------- | ------ | ----------------- | ------------------------------------------------------------------ |
| date                | string | YYYY-MM-DD        | First day of reference month                                       |
| country             | string | —                 | Country code (e.g. US)                                             |
| pce                 | float  | Millions of USD   | Personal consumption expenditures, seasonally adjusted annual rate |
| pceMoMChgPc         | float  | Percentage points | PCE month-over-month percentage change                             |
| retailSales         | float  | Millions of USD   | Total retail and food services sales, seasonally adjusted          |
| retailSalesMoMChgPc | float  | Percentage points | Retail sales month-over-month percentage change                    |
| personalSavingRate  | float  | Percentage points | Personal saving as a percentage of disposable income               |
| id                  | string | —                 | Dataset identifier (CONSUMPTION\_MONTHLY)                          |
| key                 | string | —                 | Partition key (US)                                                 |
| subkey              | string | —                 | Sub-partition key (empty)                                          |
| updated             | float  | Unix ms           | Timestamp of last data refresh                                     |

## Disclaimer

Monthly consumption data is sourced from the US Bureau of Economic Analysis (BEA) and the US Census Bureau via the Federal Reserve Bank of St. Louis (FRED). This data is provided for informational purposes only and is subject to the terms of use of the respective data providers. Blue-Sky Data Platform LLC makes no representations as to the accuracy, completeness, or timeliness of the data and accepts no liability for decisions made in reliance upon it. Users are responsible for ensuring their use of this data complies with applicable provider terms and licensing requirements.

## Attribution

PCE and personal saving rate data: US Bureau of Economic Analysis (BEA) via the Federal Reserve Bank of St. Louis (FRED). Retail sales data: US Census Bureau via FRED. Key FRED series: `PCE` (personal consumption expenditures), `PSAVERT` (personal saving rate), `RSAFS` (retail sales).

---

- Page: https://console.vianexus.com/docs/core/economic-indicators/consumption_monthly
- Category: [Economic Indicators](https://console.vianexus.com/docs/core/economic-indicators)
- Provider: [core](https://console.vianexus.com/docs/core)

Markdown of https://console.vianexus.com/docs/core/economic-indicators/consumption_monthly. Append `.md` to any docs URL.
