data-analyst-mcp 0.0.0-stage → 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 (640) hide show
  1. package/README.md +261 -2
  2. package/dist/adapters/_acf_tidy.d.ts +18 -0
  3. package/dist/adapters/_acf_tidy.js +432 -0
  4. package/dist/adapters/_acf_tidy.js.map +1 -0
  5. package/dist/adapters/_actuaries_read.d.ts +38 -0
  6. package/dist/adapters/_actuaries_read.js +728 -0
  7. package/dist/adapters/_actuaries_read.js.map +1 -0
  8. package/dist/adapters/_census_micro.d.ts +70 -0
  9. package/dist/adapters/_census_micro.js +622 -0
  10. package/dist/adapters/_census_micro.js.map +1 -0
  11. package/dist/adapters/_census_util.d.ts +40 -0
  12. package/dist/adapters/_census_util.js +275 -0
  13. package/dist/adapters/_census_util.js.map +1 -0
  14. package/dist/adapters/_dol_states.d.ts +6 -0
  15. package/dist/adapters/_dol_states.js +58 -0
  16. package/dist/adapters/_dol_states.js.map +1 -0
  17. package/dist/adapters/_govinfo_entities.d.ts +4 -0
  18. package/dist/adapters/_govinfo_entities.js +6 -0
  19. package/dist/adapters/_govinfo_entities.js.map +1 -0
  20. package/dist/adapters/_govinfo_json.d.ts +13 -0
  21. package/dist/adapters/_govinfo_json.js +107 -0
  22. package/dist/adapters/_govinfo_json.js.map +1 -0
  23. package/dist/adapters/_govinfo_py.d.ts +22 -0
  24. package/dist/adapters/_govinfo_py.js +272 -0
  25. package/dist/adapters/_govinfo_py.js.map +1 -0
  26. package/dist/adapters/_govinfo_xml.d.ts +22 -0
  27. package/dist/adapters/_govinfo_xml.js +233 -0
  28. package/dist/adapters/_govinfo_xml.js.map +1 -0
  29. package/dist/adapters/_hud_excel.d.ts +2 -0
  30. package/dist/adapters/_hud_excel.js +166 -0
  31. package/dist/adapters/_hud_excel.js.map +1 -0
  32. package/dist/adapters/_omb_grid.d.ts +17 -0
  33. package/dist/adapters/_omb_grid.js +132 -0
  34. package/dist/adapters/_omb_grid.js.map +1 -0
  35. package/dist/adapters/_omb_util.d.ts +40 -0
  36. package/dist/adapters/_omb_util.js +192 -0
  37. package/dist/adapters/_omb_util.js.map +1 -0
  38. package/dist/adapters/_usaspending_state.d.ts +6 -0
  39. package/dist/adapters/_usaspending_state.js +54 -0
  40. package/dist/adapters/_usaspending_state.js.map +1 -0
  41. package/dist/adapters/_usda-fna_book.d.ts +59 -0
  42. package/dist/adapters/_usda-fna_book.js +869 -0
  43. package/dist/adapters/_usda-fna_book.js.map +1 -0
  44. package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
  45. package/dist/adapters/_usda-fna_pdf.js +361 -0
  46. package/dist/adapters/_usda-fna_pdf.js.map +1 -0
  47. package/dist/adapters/_usda-outlook_read.d.ts +70 -0
  48. package/dist/adapters/_usda-outlook_read.js +362 -0
  49. package/dist/adapters/_usda-outlook_read.js.map +1 -0
  50. package/dist/adapters/acf.d.ts +3 -0
  51. package/dist/adapters/acf.js +187 -0
  52. package/dist/adapters/acf.js.map +1 -0
  53. package/dist/adapters/actuaries.d.ts +3 -0
  54. package/dist/adapters/actuaries.js +293 -0
  55. package/dist/adapters/actuaries.js.map +1 -0
  56. package/dist/adapters/bts.d.ts +3 -0
  57. package/dist/adapters/bts.js +26 -0
  58. package/dist/adapters/bts.js.map +1 -0
  59. package/dist/adapters/census-geocoder.d.ts +10 -0
  60. package/dist/adapters/census-geocoder.js +47 -0
  61. package/dist/adapters/census-geocoder.js.map +1 -0
  62. package/dist/adapters/census.d.ts +17 -0
  63. package/dist/adapters/census.js +983 -0
  64. package/dist/adapters/census.js.map +1 -0
  65. package/dist/adapters/cfpb.d.ts +7 -0
  66. package/dist/adapters/cfpb.js +348 -0
  67. package/dist/adapters/cfpb.js.map +1 -0
  68. package/dist/adapters/clinical-trials.d.ts +3 -0
  69. package/dist/adapters/clinical-trials.js +135 -0
  70. package/dist/adapters/clinical-trials.js.map +1 -0
  71. package/dist/adapters/cms.d.ts +3 -0
  72. package/dist/adapters/cms.js +292 -0
  73. package/dist/adapters/cms.js.map +1 -0
  74. package/dist/adapters/college-scorecard.d.ts +3 -0
  75. package/dist/adapters/college-scorecard.js +122 -0
  76. package/dist/adapters/college-scorecard.js.map +1 -0
  77. package/dist/adapters/congress.d.ts +33 -0
  78. package/dist/adapters/congress.js +589 -0
  79. package/dist/adapters/congress.js.map +1 -0
  80. package/dist/adapters/dhs-ohss.d.ts +13 -0
  81. package/dist/adapters/dhs-ohss.js +598 -0
  82. package/dist/adapters/dhs-ohss.js.map +1 -0
  83. package/dist/adapters/doj-news.d.ts +7 -0
  84. package/dist/adapters/doj-news.js +286 -0
  85. package/dist/adapters/doj-news.js.map +1 -0
  86. package/dist/adapters/dol.d.ts +4 -0
  87. package/dist/adapters/dol.js +634 -0
  88. package/dist/adapters/dol.js.map +1 -0
  89. package/dist/adapters/eia.d.ts +15 -0
  90. package/dist/adapters/eia.js +456 -0
  91. package/dist/adapters/eia.js.map +1 -0
  92. package/dist/adapters/epa-aqs.d.ts +3 -0
  93. package/dist/adapters/epa-aqs.js +357 -0
  94. package/dist/adapters/epa-aqs.js.map +1 -0
  95. package/dist/adapters/epa.d.ts +3 -0
  96. package/dist/adapters/epa.js +298 -0
  97. package/dist/adapters/epa.js.map +1 -0
  98. package/dist/adapters/fbi.d.ts +3 -0
  99. package/dist/adapters/fbi.js +192 -0
  100. package/dist/adapters/fbi.js.map +1 -0
  101. package/dist/adapters/fda.d.ts +5 -0
  102. package/dist/adapters/fda.js +184 -0
  103. package/dist/adapters/fda.js.map +1 -0
  104. package/dist/adapters/fdic.d.ts +4 -0
  105. package/dist/adapters/fdic.js +95 -0
  106. package/dist/adapters/fdic.js.map +1 -0
  107. package/dist/adapters/fec.d.ts +3 -0
  108. package/dist/adapters/fec.js +142 -0
  109. package/dist/adapters/fec.js.map +1 -0
  110. package/dist/adapters/fed-board.d.ts +12 -0
  111. package/dist/adapters/fed-board.js +581 -0
  112. package/dist/adapters/fed-board.js.map +1 -0
  113. package/dist/adapters/federal-register.d.ts +11 -0
  114. package/dist/adapters/federal-register.js +43 -0
  115. package/dist/adapters/federal-register.js.map +1 -0
  116. package/dist/adapters/fhfa.d.ts +3 -0
  117. package/dist/adapters/fhfa.js +253 -0
  118. package/dist/adapters/fhfa.js.map +1 -0
  119. package/dist/adapters/fsa.d.ts +9 -0
  120. package/dist/adapters/fsa.js +335 -0
  121. package/dist/adapters/fsa.js.map +1 -0
  122. package/dist/adapters/govinfo.d.ts +30 -0
  123. package/dist/adapters/govinfo.js +636 -0
  124. package/dist/adapters/govinfo.js.map +1 -0
  125. package/dist/adapters/gsa-calc.d.ts +10 -0
  126. package/dist/adapters/gsa-calc.js +318 -0
  127. package/dist/adapters/gsa-calc.js.map +1 -0
  128. package/dist/adapters/hud.d.ts +3 -0
  129. package/dist/adapters/hud.js +200 -0
  130. package/dist/adapters/hud.js.map +1 -0
  131. package/dist/adapters/index.d.ts +3 -0
  132. package/dist/adapters/index.js +25 -0
  133. package/dist/adapters/index.js.map +1 -0
  134. package/dist/adapters/irs-soi.d.ts +6 -0
  135. package/dist/adapters/irs-soi.js +576 -0
  136. package/dist/adapters/irs-soi.js.map +1 -0
  137. package/dist/adapters/naep.d.ts +15 -0
  138. package/dist/adapters/naep.js +341 -0
  139. package/dist/adapters/naep.js.map +1 -0
  140. package/dist/adapters/nhtsa.d.ts +10 -0
  141. package/dist/adapters/nhtsa.js +239 -0
  142. package/dist/adapters/nhtsa.js.map +1 -0
  143. package/dist/adapters/nih.d.ts +5 -0
  144. package/dist/adapters/nih.js +196 -0
  145. package/dist/adapters/nih.js.map +1 -0
  146. package/dist/adapters/noaa.d.ts +3 -0
  147. package/dist/adapters/noaa.js +148 -0
  148. package/dist/adapters/noaa.js.map +1 -0
  149. package/dist/adapters/nrel.d.ts +3 -0
  150. package/dist/adapters/nrel.js +186 -0
  151. package/dist/adapters/nrel.js.map +1 -0
  152. package/dist/adapters/nws.d.ts +3 -0
  153. package/dist/adapters/nws.js +119 -0
  154. package/dist/adapters/nws.js.map +1 -0
  155. package/dist/adapters/omb.d.ts +15 -0
  156. package/dist/adapters/omb.js +517 -0
  157. package/dist/adapters/omb.js.map +1 -0
  158. package/dist/adapters/open-payments.d.ts +5 -0
  159. package/dist/adapters/open-payments.js +149 -0
  160. package/dist/adapters/open-payments.js.map +1 -0
  161. package/dist/adapters/pbgc.d.ts +13 -0
  162. package/dist/adapters/pbgc.js +283 -0
  163. package/dist/adapters/pbgc.js.map +1 -0
  164. package/dist/adapters/philfed.d.ts +12 -0
  165. package/dist/adapters/philfed.js +59 -0
  166. package/dist/adapters/philfed.js.map +1 -0
  167. package/dist/adapters/regulations.d.ts +6 -0
  168. package/dist/adapters/regulations.js +58 -0
  169. package/dist/adapters/regulations.js.map +1 -0
  170. package/dist/adapters/sec.d.ts +13 -0
  171. package/dist/adapters/sec.js +504 -0
  172. package/dist/adapters/sec.js.map +1 -0
  173. package/dist/adapters/senate-lobbying.d.ts +3 -0
  174. package/dist/adapters/senate-lobbying.js +181 -0
  175. package/dist/adapters/senate-lobbying.js.map +1 -0
  176. package/dist/adapters/snapqc.d.ts +32 -0
  177. package/dist/adapters/snapqc.js +701 -0
  178. package/dist/adapters/snapqc.js.map +1 -0
  179. package/dist/adapters/treasury-yields.d.ts +3 -0
  180. package/dist/adapters/treasury-yields.js +170 -0
  181. package/dist/adapters/treasury-yields.js.map +1 -0
  182. package/dist/adapters/usaspending.d.ts +3 -0
  183. package/dist/adapters/usaspending.js +340 -0
  184. package/dist/adapters/usaspending.js.map +1 -0
  185. package/dist/adapters/usda-fna.d.ts +7 -0
  186. package/dist/adapters/usda-fna.js +707 -0
  187. package/dist/adapters/usda-fna.js.map +1 -0
  188. package/dist/adapters/usda-fooddata.d.ts +3 -0
  189. package/dist/adapters/usda-fooddata.js +101 -0
  190. package/dist/adapters/usda-fooddata.js.map +1 -0
  191. package/dist/adapters/usda-nass.d.ts +3 -0
  192. package/dist/adapters/usda-nass.js +108 -0
  193. package/dist/adapters/usda-nass.js.map +1 -0
  194. package/dist/adapters/usda-outlook.d.ts +12 -0
  195. package/dist/adapters/usda-outlook.js +696 -0
  196. package/dist/adapters/usda-outlook.js.map +1 -0
  197. package/dist/adapters/usgs.d.ts +9 -0
  198. package/dist/adapters/usgs.js +265 -0
  199. package/dist/adapters/usgs.js.map +1 -0
  200. package/dist/adapters/usitc.d.ts +18 -0
  201. package/dist/adapters/usitc.js +170 -0
  202. package/dist/adapters/usitc.js.map +1 -0
  203. package/dist/adapters/uspto.d.ts +3 -0
  204. package/dist/adapters/uspto.js +47 -0
  205. package/dist/adapters/uspto.js.map +1 -0
  206. package/dist/adapters/world-bank.d.ts +3 -0
  207. package/dist/adapters/world-bank.js +163 -0
  208. package/dist/adapters/world-bank.js.map +1 -0
  209. package/dist/analysis/cite.d.ts +31 -0
  210. package/dist/analysis/cite.js +229 -0
  211. package/dist/analysis/cite.js.map +1 -0
  212. package/dist/analysis/combine.d.ts +27 -0
  213. package/dist/analysis/combine.js +198 -0
  214. package/dist/analysis/combine.js.map +1 -0
  215. package/dist/analysis/compute.d.ts +62 -0
  216. package/dist/analysis/compute.js +583 -0
  217. package/dist/analysis/compute.js.map +1 -0
  218. package/dist/analysis/expr.d.ts +69 -0
  219. package/dist/analysis/expr.js +780 -0
  220. package/dist/analysis/expr.js.map +1 -0
  221. package/dist/analysis/factfmt.d.ts +16 -0
  222. package/dist/analysis/factfmt.js +187 -0
  223. package/dist/analysis/factfmt.js.map +1 -0
  224. package/dist/analysis/facts.d.ts +63 -0
  225. package/dist/analysis/facts.js +355 -0
  226. package/dist/analysis/facts.js.map +1 -0
  227. package/dist/analysis/handoff.d.ts +58 -0
  228. package/dist/analysis/handoff.js +208 -0
  229. package/dist/analysis/handoff.js.map +1 -0
  230. package/dist/analysis/pyfmt.d.ts +16 -0
  231. package/dist/analysis/pyfmt.js +156 -0
  232. package/dist/analysis/pyfmt.js.map +1 -0
  233. package/dist/analysis/rerun.d.ts +13 -0
  234. package/dist/analysis/rerun.js +125 -0
  235. package/dist/analysis/rerun.js.map +1 -0
  236. package/dist/analysis/table.d.ts +18 -0
  237. package/dist/analysis/table.js +109 -0
  238. package/dist/analysis/table.js.map +1 -0
  239. package/dist/analysis/tools.d.ts +67 -0
  240. package/dist/analysis/tools.js +217 -0
  241. package/dist/analysis/tools.js.map +1 -0
  242. package/dist/analysis/write_table.d.ts +13 -0
  243. package/dist/analysis/write_table.js +59 -0
  244. package/dist/analysis/write_table.js.map +1 -0
  245. package/dist/bin/cli.d.ts +10 -0
  246. package/dist/bin/cli.js +177 -0
  247. package/dist/bin/cli.js.map +1 -0
  248. package/dist/core/cache.d.ts +14 -0
  249. package/dist/core/cache.js +90 -0
  250. package/dist/core/cache.js.map +1 -0
  251. package/dist/core/context.d.ts +12 -0
  252. package/dist/core/context.js +15 -0
  253. package/dist/core/context.js.map +1 -0
  254. package/dist/core/env.d.ts +14 -0
  255. package/dist/core/env.js +52 -0
  256. package/dist/core/env.js.map +1 -0
  257. package/dist/core/generic-rest.d.ts +61 -0
  258. package/dist/core/generic-rest.js +639 -0
  259. package/dist/core/generic-rest.js.map +1 -0
  260. package/dist/core/http.d.ts +120 -0
  261. package/dist/core/http.js +514 -0
  262. package/dist/core/http.js.map +1 -0
  263. package/dist/core/keys.d.ts +43 -0
  264. package/dist/core/keys.js +174 -0
  265. package/dist/core/keys.js.map +1 -0
  266. package/dist/core/manual.d.ts +41 -0
  267. package/dist/core/manual.js +218 -0
  268. package/dist/core/manual.js.map +1 -0
  269. package/dist/core/package.d.ts +58 -0
  270. package/dist/core/package.js +228 -0
  271. package/dist/core/package.js.map +1 -0
  272. package/dist/core/packs.d.ts +139 -0
  273. package/dist/core/packs.js +173 -0
  274. package/dist/core/packs.js.map +1 -0
  275. package/dist/core/policy.d.ts +69 -0
  276. package/dist/core/policy.js +189 -0
  277. package/dist/core/policy.js.map +1 -0
  278. package/dist/core/py.d.ts +40 -0
  279. package/dist/core/py.js +171 -0
  280. package/dist/core/py.js.map +1 -0
  281. package/dist/core/routing.d.ts +10 -0
  282. package/dist/core/routing.js +39 -0
  283. package/dist/core/routing.js.map +1 -0
  284. package/dist/core/tabular.d.ts +21 -0
  285. package/dist/core/tabular.js +229 -0
  286. package/dist/core/tabular.js.map +1 -0
  287. package/dist/deep/_bea_api.d.ts +102 -0
  288. package/dist/deep/_bea_api.js +457 -0
  289. package/dist/deep/_bea_api.js.map +1 -0
  290. package/dist/deep/_bea_fetch.d.ts +151 -0
  291. package/dist/deep/_bea_fetch.js +1274 -0
  292. package/dist/deep/_bea_fetch.js.map +1 -0
  293. package/dist/deep/_bea_util.d.ts +14 -0
  294. package/dist/deep/_bea_util.js +156 -0
  295. package/dist/deep/_bea_util.js.map +1 -0
  296. package/dist/deep/_bls_api.d.ts +84 -0
  297. package/dist/deep/_bls_api.js +231 -0
  298. package/dist/deep/_bls_api.js.map +1 -0
  299. package/dist/deep/_bls_ids.d.ts +43 -0
  300. package/dist/deep/_bls_ids.js +188 -0
  301. package/dist/deep/_bls_ids.js.map +1 -0
  302. package/dist/deep/_bls_lib.d.ts +61 -0
  303. package/dist/deep/_bls_lib.js +442 -0
  304. package/dist/deep/_bls_lib.js.map +1 -0
  305. package/dist/deep/_fred_api.d.ts +148 -0
  306. package/dist/deep/_fred_api.js +545 -0
  307. package/dist/deep/_fred_api.js.map +1 -0
  308. package/dist/deep/_fred_pack.d.ts +162 -0
  309. package/dist/deep/_fred_pack.js +1027 -0
  310. package/dist/deep/_fred_pack.js.map +1 -0
  311. package/dist/deep/_fred_py.d.ts +40 -0
  312. package/dist/deep/_fred_py.js +199 -0
  313. package/dist/deep/_fred_py.js.map +1 -0
  314. package/dist/deep/_ipums_bundle.d.ts +29 -0
  315. package/dist/deep/_ipums_bundle.js +194 -0
  316. package/dist/deep/_ipums_bundle.js.map +1 -0
  317. package/dist/deep/_ipums_ddi.d.ts +23 -0
  318. package/dist/deep/_ipums_ddi.js +162 -0
  319. package/dist/deep/_ipums_ddi.js.map +1 -0
  320. package/dist/deep/_opm_io.d.ts +26 -0
  321. package/dist/deep/_opm_io.js +383 -0
  322. package/dist/deep/_opm_io.js.map +1 -0
  323. package/dist/deep/_opm_parquet.d.ts +31 -0
  324. package/dist/deep/_opm_parquet.js +744 -0
  325. package/dist/deep/_opm_parquet.js.map +1 -0
  326. package/dist/deep/_opm_py.d.ts +6 -0
  327. package/dist/deep/_opm_py.js +74 -0
  328. package/dist/deep/_opm_py.js.map +1 -0
  329. package/dist/deep/_treasury_api.d.ts +48 -0
  330. package/dist/deep/_treasury_api.js +221 -0
  331. package/dist/deep/_treasury_api.js.map +1 -0
  332. package/dist/deep/_treasury_context.d.ts +34 -0
  333. package/dist/deep/_treasury_context.js +142 -0
  334. package/dist/deep/_treasury_context.js.map +1 -0
  335. package/dist/deep/_treasury_lib.d.ts +109 -0
  336. package/dist/deep/_treasury_lib.js +686 -0
  337. package/dist/deep/_treasury_lib.js.map +1 -0
  338. package/dist/deep/bea.d.ts +3 -0
  339. package/dist/deep/bea.js +248 -0
  340. package/dist/deep/bea.js.map +1 -0
  341. package/dist/deep/bls.d.ts +3 -0
  342. package/dist/deep/bls.js +220 -0
  343. package/dist/deep/bls.js.map +1 -0
  344. package/dist/deep/fred.d.ts +3 -0
  345. package/dist/deep/fred.js +325 -0
  346. package/dist/deep/fred.js.map +1 -0
  347. package/dist/deep/ipums.d.ts +59 -0
  348. package/dist/deep/ipums.js +744 -0
  349. package/dist/deep/ipums.js.map +1 -0
  350. package/dist/deep/opm.d.ts +56 -0
  351. package/dist/deep/opm.js +1033 -0
  352. package/dist/deep/opm.js.map +1 -0
  353. package/dist/deep/treasury.d.ts +3 -0
  354. package/dist/deep/treasury.js +218 -0
  355. package/dist/deep/treasury.js.map +1 -0
  356. package/dist/envelope.d.ts +47 -0
  357. package/dist/envelope.js +88 -0
  358. package/dist/envelope.js.map +1 -0
  359. package/dist/index.d.ts +277 -0
  360. package/dist/index.js +106 -0
  361. package/dist/index.js.map +1 -0
  362. package/dist/remote/app.d.ts +21 -0
  363. package/dist/remote/app.js +218 -0
  364. package/dist/remote/app.js.map +1 -0
  365. package/dist/remote/oauth.d.ts +14 -0
  366. package/dist/remote/oauth.js +90 -0
  367. package/dist/remote/oauth.js.map +1 -0
  368. package/dist/remote/pages.d.ts +8 -0
  369. package/dist/remote/pages.js +56 -0
  370. package/dist/remote/pages.js.map +1 -0
  371. package/dist/remote/sign.d.ts +4 -0
  372. package/dist/remote/sign.js +40 -0
  373. package/dist/remote/sign.js.map +1 -0
  374. package/dist/remote/store.d.ts +31 -0
  375. package/dist/remote/store.js +129 -0
  376. package/dist/remote/store.js.map +1 -0
  377. package/dist/report/audit_answer.d.ts +94 -0
  378. package/dist/report/audit_answer.js +1349 -0
  379. package/dist/report/audit_answer.js.map +1 -0
  380. package/dist/report/audit_report.d.ts +23 -0
  381. package/dist/report/audit_report.js +637 -0
  382. package/dist/report/audit_report.js.map +1 -0
  383. package/dist/report/build_report.d.ts +27 -0
  384. package/dist/report/build_report.js +1168 -0
  385. package/dist/report/build_report.js.map +1 -0
  386. package/dist/report/method_audit.d.ts +47 -0
  387. package/dist/report/method_audit.js +716 -0
  388. package/dist/report/method_audit.js.map +1 -0
  389. package/dist/report/policyset.d.ts +50 -0
  390. package/dist/report/policyset.js +421 -0
  391. package/dist/report/policyset.js.map +1 -0
  392. package/dist/report/py.d.ts +58 -0
  393. package/dist/report/py.js +311 -0
  394. package/dist/report/py.js.map +1 -0
  395. package/dist/report/scan_secrets.d.ts +24 -0
  396. package/dist/report/scan_secrets.js +265 -0
  397. package/dist/report/scan_secrets.js.map +1 -0
  398. package/dist/report/style_check.d.ts +29 -0
  399. package/dist/report/style_check.js +173 -0
  400. package/dist/report/style_check.js.map +1 -0
  401. package/dist/report/tools.d.ts +87 -0
  402. package/dist/report/tools.js +167 -0
  403. package/dist/report/tools.js.map +1 -0
  404. package/dist/server.d.ts +5 -0
  405. package/dist/server.js +247 -0
  406. package/dist/server.js.map +1 -0
  407. package/dist/session.d.ts +47 -0
  408. package/dist/session.js +107 -0
  409. package/dist/session.js.map +1 -0
  410. package/dist/toolkit.d.ts +21 -0
  411. package/dist/toolkit.js +2 -0
  412. package/dist/toolkit.js.map +1 -0
  413. package/dist/tools.d.ts +299 -0
  414. package/dist/tools.js +491 -0
  415. package/dist/tools.js.map +1 -0
  416. package/guide/WORKFLOW.md +134 -0
  417. package/guide/assets/disclaimer.txt +1 -0
  418. package/guide/assets/download_data.ps1 +162 -0
  419. package/guide/assets/download_data.sh +143 -0
  420. package/guide/assets/report_template.html +597 -0
  421. package/guide/references/report_patterns.md +199 -0
  422. package/guide/references/routing.md +171 -0
  423. package/guide/references/style_guide.md +398 -0
  424. package/package.json +54 -4
  425. package/packs/acf/endpoints.json +114 -0
  426. package/packs/acf/policy.json +104 -0
  427. package/packs/acf/source.md +138 -0
  428. package/packs/actuaries/endpoints.json +82 -0
  429. package/packs/actuaries/policy.json +109 -0
  430. package/packs/actuaries/source.md +137 -0
  431. package/packs/bea/assets/download_bea.ps1 +182 -0
  432. package/packs/bea/assets/download_bea.sh +144 -0
  433. package/packs/bea/docs/bea_api.md +461 -0
  434. package/packs/bea/docs/datasets.md +157 -0
  435. package/packs/bea/docs/report_patterns.md +112 -0
  436. package/packs/bea/policy.json +170 -0
  437. package/packs/bea/source.md +152 -0
  438. package/packs/bls/assets/download_bls.ps1 +152 -0
  439. package/packs/bls/assets/download_bls.sh +167 -0
  440. package/packs/bls/docs/analysis_patterns.md +108 -0
  441. package/packs/bls/docs/bls_api.md +73 -0
  442. package/packs/bls/docs/series_ids.md +149 -0
  443. package/packs/bls/policy.json +238 -0
  444. package/packs/bls/series_ids.json +1375 -0
  445. package/packs/bls/source.md +156 -0
  446. package/packs/bts/endpoints.json +347 -0
  447. package/packs/bts/policy.json +94 -0
  448. package/packs/bts/source.md +97 -0
  449. package/packs/cdc/endpoints.json +197 -0
  450. package/packs/cdc/policy.json +83 -0
  451. package/packs/cdc/source.md +74 -0
  452. package/packs/census/endpoints.json +99 -0
  453. package/packs/census/policy.json +238 -0
  454. package/packs/census/source.md +304 -0
  455. package/packs/census-geocoder/endpoints.json +70 -0
  456. package/packs/census-geocoder/policy.json +80 -0
  457. package/packs/census-geocoder/source.md +53 -0
  458. package/packs/cfpb/endpoints.json +327 -0
  459. package/packs/cfpb/policy.json +119 -0
  460. package/packs/cfpb/source.md +96 -0
  461. package/packs/clinical-trials/endpoints.json +167 -0
  462. package/packs/clinical-trials/policy.json +84 -0
  463. package/packs/clinical-trials/source.md +82 -0
  464. package/packs/cms/endpoints.json +69 -0
  465. package/packs/cms/policy.json +96 -0
  466. package/packs/cms/source.md +112 -0
  467. package/packs/college-scorecard/endpoints.json +253 -0
  468. package/packs/college-scorecard/policy.json +106 -0
  469. package/packs/college-scorecard/source.md +92 -0
  470. package/packs/congress/endpoints.json +1701 -0
  471. package/packs/congress/policy.json +117 -0
  472. package/packs/congress/source.md +190 -0
  473. package/packs/dhs-ohss/endpoints.json +66 -0
  474. package/packs/dhs-ohss/policy.json +107 -0
  475. package/packs/dhs-ohss/source.md +120 -0
  476. package/packs/doj-news/endpoints.json +59 -0
  477. package/packs/doj-news/policy.json +96 -0
  478. package/packs/doj-news/source.md +99 -0
  479. package/packs/dol/endpoints.json +818 -0
  480. package/packs/dol/policy.json +135 -0
  481. package/packs/dol/source.md +181 -0
  482. package/packs/eia/endpoints.json +718 -0
  483. package/packs/eia/policy.json +112 -0
  484. package/packs/eia/source.md +112 -0
  485. package/packs/epa/endpoints.json +292 -0
  486. package/packs/epa/policy.json +99 -0
  487. package/packs/epa/source.md +99 -0
  488. package/packs/epa-aqs/endpoints.json +174 -0
  489. package/packs/epa-aqs/policy.json +96 -0
  490. package/packs/epa-aqs/source.md +97 -0
  491. package/packs/fbi/endpoints.json +1842 -0
  492. package/packs/fbi/policy.json +118 -0
  493. package/packs/fbi/source.md +108 -0
  494. package/packs/fda/endpoints.json +238 -0
  495. package/packs/fda/policy.json +121 -0
  496. package/packs/fda/source.md +117 -0
  497. package/packs/fdic/endpoints.json +417 -0
  498. package/packs/fdic/policy.json +83 -0
  499. package/packs/fdic/source.md +92 -0
  500. package/packs/fec/endpoints.json +708 -0
  501. package/packs/fec/policy.json +93 -0
  502. package/packs/fec/source.md +90 -0
  503. package/packs/fed-board/endpoints.json +89 -0
  504. package/packs/fed-board/policy.json +136 -0
  505. package/packs/fed-board/source.md +118 -0
  506. package/packs/federal-register/endpoints.json +143 -0
  507. package/packs/federal-register/policy.json +86 -0
  508. package/packs/federal-register/source.md +98 -0
  509. package/packs/fema/endpoints.json +646 -0
  510. package/packs/fema/policy.json +103 -0
  511. package/packs/fema/source.md +103 -0
  512. package/packs/fhfa/endpoints.json +105 -0
  513. package/packs/fhfa/policy.json +109 -0
  514. package/packs/fhfa/source.md +108 -0
  515. package/packs/fred/assets/download_fred.ps1 +122 -0
  516. package/packs/fred/assets/download_fred.sh +123 -0
  517. package/packs/fred/docs/analysis_patterns.md +124 -0
  518. package/packs/fred/docs/fred_api.md +94 -0
  519. package/packs/fred/docs/series.md +188 -0
  520. package/packs/fred/policy.json +253 -0
  521. package/packs/fred/source.md +142 -0
  522. package/packs/fsa/endpoints.json +150 -0
  523. package/packs/fsa/policy.json +99 -0
  524. package/packs/fsa/source.md +102 -0
  525. package/packs/govinfo/endpoints.json +520 -0
  526. package/packs/govinfo/policy.json +116 -0
  527. package/packs/govinfo/source.md +241 -0
  528. package/packs/gsa-calc/endpoints.json +93 -0
  529. package/packs/gsa-calc/policy.json +97 -0
  530. package/packs/gsa-calc/source.md +108 -0
  531. package/packs/hud/endpoints.json +147 -0
  532. package/packs/hud/policy.json +84 -0
  533. package/packs/hud/source.md +97 -0
  534. package/packs/ipums/assets/download_ipums.ps1 +215 -0
  535. package/packs/ipums/assets/download_ipums.sh +192 -0
  536. package/packs/ipums/docs/ipums_api.md +67 -0
  537. package/packs/ipums/docs/report_patterns.md +117 -0
  538. package/packs/ipums/docs/variables.md +284 -0
  539. package/packs/ipums/lib/fetch_text.json +112 -0
  540. package/packs/ipums/policy.json +215 -0
  541. package/packs/ipums/source.md +169 -0
  542. package/packs/irs-soi/endpoints.json +114 -0
  543. package/packs/irs-soi/policy.json +107 -0
  544. package/packs/irs-soi/source.md +124 -0
  545. package/packs/medicaid/endpoints.json +412 -0
  546. package/packs/medicaid/policy.json +108 -0
  547. package/packs/medicaid/source.md +136 -0
  548. package/packs/naep/endpoints.json +217 -0
  549. package/packs/naep/policy.json +100 -0
  550. package/packs/naep/source.md +120 -0
  551. package/packs/nhtsa/endpoints.json +132 -0
  552. package/packs/nhtsa/policy.json +93 -0
  553. package/packs/nhtsa/source.md +109 -0
  554. package/packs/nih/endpoints.json +453 -0
  555. package/packs/nih/policy.json +86 -0
  556. package/packs/nih/source.md +108 -0
  557. package/packs/noaa/endpoints.json +432 -0
  558. package/packs/noaa/policy.json +95 -0
  559. package/packs/noaa/source.md +88 -0
  560. package/packs/nrel/endpoints.json +328 -0
  561. package/packs/nrel/policy.json +96 -0
  562. package/packs/nrel/source.md +91 -0
  563. package/packs/nws/endpoints.json +272 -0
  564. package/packs/nws/policy.json +82 -0
  565. package/packs/nws/source.md +81 -0
  566. package/packs/nyfed/endpoints.json +80 -0
  567. package/packs/nyfed/policy.json +92 -0
  568. package/packs/nyfed/source.md +89 -0
  569. package/packs/omb/endpoints.json +460 -0
  570. package/packs/omb/policy.json +106 -0
  571. package/packs/omb/source.md +130 -0
  572. package/packs/open-payments/endpoints.json +298 -0
  573. package/packs/open-payments/policy.json +101 -0
  574. package/packs/open-payments/source.md +99 -0
  575. package/packs/opm/assets/download_opm.ps1 +125 -0
  576. package/packs/opm/assets/download_opm.sh +85 -0
  577. package/packs/opm/docs/fields.md +184 -0
  578. package/packs/opm/docs/opm_api.md +71 -0
  579. package/packs/opm/docs/report_patterns.md +83 -0
  580. package/packs/opm/lib/data_dictionary.csv +73 -0
  581. package/packs/opm/policy.json +142 -0
  582. package/packs/opm/source.md +137 -0
  583. package/packs/pbgc/endpoints.json +483 -0
  584. package/packs/pbgc/policy.json +94 -0
  585. package/packs/pbgc/source.md +95 -0
  586. package/packs/philfed/endpoints.json +85 -0
  587. package/packs/philfed/policy.json +94 -0
  588. package/packs/philfed/source.md +125 -0
  589. package/packs/port.json +287 -0
  590. package/packs/regulations/endpoints.json +288 -0
  591. package/packs/regulations/policy.json +86 -0
  592. package/packs/regulations/source.md +84 -0
  593. package/packs/sec/endpoints.json +237 -0
  594. package/packs/sec/policy.json +86 -0
  595. package/packs/sec/source.md +101 -0
  596. package/packs/senate-lobbying/endpoints.json +554 -0
  597. package/packs/senate-lobbying/policy.json +99 -0
  598. package/packs/senate-lobbying/source.md +100 -0
  599. package/packs/snapqc/endpoints.json +1426 -0
  600. package/packs/snapqc/policy.json +92 -0
  601. package/packs/snapqc/source.md +96 -0
  602. package/packs/treasury/catalog.json +2267 -0
  603. package/packs/treasury/docs/api_guide.md +245 -0
  604. package/packs/treasury/docs/datasets.md +56 -0
  605. package/packs/treasury/docs/report_patterns.md +126 -0
  606. package/packs/treasury/policy.json +159 -0
  607. package/packs/treasury/source.md +170 -0
  608. package/packs/treasury-yields/endpoints.json +226 -0
  609. package/packs/treasury-yields/policy.json +86 -0
  610. package/packs/treasury-yields/source.md +80 -0
  611. package/packs/usaspending/endpoints.json +1316 -0
  612. package/packs/usaspending/policy.json +109 -0
  613. package/packs/usaspending/source.md +103 -0
  614. package/packs/usda-fna/endpoints.json +427 -0
  615. package/packs/usda-fna/policy.json +133 -0
  616. package/packs/usda-fna/source.md +217 -0
  617. package/packs/usda-fooddata/endpoints.json +181 -0
  618. package/packs/usda-fooddata/policy.json +94 -0
  619. package/packs/usda-fooddata/source.md +105 -0
  620. package/packs/usda-nass/endpoints.json +324 -0
  621. package/packs/usda-nass/policy.json +95 -0
  622. package/packs/usda-nass/source.md +85 -0
  623. package/packs/usda-outlook/endpoints.json +86 -0
  624. package/packs/usda-outlook/policy.json +109 -0
  625. package/packs/usda-outlook/source.md +144 -0
  626. package/packs/usgs/endpoints.json +313 -0
  627. package/packs/usgs/policy.json +95 -0
  628. package/packs/usgs/source.md +96 -0
  629. package/packs/usitc/endpoints.json +74 -0
  630. package/packs/usitc/policy.json +111 -0
  631. package/packs/usitc/source.md +90 -0
  632. package/packs/uspto/endpoints.json +141 -0
  633. package/packs/uspto/policy.json +95 -0
  634. package/packs/uspto/source.md +101 -0
  635. package/packs/va/endpoints.json +414 -0
  636. package/packs/va/policy.json +101 -0
  637. package/packs/va/source.md +129 -0
  638. package/packs/world-bank/endpoints.json +122 -0
  639. package/packs/world-bank/policy.json +101 -0
  640. package/packs/world-bank/source.md +93 -0
@@ -0,0 +1,93 @@
1
+ {
2
+ "id": "fec",
3
+ "title": "OpenFEC (Federal Election Commission API)",
4
+ "agency": "Federal Election Commission",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "elections",
8
+ "campaign finance",
9
+ "legislation"
10
+ ],
11
+ "keywords": [
12
+ "fec",
13
+ "campaign finance",
14
+ "campaign contributions",
15
+ "donors",
16
+ "fundraising",
17
+ "pac",
18
+ "super pac",
19
+ "political action committee",
20
+ "candidate",
21
+ "independent expenditures",
22
+ "outside spending",
23
+ "itemized contributions",
24
+ "small donors",
25
+ "disbursements",
26
+ "election",
27
+ "race"
28
+ ],
29
+ "questions": [
30
+ "how much did each Senate candidate raise in a race",
31
+ "outside spending for or against a candidate",
32
+ "share of a candidate's money from small donors",
33
+ "contributions from employees of a company",
34
+ "where a PAC's money went"
35
+ ],
36
+ "homepage": "https://www.fec.gov/data/",
37
+ "terms_url": "https://www.fec.gov/updates/sale-or-use-contributor-information/",
38
+ "auth": {
39
+ "env": "DATA_GOV_API_KEY",
40
+ "required": "optional",
41
+ "placement": "query",
42
+ "param": "api_key",
43
+ "home": "data-gov",
44
+ "signup_url": "https://api.data.gov/signup/",
45
+ "echoes_key": false,
46
+ "demo_key": "DEMO_KEY",
47
+ "key_only": [
48
+ "more than a few requests an hour (DEMO_KEY limit); itemized schedules page 100 rows per request"
49
+ ]
50
+ },
51
+ "limits": {
52
+ "rps": 1,
53
+ "burst": 4,
54
+ "daily_quota": null,
55
+ "max_rows": 50000
56
+ },
57
+ "routes": {
58
+ "api": {
59
+ "base": "https://api.open.fec.gov/v1",
60
+ "probe": "https://api.open.fec.gov/v1/candidates/?per_page=1",
61
+ "hosts": [
62
+ "api.open.fec.gov"
63
+ ]
64
+ },
65
+ "manual": {
66
+ "how": "Open the links in INSTRUCTIONS.md in a browser (they carry the public DEMO_KEY; put your own api.data.gov key in its place for more) and save each JSON file; or use https://www.fec.gov/data/ (candidates, committees, receipts, disbursements, independent expenditures), set the same filters, click Export to download a CSV, and upload it. Bulk files: https://www.fec.gov/data/browse-data/?tab=bulk-data."
67
+ }
68
+ },
69
+ "cache": {
70
+ "mode": "run_only",
71
+ "ttl_hours": null,
72
+ "why": "Filings and amendments arrive daily and totals are revised; data/ is reused within a run."
73
+ },
74
+ "redistribution": {
75
+ "mode": "allowed",
76
+ "why": "FEC data are public records and U.S. government works. Federal law (52 U.S.C. 30111(a)(4)) forbids selling or using information about individual contributors (names, addresses) to solicit contributions or for any commercial purpose; aggregate tables and committee data may be published freely. Keep contributor-level rows out of anything used for solicitation or commercial purposes."
77
+ },
78
+ "notices": [
79
+ "Contributor information from FEC reports may not be sold or used by any person to solicit contributions or for commercial purposes (52 U.S.C. 30111(a)(4)); this analysis uses it only for research."
80
+ ],
81
+ "retention": null,
82
+ "citation": "Federal Election Commission, OpenFEC API, {dataset}, api.open.fec.gov, retrieved {retrieved_long}.",
83
+ "audit_hooks": [],
84
+ "clarify": [
85
+ "Two-year cycle or the whole election period? Senate totals over 6 years differ from one 2-year cycle; default election_full=true for races.",
86
+ "Candidate committees only, or outside spending too (super PACs, independent expenditures)?",
87
+ "Itemized contributions only (over $200) or totals including unitemized small donations? Itemized rows miss most small donors."
88
+ ],
89
+ "formats": [
90
+ "json",
91
+ "csv"
92
+ ]
93
+ }
@@ -0,0 +1,90 @@
1
+ # OpenFEC (Federal Election Commission API)
2
+ Depth: standard. Key: optional (DATA_GOV_API_KEY; the public DEMO_KEY works for a few requests an hour).
3
+ Federal campaign finance from reports filed with the FEC: candidates, committees, financial totals,
4
+ itemized contributions and disbursements, independent expenditures. Coverage starts around 1980 and
5
+ varies by table; check the earliest cycle before a long trend.
6
+
7
+ ## When to use
8
+ - Money raised and spent by candidates in a race; totals per cycle; small-donor share (by size); where
9
+ contributions come from (by state, employer, occupation); PAC and party money; outside spending for or
10
+ against a candidate; who a committee paid.
11
+ - Not here: lobbying spending and lobbyists' LD-203 contributions (senate-lobbying); state and local
12
+ races (not covered); votes and bills (congress).
13
+
14
+ ## Endpoints and datasets
15
+ | Endpoint | Returns (one row per) | Key parameters |
16
+ |---|---|---|
17
+ | `candidates_search` | candidate | `q` (name), `state`, `office` (H, S, P), `party`, `election_year`, `cycle`, `district` |
18
+ | `candidate`, `candidate_totals` | candidate record; totals per cycle | `candidate_id`, `cycle`, `election_full` |
19
+ | `candidates_totals` | candidate with receipts, disbursements, cash | `office`, `election_year`, `state`, `district`, `is_active_candidate`, `sort` |
20
+ | `elections` | candidate in one race with totals | `office` (house, senate, president), `cycle`, `state`, `district`, `election_full` |
21
+ | `committees`, `committee`, `committee_totals` | committee; record; totals per cycle | `q`, `committee_type`, `designation`, `organization_type`, `committee_id`, `cycle` |
22
+ | `schedule_a` | itemized receipt | `committee_id`, `contributor_name`, `contributor_employer`, `contributor_occupation`, `contributor_state`, `contributor_zip`, `is_individual`, `two_year_transaction_period`, `min_amount`, `min_date`, `per_page` |
23
+ | `schedule_b` | itemized disbursement | `committee_id`, `recipient_name`, `recipient_committee_id`, `disbursement_description`, `two_year_transaction_period` |
24
+ | `schedule_e` | independent expenditure | `candidate_id`, `committee_id`, `support_oppose_indicator` (S, O), `cycle`, `is_notice` |
25
+ | `contributions_by_size`, `contributions_by_state` | size bucket or state for a candidate | `candidate_id`, `cycle`, `election_full` |
26
+ | `committee_contributions_by_state`, `contributions_by_employer`, `contributions_by_occupation`, `disbursements_by_recipient` | state, employer, occupation or recipient for a committee | `committee_id`, `cycle` |
27
+ | `independent_expenditures_by_candidate` | support and oppose totals for a candidate | `candidate_id`, `cycle`, `election_full` |
28
+
29
+ IDs: candidates `S6PA00217` (office letter, first-run year digit, state, number), committees `C00431056`.
30
+ Find them with `candidates_search` or `committees` first. Committee types (catalog `committee_types`):
31
+ P, H, S candidate committees; Q, N PACs; O super PAC; V, W hybrid PAC; X, Y party; I independent
32
+ expenditure filers. A company's PAC is found with `committees` `q=<company>` and `organization_type=C`.
33
+
34
+ ## Spec examples
35
+ ```json
36
+ {"description": "2024 Pennsylvania Senate race and one candidate's small-donor and outside-spending profile",
37
+ "requests": [
38
+ {"name": "pa_senate_2024", "endpoint": "elections", "params": {"office": "senate", "state": "PA", "cycle": 2024}},
39
+ {"name": "casey_by_size", "endpoint": "contributions_by_size", "params": {"candidate_id": "S6PA00217", "cycle": 2024}},
40
+ {"name": "casey_outside", "endpoint": "independent_expenditures_by_candidate",
41
+ "params": {"candidate_id": "S6PA00217", "cycle": 2024}}]}
42
+ ```
43
+ ```json
44
+ {"description": "Top 2024 House fundraisers in Texas",
45
+ "requests": [{"name": "tx_house_2024", "endpoint": "candidates_totals",
46
+ "params": {"office": "H", "state": "TX", "election_year": 2024, "is_active_candidate": "true"}, "max_rows": 200}]}
47
+ ```
48
+ ```json
49
+ {"description": "Contributions from committees (PACs) to one campaign, first 500",
50
+ "requests": [{"name": "pac_receipts", "endpoint": "schedule_a",
51
+ "params": {"committee_id": "C00431056", "two_year_transaction_period": 2024, "is_individual": "false"}, "max_rows": 500}]}
52
+ ```
53
+
54
+ ## Data format and traps
55
+ - Cycles: `cycle` and `two_year_transaction_period` are two-year periods named by the even year (2024 =
56
+ 2023-2024). `election_full=true` (the default here for races and candidate totals) adds up the whole
57
+ election period: 6 years for a Senate seat, 4 for President. Say which one a number uses.
58
+ - Itemized is not total: Schedule A lists contributions over $200 per contributor per cycle (and some
59
+ below); most small-dollar money is only in the unitemized totals. `contributions_by_size` bucket `0`
60
+ is $200 and under, built from reported unitemized totals plus small itemized items (its `count` is
61
+ empty). Use `candidate_totals` for receipts and the size buckets for donor mix.
62
+ - Earmarked and conduit money (ActBlue, WinRed) appears twice in itemized data: once at the conduit and
63
+ once at the recipient (`memo_code` X marks memo entries). Leave memo rows out when summing receipts.
64
+ - Rows marked `- UNITEMIZED` in `contributor_name` (joint fundraising transfers) are aggregate amounts,
65
+ not one contribution.
66
+ - Keyset paging: Schedules A, B and E page with `last_indexes` (the pack does it); `count` there is
67
+ approximate when `is_count_exact` is false. Pages are at most 100 rows; a 50,000-row download is 500
68
+ requests, so narrow by committee, date or amount first.
69
+ - Totals are revised when committees amend reports; recent quarters change for months. Report the
70
+ retrieval date and `coverage_end_date`.
71
+ - Employer and occupation are typed by contributors ("SELF", "RETIRED", "NOT EMPLOYED", spelling
72
+ variants); group with care and say so. The by-employer aggregate does not merge variants.
73
+ - Amounts are dollars (numbers). Independent expenditures `support_oppose_indicator`: S support, O oppose;
74
+ 24/48-hour notices (`is_notice=true`) are later repeated in regular reports, so do not add both.
75
+ - Candidate names are "LAST, FIRST" in capitals; party codes are three letters (DEM, REP, LIB, GRE, IND).
76
+
77
+ ## Access
78
+ Key optional: DATA_GOV_API_KEY (https://api.data.gov/signup/), sent as `api_key`. DEMO_KEY allows only
79
+ a few requests an hour per IP; with a key the limit is per key. FEC documents 1,000 calls an hour for a
80
+ key and 7,200 an hour (120 a minute) on request to APIinfo@fec.gov (API description, 2026-10-22), but the
81
+ response header showed X-RateLimit-Limit 60 on a standard key (Oct 2026): plan for 60 and pace large specs. Without a key, larger specs stop with `key_missing`.
82
+ Manual route (`manual_bundle`): INSTRUCTIONS.md lists JSON links with `api_key=DEMO_KEY` (itemized schedules: the first
83
+ 100 rows only); or set the same filters on https://www.fec.gov/data/ and use Export (CSV); whole
84
+ cycles are in the bulk files at https://www.fec.gov/data/browse-data/?tab=bulk-data.
85
+
86
+ ## Citation and terms
87
+ "Federal Election Commission, OpenFEC API, <query>, api.open.fec.gov, retrieved <date>." Public
88
+ records; aggregate tables may be published. Required notice: information about individual contributors
89
+ may not be sold or used to solicit contributions or for commercial purposes (52 U.S.C. 30111(a)(4)).
90
+ Do not publish contributor-level lists (names, addresses) beyond what the analysis needs.
@@ -0,0 +1,89 @@
1
+ {
2
+ "base_url": "https://www.federalreserve.gov",
3
+ "timeout": 120,
4
+ "endpoints": {
5
+ "ddp": {
6
+ "path": "/datadownload/Output.aspx",
7
+ "description": "One preformatted Data Download Program package of a Board release as CSV, reshaped to one row per series and date: date, series, value, value_flag (ND = no data), description, unit, multiplier, currency, unique_id. The value times multiplier is in unit (Currency x 1000000 = millions of dollars).",
8
+ "params": {
9
+ "rel": {"in": "spec", "desc": "release code: G19 (consumer credit), Z1 (Financial Accounts), SLOOS, SCOOS, H8 (bank balance sheets), H6 (money stock), H15 (interest rates), H41 (Fed balance sheet), G17 (industrial production), G20 (finance companies), CHGDEL (charge-offs and delinquencies), DSR / FOR (debt service ratios), CP (commercial paper), H10 (exchange rates), H3, E2, PRATES. Optional with a catalog package alias"},
10
+ "package": {"in": "spec", "required": true, "catalog": true, "desc": "the package: its 32-character id, its title as listed by ddp_packages (exact, or a unique start or part: 'Consumer Credit Outstanding (S.A.)', 'S1M.b (Q)'), or a catalog alias (g19_all, g19_sa, sloos, z1_b101 ...)"},
11
+ "series_ids": {"in": "spec", "desc": "optional list of series codes (the Time Period header, e.g. DTCTL.M) or unique identifiers (G19/CCOUT/DTCTL.M) to keep"},
12
+ "lastobs": {"in": "spec", "desc": "optional: only the last N observations of each series (applied by the pack to the whole package)"},
13
+ "from": {"in": "spec", "desc": "optional first date: YYYY, YYYY-MM, YYYY-MM-DD or YYYYQn (applied by the pack)"},
14
+ "to": {"in": "spec", "desc": "optional last date, inclusive: YYYY, YYYY-MM, YYYY-MM-DD or YYYYQn"}
15
+ },
16
+ "records": "$csv",
17
+ "paging": {"type": "none"},
18
+ "max_rows": 300000
19
+ },
20
+ "ddp_packages": {
21
+ "path": "/datadownload/Choose.aspx",
22
+ "description": "The preformatted packages of one release (scraped from its Choose page): package_title, package (id), listed (format, default observations, size).",
23
+ "params": {
24
+ "rel": {"in": "query", "required": true, "desc": "release code, e.g. G19, Z1 (435 packages), SLOOS"}
25
+ },
26
+ "records": "$csv",
27
+ "paging": {"type": "none"}
28
+ },
29
+ "z1": {
30
+ "path": "/releases/z1/current/z1_csv_files.zip",
31
+ "description": "One table of the Financial Accounts of the United States (Z.1) from the Board's bulk CSV zip (8 MB, current release), one row per series and date: date (1945:Q4 ... 2026:Q2), series, value (millions of dollars unless the units say otherwise), value_flag (ND), description, line, units, table, table_published.",
32
+ "params": {
33
+ "table": {"in": "spec", "required": true, "desc": "table code, new style (S1M.b, S1M.s, F3.2.s, S1311.s) or the published name it replaced (B.101, L.101, F.101, L.210, L.106); z1_tables lists both"},
34
+ "series_ids": {"in": "spec", "desc": "optional list of series codes to keep, e.g. FL152000005.Q (with or without the .Q)"},
35
+ "start": {"in": "spec", "desc": "optional first date, YYYY or YYYY:Qn"},
36
+ "end": {"in": "spec", "desc": "optional last date, YYYY or YYYY:Qn"}
37
+ },
38
+ "records": "$zip:csv/*.csv",
39
+ "paging": {"type": "none"}
40
+ },
41
+ "z1_tables": {
42
+ "path": "/releases/z1/current/z1_table_mapping.csv",
43
+ "description": "Z.1 table list: new (the code the zip and DDP use, e.g. S1M.b), old (the published table name, e.g. B.101), title.",
44
+ "params": {},
45
+ "records": "$csv",
46
+ "paging": {"type": "none"}
47
+ },
48
+ "scf_chart": {
49
+ "path": "/econres/scf/dataviz/download/zips/scf.zip",
50
+ "description": "Survey of Consumer Finances interactive chart data, 1989-2025 (triennial): one row per survey year and group (Category), one column per item (Before_Tax_Income, Net_Worth, Assets, Financial_Assets, Retirement_Accounts, Primary_Residence, Debt, Credit_Card_Balances, Education_Installment_Loans ...). Mean and median in thousands of 2025 dollars; have = percent of families holding the item.",
51
+ "params": {
52
+ "group": {"in": "spec", "required": true, "enum": ["all", "agecl", "edcl", "famstruct", "housecl", "inccat", "nwcat", "occat1", "occat2", "racecl4"], "desc": "family grouping: all, agecl (age of head), edcl (education), famstruct, housecl (owner/renter), inccat (income percentile), nwcat (net worth percentile), occat1 / occat2 (work status / occupation), racecl4 (race and ethnicity)"},
53
+ "stat": {"in": "spec", "required": true, "enum": ["median", "mean", "have"], "desc": "median or mean (among families that hold the item, thousands of 2025 dollars) or have (percent of families holding it)"}
54
+ },
55
+ "records": "$zip:*.csv",
56
+ "paging": {"type": "none"}
57
+ },
58
+ "scf_table": {
59
+ "path": "/econres/files/{file}.xlsx",
60
+ "description": "One sheet of the 2025 SCF published summary tables (1989-2025), as a raw grid: row (sheet row number) and c1..cN (cells as stored); the sheets have titles and multi-row headers, so read the grid, do not expect tidy columns.",
61
+ "params": {
62
+ "file": {"in": "path", "required": true, "enum": ["scf2025_tables_public_real_historical", "scf2025_tables_public_nominal_historical"], "desc": "real = thousands of 2025 dollars; nominal = dollars of each survey year"},
63
+ "sheet": {"in": "spec", "required": true, "desc": "sheet name, e.g. 'Table 4' (net worth by family characteristics), 'Table 1 01-25' (income); a wrong name lists the sheets"}
64
+ },
65
+ "records": "$xlsx",
66
+ "paging": {"type": "none"}
67
+ }
68
+ },
69
+ "catalog": {
70
+ "g19_all": {"id": "56a37b655eef16e2ede83467282a6e95", "rel": "G19", "endpoint": "ddp", "name": "G.19 Consumer Credit Outstanding - All", "description": "monthly since 1943: totals, revolving, nonrevolving, SA and NSA levels, percent changes, holders (millions of dollars)"},
71
+ "g19_sa": {"id": "696245eb361e0a8bc89b8e5b01cc971b", "rel": "G19", "endpoint": "ddp", "name": "G.19 Consumer Credit Outstanding (S.A.)", "description": "seasonally adjusted totals and percent changes (headline)"},
72
+ "g19_terms": {"id": "10264fd36110a9c4906bd99f1daccf29", "rel": "G19", "endpoint": "ddp", "name": "G.19 Terms of Credit", "description": "interest rates on credit cards, auto loans, personal loans; loan terms"},
73
+ "g19_holders_nsa": {"id": "417121472f75218035c6ba3770a5ebf5", "rel": "G19", "endpoint": "ddp", "name": "G.19 Major Holders (N.S.A.)", "description": "consumer credit by holder: banks, finance companies, credit unions, federal government (student loans), ..."},
74
+ "g19_flows": {"id": "8605d1da650f3e18ed4d8ebd31c1cab2", "rel": "G19", "endpoint": "ddp", "name": "G.19 Consumer Credit Outstanding - (Flow)", "description": "monthly changes (flows)"},
75
+ "sloos": {"id": "e64f07187815f0e7ed89237d8cb91eeb", "rel": "SLOOS", "endpoint": "ddp", "name": "Senior Loan Officer Opinion Survey - All chart data", "description": "quarterly net percentages of banks tightening standards and reporting stronger demand, by loan type"},
76
+ "scoos": {"id": "d7ddcd636ef03b879c632a42477a0535", "rel": "SCOOS", "endpoint": "ddp", "name": "Senior Credit Officer Opinion Survey - all active questions", "description": "dealer financing terms, quarterly since 2010:Q2"},
77
+ "z1_b101": {"id": "551e7dfea97fff844e2d605f0716a500", "rel": "Z1", "endpoint": "ddp", "name": "Z.1 S1M.b (Q) Households and nonprofit organizations balance sheet (B.101)", "description": "quarterly balance sheet, net worth, millions of dollars"},
78
+ "z1_l101": {"id": "fe354c3d420803392448004ea863b975", "rel": "Z1", "endpoint": "ddp", "name": "Z.1 S1M.s (Q) Households and nonprofit organizations levels (L.101)", "description": "financial assets and liabilities outstanding"},
79
+ "z1_f101": {"id": "088b1e81bdf443c73231e042c3a744db", "rel": "Z1", "endpoint": "ddp", "name": "Z.1 S1M.t (Q) Households and nonprofit organizations transactions (F.101)", "description": "flows, seasonally adjusted annual rates"},
80
+ "z1_l106": {"id": "43e1df4e46d36e9501b35cd92bc7266f", "rel": "Z1", "endpoint": "ddp", "name": "Z.1 S1311.s (Q) Federal government levels (L.106)", "description": "federal financial assets and liabilities"},
81
+ "h15_treasury_cmt": {"id": "bf17364827e38702b42a58cf8eaa3f78", "rel": "H15", "endpoint": "ddp", "name": "H.15 Treasury Constant Maturities", "description": "daily market yields, 1-month to 30-year (also in treasury-yields and fred)"},
82
+ "h6_monthly": {"id": "798e2796917702a5f8423426ba7e6b42", "rel": "H6", "endpoint": "ddp", "name": "H.6 M1, M2 and other release data, monthly", "description": "billions of dollars"},
83
+ "h8_all_banks_sa": {"id": "17951c643555bee48d63bb6957a4a92e", "rel": "H8", "endpoint": "ddp", "name": "H.8 All Commercial Banks, SA (Weekly)", "description": "assets and liabilities of commercial banks, weekly, seasonally adjusted"},
84
+ "g17_summary": {"id": "809009461b1cba2fd5b4cf5557d9d663", "rel": "G17", "endpoint": "ddp", "name": "G.17 Summary Table Data", "description": "industrial production and capacity utilization summary"},
85
+ "chgdel_rates_all": {"id": "929faaa8d5e6bf375839d7fc2b7760fe", "rel": "CHGDEL", "endpoint": "ddp", "name": "Charge-off rates/All banks", "description": "quarterly charge-off rates by loan type, percent"},
86
+ "debt_service": {"id": "e38200c11a744800391ad51150cee181", "rel": "DSR", "endpoint": "ddp", "name": "Household Debt Service Ratios", "description": "quarterly, percent of disposable income"},
87
+ "prates_daily": {"id": "c27939ee810cb2e929a920a6bd77d9f6", "rel": "PRATES", "endpoint": "ddp", "name": "Policy Rates - Daily", "description": "interest on reserve balances, discount rate, ON RRP rate"}
88
+ }
89
+ }
@@ -0,0 +1,136 @@
1
+ {
2
+ "id": "fed-board",
3
+ "title": "Federal Reserve Board data (Data Download Program releases, Z.1 Financial Accounts, Survey of Consumer Finances)",
4
+ "agency": "Board of Governors of the Federal Reserve System",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "household finance",
8
+ "credit",
9
+ "financial accounts",
10
+ "wealth",
11
+ "banking",
12
+ "monetary policy"
13
+ ],
14
+ "keywords": [
15
+ "federal reserve board",
16
+ "consumer credit",
17
+ "g.19",
18
+ "revolving credit",
19
+ "student loans",
20
+ "auto loans",
21
+ "financial accounts",
22
+ "flow of funds",
23
+ "z.1",
24
+ "household net worth",
25
+ "household balance sheet",
26
+ "household debt",
27
+ "sector balance sheets",
28
+ "federal government debt holders",
29
+ "senior loan officer",
30
+ "sloos",
31
+ "lending standards",
32
+ "survey of consumer finances",
33
+ "scf",
34
+ "wealth distribution",
35
+ "median net worth",
36
+ "family income",
37
+ "h.8",
38
+ "h.6",
39
+ "money stock",
40
+ "g.17",
41
+ "industrial production",
42
+ "charge-off",
43
+ "delinquency",
44
+ "debt service ratio"
45
+ ],
46
+ "questions": [
47
+ "total consumer credit outstanding, latest month",
48
+ "household and nonprofit net worth from the Financial Accounts (B.101)",
49
+ "median family net worth by age or race in the 2025 Survey of Consumer Finances",
50
+ "share of banks tightening standards on commercial and industrial loans (SLOOS)",
51
+ "who holds Treasury securities by sector (Z.1)"
52
+ ],
53
+ "homepage": "https://www.federalreserve.gov/data.htm",
54
+ "terms_url": "https://www.federalreserve.gov/disclaimer.htm",
55
+ "auth": {
56
+ "env": null,
57
+ "required": "none",
58
+ "placement": "none",
59
+ "signup_url": null,
60
+ "echoes_key": false
61
+ },
62
+ "limits": {
63
+ "rps": 1,
64
+ "burst": 3,
65
+ "max_rows": 200000
66
+ },
67
+ "routes": {
68
+ "api": {
69
+ "base": "https://www.federalreserve.gov",
70
+ "probe": "https://www.federalreserve.gov/releases/z1/current/z1_table_mapping.csv",
71
+ "hosts": [
72
+ "www.federalreserve.gov"
73
+ ]
74
+ },
75
+ "manual": {
76
+ "how": "Open each link in manual_download/INSTRUCTIONS.md in a browser and save the file under the name shown, then upload it. A Data Download Program (DDP) link given by package title opens the release's Choose page (https://www.federalreserve.gov/datadownload/Choose.aspx?rel=<release>): pick that preformatted package, click Format package, keep CSV, then Download file. Z.1 tables: https://www.federalreserve.gov/releases/z1/current/z1_csv_files.zip (upload the zip, or the one table CSV from its csv/ folder). SCF: https://www.federalreserve.gov/econres/scfindex.htm (interactive chart data scf.zip, summary tables workbook)."
77
+ }
78
+ },
79
+ "cache": {
80
+ "mode": "run_only",
81
+ "ttl_hours": null,
82
+ "why": "Releases update weekly to quarterly (SCF every three years); data/ is reused only within a run."
83
+ },
84
+ "redistribution": {
85
+ "mode": "allowed",
86
+ "why": "Board website terms (https://www.federalreserve.gov/disclaimer.htm): information on the Board's website is in the public domain unless otherwise indicated and may be copied and distributed without permission; cite the Board as the source."
87
+ },
88
+ "notices": [],
89
+ "retention": null,
90
+ "citation": "Board of Governors of the Federal Reserve System, {dataset}, federalreserve.gov, retrieved {retrieved_long}.",
91
+ "audit_hooks": [],
92
+ "clarify": [
93
+ "Seasonally adjusted or not? G.19 publishes both; the headline is seasonally adjusted. Default: seasonally adjusted where it exists, named in the answer.",
94
+ "Levels (amounts outstanding) or flows (transactions, often at seasonally adjusted annual rates)? Default: levels.",
95
+ "SCF dollars: survey-year (nominal) or inflation-adjusted 2025 dollars? Default: 2025 dollars for comparisons across surveys, nominal for one survey year."
96
+ ],
97
+ "formats": [
98
+ "csv",
99
+ "xlsx"
100
+ ],
101
+ "use_instead": [
102
+ {
103
+ "question": "One Board series' long history or its past vintages",
104
+ "source": "fred",
105
+ "terms": [
106
+ "ALFRED"
107
+ ],
108
+ "why": "FRED mirrors most Board series; ALFRED keeps vintages."
109
+ },
110
+ {
111
+ "question": "SOFR, EFFR, SOMA holdings, primary dealer positions",
112
+ "source": "nyfed",
113
+ "terms": [
114
+ "SOFR",
115
+ "SOMA"
116
+ ],
117
+ "why": "The New York Fed publishes these."
118
+ },
119
+ {
120
+ "question": "Forecasts of these series",
121
+ "source": "philfed",
122
+ "terms": [
123
+ "Greenbook"
124
+ ],
125
+ "why": "SPF and Greenbook forecasts."
126
+ },
127
+ {
128
+ "question": "Bank-level balance sheets and income",
129
+ "source": "fdic",
130
+ "terms": [
131
+ "call report"
132
+ ],
133
+ "why": "FDIC institution financials."
134
+ }
135
+ ]
136
+ }
@@ -0,0 +1,118 @@
1
+ # Federal Reserve Board data (DDP releases, Z.1 Financial Accounts, Survey of Consumer Finances)
2
+ Depth: standard. Key: none. The Board of Governors' own statistical releases through its Data Download Program
3
+ (G.19 consumer credit, Senior Loan Officer survey, H.8 bank balance sheets, H.6 money stock, G.17 industrial
4
+ production, charge-offs, debt service ratios, Z.1 packages ...), the Financial Accounts of the United States (Z.1)
5
+ from its bulk CSV files, and the triennial Survey of Consumer Finances (SCF) chart data and summary tables.
6
+
7
+ ## When to use
8
+ - Consumer credit outstanding (revolving, nonrevolving, by holder, interest rates on cards and auto loans); sector
9
+ balance sheets and who holds what (household net worth B.101, Treasury securities by holder, federal government
10
+ financial assets and liabilities); bank lending standards (SLOOS); family income and wealth by age, income,
11
+ education, race in the SCF (medians, means, ownership rates, 1989-2025); a whole release package at once.
12
+ - Not here: one series' long history or its past vintages (fred has most Board series: TOTALSL, REVOLSL, household
13
+ net worth BOGZ1FL152090005Q, SLOOS DRTSCILM; ALFRED keeps vintages), Treasury yields as a curve (treasury-yields),
14
+ SOFR/EFFR, SOMA holdings and dealer data (nyfed), forecasts of these series (philfed for private and Greenbook
15
+ forecasts), household debt from credit records (NY Fed Household Debt and Credit report: not covered), bank-level
16
+ data (fdic). SCF microdata are not wrapped (see Access).
17
+
18
+ ## Endpoints and datasets
19
+ Base `https://www.federalreserve.gov`, keyless (verified live 2026-10-30). Long format for `ddp` and `z1`: one row
20
+ per series and date, with the series' own description and units on every row.
21
+
22
+ | Endpoint | Returns (one row per) | Key parameters | Units, coverage |
23
+ |---|---|---|---|
24
+ | `ddp` | series x date: `date`, `series`, `value`, `value_flag`, `description`, `unit`, `multiplier`, `currency`, `unique_id` | `rel` (release code), `package` (id, title or catalog alias), `series_ids`, `from`, `to`, `lastobs` | value x multiplier in unit; each release's own frequency and history |
25
+ | `ddp_packages` | package of a release: `package_title`, `package` (id), `listed` | `rel` | G19 7 packages, Z1 435, SLOOS 1 |
26
+ | `z1` | series x date: `date` (1945:Q4 ... 2026:Q2), `series`, `value`, `value_flag`, `description`, `line`, `units`, `table`, `table_published` | `table` (S1M.b or B.101), `series_ids`, `start`, `end` | millions of dollars; current release only |
27
+ | `z1_tables` | Z.1 table: `new` (S1M.b), `old` (B.101), `title` | none | 218 tables |
28
+ | `scf_chart` | survey year x group (`year`, `Category`), one column per item | `group` (all, agecl, edcl, famstruct, housecl, inccat, nwcat, occat1, occat2, racecl4), `stat` (median, mean, have) | thousands of 2025 dollars (median/mean), percent of families (have); 1989-2025, triennial |
29
+ | `scf_table` | non-empty sheet row: `row`, `c1`..`cN` (raw grid) | `file` (`scf2025_tables_public_real_historical` or `..._nominal_historical`), `sheet` ('Table 4') | as titled on the sheet |
30
+
31
+ Release codes for `rel`: G19 consumer credit, Z1 financial accounts, SLOOS, SCOOS, H8 commercial bank assets and
32
+ liabilities, H6 money stock, H15 interest rates, H41 Fed balance sheet, H3 reserves, G17 industrial production,
33
+ G20 finance companies, CHGDEL charge-offs and delinquencies, DSR / FOR debt service ratios, CP commercial paper, H10
34
+ exchange rates, E2 business lending terms, PRATES policy rates. Catalog aliases for `package` (they carry the
35
+ release): `g19_all`, `g19_sa`, `g19_terms`, `g19_holders_nsa`, `g19_flows`, `sloos`, `scoos`, `z1_b101`, `z1_l101`,
36
+ `z1_f101`, `z1_l106`, `h15_treasury_cmt`, `h6_monthly`, `h8_all_banks_sa`, `g17_summary`, `chgdel_rates_all`,
37
+ `debt_service`, `prates_daily` (a `request_schema` search finds them). Z.1 DDP packages are titled by the new table codes:
38
+ "S1M.b (Q)" = B.101 quarterly, "(A)" annual.
39
+
40
+ ## Spec examples
41
+ ```json
42
+ {"description": "Total consumer credit outstanding (seasonally adjusted) since 2025 and the SLOOS",
43
+ "requests": [
44
+ {"name": "g19_sa", "endpoint": "ddp", "params": {"package": "g19_sa", "from": "2025-01",
45
+ "series_ids": ["DTCTL.M", "DTCTLR.M", "DTCTLN.M", "DTCTL_@%A_BA.M"]}},
46
+ {"name": "sloos", "endpoint": "ddp", "params": {"package": "sloos", "lastobs": 8}}]}
47
+ ```
48
+ ```json
49
+ {"description": "Household and nonprofit balance sheet (B.101) and federal government levels (L.106) since 2020",
50
+ "requests": [
51
+ {"name": "b101", "endpoint": "z1", "params": {"table": "B.101", "start": "2020"}},
52
+ {"name": "l106", "endpoint": "z1", "params": {"table": "L.106", "start": "2020"}},
53
+ {"name": "z1_tables", "endpoint": "z1_tables", "params": {}}]}
54
+ ```
55
+ ```json
56
+ {"description": "SCF 1989-2025: median net worth and income by race, ownership rates, Table 4",
57
+ "requests": [
58
+ {"name": "race_median", "endpoint": "scf_chart", "params": {"group": "racecl4", "stat": "median"}},
59
+ {"name": "all_have", "endpoint": "scf_chart", "params": {"group": "all", "stat": "have"}},
60
+ {"name": "table4", "endpoint": "scf_table", "params": {"file": "scf2025_tables_public_real_historical", "sheet": "Table 4"}}]}
61
+ ```
62
+ A package can also be named by title with its release: `{"rel": "H8", "package": "All Commercial Banks, SA (Weekly)"}`;
63
+ an ambiguous or unknown title lists the candidates. `ddp_packages` lists every title and id of a release.
64
+
65
+ ## Data format and traps
66
+ - DDP units: `value` x `multiplier` is in `unit`. "Currency" with multiplier 1000000 = millions of dollars: G.19
67
+ total consumer credit DTCTL.M 5,196,778.44 for 2026-08 is $5,196.8 billion, as on the G.19 release page
68
+ (verified 2026-10-30). Percent-change series (`..._@%A_BA.M`) are seasonally adjusted annual rates. ND in a cell
69
+ = no data (`value` empty, `value_flag` ND); blank cells are dropped.
70
+ - G.19 series names say SA or NSA; the headline is SA. "Owned and securitized" totals include securitized pools.
71
+ Consumer credit excludes loans secured by real estate (mortgages, home equity). Student loans sit mostly in the
72
+ federal government holder (NSA). Discontinued series end with a note in the description ("discontinued after
73
+ February 2011"). Levels are end of month; G.19 comes out about five weeks after the month.
74
+ - The pack always downloads the whole package and applies `from`, `to`, `lastobs` and `series_ids` itself: the DDP's
75
+ own date subsetting answered some new date combinations with an empty file (and a from without a to always did)
76
+ in testing on 2026-10-30. An empty file is retried twice, then reported (a wrong package id also gives one).
77
+ - DDP retirement: the Board removes the DDP's "Build Your Package" feature the week of November 9, 2026, "in
78
+ preparation for the eventual retirement of the DDP"; the preformatted packages this pack uses still worked on
79
+ 2026-10-30. If `ddp` fails with HTML or empty files, use fred for the series, the release's own page (CSV/XML
80
+ files), or `z1` for the Financial Accounts.
81
+ - Z.1 levels vs flows: series codes start with FL (level, end of period), LM (level at market value), FA
82
+ (transactions, seasonally adjusted annual rate), FU (transactions, not seasonally adjusted), FR (revaluations), FV
83
+ (other volume changes); `units` states it per series. Flows at annual rates are four times a quarter's flow: do not
84
+ add four quarters of FA. Levels are not seasonally adjusted. Millions of dollars.
85
+ - Z.1 table names changed: the zip and the DDP use new codes (S1M.b, S1M.s, S1M.t, S1311.s); the published table names
86
+ (B.101 balance sheet, L.101 levels, F.101 flows, L.106 federal government, L.210 Treasury securities) map through
87
+ `z1_tables`; `z1` accepts either. The first observations are annual (1945:Q4 ... 1951:Q4, fourth quarters only),
88
+ quarterly from 1952:Q1. Every quarterly release revises history and the zip holds only the current release
89
+ (2026:Q2, released September 2026); say which release the numbers come from. Household net worth (FL152090005.Q,
90
+ B.101 line 42) for 2026:Q2: 195,870,496 = $195.9 trillion. Households here include nonprofit organizations
91
+ (S14.b / B.101.h is households alone).
92
+ - SCF is triennial (1989 ... 2022, 2025); no years in between. Chart data are in thousands of 2025 dollars
93
+ (1989 median net worth 118.74 equals Table 4 of the real tables); the `nominal` tables workbook is in dollars of
94
+ each survey year: never mix the two. Before-tax income is for the calendar year before the survey.
95
+ - SCF medians and means of an asset or debt are among families that hold it (`have` = percent holding it): the median
96
+ directly held bond holding of 140 (2025) applies to the 1.3 percent who hold bonds. Net worth and income medians
97
+ cover all families. Medians do not add up (median assets minus median debt is not median net worth).
98
+ - SCF units are families (the survey's primary economic unit), not Census households. Groups: racecl4 = White
99
+ non-Hispanic, Black non-Hispanic, Hispanic, Other; inccat and nwcat are percentile groups recomputed each survey.
100
+ Estimates have sampling error (standard errors in 2025_tables1_2_stderrs.xlsx on the SCF page).
101
+ - `scf_table` returns the sheet as a grid because the summary tables have titles, two header rows (year, then
102
+ Median/Mean) and section rows: read the cells, keep the `row` number when citing.
103
+
104
+ ## Access
105
+ No key; the host answers scripts (verified 2026-10-30, Python user agent). Limit used: one request a second. The Z.1
106
+ zip is 8.3 MB (downloaded once per run for all `z1` requests); a full DDP package is up to about 1 MB; the SCF
107
+ tables workbook 2.5 MB. Manual route (`manual_bundle`): the bundle links the files (a DDP package given by title links its release's
108
+ Choose page: pick the package, Format package, CSV, Download file; upload the CSV as downloaded). SCF microdata
109
+ (summary extract scfp2025excel.zip, 2.1 MB, and the full public data) are on https://www.federalreserve.gov/econres/scfindex.htm
110
+ and are not wrapped: each family appears five times (five implicates), weights must be divided by five when the
111
+ implicates are stacked, and standard errors need the replicate weights; a custom tabulation from them is the
112
+ analyst's own estimate and must say so.
113
+
114
+ ## Citation and terms
115
+ Board of Governors of the Federal Reserve System, <dataset> (name the release, e.g. "G.19 Consumer Credit, October
116
+ 7, 2026" or "Financial Accounts of the United States, Z.1, 2026:Q2"; for SCF "2025 Survey of Consumer Finances"),
117
+ federalreserve.gov, retrieved <date>. Board website content is in the public domain unless otherwise indicated
118
+ (https://www.federalreserve.gov/disclaimer.htm); cite the Board as the source.