data-analyst-mcp 0.0.0-stage → 0.3.0

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 +262 -3
  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 +710 -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 +21 -0
  396. package/dist/report/scan_secrets.js +234 -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 +246 -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 +56 -6
  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 +165 -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,159 @@
1
+ {
2
+ "id": "treasury",
3
+ "title": "U.S. Treasury Fiscal Data (fiscaldata.treasury.gov)",
4
+ "agency": "U.S. Department of the Treasury, Bureau of the Fiscal Service",
5
+ "depth": "deep",
6
+ "domains": [
7
+ "federal budget",
8
+ "federal debt",
9
+ "public finance",
10
+ "spending",
11
+ "revenue"
12
+ ],
13
+ "keywords": [
14
+ "national debt",
15
+ "debt held by the public",
16
+ "debt to the penny",
17
+ "deficit",
18
+ "surplus",
19
+ "receipts",
20
+ "outlays",
21
+ "monthly treasury statement",
22
+ "mts",
23
+ "daily treasury statement",
24
+ "dts",
25
+ "tga",
26
+ "treasury cash",
27
+ "interest on the debt",
28
+ "interest expense",
29
+ "net interest",
30
+ "average interest rate",
31
+ "debt limit",
32
+ "debt ceiling",
33
+ "auctions",
34
+ "bid-to-cover",
35
+ "exchange rates",
36
+ "tax receipts",
37
+ "spending by function",
38
+ "spending by agency",
39
+ "savings bonds",
40
+ "fiscal year",
41
+ "mspd",
42
+ "i bond",
43
+ "i bonds",
44
+ "series i bond",
45
+ "ee bond",
46
+ "savings bond rate",
47
+ "composite rate",
48
+ "outlays by function",
49
+ "budget function",
50
+ "social security outlays",
51
+ "medicare outlays",
52
+ "social security spending",
53
+ "medicare spending", "medicaid", "medicaid outlays", "medicaid spending", "program outlays", "outlays by program",
54
+ "customs duties",
55
+ "tariff revenue",
56
+ "tariffs collected",
57
+ "customs receipts",
58
+ "duties"
59
+ ],
60
+ "questions": [
61
+ "how much did interest on the debt cost last year",
62
+ "chart the deficit since 2015",
63
+ "what is the national debt today",
64
+ "federal receipts by source",
65
+ "outlays by agency",
66
+ "treasury cash balance",
67
+ "average interest rate on marketable debt",
68
+ "debt subject to the limit"
69
+ ],
70
+ "homepage": "https://fiscaldata.treasury.gov/",
71
+ "terms_url": "https://fiscaldata.treasury.gov/api-documentation/",
72
+ "auth": {
73
+ "env": null,
74
+ "required": "none",
75
+ "placement": "none",
76
+ "param": null,
77
+ "prefix": "",
78
+ "home": null,
79
+ "signup_url": null,
80
+ "echoes_key": false,
81
+ "key_only": [],
82
+ "extra": {},
83
+ "demo_key": null
84
+ },
85
+ "limits": {
86
+ "rps": 4,
87
+ "burst": 8,
88
+ "daily_quota": null,
89
+ "errors_per_min": null,
90
+ "bytes_per_min": null,
91
+ "max_rows": null,
92
+ "page_size": 10000
93
+ },
94
+ "routes": {
95
+ "api": {
96
+ "base": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/",
97
+ "probe": "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny?fields=record_date&page%5Bsize%5D=1",
98
+ "hosts": [
99
+ "api.fiscaldata.treasury.gov",
100
+ "fiscaldata.treasury.gov"
101
+ ]
102
+ },
103
+ "manual": {
104
+ "how": "Call manual_bundle: manual_download/INSTRUCTIONS.md lists one CSV link per dataset (no key; 10,000 rows per page, pages name_2.csv ...), the download scripts (download_data.sh / .ps1), and the dataset page whose Download button gives the whole table as CSV/ZIP. Upload the files unchanged (not re-saved in Excel), then call ingest."
105
+ }
106
+ },
107
+ "cache": {
108
+ "mode": "run_only",
109
+ "ttl_hours": null,
110
+ "why": "Queries are small to moderate and several series (MTS, DTS) are restated monthly; data/treasury/ is reused per run (as_of in the spec fixes the cut-off), nothing is cached across runs."
111
+ },
112
+ "redistribution": {
113
+ "mode": "allowed",
114
+ "why": "Fiscal Data is published by the U.S. government and is in the public domain (17 U.S.C. 105); redistribution is permitted. Cite the source and the retrieval date, because Treasury revises some series."
115
+ },
116
+ "notices": [],
117
+ "retention": null,
118
+ "citation": "U.S. Department of the Treasury, Bureau of the Fiscal Service, Fiscal Data (https://fiscaldata.treasury.gov), {dataset}; retrieved {retrieved_long} through the Fiscal Data API.",
119
+ "audit_hooks": [],
120
+ "clarify": [
121
+ "Fiscal year (October to September, the budget convention) or calendar year?",
122
+ "Which debt measure: debt held by the public (economic analysis), total public debt outstanding (\"the national debt\"), or debt subject to the statutory limit?",
123
+ "Nominal dollars, real dollars (CPI-U, latest full fiscal year) or a share of GDP? Over a decade or more the answer can change.",
124
+ "Which interest measure: net interest (MTS, the budget measure), gross interest expense (what Treasury pays), or interest on debt held by the public only?",
125
+ "Tax refunds: cash paid (DTS, refundable credits included) or the budget-basis refunds that offset receipts (MTS Table 4)? Default: the measure the question names; else DTS cash refunds, with MTS as the cross-check.",
126
+ "Program measure: the budget function (MTS Table 9) or CBO's program figure (benefits only, net of offsetting receipts)? Default: the budget function, with CBO's figure as the cross-check."
127
+ ],
128
+ "formats": [
129
+ "json",
130
+ "csv",
131
+ "xml"
132
+ ],
133
+ "use_instead": [
134
+ {
135
+ "question": "Market yields and the daily par yield curve",
136
+ "source": "treasury-yields",
137
+ "terms": [
138
+ "par yield"
139
+ ],
140
+ "why": "Daily Treasury par yield curve rates."
141
+ },
142
+ {
143
+ "question": "Historical budget tables in percent of GDP, the President's budget",
144
+ "source": "omb",
145
+ "terms": [
146
+ "Historical Tables"
147
+ ],
148
+ "why": "OMB Historical Tables by budget edition."
149
+ },
150
+ {
151
+ "question": "State and local government finances",
152
+ "source": "census",
153
+ "terms": [
154
+ "QTAX"
155
+ ],
156
+ "why": "Census government finance surveys."
157
+ }
158
+ ]
159
+ }
@@ -0,0 +1,165 @@
1
+ # U.S. Treasury Fiscal Data (fiscaldata.treasury.gov)
2
+ Depth: deep. Key: none. Official federal finance statistics from the Bureau of the Fiscal Service: debt,
3
+ deficits, receipts and outlays (Monthly Treasury Statement), Treasury cash (Daily Treasury Statement),
4
+ interest expense and average rates on the debt, the debt limit, auctions, exchange rates; 185 endpoints.
5
+
6
+ ## When to use
7
+ - National debt (total, held by the public, intragovernmental; daily since 1993, yearly since 1790), debt by
8
+ security type, debt subject to the limit; monthly and fiscal-year receipts, outlays and deficits; receipts
9
+ by source, outlays by function and by agency; gross interest expense, net interest, average interest rates
10
+ on outstanding debt; the TGA cash balance and daily deposits and withdrawals; auction results; exchange
11
+ rates for federal reporting; gifts to reduce the debt; savings bonds; buybacks.
12
+ - Not here: market yields and the daily par yield curve (treasury-yields); GDP and CPI (bea, bls, fred; or
13
+ the spec's `context` field here, for real dollars and "% of GDP"); budget projections (CBO); historical tables in
14
+ % of GDP and the President's budget (OMB); who holds the debt by country (Treasury TIC, not Fiscal Data);
15
+ state and local finances (Census).
16
+ - Deliver data plus a short answer by default; a report only when asked (see `guide`).
17
+
18
+ ## Endpoints and datasets
19
+ Base `https://api.fiscaldata.treasury.gov/services/api/fiscal_service/` + a path with a fixed version (v1 or
20
+ v2: the other returns 404). `request_schema` with `search: "interest expense"` searches the live catalog
21
+ (falls back to the bundled `catalog.json`: a snapshot of the live catalog plus this guidance); `search:
22
+ "<endpoint>"` gives fields, types, units, row count, first and last row; `search: "<endpoint> {"record_date":
23
+ "2026-09-30"} values"` shows which values each code and description column holds; `request_schema` with
24
+ `names: ["dataset"]` lists the curated rows below. Full question-to-endpoint table: `docs/datasets.md`; API rules,
25
+ field meanings and the numbered gotchas: `docs/api_guide.md`; framing and conventions: `docs/report_patterns.md`.
26
+
27
+ | Question | Endpoint | Rows to use | Stock/flow | Units |
28
+ |---|---|---|---|---|
29
+ | Total debt, held by the public, intragovernmental (daily) | `v2/accounting/od/debt_to_penny` | one row per business day | stock | $ |
30
+ | Debt at fiscal year end since 1790 | `v2/accounting/od/debt_outstanding` | one row per year | stock | $ |
31
+ | Debt by security type (monthly) | `v1/debt/mspd/mspd_table_1` | `security_type_desc`, `security_class_desc`; skip "Total" rows | stock | $M |
32
+ | Debt subject to the limit | `v1/debt/mspd/mspd_table_2`, `v1/accounting/dts/debt_subject_to_limit` | `debt_catg_desc` | stock | $M |
33
+ | Monthly receipts, outlays, deficit since FY1981 | `v1/accounting/mts/mts_receipts_outlays_deficit_surplus` | `amt_category` | flow | $M |
34
+ | Receipts, outlays, deficit since FY2015 | `v1/accounting/mts/mts_table_1` | months: latest `record_date`, `record_type_cd` MTH; full FY: the September release's "Year-to-Date" row (`record_type_cd` SL, `data_type_cd` T) in the current-year block (`sequence_number_cd` 2.13; 1.13 is the prior year) | flow | $ |
35
+ | Receipts by source, outlays by function | `v1/accounting/mts/mts_table_9` | September `record_date`; `data_type_cd` D components, T "Total" | flow | $ |
36
+ | Outlays by agency, bureau, program | `v1/accounting/mts/mts_table_5` | `record_type_cd` A agency totals; D rows sum to "Total Outlays". A program account is a `classification_desc` line under its agency (Medicaid: "Grants to States for Medicaid" under HHS, `record_type_cd` P; FY2019 $409.4 billion = OMB Table 8.5): fetch the agency's rows and match the line by name (`--values` lists up to 200 lines per column under a narrow filter) | flow | $ |
37
+ | Gross interest expense | `v2/accounting/od/interest_expense` | all rows (detail only) sum to the total; MTS leaves out the GAS "Restoration of Interest" line (FY2025 on); TIPS lines include inflation compensation, a separate GAS "Inflation Compensation" line is not TIPS (docs/datasets.md) | flow | $ |
38
+ | Outlays by budget function (Social Security 650, Medicare 570, defense 050, net interest 900 ...) | MTS Table 9 (`v1/accounting/mts/mts_table_9`) | function rows add to total outlays; a function is not CBO's program measure (Social Security 650 includes administration; CBO reports benefits; Medicare 570 is gross of some offsetting receipts CBO nets) | flow | $M |
39
+ | Individual income tax refunds | DTS Table V `v1/accounting/dts/income_tax_refunds_issued` (cash, checks + EFT, refundable credits included, Treasury Offset Program offsets excluded); MTS Table 4 refunds (budget basis: refundable credits above liability are outlays) | the two differ by tens of billions a year and peak in different months (DTS February, MTS April): name the basis | flow | $M |
40
+ | Savings bond (Series I) rates | `v1/accounting/od/i_bonds_interest_rates` | one row per earning period and issue month back to 1998: the rate announced for new bonds is the row whose issue month falls in its own earning period; the composite rate has a 0% floor (May 2009, May 2015), so the published formula does not reproduce those rows; dates are `earning_period_start` (no `record_date`) | stock (a rate) | % |
41
+ | Average interest rate on the debt | `v2/accounting/od/avg_interest_rates` | `security_desc` "Total Interest-bearing Debt", "Total Marketable" (these totals leave out TIPS and FRNs: weighting the component rates by MSPD amounts reproduces them only without those two [derived 2026-10-21]); the TIPS rate is the real coupon, without inflation compensation: not comparable with nominal rates | stock | % |
42
+ | Treasury cash (TGA) | `v1/accounting/dts/operating_cash_balance` | see trap on 2022-04-18 | stock | $M |
43
+ | Daily deposits and withdrawals | `v1/accounting/dts/deposits_withdrawals_operating_cash` | `transaction_type`, `transaction_catg` | flow | $M |
44
+ | Auction results | `v1/accounting/od/auctions_query` | completed auctions (non-null `high_yield`); `original_security_term` to include reopenings; `inflation_index_security` No for nominal notes and bonds (TIPS are `security_type` Note too); use `bid_to_cover_ratio` as published (excludes SOMA) | event | mixed |
45
+ | Exchange rates | `v1/accounting/od/rates_of_exchange` | latest `effective_date` per quarter | stock | foreign units per USD |
46
+
47
+ ## Spec examples
48
+ ```json
49
+ {"description": "Net interest and average rates, FY2015-FY2025",
50
+ "as_of": "2025-09-30",
51
+ "datasets": [
52
+ {"name": "mts9", "endpoint": "v1/accounting/mts/mts_table_9",
53
+ "filter": {"record_date": {"gte": "2014-09-30"}, "record_calendar_month": "09"}},
54
+ {"name": "rates", "endpoint": "v2/accounting/od/avg_interest_rates",
55
+ "filter": {"record_date": {"gte": "2014-10-01"}, "security_desc": ["Total Interest-bearing Debt", "Total Marketable"]}}]}
56
+ ```
57
+ ```json
58
+ {"description": "Debt to the penny, fiscal year ends 2015-2025", "as_of": "2025-09-30",
59
+ "datasets": [{"name": "debt", "endpoint": "v2/accounting/od/debt_to_penny",
60
+ "filter": {"record_date": {"gte": "2014-09-01"}}}]}
61
+ ```
62
+ Per dataset: `name` (file `<name>.csv`), `endpoint`, `filter` (bare value = eq, list = in, or
63
+ `{"gte": ...}`; a string is raw API syntax), optional `fields`, `date_field` (some endpoints use
64
+ `operation_date`, `effective_date` ...), `sort`, `allow_empty`. `as_of` adds `<date_field> <= as_of` to
65
+ every dataset so reruns are reproducible; leave it out only for "latest" lookups.
66
+
67
+ ## Data format and traps
68
+ `fetch` writes `data/treasury/`: `<name>.csv` (API field names, values exactly as published, "null" ->
69
+ empty), `fetch_spec.json` (query URLs, row counts, first and last date, labels, types, unit hints, SHA-256,
70
+ route) and `README.md` (data dictionary with every code column's values). Codes stay text in the CSV, but a
71
+ reader may turn them into numbers: `compute` keeps codes with a leading zero ("09") as text, but reads a
72
+ column whose codes all look like numbers ("1.10", "2.13") as numbers (1.1, 2.13): check such a column before
73
+ filtering. The API's own CSV downloads put an apostrophe before negative amounts; `fetch` and `ingest` write
74
+ them without it.
75
+ - **Units differ:** MTS tables 1-9, Debt to the Penny, interest expense are dollars; DTS, MSPD (`*_mil_amt`)
76
+ and the long MTS series (`mts_receipts_outlays_deficit_surplus.mil_amt`) millions: read the field name;
77
+ percentage fields are already percent. **Signs:** MTS Table 1 shows a deficit as positive, Table 5 negative.
78
+ - **Stocks vs flows:** debt, cash, rates take the end-of-period value or the average (`compute` `to_fiscal`
79
+ with `how` "last" or "mean"); receipts, outlays, deficits, interest sum months (`how` "sum", check
80
+ `complete`) or read the September fiscal-year-to-date value. Never sum year-to-date values or stock levels.
81
+ - **Hierarchies double count:** MTS mixes headers (S), details (D) and totals (T); choose one level and prove
82
+ it: one row per key, and the rows add to the published total. Table 4's D rows do not sum to the
83
+ total (use Table 9). The same letter can be a value of two code columns: filter on the column it is in.
84
+ - **One release, several periods:** MTS Table 1 holds the prior and current fiscal year blocks
85
+ (`sequence_number_cd` 1.x and 2.x), each with its months and a "Year-to-Date" row; its only amount columns
86
+ are `current_month_gross_rcpt_amt`, `_gross_outly_amt`, `_dfct_sur_amt` (positive = deficit). Tables 9
87
+ and others carry `current_fytd_*` / `prior_fytd_*` columns instead.
88
+ - **Dates without a record:** Debt to the Penny and DTS have rows only on business days. For a requested
89
+ weekend or holiday (January 20, 2025 was both Inauguration Day and a federal holiday), use the last record
90
+ before it (its close equals the next statement's opening balance) and say so; count calendar days from
91
+ the requested date and business days from the records, and name which one a per-day figure uses.
92
+ - **Net vs gross receipts:** MTS receipts are net of refunds. When refunds are large the two can move in
93
+ opposite directions (FY2026 customs: gross up 57 percent, net down 11 percent after $145 billion of tariff
94
+ refunds): show gross, refunds and net (Table 4) and say which one the headline uses.
95
+ - **Latest release wins:** MTS releases repeat and revise earlier months: build monthly series from the latest
96
+ `record_date`, full years from September releases; the next September restates the year (FY2024's deficit
97
+ moved by $16 billion).
98
+ - **`fields=` that drops row-identity columns makes the API group and sum rows**; `fetch` compares row
99
+ counts with and without it and stops.
100
+ - **Filter values:** exact text, case-sensitive; a malformed date returns no rows, not an error; values with
101
+ `&` or `,` (and parentheses inside an `in` list; `eq` with parentheses works, verified 2026-10) are
102
+ mishandled by the API, so `fetch` applies those conditions locally (recorded as
103
+ `local_filter`). A filter matching nothing is an `invalid_request` error unless `allow_empty`.
104
+ - **Format changes:** DTS operating cash changed on 2022-04-18 (before: the TGA/FRA row's `close_today_bal`;
105
+ after: the "Closing Balance" row's `open_today_bal`); DTS categories are renamed over time. Debt to the
106
+ Penny's held-by-public and intragovernmental fields are null before 2005-03-31.
107
+ - **Fiscal years** run October 1 to September 30, named for the year they end (`compute` `fiscal_year`); the
108
+ September MTS comes out mid-October. Find the latest complete period from the data (`request_schema` search
109
+ on the endpoint gives its last row), not from memory;
110
+ label partial years and compare them with the same months a year earlier.
111
+ - **Real dollars and GDP:** the spec field `"context": [{"kind": "cpi", "start": 2016}]` (or `"gdp"`; `start`
112
+ is the first fiscal year) writes `context_cpi.csv` / `context_gdp.csv` and `context_sources.json` (FRED, then
113
+ BLS or World Bank). Make a fiscal-year CPI with `compute` `to_fiscal` (`how` "mean") and apply it with
114
+ `deflate`; fiscal-year GDP is the average of four quarterly SAARs, Oct-Sep (`to_fiscal`, `freq` "Q", `how`
115
+ "mean"); the World Bank fallback is calendar years only and cannot give fiscal-year GDP. Incomplete periods
116
+ are flagged: say provisional.
117
+ - **Volume vs rate questions** ("more debt or higher rates?"): split the change exactly with the midpoint
118
+ method: debt effect = (debt1 - debt0) x (rate0 + rate1) / 2, rate effect = (rate1 - rate0) x (debt0 + debt1)
119
+ / 2; the two add up to the change (`compute` `derive`).
120
+ - Analysis: build fiscal-year sums, growth and decompositions with `compute` on the CSVs in `data/treasury/`.
121
+ - **Benchmark** each headline against the official statement for the same date (MTS, MSPD, DTS, Treasury's
122
+ press release, CBO's Monthly Budget Review; for auctions, TreasuryDirect's results files
123
+ `https://www.treasurydirect.gov/xml/R_YYYYMMDD_n.xml`, keyless, a separate system from Fiscal Data); when the table is the statement itself, check its identities
124
+ (components add to the total; receipts - outlays = -deficit). Statement PDFs:
125
+ `https://fiscaldata.treasury.gov/static-data/published-reports/mts/MonthlyTreasuryStatement_YYYYMM.pdf` and
126
+ `.../dts/DailyTreasuryStatement_YYYYMMDD.pdf`; MSPD: `.../mspd-entire/MonthlyStatementPublicDebt_Entire_YYYYMM.pdf`. The fiscaldata.treasury.gov dataset pages draw their tables
127
+ with JavaScript: a fetch tool sees no values there (use the API or the PDFs). The PDFs are compressed:
128
+ a web fetch tool cannot read them; save the file and extract its text locally (pypdf). The API rows are
129
+ the statement's own figures, so an API value equal to the PDF's is a transcription check, not an
130
+ independent one. cbo.gov refuses scripted downloads (HTTP 403), and a browser pane may only download its
131
+ PDF: when no one can open it, record CBO's Monthly Budget Review as "not checked" in benchmark.csv (with a
132
+ data_needs entry), or ask the user to upload the PDF.
133
+ - **Identity gaps:** in `mts_receipts_outlays_deficit_surplus`, receipts minus outlays misses the deficit line by
134
+ a few million in some months (Sep 2022 by $10 million, Mar 2024 by $270 million, as published): use the
135
+ deficit line for deficits, check an identity with a tolerance of a few hundred million, and tie fiscal-year
136
+ totals to the September MTS.
137
+ - **Coverage:** MTS Tables 1 to 9 start in March 2015, so FY2015 is their first full year; a filter from an
138
+ earlier date returns rows from 2015 on without an error. For earlier years use
139
+ `mts_receipts_outlays_deficit_surplus` (totals from FY1981) or OMB's Historical Tables through FRED
140
+ (`FYOINT` net interest, `FYFSD` deficit, `FYONET` outlays, in millions), and say where the series join.
141
+ FRED carries only those totals: a receipt or outlay line before FY2015 (customs duties, a function) comes from
142
+ OMB's Historical Tables (Table 2.5 receipts by source, 3.2 outlays by function, 10.1 GDP; FY1940 on) through
143
+ the omb pack (`historical_table`, any budget edition); each edition revises history, so name the edition.
144
+
145
+ ## Access
146
+ - No key, no registration, GET only, no documented rate limit (the client keeps 4 requests a second and
147
+ backs off on 429/5xx). Pages of up to 10,000 rows; `fetch` pages and checks the row count against
148
+ `total-count`.
149
+ - `fetch` reuses `data/treasury/` when it already holds the same spec (`force: true` refetches). A filter that
150
+ matches no rows or names an unknown field comes back as `invalid_request` (check values with `request_schema`
151
+ search `"<endpoint> <filter> values"`); a bad endpoint or aggregation the API refuses, as `agency_rejected`.
152
+ When the API cannot be reached (`agency_unavailable`: internet, VPN, proxy `HTTPS_PROXY`, a host that blocks
153
+ `api.fiscaldata.treasury.gov`), tell the user, offer `manual_bundle`, and never invent or recall numbers.
154
+ - Manual download: `manual_bundle` writes `manual_download/INSTRUCTIONS.md` with one CSV link per dataset
155
+ (10,000 rows each; more pages with `page%5Bnumber%5D=2` saved as `<name>_2.csv` ...), curl and PowerShell
156
+ scripts, and the dataset page whose Download button gives the whole table. Upload the CSV or ZIP files
157
+ unchanged (not re-saved in Excel); `ingest` with the uploaded files or their folder applies the spec's
158
+ filter locally, strips the apostrophe guard, drops duplicate rows and warns about a missing page.
159
+
160
+ ## Citation and terms
161
+ "U.S. Department of the Treasury, Bureau of the Fiscal Service, Fiscal Data (https://fiscaldata.treasury.gov),
162
+ <endpoints>; retrieved <date> through the Fiscal Data API." (exact line in `data/treasury/README.md`). Source
163
+ line: "Analyst calculations using data from the Department of the Treasury, Bureau of the Fiscal Service,
164
+ Monthly Treasury Statement (retrieved <date>)." Public domain: redistribution allowed; cite the retrieval
165
+ date because Treasury revises some series.
@@ -0,0 +1,226 @@
1
+ {
2
+ "base_url": "https://home.treasury.gov/resource-center/data-chart-center/interest-rates",
3
+ "headers": {
4
+ "Accept": "text/csv",
5
+ "User-Agent": "Mozilla/5.0 (compatible; data-analyst/1.0)"
6
+ },
7
+ "endpoints": {
8
+ "par_yield_curve": {
9
+ "path": "/daily-treasury-rates.csv/{year}/all",
10
+ "method": "GET",
11
+ "description": "Daily Treasury par yield curve rates (CMT), percent, one column per maturity from 1 Mo to 30 Yr; from 1990. One request per calendar year.",
12
+ "first_year": 1990,
13
+ "params": {
14
+ "year": {
15
+ "in": "path",
16
+ "desc": "set by the adapter from year / start_year / end_year"
17
+ },
18
+ "start_year": {
19
+ "in": "spec",
20
+ "desc": "first calendar year (default: the current year)"
21
+ },
22
+ "end_year": {
23
+ "in": "spec",
24
+ "desc": "last calendar year (default: start_year or the current year)"
25
+ },
26
+ "type": {
27
+ "desc": "fixed: daily_treasury_yield_curve"
28
+ }
29
+ },
30
+ "defaults": {
31
+ "type": "daily_treasury_yield_curve",
32
+ "_format": "csv"
33
+ },
34
+ "records": "$csv",
35
+ "paging": {
36
+ "type": "none"
37
+ },
38
+ "max_rows": 20000,
39
+ "missing": [
40
+ "",
41
+ "N/A"
42
+ ],
43
+ "flatten": false
44
+ },
45
+ "real_yield_curve": {
46
+ "path": "/daily-treasury-rates.csv/{year}/all",
47
+ "method": "GET",
48
+ "description": "Daily Treasury par real yield curve rates (TIPS), percent, 5 YR to 30 YR; from 2003.",
49
+ "first_year": 2003,
50
+ "params": {
51
+ "year": {
52
+ "in": "path",
53
+ "desc": "set by the adapter"
54
+ },
55
+ "start_year": {
56
+ "in": "spec",
57
+ "desc": "first calendar year"
58
+ },
59
+ "end_year": {
60
+ "in": "spec",
61
+ "desc": "last calendar year"
62
+ },
63
+ "type": {
64
+ "desc": "fixed: daily_treasury_real_yield_curve"
65
+ }
66
+ },
67
+ "defaults": {
68
+ "type": "daily_treasury_real_yield_curve",
69
+ "_format": "csv"
70
+ },
71
+ "records": "$csv",
72
+ "paging": {
73
+ "type": "none"
74
+ },
75
+ "max_rows": 20000,
76
+ "missing": [
77
+ "",
78
+ "N/A"
79
+ ],
80
+ "flatten": false
81
+ },
82
+ "bill_rates": {
83
+ "path": "/daily-treasury-rates.csv/{year}/all",
84
+ "method": "GET",
85
+ "description": "Daily Treasury bill rates: bank discount and coupon-equivalent rates for 4- to 52-week bills (closing market bid), percent; from 2002.",
86
+ "first_year": 2002,
87
+ "params": {
88
+ "year": {
89
+ "in": "path",
90
+ "desc": "set by the adapter"
91
+ },
92
+ "start_year": {
93
+ "in": "spec",
94
+ "desc": "first calendar year"
95
+ },
96
+ "end_year": {
97
+ "in": "spec",
98
+ "desc": "last calendar year"
99
+ },
100
+ "type": {
101
+ "desc": "fixed: daily_treasury_bill_rates"
102
+ }
103
+ },
104
+ "defaults": {
105
+ "type": "daily_treasury_bill_rates",
106
+ "_format": "csv"
107
+ },
108
+ "records": "$csv",
109
+ "paging": {
110
+ "type": "none"
111
+ },
112
+ "max_rows": 20000,
113
+ "missing": [
114
+ "",
115
+ "N/A"
116
+ ],
117
+ "flatten": false
118
+ },
119
+ "long_term_rates": {
120
+ "path": "/daily-treasury-rates.csv/{year}/all",
121
+ "method": "GET",
122
+ "description": "Daily Treasury long-term rates: the long-term composite rate (>10 years) and the 20-year CMT, percent; from 2000.",
123
+ "first_year": 2000,
124
+ "params": {
125
+ "year": {
126
+ "in": "path",
127
+ "desc": "set by the adapter"
128
+ },
129
+ "start_year": {
130
+ "in": "spec",
131
+ "desc": "first calendar year"
132
+ },
133
+ "end_year": {
134
+ "in": "spec",
135
+ "desc": "last calendar year"
136
+ },
137
+ "type": {
138
+ "desc": "fixed: daily_treasury_long_term_rate"
139
+ }
140
+ },
141
+ "defaults": {
142
+ "type": "daily_treasury_long_term_rate",
143
+ "_format": "csv"
144
+ },
145
+ "records": "$csv",
146
+ "paging": {
147
+ "type": "none"
148
+ },
149
+ "max_rows": 20000,
150
+ "missing": [
151
+ "",
152
+ "N/A"
153
+ ],
154
+ "flatten": false
155
+ },
156
+ "real_long_term": {
157
+ "path": "/daily-treasury-rates.csv/{year}/all",
158
+ "method": "GET",
159
+ "description": "Daily Treasury real long-term rate average (TIPS with more than 10 years to maturity), percent; from 2000.",
160
+ "first_year": 2000,
161
+ "params": {
162
+ "year": {
163
+ "in": "path",
164
+ "desc": "set by the adapter"
165
+ },
166
+ "start_year": {
167
+ "in": "spec",
168
+ "desc": "first calendar year"
169
+ },
170
+ "end_year": {
171
+ "in": "spec",
172
+ "desc": "last calendar year"
173
+ },
174
+ "type": {
175
+ "desc": "fixed: daily_treasury_real_long_term"
176
+ }
177
+ },
178
+ "defaults": {
179
+ "type": "daily_treasury_real_long_term",
180
+ "_format": "csv"
181
+ },
182
+ "records": "$csv",
183
+ "paging": {
184
+ "type": "none"
185
+ },
186
+ "max_rows": 20000,
187
+ "missing": [
188
+ "",
189
+ "N/A"
190
+ ],
191
+ "flatten": false
192
+ }
193
+ },
194
+ "catalog": {
195
+ "par": {
196
+ "id": "daily_treasury_yield_curve",
197
+ "name": "Daily Treasury Par Yield Curve Rates",
198
+ "endpoint": "par_yield_curve",
199
+ "description": "nominal constant-maturity (CMT) par yields, 1 month to 30 years: 10-year yield, 2-year yield, yield curve, term spread, inversion"
200
+ },
201
+ "real": {
202
+ "id": "daily_treasury_real_yield_curve",
203
+ "name": "Daily Treasury Par Real Yield Curve Rates",
204
+ "endpoint": "real_yield_curve",
205
+ "description": "TIPS real yields 5 to 30 years; breakeven inflation with the nominal curve"
206
+ },
207
+ "bills": {
208
+ "id": "daily_treasury_bill_rates",
209
+ "name": "Daily Treasury Bill Rates",
210
+ "endpoint": "bill_rates",
211
+ "description": "T-bill bank discount and coupon equivalent rates, 4 to 52 weeks"
212
+ },
213
+ "long_term": {
214
+ "id": "daily_treasury_long_term_rate",
215
+ "name": "Daily Treasury Long-Term Rates",
216
+ "endpoint": "long_term_rates",
217
+ "description": "long-term composite rate above 10 years; 20-year CMT"
218
+ },
219
+ "real_long_term": {
220
+ "id": "daily_treasury_real_long_term",
221
+ "name": "Daily Treasury Real Long-Term Rates",
222
+ "endpoint": "real_long_term",
223
+ "description": "average real yield of TIPS above 10 years"
224
+ }
225
+ }
226
+ }
@@ -0,0 +1,86 @@
1
+ {
2
+ "id": "treasury-yields",
3
+ "title": "Treasury Daily Interest Rate Statistics (home.treasury.gov)",
4
+ "agency": "U.S. Department of the Treasury, Office of Debt Management",
5
+ "depth": "standard",
6
+ "domains": [
7
+ "interest rates",
8
+ "bond market",
9
+ "finance"
10
+ ],
11
+ "keywords": [
12
+ "treasury yield",
13
+ "yield curve",
14
+ "par yield",
15
+ "10-year yield",
16
+ "2-year yield",
17
+ "30-year yield",
18
+ "constant maturity",
19
+ "cmt",
20
+ "term spread",
21
+ "inversion",
22
+ "real yield",
23
+ "tips",
24
+ "breakeven",
25
+ "bill rates",
26
+ "t-bill",
27
+ "long-term rate",
28
+ "market yields",
29
+ "interest rates"
30
+ ],
31
+ "questions": [
32
+ "10-year Treasury yield since 2020",
33
+ "is the yield curve inverted",
34
+ "2s10s spread history",
35
+ "TIPS real yields",
36
+ "3-month bill rate",
37
+ "30-year Treasury yield"
38
+ ],
39
+ "homepage": "https://home.treasury.gov/policy-issues/financing-the-government/interest-rate-statistics",
40
+ "terms_url": "https://home.treasury.gov/footer/privacy-act",
41
+ "auth": {
42
+ "env": null,
43
+ "required": "none",
44
+ "placement": "none",
45
+ "signup_url": null,
46
+ "echoes_key": false
47
+ },
48
+ "limits": {
49
+ "rps": 2,
50
+ "burst": 4,
51
+ "max_rows": 20000
52
+ },
53
+ "routes": {
54
+ "api": {
55
+ "base": "https://home.treasury.gov/resource-center/data-chart-center/interest-rates",
56
+ "probe": "https://home.treasury.gov/robots.txt",
57
+ "hosts": [
58
+ "home.treasury.gov"
59
+ ]
60
+ },
61
+ "manual": {
62
+ "how": "Open https://home.treasury.gov/policy-issues/financing-the-government/interest-rate-statistics, pick the rate type (Daily Treasury Par Yield Curve Rates, Par Real Yield Curve, Bill Rates, Long-Term Rates, Real Long-Term Rates) and the year, choose Download CSV, and upload one file per year; or open the links in INSTRUCTIONS.md."
63
+ }
64
+ },
65
+ "cache": {
66
+ "mode": "run_only",
67
+ "ttl_hours": null,
68
+ "why": "One small CSV per year (5-20 KB); the current year grows daily, so data/ is reused within a run only."
69
+ },
70
+ "redistribution": {
71
+ "mode": "allowed",
72
+ "why": "Treasury interest rate statistics are U.S. government works in the public domain (17 U.S.C. 105); cite Treasury and the retrieval date."
73
+ },
74
+ "notices": [],
75
+ "retention": null,
76
+ "citation": "U.S. Department of the Treasury, Daily Treasury Interest Rate Statistics, {dataset}, home.treasury.gov, retrieved {retrieved_long}.",
77
+ "audit_hooks": [],
78
+ "clarify": [
79
+ "Nominal par yields (CMT) or real (TIPS) yields? Bill rates come as bank discount and coupon equivalent: say which.",
80
+ "Daily values, or monthly or annual averages of business days (Treasury's own averages use business days with data)?"
81
+ ],
82
+ "formats": [
83
+ "csv",
84
+ "xml"
85
+ ]
86
+ }