data-analyst-mcp 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/README.md +262 -262
  2. package/dist/report/method_audit.js +7 -1
  3. package/dist/report/method_audit.js.map +1 -1
  4. package/dist/report/scan_secrets.d.ts +4 -1
  5. package/dist/report/scan_secrets.js +36 -5
  6. package/dist/report/scan_secrets.js.map +1 -1
  7. package/dist/server.d.ts +1 -1
  8. package/dist/server.js +3 -2
  9. package/dist/server.js.map +1 -1
  10. package/guide/WORKFLOW.md +134 -134
  11. package/guide/assets/disclaimer.txt +1 -1
  12. package/guide/assets/download_data.ps1 +162 -162
  13. package/guide/assets/report_template.html +597 -597
  14. package/guide/references/routing.md +171 -171
  15. package/guide/references/style_guide.md +398 -398
  16. package/package.json +56 -56
  17. package/packs/acf/endpoints.json +114 -114
  18. package/packs/acf/policy.json +104 -104
  19. package/packs/actuaries/endpoints.json +82 -82
  20. package/packs/actuaries/policy.json +109 -109
  21. package/packs/bea/assets/download_bea.ps1 +182 -182
  22. package/packs/bea/docs/bea_api.md +461 -461
  23. package/packs/bea/docs/datasets.md +157 -157
  24. package/packs/bea/docs/report_patterns.md +112 -112
  25. package/packs/bea/policy.json +170 -170
  26. package/packs/bea/source.md +152 -152
  27. package/packs/bls/assets/download_bls.ps1 +152 -152
  28. package/packs/bls/docs/analysis_patterns.md +108 -108
  29. package/packs/bls/docs/bls_api.md +73 -73
  30. package/packs/bls/docs/series_ids.md +149 -149
  31. package/packs/bls/policy.json +238 -238
  32. package/packs/bts/endpoints.json +346 -346
  33. package/packs/bts/policy.json +94 -94
  34. package/packs/cdc/endpoints.json +197 -197
  35. package/packs/cdc/policy.json +83 -83
  36. package/packs/census/endpoints.json +99 -99
  37. package/packs/cfpb/endpoints.json +326 -326
  38. package/packs/cfpb/policy.json +119 -119
  39. package/packs/clinical-trials/endpoints.json +166 -166
  40. package/packs/clinical-trials/policy.json +84 -84
  41. package/packs/cms/endpoints.json +69 -69
  42. package/packs/cms/policy.json +96 -96
  43. package/packs/college-scorecard/endpoints.json +252 -252
  44. package/packs/college-scorecard/policy.json +106 -106
  45. package/packs/congress/endpoints.json +1701 -1701
  46. package/packs/congress/policy.json +117 -117
  47. package/packs/dhs-ohss/endpoints.json +66 -66
  48. package/packs/dhs-ohss/policy.json +107 -107
  49. package/packs/doj-news/endpoints.json +59 -59
  50. package/packs/doj-news/policy.json +96 -96
  51. package/packs/dol/endpoints.json +817 -817
  52. package/packs/dol/policy.json +135 -135
  53. package/packs/eia/endpoints.json +717 -717
  54. package/packs/eia/policy.json +112 -112
  55. package/packs/epa/endpoints.json +291 -291
  56. package/packs/epa/policy.json +99 -99
  57. package/packs/epa-aqs/endpoints.json +173 -173
  58. package/packs/epa-aqs/policy.json +96 -96
  59. package/packs/fbi/endpoints.json +1841 -1841
  60. package/packs/fbi/policy.json +118 -118
  61. package/packs/fda/endpoints.json +237 -237
  62. package/packs/fda/policy.json +121 -121
  63. package/packs/fdic/endpoints.json +416 -416
  64. package/packs/fdic/policy.json +83 -83
  65. package/packs/fec/endpoints.json +707 -707
  66. package/packs/fec/policy.json +93 -93
  67. package/packs/fed-board/endpoints.json +89 -89
  68. package/packs/fed-board/policy.json +136 -136
  69. package/packs/federal-register/endpoints.json +143 -143
  70. package/packs/federal-register/policy.json +86 -86
  71. package/packs/fema/endpoints.json +645 -645
  72. package/packs/fema/policy.json +103 -103
  73. package/packs/fhfa/endpoints.json +105 -105
  74. package/packs/fhfa/policy.json +109 -109
  75. package/packs/fred/assets/download_fred.ps1 +122 -122
  76. package/packs/fred/docs/analysis_patterns.md +124 -124
  77. package/packs/fred/docs/fred_api.md +94 -94
  78. package/packs/fred/docs/series.md +188 -188
  79. package/packs/fred/policy.json +253 -253
  80. package/packs/fsa/endpoints.json +150 -150
  81. package/packs/fsa/policy.json +99 -99
  82. package/packs/govinfo/endpoints.json +519 -519
  83. package/packs/gsa-calc/endpoints.json +93 -93
  84. package/packs/gsa-calc/policy.json +97 -97
  85. package/packs/hud/endpoints.json +146 -146
  86. package/packs/hud/policy.json +84 -84
  87. package/packs/ipums/docs/report_patterns.md +117 -117
  88. package/packs/irs-soi/endpoints.json +114 -114
  89. package/packs/irs-soi/policy.json +107 -107
  90. package/packs/medicaid/endpoints.json +412 -412
  91. package/packs/medicaid/policy.json +108 -108
  92. package/packs/naep/endpoints.json +217 -217
  93. package/packs/naep/policy.json +100 -100
  94. package/packs/nhtsa/endpoints.json +132 -132
  95. package/packs/nhtsa/policy.json +93 -93
  96. package/packs/nih/endpoints.json +452 -452
  97. package/packs/nih/policy.json +86 -86
  98. package/packs/noaa/endpoints.json +431 -431
  99. package/packs/noaa/policy.json +95 -95
  100. package/packs/nrel/endpoints.json +327 -327
  101. package/packs/nrel/policy.json +96 -96
  102. package/packs/nws/endpoints.json +271 -271
  103. package/packs/nws/policy.json +82 -82
  104. package/packs/nyfed/endpoints.json +80 -80
  105. package/packs/nyfed/policy.json +92 -92
  106. package/packs/omb/endpoints.json +460 -460
  107. package/packs/omb/policy.json +106 -106
  108. package/packs/open-payments/endpoints.json +297 -297
  109. package/packs/open-payments/policy.json +101 -101
  110. package/packs/opm/assets/download_opm.ps1 +125 -125
  111. package/packs/opm/docs/fields.md +184 -184
  112. package/packs/opm/docs/opm_api.md +71 -71
  113. package/packs/opm/docs/report_patterns.md +83 -83
  114. package/packs/opm/lib/data_dictionary.csv +73 -73
  115. package/packs/pbgc/endpoints.json +483 -483
  116. package/packs/pbgc/policy.json +94 -94
  117. package/packs/philfed/endpoints.json +85 -85
  118. package/packs/philfed/policy.json +94 -94
  119. package/packs/regulations/endpoints.json +287 -287
  120. package/packs/regulations/policy.json +86 -86
  121. package/packs/sec/endpoints.json +236 -236
  122. package/packs/sec/policy.json +86 -86
  123. package/packs/senate-lobbying/endpoints.json +553 -553
  124. package/packs/senate-lobbying/policy.json +99 -99
  125. package/packs/snapqc/endpoints.json +1426 -1426
  126. package/packs/snapqc/policy.json +92 -92
  127. package/packs/treasury/catalog.json +2267 -2267
  128. package/packs/treasury/docs/api_guide.md +245 -245
  129. package/packs/treasury/docs/datasets.md +56 -56
  130. package/packs/treasury/docs/report_patterns.md +126 -126
  131. package/packs/treasury/policy.json +159 -159
  132. package/packs/treasury/source.md +170 -165
  133. package/packs/treasury-yields/endpoints.json +226 -226
  134. package/packs/treasury-yields/policy.json +86 -86
  135. package/packs/usaspending/endpoints.json +1315 -1315
  136. package/packs/usaspending/policy.json +109 -109
  137. package/packs/usda-fna/policy.json +133 -133
  138. package/packs/usda-fooddata/endpoints.json +180 -180
  139. package/packs/usda-fooddata/policy.json +94 -94
  140. package/packs/usda-nass/endpoints.json +323 -323
  141. package/packs/usda-nass/policy.json +95 -95
  142. package/packs/usda-outlook/endpoints.json +86 -86
  143. package/packs/usda-outlook/policy.json +109 -109
  144. package/packs/usgs/endpoints.json +313 -313
  145. package/packs/usgs/policy.json +95 -95
  146. package/packs/usitc/endpoints.json +74 -74
  147. package/packs/usitc/policy.json +111 -111
  148. package/packs/uspto/endpoints.json +141 -141
  149. package/packs/uspto/policy.json +95 -95
  150. package/packs/va/endpoints.json +414 -414
  151. package/packs/va/policy.json +101 -101
  152. package/packs/world-bank/endpoints.json +122 -122
  153. package/packs/world-bank/policy.json +101 -101
@@ -1,188 +1,188 @@
1
- # FRED series for budget and economic analysis
2
-
3
- Every ID below was checked to exist on 2026-10-20 (titles, units, frequency and adjustment as FRED shows
4
- them). FRED edits titles and adds series; confirm with the `request_schema` search `describe <IDs>` before downloading, and
5
- read the title back against the concept. Copyright tags were read on the series page only where marked ✔;
6
- read the page for the others before sharing data.
7
-
8
- Contents: 1. Output and potential · 2. Prices · 3. Labor · 4. Interest rates · 5. The federal budget ·
9
- 6. Income and other · 7. Recessions · 8. States and areas · 9. Finding a series you do not know
10
-
11
- ## 1. Output and potential output
12
- | ID | What | Units, frequency | Notes |
13
- |---|---|---|---|
14
- | `GDP` | Gross domestic product | Billions of dollars, quarterly, SAAR | Nominal; the denominator for shares of GDP (average the 4 quarters of a fiscal year) |
15
- | `GDPA` | GDP, annual | Billions of dollars, annual | Calendar year; the denominator of FRED's FY*GDA188S ratios |
16
- | `FYGDP` | GDP, fiscal year (OMB) | Billions of dollars, annual, fiscal year (dated Sep 30) | OMB's figure from its latest budget; lags BEA revisions. The mean of the four quarters of `GDP` is the current-vintage alternative |
17
- | `GDPC1` | Real GDP | Billions of chained 2017 dollars, quarterly, SAAR | BEA; Public Domain ✔ |
18
- | `A191RL1Q225SBEA` | Real GDP, percent change from preceding period | Percent, quarterly, SAAR | BEA's published growth rate: the benchmark for an annualized growth rate computed from `GDPC1` |
19
- | `A939RX0Q048SBEA` | Real GDP per capita | Chained 2017 dollars, quarterly, SAAR | |
20
- | `GDPPOT` | Real potential GDP (CBO) | Billions of chained 2017 dollars, quarterly, NSA | CBO; Public Domain ✔; **projected ~10 years ahead**; last updated with CBO's latest outlook, so it may rest on an older GDP vintage than GDPC1 |
21
- | `NGDPPOT` | Nominal potential GDP (CBO) | Billions of dollars, quarterly | Projections as above |
22
- | `NROU` | Noncyclical rate of unemployment (CBO) | Percent, quarterly | Projections as above |
23
- | `GDPDEF` | GDP implicit price deflator | Index 2017=100, quarterly, SA | |
24
-
25
- Output gap = `GDPC1 / GDPPOT - 1` (both chained 2017 dollars), on dates both have (join on date; stop at the last date both series hold).
26
-
27
- ## 2. Prices
28
- | ID | What | Units, frequency | Notes |
29
- |---|---|---|---|
30
- | `PCEPI` | PCE price index | Index 2017=100, monthly, SA | The measure in the Federal Reserve's 2 percent objective; CBO projects it alongside the CPI-U |
31
- | `PCEPILFE` | Core PCE price index | Index 2017=100, monthly, SA | |
32
- | `CPIAUCSL` | CPI-U, all items | Index 1982-84=100, monthly, SA | Monthly changes |
33
- | `CPIAUCNS` | CPI-U, all items | Index 1982-84=100, monthly, NSA | 12-month changes as BLS reports them; annual averages |
34
- | `CPILFENS` | Core CPI-U, not seasonally adjusted (12-month changes) | Index 1982-84=100, monthly, NSA | |
35
- | `CPILFESL` | Core CPI-U | Index 1982-84=100, monthly, SA | |
36
- | `CWUR0000SA0` | CPI-W, all items | Index 1982-84=100, monthly, NSA | Social Security COLA: average of July-September over the same quarter a year earlier |
37
- | `SUUR0000SA0` | Chained CPI-U (C-CPI-U) | Index Dec 1999=100, monthly, NSA | Tax-bracket indexing; preliminary for 10-12 months |
38
- | `T10YIE` | 10-year breakeven inflation | Percent, daily | Market-based expectation (10-year nominal minus 10-year TIPS yield) |
39
- | `T5YIE` | 5-year breakeven inflation | Percent, daily | 5-year nominal minus 5-year TIPS yield; monthly averages `T5YIEM` |
40
- | `T5YIFR` | 5-year, 5-year forward inflation expectation | Percent, daily | (((1+b10/100)^10/(1+b5/100)^5)^(1/5)-1)*100 from the 10- and 5-year breakevens; monthly `T5YIFRM` |
41
- | `UMCSENT` | University of Michigan consumer sentiment | Index 1966:Q1=100, monthly, NSA | **Posted on FRED one month late** at UMich's request: the latest final and preliminary months are on sca.isr.umich.edu (save them in published/). UMich moved from phone to web interviews in 2024, which shifts levels |
42
-
43
- ## 3. Labor
44
- | ID | What | Units, frequency |
45
- |---|---|---|
46
- | `UNRATE` | Unemployment rate | Percent, monthly, SA |
47
- | `PAYEMS` | All employees, total nonfarm | Thousands, monthly, SA |
48
- | `CIVPART` | Labor force participation rate | Percent, monthly, SA |
49
- | `CNP16OV` | Civilian noninstitutional population 16+ | Thousands, monthly, NSA |
50
- | `CES0500000003` | Average hourly earnings, total private | Dollars per hour, monthly, SA |
51
- | `ECIWAG` | ECI, wages and salaries, private industry | Index Dec 2005=100, quarterly, SA |
52
-
53
- For more detail on BLS series (demographic groups, industries, significance), the bls pack is the
54
- better tool; FRED mirrors the same data.
55
-
56
- ## 4. Interest rates
57
- | ID | What | Units, frequency |
58
- |---|---|---|
59
- | `DFEDTARU` / `DFEDTARL` | Federal funds target range, upper / lower limit (FOMC) | Percent, daily (steps on decision dates). "Cut since the peak": when the path reverses, report the net change and the gross cuts separately (2024-2026: 1.75 points of cuts, 1.50 net after a 2026 raise); the Board's Open Market Operations table is the benchmark |
60
- | `FEDFUNDS` | Effective federal funds rate | Percent, monthly average |
61
- | `DFF` | Effective federal funds rate | Percent, daily (7-day) |
62
- | `DGS10` | 10-year Treasury constant-maturity yield | Percent, daily (business days; gaps on holidays) |
63
- | `GS10` | 10-year Treasury yield | Percent, monthly average |
64
- | `TB3MS` | 3-month Treasury bill, secondary market | Percent, monthly (discount basis) |
65
- | `MORTGAGE30US` | 30-year fixed mortgage rate (Freddie Mac) | Percent, weekly ending Thursday |
66
- | `T10Y2Y` / `T10Y2YM` | 10-year minus 2-year Treasury spread (curve inversion when negative) | Percentage points, daily / monthly average |
67
- | `T10Y3M` | 10-year minus 3-month Treasury spread | Percentage points, daily |
68
-
69
- Use the monthly averages (GS10, TB3MS) for annual or fiscal-year averages; CBO's interest-rate projections
70
- are calendar- or fiscal-year averages of these rates.
71
-
72
- ## 5. The federal budget
73
- | ID | What | Units, frequency | Notes |
74
- |---|---|---|---|
75
- | `FYFR` | Federal receipts (revenues) | Millions of dollars, annual, **fiscal year** | OMB/Treasury; dated Sep 30 |
76
- | `FYONET` | Federal net outlays | Millions of dollars, annual, fiscal year | |
77
- | `FYFSD` | Federal surplus or deficit (negative = deficit) | Millions of dollars, annual, fiscal year | |
78
- | `FYOINT` | Federal outlays: interest | Millions of dollars, annual, fiscal year | OMB, Public Domain ✔. OMB's net interest (budget function 900, matches OMB Historical Table 3.1): $970.1 billion in FY2025. CBO's Monthly Budget Review reports "net interest on the public debt" above $1 trillion for FY2025, a different budget category; say which one the text means and benchmark it against its own source |
79
- | `FYFSGDA188S` | Surplus or deficit as percent of GDP | Percent of GDP, annual (fiscal year, dated Jan 1) | |
80
- | `FYOIGDA188S` | Interest outlays as percent of GDP | Percent of GDP, annual (fiscal year, dated Jan 1) | Benchmark only: divides by calendar-year GDP (GDPA), not fiscal-year GDP |
81
- | `FYGFDPUN` | Federal debt held by the public | Millions of dollars, quarterly, end of period | |
82
- | `FYGFGDQ188S` | Debt held by the public as percent of GDP | Percent of GDP, quarterly, SA | |
83
- | `GFDEBTN` | Total public debt | Millions of dollars, quarterly, end of period | Includes intragovernmental debt: not "debt held by the public" |
84
- | `GFDEGDQ188S` | Total public debt as percent of GDP | Percent of GDP, quarterly, SA | |
85
- | `A091RC1Q027SBEA` | Federal interest payments (NIPA) | Billions of dollars, quarterly, SAAR | National-accounts basis, not budget basis |
86
- | `W006RC1Q027SBEA` | Federal current tax receipts (NIPA) | Billions of dollars, quarterly, SAAR | NIPA basis |
87
- | `FGEXPND` | Federal current expenditures (NIPA) | Billions of dollars, quarterly, SAAR | NIPA basis |
88
-
89
- Budget-basis (OMB/Treasury, fiscal year) and NIPA-basis (BEA, calendar quarters) measures differ in timing and
90
- coverage; never mix them in one ratio without saying so. For CBO's own baseline projections and historical
91
- budget data, use CBO's data files (cbo.gov), not FRED.
92
-
93
- ## 6. Income and other
94
- | ID | What | Units, frequency |
95
- |---|---|---|
96
- | `PCE` | Personal consumption expenditures | Billions of dollars, monthly, SAAR |
97
- | `DSPIC96` | Real disposable personal income | Billions of chained 2017 dollars, monthly, SAAR |
98
- | `PSAVERT` / `A072RC1Q156SBEA` | Personal saving rate (NIPA Table 2.6 / 2.1 line 35) | Percent of disposable income, monthly / quarterly |
99
- | `MEHOINUSA672N` | Real median household income (Census) | Dollars of the latest year (C-CPI-U), annual |
100
- | `SP500` | S&P 500 index | Index, daily; **Copyrighted: Pre-Approval Required** ✔ (only 10 years on FRED) |
101
-
102
- **International trade** (the Census/BEA monthly release, FT-900, mirrored keyless; BEA's ITA needs a key)
103
- | ID | What | Units, frequency |
104
- |---|---|---|
105
- | `BOPGSTB` / `BOPGTB` / `BOPSTB` | Trade balance: goods and services / goods / services, balance of payments basis | Millions of dollars, monthly, SA |
106
- | `BOPTEXP` / `BOPTIMP` | Exports / imports of goods and services, BOP basis | Millions of dollars, monthly, SA |
107
- | `EXPCH` / `IMPCH` | Goods exports to / imports from China, Census basis (other partners: EXP / IMP + country code) | Millions of dollars, monthly, NSA |
108
-
109
- Annual totals are sums of the months; the June annual revision replaces the first-published year. Partner
110
- balances are on the Census basis, as the release gives them.
111
-
112
- ## 4b. Money stock (Federal Reserve H.6, monthly)
113
- `M2SL` M2 (billions of dollars, SA), `M1SL` M1, `M2NS` M2 not adjusted, `WM2NS` weekly M2. The H.6 has not
114
- published growth rates since February 2021: 12-month growth is computed from levels (`pc1`), and the H.6
115
- data file is the level benchmark.
116
-
117
- ## 5a. Industrial production and capacity utilization (Federal Reserve G.17, monthly)
118
- `INDPRO` industrial production, total (index 2017=100), `IPMAN` manufacturing; `TCU` capacity
119
- utilization, total (percent), `MCUMFN` manufacturing (metadata checked on 2026-10-21). The
120
- latest months are preliminary and revised for several months. G.17 states the gap to the long-run
121
- average as the difference of its one-decimal rates (76.9 - 79.4 = 2.5 points below): compute it the
122
- same way to match, and show the unrounded gap as a sensitivity.
123
-
124
- ## 5c. Housing starts and permits (Census New Residential Construction, monthly)
125
- `HOUST` total starts, `HOUST1F` single-family, `PERMIT` permits (thousands of units, SAAR; metadata checked
126
- on 2026-10-21); `HOUSTNSA` not adjusted. The latest month is preliminary and revised twice.
127
- An annual total from FRED sums rounded months: Census's annual sheet sums unrounded estimates (0.1 apart).
128
-
129
- ## 5b. Unemployment insurance claims (DOL, weekly)
130
- `ICSA` initial claims (SA), `IC4WSA` 4-week moving average (SA), `ICNSA` (NSA), `CCSA` continued claims.
131
- Weeks end on Saturday; the latest week is an advance figure (preliminary). The keyless route when the dol
132
- pack has no key. A calendar-year average needs all the weeks of the year (count them; never average a
133
- partial year).
134
-
135
- ## 6a. Household debt service (Federal Reserve DSR release)
136
- Quarterly, percent of disposable personal income: `TDSP` total, `MDSP` mortgage, `CDSP` consumer debt
137
- service. The Fed rebuilt the series on credit-bureau data in 2024: its levels are about 2.5 points above the
138
- archived lender-based series (2007 Q4 15.8 against 13.3), so never mix the two; the latest quarter is
139
- preliminary. Benchmark: federalreserve.gov/releases/dsr.
140
-
141
- ## 6b. Federal Reserve balance sheet (H.4.1)
142
- Weekly, millions of dollars (metadata checked on 2026-10-21). Wednesday levels: `WALCL` total
143
- assets, `TREAST` Treasury securities held outright, `WSHOMCB` mortgage-backed securities, `WSHOSHO` all
144
- securities held outright, `WLRRAL` reverse repurchase agreements (liability). Week averages (not Wednesday
145
- levels; do not mix with the above): `WRESBAL` reserve balances, `WTREGEN` Treasury General Account.
146
- `RRPONTSYD` overnight reverse repos is daily and in billions. Changes between two weeks are differences of
147
- published levels, not published figures: say so in benchmark.csv. Other assets (premiums, loans, the
148
- rest) are total minus the securities.
149
-
150
- ## 6d. House prices and the international investment position
151
- | ID | What | Units, frequency | Notes |
152
- |---|---|---|---|
153
- | `CSUSHPINSA`, `CSUSHPISA` | S&P CoreLogic Case-Shiller U.S. National home price index, NSA / SA | Index Jan 2000=100, monthly, two months' lag | `copyright` preapproval_required: say the values may not be republished; S&P's release leads with NSA 12-month changes |
154
- | `USSTHPI` | FHFA all-transactions house price index, U.S. | Index 1980:Q1=100, quarterly | Public domain |
155
- | `IIPUSNETIQ`, `IIPUSNETIA` | U.S. net international investment position (BEA), quarterly / annual | Millions of dollars | The keyless route to BEA's IIP (the BEA pack needs a key for IIP); preliminary for the latest quarter |
156
-
157
- ## 6c. Exchange rates (Federal Reserve H.10)
158
- | ID | What | Units, frequency | Notes |
159
- |---|---|---|---|
160
- | `DTWEXBGS` | Nominal broad dollar index (trade-weighted, 26 currencies) | Index Jan 2006=100, daily | The Fed's headline dollar index; checked against H.10 [2026-10-22] |
161
- | `TWEXBGSMTH` | Nominal broad dollar index, monthly average | Index Jan 2006=100, monthly | A year-to-date change can differ in sign between daily end points and monthly averages: say which |
162
- | `RTWEXBGS` | Real broad dollar index | Index Jan 2006=100, monthly | Adjusted for relative consumer prices |
163
- | `DEXUSEU`, `DEXJPUS`, `DEXCHUS`, `DEXCAUS`, `DEXMXUS` | Bilateral rates: dollars per euro; yen, yuan, Canadian dollars, pesos per dollar | daily | Mind the quote direction (US per foreign for the euro) |
164
-
165
- ## 7. Recessions
166
- `USREC` (monthly; FRBSL from NBER dates; **Copyrighted: Citation Required** ✔), `USRECQ` (quarterly), `USRECD`
167
- (daily). 1 from the month after the NBER peak through the trough. `"recessions": true` in the spec adds USREC;
168
- for chart shading, turn its runs of 1 into start and end dates.
169
- Sahm rule: `SAHMREALTIME` (real-time, as first published; empty where a month's unemployment rate was not
170
- collected, Oct 2025) and `SAHMCURRENT` (from current UNRATE vintages): the 3-month average of the unemployment
171
- rate minus its low of the prior 12 months; 0.50 or more signals a recession start.
172
-
173
- ## 8. States and areas
174
- - Unemployment rate: `<ST>UR` (CAUR, TXUR ...), monthly, SA (BLS LAUS).
175
- - Per capita personal income: `<ST>PCPI` (CAPCPI ...), annual (BEA).
176
- - A full cross-section in one call needs a key: spec `"regional": [{"series_id": "CAUR", "region_type": "state",
177
- "date": "2026-08-01"}]` (GeoFRED finds the group from any member series). Without a key, list the 50 state IDs
178
- plus DC explicitly; check each with the `request_schema` search `describe <IDs>` (a 404 means the pattern does
179
- not hold for that series).
180
-
181
- ## 9. Finding a series you do not know
182
- 1. With a key: `request_schema` for fred with the search "federal outlays interest" (sorted by
183
- popularity; prefer the most popular series from the official source).
184
- 2. Without a key: search https://fred.stlouisfed.org/searchresults/?st=<words> in the browser (or WebSearch
185
- "site:fred.stlouisfed.org <words>").
186
- 3. Confirm with the `request_schema` search `describe <IDs>`: title, units, frequency, seasonal adjustment, last updated. Prefer the series
187
- published by the original agency (BEA, BLS, OMB, Treasury, CBO, the Board of Governors) over derived copies,
188
- and an SA series for short-run changes, NSA for 12-month changes and annual averages.
1
+ # FRED series for budget and economic analysis
2
+
3
+ Every ID below was checked to exist on 2026-10-20 (titles, units, frequency and adjustment as FRED shows
4
+ them). FRED edits titles and adds series; confirm with the `request_schema` search `describe <IDs>` before downloading, and
5
+ read the title back against the concept. Copyright tags were read on the series page only where marked ✔;
6
+ read the page for the others before sharing data.
7
+
8
+ Contents: 1. Output and potential · 2. Prices · 3. Labor · 4. Interest rates · 5. The federal budget ·
9
+ 6. Income and other · 7. Recessions · 8. States and areas · 9. Finding a series you do not know
10
+
11
+ ## 1. Output and potential output
12
+ | ID | What | Units, frequency | Notes |
13
+ |---|---|---|---|
14
+ | `GDP` | Gross domestic product | Billions of dollars, quarterly, SAAR | Nominal; the denominator for shares of GDP (average the 4 quarters of a fiscal year) |
15
+ | `GDPA` | GDP, annual | Billions of dollars, annual | Calendar year; the denominator of FRED's FY*GDA188S ratios |
16
+ | `FYGDP` | GDP, fiscal year (OMB) | Billions of dollars, annual, fiscal year (dated Sep 30) | OMB's figure from its latest budget; lags BEA revisions. The mean of the four quarters of `GDP` is the current-vintage alternative |
17
+ | `GDPC1` | Real GDP | Billions of chained 2017 dollars, quarterly, SAAR | BEA; Public Domain ✔ |
18
+ | `A191RL1Q225SBEA` | Real GDP, percent change from preceding period | Percent, quarterly, SAAR | BEA's published growth rate: the benchmark for an annualized growth rate computed from `GDPC1` |
19
+ | `A939RX0Q048SBEA` | Real GDP per capita | Chained 2017 dollars, quarterly, SAAR | |
20
+ | `GDPPOT` | Real potential GDP (CBO) | Billions of chained 2017 dollars, quarterly, NSA | CBO; Public Domain ✔; **projected ~10 years ahead**; last updated with CBO's latest outlook, so it may rest on an older GDP vintage than GDPC1 |
21
+ | `NGDPPOT` | Nominal potential GDP (CBO) | Billions of dollars, quarterly | Projections as above |
22
+ | `NROU` | Noncyclical rate of unemployment (CBO) | Percent, quarterly | Projections as above |
23
+ | `GDPDEF` | GDP implicit price deflator | Index 2017=100, quarterly, SA | |
24
+
25
+ Output gap = `GDPC1 / GDPPOT - 1` (both chained 2017 dollars), on dates both have (join on date; stop at the last date both series hold).
26
+
27
+ ## 2. Prices
28
+ | ID | What | Units, frequency | Notes |
29
+ |---|---|---|---|
30
+ | `PCEPI` | PCE price index | Index 2017=100, monthly, SA | The measure in the Federal Reserve's 2 percent objective; CBO projects it alongside the CPI-U |
31
+ | `PCEPILFE` | Core PCE price index | Index 2017=100, monthly, SA | |
32
+ | `CPIAUCSL` | CPI-U, all items | Index 1982-84=100, monthly, SA | Monthly changes |
33
+ | `CPIAUCNS` | CPI-U, all items | Index 1982-84=100, monthly, NSA | 12-month changes as BLS reports them; annual averages |
34
+ | `CPILFENS` | Core CPI-U, not seasonally adjusted (12-month changes) | Index 1982-84=100, monthly, NSA | |
35
+ | `CPILFESL` | Core CPI-U | Index 1982-84=100, monthly, SA | |
36
+ | `CWUR0000SA0` | CPI-W, all items | Index 1982-84=100, monthly, NSA | Social Security COLA: average of July-September over the same quarter a year earlier |
37
+ | `SUUR0000SA0` | Chained CPI-U (C-CPI-U) | Index Dec 1999=100, monthly, NSA | Tax-bracket indexing; preliminary for 10-12 months |
38
+ | `T10YIE` | 10-year breakeven inflation | Percent, daily | Market-based expectation (10-year nominal minus 10-year TIPS yield) |
39
+ | `T5YIE` | 5-year breakeven inflation | Percent, daily | 5-year nominal minus 5-year TIPS yield; monthly averages `T5YIEM` |
40
+ | `T5YIFR` | 5-year, 5-year forward inflation expectation | Percent, daily | (((1+b10/100)^10/(1+b5/100)^5)^(1/5)-1)*100 from the 10- and 5-year breakevens; monthly `T5YIFRM` |
41
+ | `UMCSENT` | University of Michigan consumer sentiment | Index 1966:Q1=100, monthly, NSA | **Posted on FRED one month late** at UMich's request: the latest final and preliminary months are on sca.isr.umich.edu (save them in published/). UMich moved from phone to web interviews in 2024, which shifts levels |
42
+
43
+ ## 3. Labor
44
+ | ID | What | Units, frequency |
45
+ |---|---|---|
46
+ | `UNRATE` | Unemployment rate | Percent, monthly, SA |
47
+ | `PAYEMS` | All employees, total nonfarm | Thousands, monthly, SA |
48
+ | `CIVPART` | Labor force participation rate | Percent, monthly, SA |
49
+ | `CNP16OV` | Civilian noninstitutional population 16+ | Thousands, monthly, NSA |
50
+ | `CES0500000003` | Average hourly earnings, total private | Dollars per hour, monthly, SA |
51
+ | `ECIWAG` | ECI, wages and salaries, private industry | Index Dec 2005=100, quarterly, SA |
52
+
53
+ For more detail on BLS series (demographic groups, industries, significance), the bls pack is the
54
+ better tool; FRED mirrors the same data.
55
+
56
+ ## 4. Interest rates
57
+ | ID | What | Units, frequency |
58
+ |---|---|---|
59
+ | `DFEDTARU` / `DFEDTARL` | Federal funds target range, upper / lower limit (FOMC) | Percent, daily (steps on decision dates). "Cut since the peak": when the path reverses, report the net change and the gross cuts separately (2024-2026: 1.75 points of cuts, 1.50 net after a 2026 raise); the Board's Open Market Operations table is the benchmark |
60
+ | `FEDFUNDS` | Effective federal funds rate | Percent, monthly average |
61
+ | `DFF` | Effective federal funds rate | Percent, daily (7-day) |
62
+ | `DGS10` | 10-year Treasury constant-maturity yield | Percent, daily (business days; gaps on holidays) |
63
+ | `GS10` | 10-year Treasury yield | Percent, monthly average |
64
+ | `TB3MS` | 3-month Treasury bill, secondary market | Percent, monthly (discount basis) |
65
+ | `MORTGAGE30US` | 30-year fixed mortgage rate (Freddie Mac) | Percent, weekly ending Thursday |
66
+ | `T10Y2Y` / `T10Y2YM` | 10-year minus 2-year Treasury spread (curve inversion when negative) | Percentage points, daily / monthly average |
67
+ | `T10Y3M` | 10-year minus 3-month Treasury spread | Percentage points, daily |
68
+
69
+ Use the monthly averages (GS10, TB3MS) for annual or fiscal-year averages; CBO's interest-rate projections
70
+ are calendar- or fiscal-year averages of these rates.
71
+
72
+ ## 5. The federal budget
73
+ | ID | What | Units, frequency | Notes |
74
+ |---|---|---|---|
75
+ | `FYFR` | Federal receipts (revenues) | Millions of dollars, annual, **fiscal year** | OMB/Treasury; dated Sep 30 |
76
+ | `FYONET` | Federal net outlays | Millions of dollars, annual, fiscal year | |
77
+ | `FYFSD` | Federal surplus or deficit (negative = deficit) | Millions of dollars, annual, fiscal year | |
78
+ | `FYOINT` | Federal outlays: interest | Millions of dollars, annual, fiscal year | OMB, Public Domain ✔. OMB's net interest (budget function 900, matches OMB Historical Table 3.1): $970.1 billion in FY2025. CBO's Monthly Budget Review reports "net interest on the public debt" above $1 trillion for FY2025, a different budget category; say which one the text means and benchmark it against its own source |
79
+ | `FYFSGDA188S` | Surplus or deficit as percent of GDP | Percent of GDP, annual (fiscal year, dated Jan 1) | |
80
+ | `FYOIGDA188S` | Interest outlays as percent of GDP | Percent of GDP, annual (fiscal year, dated Jan 1) | Benchmark only: divides by calendar-year GDP (GDPA), not fiscal-year GDP |
81
+ | `FYGFDPUN` | Federal debt held by the public | Millions of dollars, quarterly, end of period | |
82
+ | `FYGFGDQ188S` | Debt held by the public as percent of GDP | Percent of GDP, quarterly, SA | |
83
+ | `GFDEBTN` | Total public debt | Millions of dollars, quarterly, end of period | Includes intragovernmental debt: not "debt held by the public" |
84
+ | `GFDEGDQ188S` | Total public debt as percent of GDP | Percent of GDP, quarterly, SA | |
85
+ | `A091RC1Q027SBEA` | Federal interest payments (NIPA) | Billions of dollars, quarterly, SAAR | National-accounts basis, not budget basis |
86
+ | `W006RC1Q027SBEA` | Federal current tax receipts (NIPA) | Billions of dollars, quarterly, SAAR | NIPA basis |
87
+ | `FGEXPND` | Federal current expenditures (NIPA) | Billions of dollars, quarterly, SAAR | NIPA basis |
88
+
89
+ Budget-basis (OMB/Treasury, fiscal year) and NIPA-basis (BEA, calendar quarters) measures differ in timing and
90
+ coverage; never mix them in one ratio without saying so. For CBO's own baseline projections and historical
91
+ budget data, use CBO's data files (cbo.gov), not FRED.
92
+
93
+ ## 6. Income and other
94
+ | ID | What | Units, frequency |
95
+ |---|---|---|
96
+ | `PCE` | Personal consumption expenditures | Billions of dollars, monthly, SAAR |
97
+ | `DSPIC96` | Real disposable personal income | Billions of chained 2017 dollars, monthly, SAAR |
98
+ | `PSAVERT` / `A072RC1Q156SBEA` | Personal saving rate (NIPA Table 2.6 / 2.1 line 35) | Percent of disposable income, monthly / quarterly |
99
+ | `MEHOINUSA672N` | Real median household income (Census) | Dollars of the latest year (C-CPI-U), annual |
100
+ | `SP500` | S&P 500 index | Index, daily; **Copyrighted: Pre-Approval Required** ✔ (only 10 years on FRED) |
101
+
102
+ **International trade** (the Census/BEA monthly release, FT-900, mirrored keyless; BEA's ITA needs a key)
103
+ | ID | What | Units, frequency |
104
+ |---|---|---|
105
+ | `BOPGSTB` / `BOPGTB` / `BOPSTB` | Trade balance: goods and services / goods / services, balance of payments basis | Millions of dollars, monthly, SA |
106
+ | `BOPTEXP` / `BOPTIMP` | Exports / imports of goods and services, BOP basis | Millions of dollars, monthly, SA |
107
+ | `EXPCH` / `IMPCH` | Goods exports to / imports from China, Census basis (other partners: EXP / IMP + country code) | Millions of dollars, monthly, NSA |
108
+
109
+ Annual totals are sums of the months; the June annual revision replaces the first-published year. Partner
110
+ balances are on the Census basis, as the release gives them.
111
+
112
+ ## 4b. Money stock (Federal Reserve H.6, monthly)
113
+ `M2SL` M2 (billions of dollars, SA), `M1SL` M1, `M2NS` M2 not adjusted, `WM2NS` weekly M2. The H.6 has not
114
+ published growth rates since February 2021: 12-month growth is computed from levels (`pc1`), and the H.6
115
+ data file is the level benchmark.
116
+
117
+ ## 5a. Industrial production and capacity utilization (Federal Reserve G.17, monthly)
118
+ `INDPRO` industrial production, total (index 2017=100), `IPMAN` manufacturing; `TCU` capacity
119
+ utilization, total (percent), `MCUMFN` manufacturing (metadata checked on 2026-10-21). The
120
+ latest months are preliminary and revised for several months. G.17 states the gap to the long-run
121
+ average as the difference of its one-decimal rates (76.9 - 79.4 = 2.5 points below): compute it the
122
+ same way to match, and show the unrounded gap as a sensitivity.
123
+
124
+ ## 5c. Housing starts and permits (Census New Residential Construction, monthly)
125
+ `HOUST` total starts, `HOUST1F` single-family, `PERMIT` permits (thousands of units, SAAR; metadata checked
126
+ on 2026-10-21); `HOUSTNSA` not adjusted. The latest month is preliminary and revised twice.
127
+ An annual total from FRED sums rounded months: Census's annual sheet sums unrounded estimates (0.1 apart).
128
+
129
+ ## 5b. Unemployment insurance claims (DOL, weekly)
130
+ `ICSA` initial claims (SA), `IC4WSA` 4-week moving average (SA), `ICNSA` (NSA), `CCSA` continued claims.
131
+ Weeks end on Saturday; the latest week is an advance figure (preliminary). The keyless route when the dol
132
+ pack has no key. A calendar-year average needs all the weeks of the year (count them; never average a
133
+ partial year).
134
+
135
+ ## 6a. Household debt service (Federal Reserve DSR release)
136
+ Quarterly, percent of disposable personal income: `TDSP` total, `MDSP` mortgage, `CDSP` consumer debt
137
+ service. The Fed rebuilt the series on credit-bureau data in 2024: its levels are about 2.5 points above the
138
+ archived lender-based series (2007 Q4 15.8 against 13.3), so never mix the two; the latest quarter is
139
+ preliminary. Benchmark: federalreserve.gov/releases/dsr.
140
+
141
+ ## 6b. Federal Reserve balance sheet (H.4.1)
142
+ Weekly, millions of dollars (metadata checked on 2026-10-21). Wednesday levels: `WALCL` total
143
+ assets, `TREAST` Treasury securities held outright, `WSHOMCB` mortgage-backed securities, `WSHOSHO` all
144
+ securities held outright, `WLRRAL` reverse repurchase agreements (liability). Week averages (not Wednesday
145
+ levels; do not mix with the above): `WRESBAL` reserve balances, `WTREGEN` Treasury General Account.
146
+ `RRPONTSYD` overnight reverse repos is daily and in billions. Changes between two weeks are differences of
147
+ published levels, not published figures: say so in benchmark.csv. Other assets (premiums, loans, the
148
+ rest) are total minus the securities.
149
+
150
+ ## 6d. House prices and the international investment position
151
+ | ID | What | Units, frequency | Notes |
152
+ |---|---|---|---|
153
+ | `CSUSHPINSA`, `CSUSHPISA` | S&P CoreLogic Case-Shiller U.S. National home price index, NSA / SA | Index Jan 2000=100, monthly, two months' lag | `copyright` preapproval_required: say the values may not be republished; S&P's release leads with NSA 12-month changes |
154
+ | `USSTHPI` | FHFA all-transactions house price index, U.S. | Index 1980:Q1=100, quarterly | Public domain |
155
+ | `IIPUSNETIQ`, `IIPUSNETIA` | U.S. net international investment position (BEA), quarterly / annual | Millions of dollars | The keyless route to BEA's IIP (the BEA pack needs a key for IIP); preliminary for the latest quarter |
156
+
157
+ ## 6c. Exchange rates (Federal Reserve H.10)
158
+ | ID | What | Units, frequency | Notes |
159
+ |---|---|---|---|
160
+ | `DTWEXBGS` | Nominal broad dollar index (trade-weighted, 26 currencies) | Index Jan 2006=100, daily | The Fed's headline dollar index; checked against H.10 [2026-10-22] |
161
+ | `TWEXBGSMTH` | Nominal broad dollar index, monthly average | Index Jan 2006=100, monthly | A year-to-date change can differ in sign between daily end points and monthly averages: say which |
162
+ | `RTWEXBGS` | Real broad dollar index | Index Jan 2006=100, monthly | Adjusted for relative consumer prices |
163
+ | `DEXUSEU`, `DEXJPUS`, `DEXCHUS`, `DEXCAUS`, `DEXMXUS` | Bilateral rates: dollars per euro; yen, yuan, Canadian dollars, pesos per dollar | daily | Mind the quote direction (US per foreign for the euro) |
164
+
165
+ ## 7. Recessions
166
+ `USREC` (monthly; FRBSL from NBER dates; **Copyrighted: Citation Required** ✔), `USRECQ` (quarterly), `USRECD`
167
+ (daily). 1 from the month after the NBER peak through the trough. `"recessions": true` in the spec adds USREC;
168
+ for chart shading, turn its runs of 1 into start and end dates.
169
+ Sahm rule: `SAHMREALTIME` (real-time, as first published; empty where a month's unemployment rate was not
170
+ collected, Oct 2025) and `SAHMCURRENT` (from current UNRATE vintages): the 3-month average of the unemployment
171
+ rate minus its low of the prior 12 months; 0.50 or more signals a recession start.
172
+
173
+ ## 8. States and areas
174
+ - Unemployment rate: `<ST>UR` (CAUR, TXUR ...), monthly, SA (BLS LAUS).
175
+ - Per capita personal income: `<ST>PCPI` (CAPCPI ...), annual (BEA).
176
+ - A full cross-section in one call needs a key: spec `"regional": [{"series_id": "CAUR", "region_type": "state",
177
+ "date": "2026-08-01"}]` (GeoFRED finds the group from any member series). Without a key, list the 50 state IDs
178
+ plus DC explicitly; check each with the `request_schema` search `describe <IDs>` (a 404 means the pattern does
179
+ not hold for that series).
180
+
181
+ ## 9. Finding a series you do not know
182
+ 1. With a key: `request_schema` for fred with the search "federal outlays interest" (sorted by
183
+ popularity; prefer the most popular series from the official source).
184
+ 2. Without a key: search https://fred.stlouisfed.org/searchresults/?st=<words> in the browser (or WebSearch
185
+ "site:fred.stlouisfed.org <words>").
186
+ 3. Confirm with the `request_schema` search `describe <IDs>`: title, units, frequency, seasonal adjustment, last updated. Prefer the series
187
+ published by the original agency (BEA, BLS, OMB, Treasury, CBO, the Board of Governors) over derived copies,
188
+ and an SA series for short-run changes, NSA for 12-month changes and annual averages.