Part 4: GDP & Growth Indicators — Track Economic Growth in Real Time

Use Cases at a Glance

BEA API Setup

The Bureau of Economic Analysis (BEA) publishes all official GDP data. Registration is free and gives you access to the NIPA (National Income and Product Accounts) dataset.

1. Go to apps.bea.gov/api/signup
2. Register with your email
3. Generate API key
4. Store as environment variable: BEA_API_KEY

Key BEA dataset: NIPA (National Income and Product Accounts)

• TableName: T10101 (GDP and Major Components)
• Series IDs:
  • A191RL1Q225SBEA — Real GDP, Percent Change
  • A191RL1Q225SBEA for QoQ annualized growth
  • A191RC1Q225SBEA — Real PCE (Personal Consumption Expenditures)
  • A191RX1Q225SBEA — Net Exports contribution

Simpler approach: Use FRED for GDP and PCE data. FRED mirrors BEA releases with a short lag. FRED series: A191RL1Q225SBEA (real GDP annualized growth), DPCCRG3M086SBEA (PCE).

GDPNow Real-Time Tracking

The Atlanta Federal Reserve publishes GDPNow — a real-time estimate of quarterly GDP that updates 2-3 times per week as new economic data comes in.

Why it matters: GDPNow gives you a running estimate of what GDP will be for the current quarter without waiting 4 weeks for the official Advance estimate. Early in the quarter, it's volatile. By quarter-end, it converges toward the official number.

How to fetch it: GDPNow is published at atlantafed.org/cgi-bin/beamod/gp10.aspx as an HTML page. Use HTTP fetch and parse the current estimate number, update date, and components (consumption, investment, government, net exports).

GDPNow tracking example:
- Update frequency: Tuesday, Thursday, occasionally Friday (2-3x/week)
- Store in time-series for quarter: [date, estimate_pct, PCE_contrib, GPDI_contrib, govt_contrib, NX_contrib]
- Display in weekly dashboard as: "GDPNow Q1 2026: +2.1% (as of March 24, updated daily)"

Quarterly GDP Release Brief

The BEA releases three GDP estimates for each quarter, spaced about 4-5 weeks apart:

• Advance estimate: ~4 weeks after quarter-end, most market-moving
• Second estimate: ~8 weeks after quarter-end, incorporates more complete data
• Third (final) estimate: ~12 weeks after quarter-end

Pre-release brief (morning of Advance estimate):

• Prior quarter's final GDP reading
• GDPNow current estimate going into release
• What consensus expects (optional — this data isn't easily automated)
• Components to watch: Personal Consumption is ~70% of GDP, so watch PCE closely

Post-release brief (8:35 AM following release):

• Actual GDP reading (annualized % change)
• Prior quarter final (for trend)
• Beat/miss vs GDPNow estimate
• Components breakdown: PCE, Business Investment (GPDI), Government, Net Exports
• Recession flag check: if this is the 2nd consecutive quarter of negative growth, flag as "TECHNICAL RECESSION SIGNAL"
• Classification: Moderate (2-3%), Healthy (3-4%), Strong (>4%)

Retail Sales Monitor

Retail sales data comes from the Census Bureau and signals consumer spending health. Retail sales release monthly.

Alert if MoM retail sales decline two consecutive months — this often precedes weakening consumer spending and slowing GDP growth. Retail sales represent a leading indicator for PCE (the consumer spending component of GDP).

Recession Detection

Technical definition: Two consecutive quarters of negative real GDP growth. This is NOT the official NBER definition (which is more nuanced), but it's a useful technical signal.

Implementation:

1. Track quarterly real GDP growth rates (current quarter vs prior quarter, annualized)
2. If current quarter is negative AND prior quarter was negative: fire "TECHNICAL RECESSION SIGNAL" alert
3. Include note: "This is a technical indicator. Official recession designation comes from NBER, which uses a broader definition and often dates recessions months or years after they begin."

Growth Trend Analysis

Beyond single quarters, track multi-quarter trends:

• Average growth last 4 quarters: Is trend accelerating or decelerating?
• Component divergence: If consumer spending (PCE) is strong but business investment (GPDI) is weak, it signals unequal recovery
• Potential growth estimate: Long-term US potential real GDP growth is roughly 2-2.5%. Are we above or below trend?

HEARTBEAT Schedule

# GDPNow update (2-3x per week, Tue/Thu typical)
0 9 * * 2,4 — Tuesday and Thursday 9 AM: check GDPNow for updates

# Quarterly GDP release (Advance estimate)
0 8 [gdp_release_dates] * * — Morning of GDP Advance release: pre-brief

# GDP post-release
35 8 [gdp_release_dates] * * — 8:35 AM: full post-release GDP brief

# Mid-month retail sales check
0 11 15 * * — 15th of month at 11 AM: check for retail sales release

Sample Quarterly GDP Brief

FAQ

How is GDPNow different from the official GDP release?

The official GDP estimate from the BEA releases quarterly — typically the last week of the month following the end of a quarter. GDPNow is the Atlanta Fed's real-time tracking estimate that updates 2-3 times per week as new economic data comes in throughout the quarter. It's not a forecast of what GDP will be — it's an estimate of what GDP *is* based on data already available. The two often diverge significantly early in the quarter and converge as more data accumulates.

How is a recession technically defined?

The most common definition used in the US is two consecutive quarters of negative real GDP growth. However, the official arbiter of US recessions is the NBER (National Bureau of Economic Research), which uses a broader definition including income, employment, and production data — and often calls recessions months or years after they begin. The agent flags two consecutive negative GDP quarters as a recession signal, while noting this is an informal indicator; NBER dating is the official standard.

What is the advance GDP estimate vs revised?

The BEA releases three GDP estimates for each quarter: the Advance estimate (first release, about 4 weeks after quarter ends, most market-moving), the Second estimate (about 8 weeks after), and the Third estimate (about 12 weeks after). Each revision incorporates more complete data. The Advance estimate often moves markets because it's the first read. The agent monitors all three but flags the Advance estimate most prominently.