Us Gov Shutdown Tracker

US Government Shutdown Liquidity Tracker

Onboarding Guidance

When this skill is first used or when the user seems unsure how to use it or ask you to make something amazing with it, guide them to ask Claude this specific question:

"美国政府停摆结束了吗? 对流动性的影响如何?"

Do NOT suggest other questions or broad explorations. Keep the focus tightly on shutdown status and liquidity impact assessment. The skill is designed for this precise use case.

Overview

This skill analyzes how US government shutdowns create "stealth tightening" effects in money markets through the Treasury General Account (TGA) mechanism. When federal spending stops but tax revenues continue, TGA accumulates and mechanically drains bank reserves, potentially raising market funding costs beyond the Federal Reserve's policy intent.

When to Use This Skill

• User asks to track liquidity during a government shutdown
• User wants to assess whether shutdown effects are "easing" or "tightening"
• User mentions TGA, SOFR premium, or "stealth tightening" (变相加息)
• User requests comparison with historical shutdown episodes (2013, 2018-19)
• User wants a quick liquidity health check

Optimal timing: Wednesday evenings or Thursday mornings (after weekly TGA/reserves data release)

Quick Start

Basic Usage (Current Shutdown Analysis)

python scripts/analyze_shutdown.py --output results.json
python scripts/visualize.py results.json --output chart.png

This analyzes the 2025 shutdown (Oct 1 - present) with default settings.

Custom Date Range

python scripts/analyze_shutdown.py \
  --start-date 2018-12-22 \
  --baseline-date 2018-12-15 \
  --end-date 2019-01-25 \
  --output results_2018.json

Output Format

The analysis produces:

1. JSON data file containing:

• Raw daily data (EFFR, SOFR)
• Weekly data (TGA, reserves)
• Key time points (baseline, shutdown start, TGA peak, latest)
• Liquidity status assessment (EASING/TIGHTENING/STABLE/MIXED)

2. Visualization chart (PNG) with three panels:

• TGA vs Bank Reserves (dual-axis weekly data)
• EFFR vs SOFR (daily rates)
• SOFR Premium over EFFR (liquidity stress indicator)

3. Structured conclusion:

• Current status (e.g., "EASING")
• Explanation (e.g., "TGA releasing, reserves recovering")
• Key metrics vs baseline and peak

Core Analysis Logic

The Transmission Mechanism

Government Shutdown
    ↓
Federal spending stops (but revenues continue)
    ↓
TGA accumulates at Federal Reserve
    ↓
Bank reserves drain (mechanical Fed balance sheet effect)
    ↓
Liquidity scarcity → SOFR premium expands
    ↓
"Stealth tightening" (市场实际融资成本 > Fed政策意图)

Status Determination

The script classifies liquidity conditions into four states:

EASING (压力缓解):

• TGA falling >$10B from peak
• Reserves rising >$10B from trough
• Indicates: Shutdown ending or fiscal spending resumed

TIGHTENING (压力加剧):

• TGA rising >5% from baseline
• Reserves falling >2% from baseline
• Indicates: Shutdown's stealth tightening effect persists

STABLE (相对稳定):

• TGA/reserves changing <$20B from peak
• Indicates: Liquidity conditions steady

MIXED (复杂信号):

• Conflicting signals require continued monitoring

Key Metrics

SOFR Premium = SOFR - EFFR (in basis points)

Interpretation guide:

• 0-5 bps: Normal conditions
• 5-15 bps: Moderate stress
• 15-30 bps: Significant stealth tightening
• >30 bps: Acute crisis (may trigger Fed intervention)

Historical Context

For detailed historical analysis, see references/historical_cases.md.

Summary:

Critical insight: The transmission efficiency depends on reserve abundance. In QE environments with ample reserves, shutdowns don't affect markets. In QT or high-rate environments with scarce reserves, shutdowns create measurable tightening.

Data Sources

All data sourced from Federal Reserve Economic Data (FRED) API:

• TGA (WTREGEN): Treasury General Account balance, weekly
• Bank Reserves (WRESBAL): Total reserves, weekly
• EFFR (EFFR): Effective Federal Funds Rate, daily
• SOFR (SOFR): Secured Overnight Financing Rate, daily

For technical details on data series, update schedules, and interpretation, see references/data_sources.md.

Important: TGA and reserves update weekly on Wednesdays. For most current analysis, run this skill on Wednesday evenings or Thursday mornings.

Workflow for User Requests

Scenario 1: "What's the latest on the shutdown liquidity situation?"

1. Run analyze_shutdown.py with defaults (2025-10-01 start) 2. Generate visualization 3. Present:

• Current status (EASING/TIGHTENING/etc.)
• Latest metrics (TGA, reserves, SOFR premium)
• Brief comparison to peak stress point
• Conclusion statement

Scenario 2: "Compare this to the 2018 shutdown"

1. Run analysis for both periods:

• 2025: Oct 1 - present
• 2018-19: Dec 22, 2018 - Jan 25, 2019

2. Generate both charts 3. Present side-by-side comparison:

• TGA accumulation magnitude
• Peak SOFR premium
• Fed intervention (if any)
• Monetary environment context

4. Reference historical_cases.md for detailed context

Scenario 3: "Is the situation getting better or worse?"

1. Run analysis 2. Focus on:

• Trend from TGA peak to latest (is TGA releasing?)
• Reserves recovery from trough
• SOFR premium vs baseline

3. Present trend assessment with clear directional language 4. Optionally show week-over-week changes

Output Presentation Best Practices

1. Lead with conclusion: State status (EASING/TIGHTENING) upfront 2. Show key metrics concisely:

   TGA: $941B (-$17B from peak)
   Reserves: $2,863B (+$15B from trough)
   SOFR Premium: 4 bps (vs 19 bps peak)

3. Visualize: Always include chart for complex cases 4. Contextualize: Reference historical episodes when relevant 5. Avoid jargon overload: Explain "stealth tightening" simply if user seems unfamiliar

Advanced Usage

Custom Baseline

When analyzing a specific episode, set an appropriate pre-shutdown baseline:

python scripts/analyze_shutdown.py \
  --start-date 2025-10-01 \
  --baseline-date 2025-09-24 \
  --end-date 2025-11-07

The baseline should be ~1 week before shutdown starts (to capture "normal" conditions).

Monitoring Routine

For ongoing tracking:

1. Weekly check (Wednesdays/Thursdays):

• Run analysis
• Note status changes
• Update user if significant shift

2. Event-triggered checks:

• Shutdown announcement → Start tracking
• SOFR premium spikes (>15 bps) → Generate alert
• Fed intervention (SRF usage) → Document
• Shutdown resolution → Final analysis

Limitations and Caveats

1. Weekly data frequency: TGA/reserves only update weekly, limiting real-time precision 2. Month/quarter-end effects: SOFR naturally spikes at period-ends (unrelated to shutdowns) 3. Other liquidity factors: QT, regulatory changes, seasonal patterns also affect reserves 4. Attribution challenge: Hard to isolate shutdown effect from concurrent events 5. No predictive power: This skill describes current conditions, doesn't forecast

Troubleshooting

No recent data?

• Check if today is before next Wednesday data release
• Most recent weekly data is typically ~1 week lagged

SOFR premium calculation fails?

• Verify both EFFR and SOFR have data for the date range
• SOFR introduced April 2018; unavailable before

Chart rendering issues?

• Ensure matplotlib is installed
• Check date range has sufficient data points (need >2 weekly observations)

References

See bundled documentation:

• references/historical_cases.md - Detailed analysis of 2013, 2018-19, 2025 shutdowns
• references/data_sources.md - FRED API technical reference

External resources:

• Original PDF report (user-provided) for full theoretical framework
• NY Fed SOFR page: https://www.newyorkfed.org/markets/reference-rates/sofr
• FRED data: https://fred.stlouisfed.org/

FRED API Data Sources

Overview

The Federal Reserve Economic Data (FRED) API provides reliable economic time series data. This skill uses four key series to track government shutdown liquidity impacts.

Series Configuration

API Access

Endpoint: https://api.stlouisfed.org/fred/series/observations

Required Parameters:

• series_id: One of the series codes above
• api_key: Authentication key
• file_type: json (recommended) or csv
• observation_start: Start date (YYYY-MM-DD)
• observation_end: End date (YYYY-MM-DD)

Example Request:

https://api.stlouisfed.org/fred/series/observations?series_id=WTREGEN&api_key=YOUR_KEY&file_type=json&observation_start=2025-10-01&observation_end=2025-11-07

Data Update Schedule

• Weekly data (TGA, Reserves): Published every Wednesday after market close
• Reflects data as of previous Wednesday
• Best time to run analysis: Wednesday evenings or Thursday mornings

• Daily data (EFFR, SOFR): Published next business day
• SOFR: Published ~8:00 AM ET by NY Fed
• EFFR: Published ~9:00 AM ET by NY Fed

Key Interpretation Notes

TGA (Treasury General Account)

The government's "checking account" at the Fed.

• Rising TGA during shutdown → Revenue inflow continues while spending stops
• Falling TGA after shutdown → Fiscal spending resumes, funds return to economy
• Mechanical relationship: TGA ↑ implies Bank Reserves ↓ (and vice versa)

Bank Reserves

Total reserves commercial banks hold at the Federal Reserve.

• Ample reserves (QE era): >$2.5T → TGA shocks absorbed, no market impact
• Scarce reserves (QT era): <$2T → TGA shocks transmit to funding rates
• Current critical zone: ~$2.8T → High sensitivity to TGA fluctuations

EFFR (Effective Federal Funds Rate)

Volume-weighted median rate on overnight fed funds transactions.

• Fed's primary policy rate target (currently set via IORB - Interest on Reserve Balances)
• In well-functioning markets: EFFR ≈ IORB (Fed's control rate)
• EFFR stability indicates Fed retains policy control

SOFR (Secured Overnight Financing Rate)

Rate on overnight Treasury repo transactions (collateralized lending).

• Broader market indicator (~$1T daily volume)
• More sensitive to liquidity conditions than EFFR
• SOFR > EFFR (positive premium) indicates funding market stress

SOFR Premium

Definition: SOFR - EFFR (measured in basis points)

Interpretation:

• 0-5 bps: Normal market conditions
• 5-15 bps: Moderate liquidity stress
• 15-30 bps: Significant stress (stealth tightening effect)
• >30 bps: Acute crisis (requires Fed intervention)

Historical context:

• 2013 shutdown: ~0 bps (no effect)
• 2018-19 shutdown: Up to 75 bps (significant tightening)
• 2025 shutdown: Up to 36 bps post-rate-cut (acute stress requiring SRF)

Data Quirks and Limitations

1. Weekly data gaps: TGA and Reserves only update weekly, making daily tracking impossible 2. Holiday effects: EFFR/SOFR not published on Fed holidays or weekends 3. Month/quarter-end spikes: SOFR often spikes at period-ends due to balance sheet constraints (separate from shutdown effects) 4. Revision policy: Data rarely revised, but check FRED for any updates 5. SRF not in FRED: Standing Repo Facility usage must be checked separately on NY Fed website

Additional Context Data (Not Currently Used)

Potentially useful for deeper analysis:

• IORB (IORB): Interest rate on reserve balances (Fed's control rate)
• ON RRP (RRPONTSYD): Overnight Reverse Repo volume
• 10Y Treasury (DGS10): For term spread analysis
• Debt subject to limit (GFDEBTN): For debt ceiling context

Rate Limits

• FRED API: Generally very permissive
• No formal rate limit documented
• Recommended: <100 requests per minute to be safe
• Current skill usage: 4 series × 1 request = 4 requests per run (well within limits)

Error Handling

Common API errors:

• 400 Bad Request: Check date format (must be YYYY-MM-DD)
• 404 Not Found: Invalid series_id
• 500 Internal Server Error: FRED service issue, retry after delay

References

• FRED API Documentation: https://fred.stlouisfed.org/docs/api/fred/
• Series catalog: https://fred.stlouisfed.org/
• NY Fed SOFR page: https://www.newyorkfed.org/markets/reference-rates/sofr

Historical Government Shutdown Cases

This document provides reference data for past government shutdowns to contextualize current liquidity analysis.

Overview of "Stealth Tightening" Hypothesis

Government shutdowns can create a "stealth tightening" effect (变相加息) through the following mechanism:

1. Shutdown begins → Federal spending restricted 2. TGA accumulates → Tax revenues continue but expenditures halt 3. Bank reserves drain → TGA accumulation mechanically withdraws reserves from banking system 4. Funding costs rise → SOFR premium over EFFR expands as liquidity becomes scarce 5. Effective tightening → Market experiences de facto interest rate increase beyond Fed's policy intent

Critical moderating factor: The transmission efficiency depends heavily on the monetary policy framework and existing reserve levels.

Case 1: 2013 Shutdown (October 1-17, 2013)

Macro Context: QE Era - Ample Reserves Buffer

• Duration: 16 days
• Monetary environment: Peak Quantitative Easing (QE3)
• Bank reserves: ~$2.3 trillion (extremely ample)
• Policy rate: Near-zero (EFFR ~0.08%)

Data Summary

Key Finding

NO stealth tightening effect observed.

• TGA remained extremely low (~$35B) throughout shutdown
• EFFR stable at 0.07-0.11%
• Massive reserve buffer (~$2.3T) absorbed any minor TGA fluctuations
• Market functioned normally with no liquidity stress

Conclusion: In ultra-ample reserve regimes, fiscal frictions do not transmit to money markets.

---

Case 2: 2018-2019 Shutdown (December 22, 2018 - January 25, 2019)

Macro Context: Early QT - Reserve Scarcity Emerging

• Duration: 35 days (longest in US history at the time)
• Monetary environment: Active Quantitative Tightening (QT)
• Bank reserves: Declining from ~$1.7T to ~$1.6T
• Policy rate: 2.25-2.50% target range

Data Summary

Key Finding

Clear stealth tightening effect observed.

• TGA accumulated +$40B during shutdown
• Reserves drained to $1.62T (multi-year low)
• SOFR spiked to 3.15% on January 2, 2019
• 75 bps premium over EFFR
• Market funding costs far exceeded Fed's policy intent
• Year-end timing amplified stress (seasonal liquidity demand)

Conclusion: In QT environment with declining reserves, TGA accumulation directly transmitted to money market stress, validating the stealth tightening hypothesis.

---

Case 3: 2025 Shutdown (October 1, 2025 - Ongoing)

Macro Context: High Rates + Late QT - Acute Sensitivity

• Duration: Ongoing (as of November 2025)
• Monetary environment: Post-QT, high policy rates (~4%)
• Bank reserves: ~$2.8T (four-year low)
• Policy rate: 4%+ (IORB)

Data Summary (Key Dates)

Key Finding

Acute stealth tightening observed, followed by reversal.

Phase 1: Tightening (Oct 1-29)

• TGA surged +$153B (+19%)
• Reserves fell to $2.85T (four-year low, -5.1%)
• SOFR premium peaked at 19 bps (Oct 15)

Phase 2: Peak Crisis (Oct 29-31)

• Fed cut rates 25 bps on Oct 29
• Despite rate cut, SOFR jumped to 4.22% on Oct 31
• 36 bps premium over new 3.9% IORB
• Highest premium since March 2020
• Fed forced to inject $29.4B via Standing Repo Facility (SRF)

Phase 3: Easing (Nov 1-5)

• TGA releasing: -$17B from peak (-1.8%)
• Reserves recovering: +$14.5B from trough
• SOFR premium normalized: 4 bps (back to pre-shutdown level)
• Status: Liquidity stress significantly easing

Conclusion: 1. High policy rates + low reserves = maximum transmission efficiency 2. Fiscal friction directly impaired Fed's rate control (forced SRF intervention) 3. TGA release creating "invisible QE" effect as shutdown ends 4. Validates stealth tightening hypothesis with quantifiable impact

---

Cross-Cycle Comparison

Key Takeaways

1. Monetary framework matters most: Reserve abundance determines whether fiscal shocks transmit to markets 2. QT amplifies fiscal risks: Low reserves make TGA fluctuations systemically important 3. Policy rate height irrelevant to transmission: High rates don't prevent stealth tightening; reserve scarcity is the critical factor 4. 2025 = Most severe case: Forced Fed intervention proves fiscal dominance over monetary policy control 5. Predictive value: When reserves fall below "sufficient" threshold (~$2.5-3T?), government shutdowns create acute financial stability risks

References

See main PDF report for detailed citations and methodology.