Federal Surplus or Deficit
Returns the U.S. federal government surplus (positive) or deficit (negative) in billions of dollars. This is calculated as receipts minus outlays.
Data Details
| Attribute | Value |
|---|---|
| Source | U.S. Treasury / FRED |
| Frequency | Monthly |
| Unit | Billions of USD |
| Interpretation | Positive = surplus, Negative = deficit |
Notes
- A negative value indicates a budget deficit (spending exceeds revenue)
- A positive value indicates a budget surplus (revenue exceeds spending)
- This equals
FederalReceipts()minusFederalOutlays()
Examples
Current surplus/deficit in billions
=FederalSurplusOrDeficit()/1000=ABS(FederalSurplusOrDeficit())=IF(FederalSurplusOrDeficit()<0,"Deficit","Surplus")When to Use
- Analyzing the federal budget balance
- Tracking deficit trends over time
- Economic research on fiscal policy
- Comparing government spending to revenue
When NOT to Use
| Scenario | Use Instead |
|---|---|
| Need just receipts | FederalReceipts() |
| Need just outlays | FederalOutlays() |
| Need national debt | FederalDebt() |
Common Issues & FAQ
Q: What does a negative value mean? A: A negative value indicates a budget deficit (spending exceeds revenue).
Q: What does a positive value mean? A: A positive value indicates a budget surplus (revenue exceeds spending).
Q: What unit is the result in? A: Billions of U.S. dollars.
