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.
- package/README.md +261 -2
- package/dist/adapters/_acf_tidy.d.ts +18 -0
- package/dist/adapters/_acf_tidy.js +432 -0
- package/dist/adapters/_acf_tidy.js.map +1 -0
- package/dist/adapters/_actuaries_read.d.ts +38 -0
- package/dist/adapters/_actuaries_read.js +728 -0
- package/dist/adapters/_actuaries_read.js.map +1 -0
- package/dist/adapters/_census_micro.d.ts +70 -0
- package/dist/adapters/_census_micro.js +622 -0
- package/dist/adapters/_census_micro.js.map +1 -0
- package/dist/adapters/_census_util.d.ts +40 -0
- package/dist/adapters/_census_util.js +275 -0
- package/dist/adapters/_census_util.js.map +1 -0
- package/dist/adapters/_dol_states.d.ts +6 -0
- package/dist/adapters/_dol_states.js +58 -0
- package/dist/adapters/_dol_states.js.map +1 -0
- package/dist/adapters/_govinfo_entities.d.ts +4 -0
- package/dist/adapters/_govinfo_entities.js +6 -0
- package/dist/adapters/_govinfo_entities.js.map +1 -0
- package/dist/adapters/_govinfo_json.d.ts +13 -0
- package/dist/adapters/_govinfo_json.js +107 -0
- package/dist/adapters/_govinfo_json.js.map +1 -0
- package/dist/adapters/_govinfo_py.d.ts +22 -0
- package/dist/adapters/_govinfo_py.js +272 -0
- package/dist/adapters/_govinfo_py.js.map +1 -0
- package/dist/adapters/_govinfo_xml.d.ts +22 -0
- package/dist/adapters/_govinfo_xml.js +233 -0
- package/dist/adapters/_govinfo_xml.js.map +1 -0
- package/dist/adapters/_hud_excel.d.ts +2 -0
- package/dist/adapters/_hud_excel.js +166 -0
- package/dist/adapters/_hud_excel.js.map +1 -0
- package/dist/adapters/_omb_grid.d.ts +17 -0
- package/dist/adapters/_omb_grid.js +132 -0
- package/dist/adapters/_omb_grid.js.map +1 -0
- package/dist/adapters/_omb_util.d.ts +40 -0
- package/dist/adapters/_omb_util.js +192 -0
- package/dist/adapters/_omb_util.js.map +1 -0
- package/dist/adapters/_usaspending_state.d.ts +6 -0
- package/dist/adapters/_usaspending_state.js +54 -0
- package/dist/adapters/_usaspending_state.js.map +1 -0
- package/dist/adapters/_usda-fna_book.d.ts +59 -0
- package/dist/adapters/_usda-fna_book.js +869 -0
- package/dist/adapters/_usda-fna_book.js.map +1 -0
- package/dist/adapters/_usda-fna_pdf.d.ts +20 -0
- package/dist/adapters/_usda-fna_pdf.js +361 -0
- package/dist/adapters/_usda-fna_pdf.js.map +1 -0
- package/dist/adapters/_usda-outlook_read.d.ts +70 -0
- package/dist/adapters/_usda-outlook_read.js +362 -0
- package/dist/adapters/_usda-outlook_read.js.map +1 -0
- package/dist/adapters/acf.d.ts +3 -0
- package/dist/adapters/acf.js +187 -0
- package/dist/adapters/acf.js.map +1 -0
- package/dist/adapters/actuaries.d.ts +3 -0
- package/dist/adapters/actuaries.js +293 -0
- package/dist/adapters/actuaries.js.map +1 -0
- package/dist/adapters/bts.d.ts +3 -0
- package/dist/adapters/bts.js +26 -0
- package/dist/adapters/bts.js.map +1 -0
- package/dist/adapters/census-geocoder.d.ts +10 -0
- package/dist/adapters/census-geocoder.js +47 -0
- package/dist/adapters/census-geocoder.js.map +1 -0
- package/dist/adapters/census.d.ts +17 -0
- package/dist/adapters/census.js +983 -0
- package/dist/adapters/census.js.map +1 -0
- package/dist/adapters/cfpb.d.ts +7 -0
- package/dist/adapters/cfpb.js +348 -0
- package/dist/adapters/cfpb.js.map +1 -0
- package/dist/adapters/clinical-trials.d.ts +3 -0
- package/dist/adapters/clinical-trials.js +135 -0
- package/dist/adapters/clinical-trials.js.map +1 -0
- package/dist/adapters/cms.d.ts +3 -0
- package/dist/adapters/cms.js +292 -0
- package/dist/adapters/cms.js.map +1 -0
- package/dist/adapters/college-scorecard.d.ts +3 -0
- package/dist/adapters/college-scorecard.js +122 -0
- package/dist/adapters/college-scorecard.js.map +1 -0
- package/dist/adapters/congress.d.ts +33 -0
- package/dist/adapters/congress.js +589 -0
- package/dist/adapters/congress.js.map +1 -0
- package/dist/adapters/dhs-ohss.d.ts +13 -0
- package/dist/adapters/dhs-ohss.js +598 -0
- package/dist/adapters/dhs-ohss.js.map +1 -0
- package/dist/adapters/doj-news.d.ts +7 -0
- package/dist/adapters/doj-news.js +286 -0
- package/dist/adapters/doj-news.js.map +1 -0
- package/dist/adapters/dol.d.ts +4 -0
- package/dist/adapters/dol.js +634 -0
- package/dist/adapters/dol.js.map +1 -0
- package/dist/adapters/eia.d.ts +15 -0
- package/dist/adapters/eia.js +456 -0
- package/dist/adapters/eia.js.map +1 -0
- package/dist/adapters/epa-aqs.d.ts +3 -0
- package/dist/adapters/epa-aqs.js +357 -0
- package/dist/adapters/epa-aqs.js.map +1 -0
- package/dist/adapters/epa.d.ts +3 -0
- package/dist/adapters/epa.js +298 -0
- package/dist/adapters/epa.js.map +1 -0
- package/dist/adapters/fbi.d.ts +3 -0
- package/dist/adapters/fbi.js +192 -0
- package/dist/adapters/fbi.js.map +1 -0
- package/dist/adapters/fda.d.ts +5 -0
- package/dist/adapters/fda.js +184 -0
- package/dist/adapters/fda.js.map +1 -0
- package/dist/adapters/fdic.d.ts +4 -0
- package/dist/adapters/fdic.js +95 -0
- package/dist/adapters/fdic.js.map +1 -0
- package/dist/adapters/fec.d.ts +3 -0
- package/dist/adapters/fec.js +142 -0
- package/dist/adapters/fec.js.map +1 -0
- package/dist/adapters/fed-board.d.ts +12 -0
- package/dist/adapters/fed-board.js +581 -0
- package/dist/adapters/fed-board.js.map +1 -0
- package/dist/adapters/federal-register.d.ts +11 -0
- package/dist/adapters/federal-register.js +43 -0
- package/dist/adapters/federal-register.js.map +1 -0
- package/dist/adapters/fhfa.d.ts +3 -0
- package/dist/adapters/fhfa.js +253 -0
- package/dist/adapters/fhfa.js.map +1 -0
- package/dist/adapters/fsa.d.ts +9 -0
- package/dist/adapters/fsa.js +335 -0
- package/dist/adapters/fsa.js.map +1 -0
- package/dist/adapters/govinfo.d.ts +30 -0
- package/dist/adapters/govinfo.js +636 -0
- package/dist/adapters/govinfo.js.map +1 -0
- package/dist/adapters/gsa-calc.d.ts +10 -0
- package/dist/adapters/gsa-calc.js +318 -0
- package/dist/adapters/gsa-calc.js.map +1 -0
- package/dist/adapters/hud.d.ts +3 -0
- package/dist/adapters/hud.js +200 -0
- package/dist/adapters/hud.js.map +1 -0
- package/dist/adapters/index.d.ts +3 -0
- package/dist/adapters/index.js +25 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/irs-soi.d.ts +6 -0
- package/dist/adapters/irs-soi.js +576 -0
- package/dist/adapters/irs-soi.js.map +1 -0
- package/dist/adapters/naep.d.ts +15 -0
- package/dist/adapters/naep.js +341 -0
- package/dist/adapters/naep.js.map +1 -0
- package/dist/adapters/nhtsa.d.ts +10 -0
- package/dist/adapters/nhtsa.js +239 -0
- package/dist/adapters/nhtsa.js.map +1 -0
- package/dist/adapters/nih.d.ts +5 -0
- package/dist/adapters/nih.js +196 -0
- package/dist/adapters/nih.js.map +1 -0
- package/dist/adapters/noaa.d.ts +3 -0
- package/dist/adapters/noaa.js +148 -0
- package/dist/adapters/noaa.js.map +1 -0
- package/dist/adapters/nrel.d.ts +3 -0
- package/dist/adapters/nrel.js +186 -0
- package/dist/adapters/nrel.js.map +1 -0
- package/dist/adapters/nws.d.ts +3 -0
- package/dist/adapters/nws.js +119 -0
- package/dist/adapters/nws.js.map +1 -0
- package/dist/adapters/omb.d.ts +15 -0
- package/dist/adapters/omb.js +517 -0
- package/dist/adapters/omb.js.map +1 -0
- package/dist/adapters/open-payments.d.ts +5 -0
- package/dist/adapters/open-payments.js +149 -0
- package/dist/adapters/open-payments.js.map +1 -0
- package/dist/adapters/pbgc.d.ts +13 -0
- package/dist/adapters/pbgc.js +283 -0
- package/dist/adapters/pbgc.js.map +1 -0
- package/dist/adapters/philfed.d.ts +12 -0
- package/dist/adapters/philfed.js +59 -0
- package/dist/adapters/philfed.js.map +1 -0
- package/dist/adapters/regulations.d.ts +6 -0
- package/dist/adapters/regulations.js +58 -0
- package/dist/adapters/regulations.js.map +1 -0
- package/dist/adapters/sec.d.ts +13 -0
- package/dist/adapters/sec.js +504 -0
- package/dist/adapters/sec.js.map +1 -0
- package/dist/adapters/senate-lobbying.d.ts +3 -0
- package/dist/adapters/senate-lobbying.js +181 -0
- package/dist/adapters/senate-lobbying.js.map +1 -0
- package/dist/adapters/snapqc.d.ts +32 -0
- package/dist/adapters/snapqc.js +701 -0
- package/dist/adapters/snapqc.js.map +1 -0
- package/dist/adapters/treasury-yields.d.ts +3 -0
- package/dist/adapters/treasury-yields.js +170 -0
- package/dist/adapters/treasury-yields.js.map +1 -0
- package/dist/adapters/usaspending.d.ts +3 -0
- package/dist/adapters/usaspending.js +340 -0
- package/dist/adapters/usaspending.js.map +1 -0
- package/dist/adapters/usda-fna.d.ts +7 -0
- package/dist/adapters/usda-fna.js +707 -0
- package/dist/adapters/usda-fna.js.map +1 -0
- package/dist/adapters/usda-fooddata.d.ts +3 -0
- package/dist/adapters/usda-fooddata.js +101 -0
- package/dist/adapters/usda-fooddata.js.map +1 -0
- package/dist/adapters/usda-nass.d.ts +3 -0
- package/dist/adapters/usda-nass.js +108 -0
- package/dist/adapters/usda-nass.js.map +1 -0
- package/dist/adapters/usda-outlook.d.ts +12 -0
- package/dist/adapters/usda-outlook.js +696 -0
- package/dist/adapters/usda-outlook.js.map +1 -0
- package/dist/adapters/usgs.d.ts +9 -0
- package/dist/adapters/usgs.js +265 -0
- package/dist/adapters/usgs.js.map +1 -0
- package/dist/adapters/usitc.d.ts +18 -0
- package/dist/adapters/usitc.js +170 -0
- package/dist/adapters/usitc.js.map +1 -0
- package/dist/adapters/uspto.d.ts +3 -0
- package/dist/adapters/uspto.js +47 -0
- package/dist/adapters/uspto.js.map +1 -0
- package/dist/adapters/world-bank.d.ts +3 -0
- package/dist/adapters/world-bank.js +163 -0
- package/dist/adapters/world-bank.js.map +1 -0
- package/dist/analysis/cite.d.ts +31 -0
- package/dist/analysis/cite.js +229 -0
- package/dist/analysis/cite.js.map +1 -0
- package/dist/analysis/combine.d.ts +27 -0
- package/dist/analysis/combine.js +198 -0
- package/dist/analysis/combine.js.map +1 -0
- package/dist/analysis/compute.d.ts +62 -0
- package/dist/analysis/compute.js +583 -0
- package/dist/analysis/compute.js.map +1 -0
- package/dist/analysis/expr.d.ts +69 -0
- package/dist/analysis/expr.js +780 -0
- package/dist/analysis/expr.js.map +1 -0
- package/dist/analysis/factfmt.d.ts +16 -0
- package/dist/analysis/factfmt.js +187 -0
- package/dist/analysis/factfmt.js.map +1 -0
- package/dist/analysis/facts.d.ts +63 -0
- package/dist/analysis/facts.js +355 -0
- package/dist/analysis/facts.js.map +1 -0
- package/dist/analysis/handoff.d.ts +58 -0
- package/dist/analysis/handoff.js +208 -0
- package/dist/analysis/handoff.js.map +1 -0
- package/dist/analysis/pyfmt.d.ts +16 -0
- package/dist/analysis/pyfmt.js +156 -0
- package/dist/analysis/pyfmt.js.map +1 -0
- package/dist/analysis/rerun.d.ts +13 -0
- package/dist/analysis/rerun.js +125 -0
- package/dist/analysis/rerun.js.map +1 -0
- package/dist/analysis/table.d.ts +18 -0
- package/dist/analysis/table.js +109 -0
- package/dist/analysis/table.js.map +1 -0
- package/dist/analysis/tools.d.ts +67 -0
- package/dist/analysis/tools.js +217 -0
- package/dist/analysis/tools.js.map +1 -0
- package/dist/analysis/write_table.d.ts +13 -0
- package/dist/analysis/write_table.js +59 -0
- package/dist/analysis/write_table.js.map +1 -0
- package/dist/bin/cli.d.ts +10 -0
- package/dist/bin/cli.js +177 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/core/cache.d.ts +14 -0
- package/dist/core/cache.js +90 -0
- package/dist/core/cache.js.map +1 -0
- package/dist/core/context.d.ts +12 -0
- package/dist/core/context.js +15 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/env.d.ts +14 -0
- package/dist/core/env.js +52 -0
- package/dist/core/env.js.map +1 -0
- package/dist/core/generic-rest.d.ts +61 -0
- package/dist/core/generic-rest.js +639 -0
- package/dist/core/generic-rest.js.map +1 -0
- package/dist/core/http.d.ts +120 -0
- package/dist/core/http.js +514 -0
- package/dist/core/http.js.map +1 -0
- package/dist/core/keys.d.ts +43 -0
- package/dist/core/keys.js +174 -0
- package/dist/core/keys.js.map +1 -0
- package/dist/core/manual.d.ts +41 -0
- package/dist/core/manual.js +218 -0
- package/dist/core/manual.js.map +1 -0
- package/dist/core/package.d.ts +58 -0
- package/dist/core/package.js +228 -0
- package/dist/core/package.js.map +1 -0
- package/dist/core/packs.d.ts +139 -0
- package/dist/core/packs.js +173 -0
- package/dist/core/packs.js.map +1 -0
- package/dist/core/policy.d.ts +69 -0
- package/dist/core/policy.js +189 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/py.d.ts +40 -0
- package/dist/core/py.js +171 -0
- package/dist/core/py.js.map +1 -0
- package/dist/core/routing.d.ts +10 -0
- package/dist/core/routing.js +39 -0
- package/dist/core/routing.js.map +1 -0
- package/dist/core/tabular.d.ts +21 -0
- package/dist/core/tabular.js +229 -0
- package/dist/core/tabular.js.map +1 -0
- package/dist/deep/_bea_api.d.ts +102 -0
- package/dist/deep/_bea_api.js +457 -0
- package/dist/deep/_bea_api.js.map +1 -0
- package/dist/deep/_bea_fetch.d.ts +151 -0
- package/dist/deep/_bea_fetch.js +1274 -0
- package/dist/deep/_bea_fetch.js.map +1 -0
- package/dist/deep/_bea_util.d.ts +14 -0
- package/dist/deep/_bea_util.js +156 -0
- package/dist/deep/_bea_util.js.map +1 -0
- package/dist/deep/_bls_api.d.ts +84 -0
- package/dist/deep/_bls_api.js +231 -0
- package/dist/deep/_bls_api.js.map +1 -0
- package/dist/deep/_bls_ids.d.ts +43 -0
- package/dist/deep/_bls_ids.js +188 -0
- package/dist/deep/_bls_ids.js.map +1 -0
- package/dist/deep/_bls_lib.d.ts +61 -0
- package/dist/deep/_bls_lib.js +442 -0
- package/dist/deep/_bls_lib.js.map +1 -0
- package/dist/deep/_fred_api.d.ts +148 -0
- package/dist/deep/_fred_api.js +545 -0
- package/dist/deep/_fred_api.js.map +1 -0
- package/dist/deep/_fred_pack.d.ts +162 -0
- package/dist/deep/_fred_pack.js +1027 -0
- package/dist/deep/_fred_pack.js.map +1 -0
- package/dist/deep/_fred_py.d.ts +40 -0
- package/dist/deep/_fred_py.js +199 -0
- package/dist/deep/_fred_py.js.map +1 -0
- package/dist/deep/_ipums_bundle.d.ts +29 -0
- package/dist/deep/_ipums_bundle.js +194 -0
- package/dist/deep/_ipums_bundle.js.map +1 -0
- package/dist/deep/_ipums_ddi.d.ts +23 -0
- package/dist/deep/_ipums_ddi.js +162 -0
- package/dist/deep/_ipums_ddi.js.map +1 -0
- package/dist/deep/_opm_io.d.ts +26 -0
- package/dist/deep/_opm_io.js +383 -0
- package/dist/deep/_opm_io.js.map +1 -0
- package/dist/deep/_opm_parquet.d.ts +31 -0
- package/dist/deep/_opm_parquet.js +744 -0
- package/dist/deep/_opm_parquet.js.map +1 -0
- package/dist/deep/_opm_py.d.ts +6 -0
- package/dist/deep/_opm_py.js +74 -0
- package/dist/deep/_opm_py.js.map +1 -0
- package/dist/deep/_treasury_api.d.ts +48 -0
- package/dist/deep/_treasury_api.js +221 -0
- package/dist/deep/_treasury_api.js.map +1 -0
- package/dist/deep/_treasury_context.d.ts +34 -0
- package/dist/deep/_treasury_context.js +142 -0
- package/dist/deep/_treasury_context.js.map +1 -0
- package/dist/deep/_treasury_lib.d.ts +109 -0
- package/dist/deep/_treasury_lib.js +686 -0
- package/dist/deep/_treasury_lib.js.map +1 -0
- package/dist/deep/bea.d.ts +3 -0
- package/dist/deep/bea.js +248 -0
- package/dist/deep/bea.js.map +1 -0
- package/dist/deep/bls.d.ts +3 -0
- package/dist/deep/bls.js +220 -0
- package/dist/deep/bls.js.map +1 -0
- package/dist/deep/fred.d.ts +3 -0
- package/dist/deep/fred.js +325 -0
- package/dist/deep/fred.js.map +1 -0
- package/dist/deep/ipums.d.ts +59 -0
- package/dist/deep/ipums.js +744 -0
- package/dist/deep/ipums.js.map +1 -0
- package/dist/deep/opm.d.ts +56 -0
- package/dist/deep/opm.js +1033 -0
- package/dist/deep/opm.js.map +1 -0
- package/dist/deep/treasury.d.ts +3 -0
- package/dist/deep/treasury.js +218 -0
- package/dist/deep/treasury.js.map +1 -0
- package/dist/envelope.d.ts +47 -0
- package/dist/envelope.js +88 -0
- package/dist/envelope.js.map +1 -0
- package/dist/index.d.ts +277 -0
- package/dist/index.js +106 -0
- package/dist/index.js.map +1 -0
- package/dist/remote/app.d.ts +21 -0
- package/dist/remote/app.js +218 -0
- package/dist/remote/app.js.map +1 -0
- package/dist/remote/oauth.d.ts +14 -0
- package/dist/remote/oauth.js +90 -0
- package/dist/remote/oauth.js.map +1 -0
- package/dist/remote/pages.d.ts +8 -0
- package/dist/remote/pages.js +56 -0
- package/dist/remote/pages.js.map +1 -0
- package/dist/remote/sign.d.ts +4 -0
- package/dist/remote/sign.js +40 -0
- package/dist/remote/sign.js.map +1 -0
- package/dist/remote/store.d.ts +31 -0
- package/dist/remote/store.js +129 -0
- package/dist/remote/store.js.map +1 -0
- package/dist/report/audit_answer.d.ts +94 -0
- package/dist/report/audit_answer.js +1349 -0
- package/dist/report/audit_answer.js.map +1 -0
- package/dist/report/audit_report.d.ts +23 -0
- package/dist/report/audit_report.js +637 -0
- package/dist/report/audit_report.js.map +1 -0
- package/dist/report/build_report.d.ts +27 -0
- package/dist/report/build_report.js +1168 -0
- package/dist/report/build_report.js.map +1 -0
- package/dist/report/method_audit.d.ts +47 -0
- package/dist/report/method_audit.js +716 -0
- package/dist/report/method_audit.js.map +1 -0
- package/dist/report/policyset.d.ts +50 -0
- package/dist/report/policyset.js +421 -0
- package/dist/report/policyset.js.map +1 -0
- package/dist/report/py.d.ts +58 -0
- package/dist/report/py.js +311 -0
- package/dist/report/py.js.map +1 -0
- package/dist/report/scan_secrets.d.ts +24 -0
- package/dist/report/scan_secrets.js +265 -0
- package/dist/report/scan_secrets.js.map +1 -0
- package/dist/report/style_check.d.ts +29 -0
- package/dist/report/style_check.js +173 -0
- package/dist/report/style_check.js.map +1 -0
- package/dist/report/tools.d.ts +87 -0
- package/dist/report/tools.js +167 -0
- package/dist/report/tools.js.map +1 -0
- package/dist/server.d.ts +5 -0
- package/dist/server.js +247 -0
- package/dist/server.js.map +1 -0
- package/dist/session.d.ts +47 -0
- package/dist/session.js +107 -0
- package/dist/session.js.map +1 -0
- package/dist/toolkit.d.ts +21 -0
- package/dist/toolkit.js +2 -0
- package/dist/toolkit.js.map +1 -0
- package/dist/tools.d.ts +299 -0
- package/dist/tools.js +491 -0
- package/dist/tools.js.map +1 -0
- package/guide/WORKFLOW.md +134 -0
- package/guide/assets/disclaimer.txt +1 -0
- package/guide/assets/download_data.ps1 +162 -0
- package/guide/assets/download_data.sh +143 -0
- package/guide/assets/report_template.html +597 -0
- package/guide/references/report_patterns.md +199 -0
- package/guide/references/routing.md +171 -0
- package/guide/references/style_guide.md +398 -0
- package/package.json +54 -4
- package/packs/acf/endpoints.json +114 -0
- package/packs/acf/policy.json +104 -0
- package/packs/acf/source.md +138 -0
- package/packs/actuaries/endpoints.json +82 -0
- package/packs/actuaries/policy.json +109 -0
- package/packs/actuaries/source.md +137 -0
- package/packs/bea/assets/download_bea.ps1 +182 -0
- package/packs/bea/assets/download_bea.sh +144 -0
- package/packs/bea/docs/bea_api.md +461 -0
- package/packs/bea/docs/datasets.md +157 -0
- package/packs/bea/docs/report_patterns.md +112 -0
- package/packs/bea/policy.json +170 -0
- package/packs/bea/source.md +152 -0
- package/packs/bls/assets/download_bls.ps1 +152 -0
- package/packs/bls/assets/download_bls.sh +167 -0
- package/packs/bls/docs/analysis_patterns.md +108 -0
- package/packs/bls/docs/bls_api.md +73 -0
- package/packs/bls/docs/series_ids.md +149 -0
- package/packs/bls/policy.json +238 -0
- package/packs/bls/series_ids.json +1375 -0
- package/packs/bls/source.md +156 -0
- package/packs/bts/endpoints.json +347 -0
- package/packs/bts/policy.json +94 -0
- package/packs/bts/source.md +97 -0
- package/packs/cdc/endpoints.json +197 -0
- package/packs/cdc/policy.json +83 -0
- package/packs/cdc/source.md +74 -0
- package/packs/census/endpoints.json +99 -0
- package/packs/census/policy.json +238 -0
- package/packs/census/source.md +304 -0
- package/packs/census-geocoder/endpoints.json +70 -0
- package/packs/census-geocoder/policy.json +80 -0
- package/packs/census-geocoder/source.md +53 -0
- package/packs/cfpb/endpoints.json +327 -0
- package/packs/cfpb/policy.json +119 -0
- package/packs/cfpb/source.md +96 -0
- package/packs/clinical-trials/endpoints.json +167 -0
- package/packs/clinical-trials/policy.json +84 -0
- package/packs/clinical-trials/source.md +82 -0
- package/packs/cms/endpoints.json +69 -0
- package/packs/cms/policy.json +96 -0
- package/packs/cms/source.md +112 -0
- package/packs/college-scorecard/endpoints.json +253 -0
- package/packs/college-scorecard/policy.json +106 -0
- package/packs/college-scorecard/source.md +92 -0
- package/packs/congress/endpoints.json +1701 -0
- package/packs/congress/policy.json +117 -0
- package/packs/congress/source.md +190 -0
- package/packs/dhs-ohss/endpoints.json +66 -0
- package/packs/dhs-ohss/policy.json +107 -0
- package/packs/dhs-ohss/source.md +120 -0
- package/packs/doj-news/endpoints.json +59 -0
- package/packs/doj-news/policy.json +96 -0
- package/packs/doj-news/source.md +99 -0
- package/packs/dol/endpoints.json +818 -0
- package/packs/dol/policy.json +135 -0
- package/packs/dol/source.md +181 -0
- package/packs/eia/endpoints.json +718 -0
- package/packs/eia/policy.json +112 -0
- package/packs/eia/source.md +112 -0
- package/packs/epa/endpoints.json +292 -0
- package/packs/epa/policy.json +99 -0
- package/packs/epa/source.md +99 -0
- package/packs/epa-aqs/endpoints.json +174 -0
- package/packs/epa-aqs/policy.json +96 -0
- package/packs/epa-aqs/source.md +97 -0
- package/packs/fbi/endpoints.json +1842 -0
- package/packs/fbi/policy.json +118 -0
- package/packs/fbi/source.md +108 -0
- package/packs/fda/endpoints.json +238 -0
- package/packs/fda/policy.json +121 -0
- package/packs/fda/source.md +117 -0
- package/packs/fdic/endpoints.json +417 -0
- package/packs/fdic/policy.json +83 -0
- package/packs/fdic/source.md +92 -0
- package/packs/fec/endpoints.json +708 -0
- package/packs/fec/policy.json +93 -0
- package/packs/fec/source.md +90 -0
- package/packs/fed-board/endpoints.json +89 -0
- package/packs/fed-board/policy.json +136 -0
- package/packs/fed-board/source.md +118 -0
- package/packs/federal-register/endpoints.json +143 -0
- package/packs/federal-register/policy.json +86 -0
- package/packs/federal-register/source.md +98 -0
- package/packs/fema/endpoints.json +646 -0
- package/packs/fema/policy.json +103 -0
- package/packs/fema/source.md +103 -0
- package/packs/fhfa/endpoints.json +105 -0
- package/packs/fhfa/policy.json +109 -0
- package/packs/fhfa/source.md +108 -0
- package/packs/fred/assets/download_fred.ps1 +122 -0
- package/packs/fred/assets/download_fred.sh +123 -0
- package/packs/fred/docs/analysis_patterns.md +124 -0
- package/packs/fred/docs/fred_api.md +94 -0
- package/packs/fred/docs/series.md +188 -0
- package/packs/fred/policy.json +253 -0
- package/packs/fred/source.md +142 -0
- package/packs/fsa/endpoints.json +150 -0
- package/packs/fsa/policy.json +99 -0
- package/packs/fsa/source.md +102 -0
- package/packs/govinfo/endpoints.json +520 -0
- package/packs/govinfo/policy.json +116 -0
- package/packs/govinfo/source.md +241 -0
- package/packs/gsa-calc/endpoints.json +93 -0
- package/packs/gsa-calc/policy.json +97 -0
- package/packs/gsa-calc/source.md +108 -0
- package/packs/hud/endpoints.json +147 -0
- package/packs/hud/policy.json +84 -0
- package/packs/hud/source.md +97 -0
- package/packs/ipums/assets/download_ipums.ps1 +215 -0
- package/packs/ipums/assets/download_ipums.sh +192 -0
- package/packs/ipums/docs/ipums_api.md +67 -0
- package/packs/ipums/docs/report_patterns.md +117 -0
- package/packs/ipums/docs/variables.md +284 -0
- package/packs/ipums/lib/fetch_text.json +112 -0
- package/packs/ipums/policy.json +215 -0
- package/packs/ipums/source.md +169 -0
- package/packs/irs-soi/endpoints.json +114 -0
- package/packs/irs-soi/policy.json +107 -0
- package/packs/irs-soi/source.md +124 -0
- package/packs/medicaid/endpoints.json +412 -0
- package/packs/medicaid/policy.json +108 -0
- package/packs/medicaid/source.md +136 -0
- package/packs/naep/endpoints.json +217 -0
- package/packs/naep/policy.json +100 -0
- package/packs/naep/source.md +120 -0
- package/packs/nhtsa/endpoints.json +132 -0
- package/packs/nhtsa/policy.json +93 -0
- package/packs/nhtsa/source.md +109 -0
- package/packs/nih/endpoints.json +453 -0
- package/packs/nih/policy.json +86 -0
- package/packs/nih/source.md +108 -0
- package/packs/noaa/endpoints.json +432 -0
- package/packs/noaa/policy.json +95 -0
- package/packs/noaa/source.md +88 -0
- package/packs/nrel/endpoints.json +328 -0
- package/packs/nrel/policy.json +96 -0
- package/packs/nrel/source.md +91 -0
- package/packs/nws/endpoints.json +272 -0
- package/packs/nws/policy.json +82 -0
- package/packs/nws/source.md +81 -0
- package/packs/nyfed/endpoints.json +80 -0
- package/packs/nyfed/policy.json +92 -0
- package/packs/nyfed/source.md +89 -0
- package/packs/omb/endpoints.json +460 -0
- package/packs/omb/policy.json +106 -0
- package/packs/omb/source.md +130 -0
- package/packs/open-payments/endpoints.json +298 -0
- package/packs/open-payments/policy.json +101 -0
- package/packs/open-payments/source.md +99 -0
- package/packs/opm/assets/download_opm.ps1 +125 -0
- package/packs/opm/assets/download_opm.sh +85 -0
- package/packs/opm/docs/fields.md +184 -0
- package/packs/opm/docs/opm_api.md +71 -0
- package/packs/opm/docs/report_patterns.md +83 -0
- package/packs/opm/lib/data_dictionary.csv +73 -0
- package/packs/opm/policy.json +142 -0
- package/packs/opm/source.md +137 -0
- package/packs/pbgc/endpoints.json +483 -0
- package/packs/pbgc/policy.json +94 -0
- package/packs/pbgc/source.md +95 -0
- package/packs/philfed/endpoints.json +85 -0
- package/packs/philfed/policy.json +94 -0
- package/packs/philfed/source.md +125 -0
- package/packs/port.json +287 -0
- package/packs/regulations/endpoints.json +288 -0
- package/packs/regulations/policy.json +86 -0
- package/packs/regulations/source.md +84 -0
- package/packs/sec/endpoints.json +237 -0
- package/packs/sec/policy.json +86 -0
- package/packs/sec/source.md +101 -0
- package/packs/senate-lobbying/endpoints.json +554 -0
- package/packs/senate-lobbying/policy.json +99 -0
- package/packs/senate-lobbying/source.md +100 -0
- package/packs/snapqc/endpoints.json +1426 -0
- package/packs/snapqc/policy.json +92 -0
- package/packs/snapqc/source.md +96 -0
- package/packs/treasury/catalog.json +2267 -0
- package/packs/treasury/docs/api_guide.md +245 -0
- package/packs/treasury/docs/datasets.md +56 -0
- package/packs/treasury/docs/report_patterns.md +126 -0
- package/packs/treasury/policy.json +159 -0
- package/packs/treasury/source.md +170 -0
- package/packs/treasury-yields/endpoints.json +226 -0
- package/packs/treasury-yields/policy.json +86 -0
- package/packs/treasury-yields/source.md +80 -0
- package/packs/usaspending/endpoints.json +1316 -0
- package/packs/usaspending/policy.json +109 -0
- package/packs/usaspending/source.md +103 -0
- package/packs/usda-fna/endpoints.json +427 -0
- package/packs/usda-fna/policy.json +133 -0
- package/packs/usda-fna/source.md +217 -0
- package/packs/usda-fooddata/endpoints.json +181 -0
- package/packs/usda-fooddata/policy.json +94 -0
- package/packs/usda-fooddata/source.md +105 -0
- package/packs/usda-nass/endpoints.json +324 -0
- package/packs/usda-nass/policy.json +95 -0
- package/packs/usda-nass/source.md +85 -0
- package/packs/usda-outlook/endpoints.json +86 -0
- package/packs/usda-outlook/policy.json +109 -0
- package/packs/usda-outlook/source.md +144 -0
- package/packs/usgs/endpoints.json +313 -0
- package/packs/usgs/policy.json +95 -0
- package/packs/usgs/source.md +96 -0
- package/packs/usitc/endpoints.json +74 -0
- package/packs/usitc/policy.json +111 -0
- package/packs/usitc/source.md +90 -0
- package/packs/uspto/endpoints.json +141 -0
- package/packs/uspto/policy.json +95 -0
- package/packs/uspto/source.md +101 -0
- package/packs/va/endpoints.json +414 -0
- package/packs/va/policy.json +101 -0
- package/packs/va/source.md +129 -0
- package/packs/world-bank/endpoints.json +122 -0
- package/packs/world-bank/policy.json +101 -0
- 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.
|