Substrate/Data/US-GDP/US-GDP-1929-2025.md

# U.S. Gross Domestic Product (GDP) — 1929-2025

## Dataset Metadata

**Dataset Name**: U.S. Gross Domestic Product (Real GDP)
**Category**: Economic Indicators / National Accounts
**Geographic Coverage**: United States
**Temporal Coverage**:
- Quarterly: Q1 1947 - Q2 2025 (314 data points)
- Annual: 1929 - 2024 (96 data points)

**Data Type**: Real GDP (inflation-adjusted, chained 2017 dollars)
**Format**: CSV (Comma-Separated Values)
**File Encoding**: UTF-8

## Source Information

**Primary Source**: Federal Reserve Economic Data (FRED)
- **Organization**: Federal Reserve Bank of St. Louis
- **URL**: https://fred.stlouisfed.org
- **Data Origin**: U.S. Bureau of Economic Analysis (BEA)

**FRED Series:**
- **GDPC1**: Real Gross Domestic Product (Quarterly)
  - URL: https://fred.stlouisfed.org/series/GDPC1
  - Frequency: Quarterly
  - Seasonal Adjustment: Seasonally Adjusted Annual Rate
  - Units: Billions of Chained 2017 Dollars

- **GDPCA**: Real Gross Domestic Product (Annual)
  - URL: https://fred.stlouisfed.org/series/GDPCA
  - Frequency: Annual
  - Seasonal Adjustment: Not Seasonally Adjusted
  - Units: Billions of Chained 2017 Dollars

**Ultimate Authority**: U.S. Bureau of Economic Analysis (BEA)
- **Organization**: U.S. Department of Commerce
- **URL**: https://www.bea.gov
- **Methodology**: National Income and Product Accounts (NIPA)

## License & Usage Rights

**License**: Public Domain (U.S. Government Data)
**Copyright**: None (U.S. federal government works)
**Attribution**: Recommended but not required
**Restrictions**: None
**Commercial Use**: Permitted

**Suggested Citation**:
```
U.S. Bureau of Economic Analysis, Real Gross Domestic Product [GDPC1],
retrieved from FRED, Federal Reserve Bank of St. Louis;
https://fred.stlouisfed.org/series/GDPC1, October 16, 2025.
```

## Data Quality Assessment

**Reliability**: ⭐⭐⭐⭐⭐ (Highest - Official U.S. Government Statistic)

**Quality Indicators:**
- **Completeness**: 100% (no missing data points)
- **Accuracy**: Official government statistic with rigorous methodology
- **Timeliness**: Quarterly updates with three-stage revision process
- **Transparency**: Full methodology documentation available
- **Reproducibility**: Direct CSV download, public APIs available

**Revision Process:**
1. Advance Estimate (~30 days after quarter end)
2. Second Estimate (~60 days after quarter end)
3. Third Estimate (~90 days after quarter end)
4. Annual Comprehensive Update (September, revises 5+ years)

**Known Limitations:**
- Pre-1947 quarterly data not available from BEA
- Real GDP uses 2017 as base year (updated periodically by BEA)
- Subject to revision as more complete source data becomes available
- Seasonal adjustment may mask short-term fluctuations

## Update Information

**Update Frequency**: Quarterly (after third estimate release)
**Last Updated**: 2025-10-16
**Latest Data Point**:
- Quarterly: Q2 2025: $23,770.976 billion
- Annual: 2024: $23,358.435 billion

**Next Scheduled Update**: After Q3 2025 third estimate (expected late January 2026)

**BEA Release Schedule**:
- All releases at 8:30 AM Eastern Time
- Quarterly: Advance → Second → Third estimates
- Annual: Comprehensive update in September

**How to Update:**
```bash
# Download latest quarterly data
curl -L "https://fred.stlouisfed.org/graph/fredgraph.csv?id=GDPC1" -o Real-GDP-Quarterly-1947-2025.csv

# Download latest annual data
curl -L "https://fred.stlouisfed.org/graph/fredgraph.csv?id=GDPCA" -o Real-GDP-Annual-1929-2024.csv
```

## File Specifications

### Real-GDP-Quarterly-1947-2025.csv

**Columns:**
1. `observation_date` - Date of observation (YYYY-MM-DD format, first day of quarter)
2. `GDPC1` - Real Gross Domestic Product (billions of chained 2017 dollars)

**Row Count**: 314 data rows + 1 header row = 315 total
**Date Range**: 1947-01-01 to 2025-04-01
**Frequency**: Quarterly (Q1, Q2, Q3, Q4)
**Missing Values**: None

**Sample Data:**
```csv
observation_date,GDPC1
1947-01-01,2182.681
1947-04-01,2176.892
1947-07-01,2172.432
...
2025-01-01,23548.210
2025-04-01,23770.976
```

### Real-GDP-Annual-1929-2024.csv

**Columns:**
1. `observation_date` - Date of observation (YYYY-MM-DD format, January 1st of year)
2. `GDPCA` - Real Gross Domestic Product (billions of chained 2017 dollars)

**Row Count**: 96 data rows + 1 header row = 97 total
**Date Range**: 1929-01-01 to 2024-01-01
**Frequency**: Annual
**Missing Values**: None

**Sample Data:**
```csv
observation_date,GDPCA
1929-01-01,1191.124
1930-01-01,1089.785
1931-01-01,1019.977
...
2023-01-01,22723.719
2024-01-01,23358.435
```

## Technical Details

### Measurement Methodology

**What is GDP:**
Gross Domestic Product measures the total value of all final goods and services produced within a country's borders during a specific period.

**Three Approaches:**
1. **Production Approach**: Sum of value added at each production stage
2. **Expenditure Approach**: Sum of consumption + investment + government + net exports
3. **Income Approach**: Sum of all income earned in production

BEA primarily uses expenditure approach: GDP = C + I + G + (X - M)
- C = Personal consumption expenditures
- I = Gross private domestic investment
- G = Government consumption and investment
- X = Exports
- M = Imports

**Real vs Nominal GDP:**
- **Real GDP** (this dataset): Adjusted for inflation using chained 2017 dollars
- **Nominal GDP**: Measured in current prices without inflation adjustment
- Real GDP enables valid comparisons across time periods

**Chained Dollar Method:**
- Uses 2017 as reference year
- "Chained" methodology accounts for changing spending patterns
- More accurate than fixed-weight indexes for long-term analysis
- Base year updated periodically by BEA

**Seasonal Adjustment (Quarterly Only):**
- Removes predictable seasonal patterns
- Allows for clearer trend identification
- Annual data not seasonally adjusted (seasonal effects average out)

### Data Validation

**Verification Checksums:**
```bash
# Quarterly data
md5sum Real-GDP-Quarterly-1947-2025.csv
wc -l Real-GDP-Quarterly-1947-2025.csv  # Should be 315

# Annual data
md5sum Real-GDP-Annual-1929-2024.csv
wc -l Real-GDP-Annual-1929-2024.csv  # Should be 97
```

**Expected Ranges:**
- Quarterly (GDPC1): ~2,000 to ~24,000 billion (1947-2025)
- Annual (GDPCA): ~800 to ~24,000 billion (1929-2024)
- Growth rate: Typically -5% to +10% year-over-year

**Data Integrity Checks:**
1. No missing observation dates
2. All GDP values are positive numbers
3. No duplicate dates
4. Dates in chronological order
5. Quarterly dates align with calendar quarters (01-01, 04-01, 07-01, 10-01)
6. Annual dates all use 01-01

## Historical Context & Key Events

### Major Economic Periods Captured

**Great Depression (1929-1933)**
- GDP fell from $1,191B (1929) to $877B (1933) = -26% decline
- Worst economic contraction in U.S. history
- Led to New Deal policies and economic reforms

**World War II Era (1941-1945)**
- Massive GDP growth driven by war production
- GDP doubled from ~$1,000B to ~$2,000B (nominal)
- Post-war transition and adjustment (1945-1947)

**Post-War Boom (1945-1973)**
- Sustained growth averaging ~4% annually
- Middle class expansion, suburbanization
- "Golden Age of Capitalism"

**Stagflation (1970s-1980s)**
- Slower growth combined with high inflation
- Oil crises (1973, 1979)
- Fed's aggressive inflation-fighting (early 1980s)

**Great Moderation (1990s-2007)**
- Stable growth around 3% annually
- Low inflation, declining volatility
- Tech boom and subsequent bust (2000-2001)

**Great Recession (2007-2009)**
- Financial crisis beginning in 2007-2008
- GDP declined ~4.3% from peak to trough
- Deepest recession since Great Depression
- Slow recovery through 2010s

**COVID-19 Pandemic (2020)**
- Q2 2020: Historic 31.4% annualized decline (largest quarterly decline on record)
- Fastest recession and recovery in U.S. history
- Massive fiscal and monetary stimulus

**Post-Pandemic Period (2021-2025)**
- Strong rebound: 5.8% growth in 2021
- Inflation surge (2021-2023)
- Gradual normalization (2024-2025)

## Use Cases & Applications

### Economic Research
- Long-term growth trend analysis
- Business cycle identification and dating
- Productivity studies
- Economic forecasting models
- Cross-country comparisons (using PPP adjustments)

### Policy Analysis
- Fiscal policy effectiveness evaluation
- Monetary policy impact assessment
- Infrastructure investment justification
- Tax policy modeling
- Government budget planning

### Financial Applications
- Economic scenario analysis
- Portfolio allocation decisions
- Credit risk modeling
- Real asset valuation
- Inflation-adjusted return calculations

### Business Strategy
- Market sizing and TAM calculations
- Demand forecasting
- Long-term strategic planning
- Economic environment assessment
- Competitor analysis context

### Academic Studies
- Macroeconomic research
- Econometric modeling
- Economic history analysis
- Development economics
- Comparative economic systems

### Substrate Integration
- Supporting economic Claims with authoritative data
- Backing Arguments with empirical evidence
- Informing Economic Models and frameworks
- Tracking progress on economic Plans
- Validating Solutions with outcome data

## Related Datasets

**Within Substrate:**
- **US-Inflation** (CPI data): Complementary price-level measurement
- Future additions: Employment, industrial production, trade data

**External Complementary Sources:**
- **BEA Personal Income**: Income components of GDP
- **BEA Corporate Profits**: Profitability trends
- **FRED Employment**: Labor market indicators
- **FRED Interest Rates**: Monetary policy context
- **FRED Consumer Spending**: Largest GDP component

## Research Provenance

**Research Date**: 2025-10-16
**Research Method**: Parallel multi-agent investigation

**Research Agents Deployed**: 10
- perplexity-researcher (4 agents)
- claude-researcher (3 agents)
- gemini-researcher (3 agents)

**Queries Executed**: 20 (10 primary + 10 follow-ups)
**Research Duration**: ~30 seconds (parallel execution)
**Confidence Level**: 95%+ (multi-source corroboration)

**Research Questions Investigated:**
1. Most authoritative US GDP data sources
2. FRED database GDP coverage and date ranges
3. BEA official data access methods
4. Historical GDP earliest measurements
5. Nominal vs Real GDP availability and preferences
6. Data formats and download accessibility
7. GDP measurement methodologies and quality standards
8. International sources comparison
9. Quarterly vs Annual data recommendations
10. Update frequency and data quality standards

**Key Finding**: BEA is the primary official source; FRED provides easiest access to BEA data with identical quality.

## Contact & Support

**Data Issues**: Report to Substrate maintainers
**Source Questions**: Contact BEA or FRED directly
- FRED: stlsFRED@stls.frb.org
- BEA: customerservice@bea.gov

**Methodology Questions**: See BEA NIPA Handbook
- URL: https://www.bea.gov/resources/methodologies/nipa-handbook

---

**Dataset Created**: 2025-10-16
**Maintained By**: Substrate Data Curation
**Last Verified**: 2025-10-16
**Status**: Active, quarterly updates