data-analyst-mcp 0.3.0 → 0.4.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 (292) hide show
  1. package/README.md +286 -262
  2. package/dist/adapters/bjs.d.ts +13 -0
  3. package/dist/adapters/bjs.js +28 -0
  4. package/dist/adapters/bjs.js.map +1 -0
  5. package/dist/adapters/cbp.d.ts +5 -0
  6. package/dist/adapters/cbp.js +64 -0
  7. package/dist/adapters/cbp.js.map +1 -0
  8. package/dist/adapters/cdc-wonder.d.ts +5 -0
  9. package/dist/adapters/cdc-wonder.js +68 -0
  10. package/dist/adapters/cdc-wonder.js.map +1 -0
  11. package/dist/adapters/cpsc.d.ts +4 -0
  12. package/dist/adapters/cpsc.js +125 -0
  13. package/dist/adapters/cpsc.js.map +1 -0
  14. package/dist/adapters/fhwa.d.ts +9 -0
  15. package/dist/adapters/fhwa.js +16 -0
  16. package/dist/adapters/fhwa.js.map +1 -0
  17. package/dist/adapters/foreign-assistance.d.ts +9 -0
  18. package/dist/adapters/foreign-assistance.js +42 -0
  19. package/dist/adapters/foreign-assistance.js.map +1 -0
  20. package/dist/adapters/hud-ahar.d.ts +3 -0
  21. package/dist/adapters/hud-ahar.js +80 -0
  22. package/dist/adapters/hud-ahar.js.map +1 -0
  23. package/dist/adapters/nces.d.ts +10 -0
  24. package/dist/adapters/nces.js +32 -0
  25. package/dist/adapters/nces.js.map +1 -0
  26. package/dist/adapters/nsf.d.ts +11 -0
  27. package/dist/adapters/nsf.js +25 -0
  28. package/dist/adapters/nsf.js.map +1 -0
  29. package/dist/adapters/onrr.d.ts +9 -0
  30. package/dist/adapters/onrr.js +35 -0
  31. package/dist/adapters/onrr.js.map +1 -0
  32. package/dist/adapters/sba.d.ts +10 -0
  33. package/dist/adapters/sba.js +134 -0
  34. package/dist/adapters/sba.js.map +1 -0
  35. package/dist/adapters/treasury-tic.d.ts +30 -0
  36. package/dist/adapters/treasury-tic.js +149 -0
  37. package/dist/adapters/treasury-tic.js.map +1 -0
  38. package/dist/adapters/uscourts.d.ts +8 -0
  39. package/dist/adapters/uscourts.js +8 -0
  40. package/dist/adapters/uscourts.js.map +1 -0
  41. package/dist/analysis/cite.d.ts +9 -1
  42. package/dist/analysis/cite.js +9 -2
  43. package/dist/analysis/cite.js.map +1 -1
  44. package/dist/bin/cli.d.ts +2 -0
  45. package/dist/bin/cli.js +17 -0
  46. package/dist/bin/cli.js.map +1 -1
  47. package/dist/core/generic-rest.js +42 -17
  48. package/dist/core/generic-rest.js.map +1 -1
  49. package/dist/core/guard.d.ts +32 -0
  50. package/dist/core/guard.js +176 -0
  51. package/dist/core/guard.js.map +1 -0
  52. package/dist/core/http.d.ts +10 -0
  53. package/dist/core/http.js +36 -7
  54. package/dist/core/http.js.map +1 -1
  55. package/dist/core/keys.d.ts +13 -3
  56. package/dist/core/keys.js +67 -7
  57. package/dist/core/keys.js.map +1 -1
  58. package/dist/core/package.d.ts +12 -3
  59. package/dist/core/package.js +56 -12
  60. package/dist/core/package.js.map +1 -1
  61. package/dist/core/secret_patterns.d.ts +6 -0
  62. package/dist/core/secret_patterns.js +20 -0
  63. package/dist/core/secret_patterns.js.map +1 -0
  64. package/dist/core/tabular.d.ts +43 -1
  65. package/dist/core/tabular.js +149 -6
  66. package/dist/core/tabular.js.map +1 -1
  67. package/dist/envelope.js +3 -1
  68. package/dist/envelope.js.map +1 -1
  69. package/dist/index.d.ts +29 -22
  70. package/dist/index.js +45 -46
  71. package/dist/index.js.map +1 -1
  72. package/dist/remote/app.js +87 -31
  73. package/dist/remote/app.js.map +1 -1
  74. package/dist/remote/oauth.js +8 -1
  75. package/dist/remote/oauth.js.map +1 -1
  76. package/dist/remote/pages.d.ts +3 -7
  77. package/dist/remote/pages.js +49 -19
  78. package/dist/remote/pages.js.map +1 -1
  79. package/dist/remote/sign.d.ts +7 -1
  80. package/dist/remote/sign.js +33 -7
  81. package/dist/remote/sign.js.map +1 -1
  82. package/dist/remote/store.js +14 -5
  83. package/dist/remote/store.js.map +1 -1
  84. package/dist/report/audit_report.js +29 -7
  85. package/dist/report/audit_report.js.map +1 -1
  86. package/dist/report/build_report.js +34 -4
  87. package/dist/report/build_report.js.map +1 -1
  88. package/dist/report/method_audit.js +10 -1
  89. package/dist/report/method_audit.js.map +1 -1
  90. package/dist/report/scan_secrets.d.ts +4 -1
  91. package/dist/report/scan_secrets.js +38 -18
  92. package/dist/report/scan_secrets.js.map +1 -1
  93. package/dist/server.d.ts +3 -1
  94. package/dist/server.js +46 -13
  95. package/dist/server.js.map +1 -1
  96. package/dist/tools.js +27 -6
  97. package/dist/tools.js.map +1 -1
  98. package/guide/WORKFLOW.md +134 -134
  99. package/guide/assets/disclaimer.txt +1 -1
  100. package/guide/assets/download_data.ps1 +164 -162
  101. package/guide/assets/download_data.sh +8 -2
  102. package/guide/assets/report_template.html +597 -597
  103. package/guide/references/routing.md +198 -171
  104. package/guide/references/style_guide.md +398 -398
  105. package/package.json +56 -56
  106. package/packs/acf/endpoints.json +114 -114
  107. package/packs/acf/policy.json +104 -104
  108. package/packs/actuaries/endpoints.json +82 -82
  109. package/packs/actuaries/policy.json +109 -109
  110. package/packs/bea/assets/download_bea.ps1 +182 -182
  111. package/packs/bea/docs/bea_api.md +461 -461
  112. package/packs/bea/docs/datasets.md +157 -157
  113. package/packs/bea/docs/report_patterns.md +112 -112
  114. package/packs/bea/policy.json +170 -170
  115. package/packs/bea/source.md +152 -152
  116. package/packs/bjs/endpoints.json +150 -0
  117. package/packs/bjs/policy.json +114 -0
  118. package/packs/bjs/source.md +98 -0
  119. package/packs/bls/assets/download_bls.ps1 +152 -152
  120. package/packs/bls/docs/analysis_patterns.md +108 -108
  121. package/packs/bls/docs/bls_api.md +73 -73
  122. package/packs/bls/docs/series_ids.md +149 -149
  123. package/packs/bls/policy.json +238 -238
  124. package/packs/bts/endpoints.json +346 -346
  125. package/packs/bts/policy.json +94 -94
  126. package/packs/cbp/endpoints.json +31 -0
  127. package/packs/cbp/policy.json +85 -0
  128. package/packs/cbp/source.md +57 -0
  129. package/packs/cdc/endpoints.json +197 -197
  130. package/packs/cdc/policy.json +83 -83
  131. package/packs/cdc/source.md +1 -1
  132. package/packs/cdc-wonder/endpoints.json +26 -0
  133. package/packs/cdc-wonder/policy.json +84 -0
  134. package/packs/cdc-wonder/source.md +53 -0
  135. package/packs/census/endpoints.json +99 -99
  136. package/packs/cfpb/endpoints.json +326 -326
  137. package/packs/cfpb/policy.json +119 -119
  138. package/packs/clinical-trials/endpoints.json +166 -166
  139. package/packs/clinical-trials/policy.json +84 -84
  140. package/packs/cms/endpoints.json +69 -69
  141. package/packs/cms/policy.json +96 -96
  142. package/packs/college-scorecard/endpoints.json +252 -252
  143. package/packs/college-scorecard/policy.json +106 -106
  144. package/packs/college-scorecard/source.md +1 -1
  145. package/packs/congress/endpoints.json +1701 -1701
  146. package/packs/congress/policy.json +117 -117
  147. package/packs/cpsc/endpoints.json +91 -0
  148. package/packs/cpsc/policy.json +91 -0
  149. package/packs/cpsc/source.md +76 -0
  150. package/packs/dhs-ohss/endpoints.json +66 -66
  151. package/packs/dhs-ohss/policy.json +107 -107
  152. package/packs/dhs-ohss/source.md +1 -1
  153. package/packs/doj-news/endpoints.json +59 -59
  154. package/packs/doj-news/policy.json +96 -96
  155. package/packs/doj-news/source.md +1 -1
  156. package/packs/dol/endpoints.json +817 -817
  157. package/packs/dol/policy.json +135 -135
  158. package/packs/eia/endpoints.json +717 -717
  159. package/packs/eia/policy.json +112 -112
  160. package/packs/epa/endpoints.json +291 -291
  161. package/packs/epa/policy.json +99 -99
  162. package/packs/epa-aqs/endpoints.json +173 -173
  163. package/packs/epa-aqs/policy.json +96 -96
  164. package/packs/fbi/endpoints.json +1841 -1841
  165. package/packs/fbi/policy.json +118 -118
  166. package/packs/fbi/source.md +3 -3
  167. package/packs/fda/endpoints.json +237 -237
  168. package/packs/fda/policy.json +121 -121
  169. package/packs/fdic/endpoints.json +416 -416
  170. package/packs/fdic/policy.json +83 -83
  171. package/packs/fec/endpoints.json +707 -707
  172. package/packs/fec/policy.json +93 -93
  173. package/packs/fed-board/endpoints.json +89 -89
  174. package/packs/fed-board/policy.json +136 -136
  175. package/packs/federal-register/endpoints.json +143 -143
  176. package/packs/federal-register/policy.json +86 -86
  177. package/packs/fema/endpoints.json +645 -645
  178. package/packs/fema/policy.json +103 -103
  179. package/packs/fhfa/endpoints.json +105 -105
  180. package/packs/fhfa/policy.json +109 -109
  181. package/packs/fhwa/endpoints.json +48 -0
  182. package/packs/fhwa/policy.json +91 -0
  183. package/packs/fhwa/source.md +59 -0
  184. package/packs/foreign-assistance/endpoints.json +166 -0
  185. package/packs/foreign-assistance/policy.json +80 -0
  186. package/packs/foreign-assistance/source.md +76 -0
  187. package/packs/fred/assets/download_fred.ps1 +122 -122
  188. package/packs/fred/docs/analysis_patterns.md +124 -124
  189. package/packs/fred/docs/fred_api.md +94 -94
  190. package/packs/fred/docs/series.md +188 -188
  191. package/packs/fred/policy.json +253 -253
  192. package/packs/fsa/endpoints.json +150 -150
  193. package/packs/fsa/policy.json +99 -99
  194. package/packs/fsa/source.md +1 -1
  195. package/packs/govinfo/endpoints.json +519 -519
  196. package/packs/gsa-calc/endpoints.json +93 -93
  197. package/packs/gsa-calc/policy.json +97 -97
  198. package/packs/hud/endpoints.json +146 -146
  199. package/packs/hud/policy.json +84 -84
  200. package/packs/hud/source.md +1 -1
  201. package/packs/hud-ahar/endpoints.json +92 -0
  202. package/packs/hud-ahar/policy.json +88 -0
  203. package/packs/hud-ahar/source.md +72 -0
  204. package/packs/ipums/docs/report_patterns.md +117 -117
  205. package/packs/irs-soi/endpoints.json +114 -114
  206. package/packs/irs-soi/policy.json +107 -107
  207. package/packs/medicaid/endpoints.json +412 -412
  208. package/packs/medicaid/policy.json +108 -108
  209. package/packs/naep/endpoints.json +217 -217
  210. package/packs/naep/policy.json +100 -100
  211. package/packs/naep/source.md +1 -1
  212. package/packs/nces/endpoints.json +101 -0
  213. package/packs/nces/policy.json +99 -0
  214. package/packs/nces/source.md +75 -0
  215. package/packs/nhtsa/endpoints.json +132 -132
  216. package/packs/nhtsa/policy.json +93 -93
  217. package/packs/nhtsa/source.md +1 -1
  218. package/packs/nih/endpoints.json +452 -452
  219. package/packs/nih/policy.json +86 -86
  220. package/packs/noaa/endpoints.json +431 -431
  221. package/packs/noaa/policy.json +95 -95
  222. package/packs/nrel/endpoints.json +327 -327
  223. package/packs/nrel/policy.json +96 -96
  224. package/packs/nsf/endpoints.json +33 -0
  225. package/packs/nsf/policy.json +83 -0
  226. package/packs/nsf/source.md +59 -0
  227. package/packs/nws/endpoints.json +271 -271
  228. package/packs/nws/policy.json +82 -82
  229. package/packs/nyfed/endpoints.json +80 -80
  230. package/packs/nyfed/policy.json +92 -92
  231. package/packs/omb/endpoints.json +460 -460
  232. package/packs/omb/policy.json +106 -106
  233. package/packs/onrr/endpoints.json +198 -0
  234. package/packs/onrr/policy.json +91 -0
  235. package/packs/onrr/source.md +55 -0
  236. package/packs/open-payments/endpoints.json +297 -297
  237. package/packs/open-payments/policy.json +101 -101
  238. package/packs/opm/assets/download_opm.ps1 +125 -125
  239. package/packs/opm/docs/fields.md +184 -184
  240. package/packs/opm/docs/opm_api.md +71 -71
  241. package/packs/opm/docs/report_patterns.md +83 -83
  242. package/packs/opm/lib/data_dictionary.csv +73 -73
  243. package/packs/pbgc/endpoints.json +483 -483
  244. package/packs/pbgc/policy.json +94 -94
  245. package/packs/philfed/endpoints.json +85 -85
  246. package/packs/philfed/policy.json +94 -94
  247. package/packs/port.json +65 -0
  248. package/packs/regulations/endpoints.json +287 -287
  249. package/packs/regulations/policy.json +86 -86
  250. package/packs/sba/endpoints.json +34 -0
  251. package/packs/sba/policy.json +86 -0
  252. package/packs/sba/source.md +60 -0
  253. package/packs/sec/endpoints.json +236 -236
  254. package/packs/sec/policy.json +86 -86
  255. package/packs/senate-lobbying/endpoints.json +553 -553
  256. package/packs/senate-lobbying/policy.json +99 -99
  257. package/packs/snapqc/endpoints.json +1426 -1426
  258. package/packs/snapqc/policy.json +92 -92
  259. package/packs/treasury/catalog.json +2267 -2267
  260. package/packs/treasury/docs/api_guide.md +245 -245
  261. package/packs/treasury/docs/datasets.md +56 -56
  262. package/packs/treasury/docs/report_patterns.md +126 -126
  263. package/packs/treasury/policy.json +159 -159
  264. package/packs/treasury/source.md +170 -165
  265. package/packs/treasury-tic/endpoints.json +77 -0
  266. package/packs/treasury-tic/policy.json +89 -0
  267. package/packs/treasury-tic/source.md +80 -0
  268. package/packs/treasury-yields/endpoints.json +226 -226
  269. package/packs/treasury-yields/policy.json +86 -86
  270. package/packs/usaspending/endpoints.json +1315 -1315
  271. package/packs/usaspending/policy.json +109 -109
  272. package/packs/uscourts/endpoints.json +22 -0
  273. package/packs/uscourts/policy.json +87 -0
  274. package/packs/uscourts/source.md +56 -0
  275. package/packs/usda-fna/policy.json +133 -133
  276. package/packs/usda-fooddata/endpoints.json +180 -180
  277. package/packs/usda-fooddata/policy.json +94 -94
  278. package/packs/usda-nass/endpoints.json +323 -323
  279. package/packs/usda-nass/policy.json +95 -95
  280. package/packs/usda-outlook/endpoints.json +86 -86
  281. package/packs/usda-outlook/policy.json +109 -109
  282. package/packs/usgs/endpoints.json +313 -313
  283. package/packs/usgs/policy.json +95 -95
  284. package/packs/usitc/endpoints.json +74 -74
  285. package/packs/usitc/policy.json +111 -111
  286. package/packs/uspto/endpoints.json +141 -141
  287. package/packs/uspto/policy.json +95 -95
  288. package/packs/uspto/source.md +1 -1
  289. package/packs/va/endpoints.json +414 -414
  290. package/packs/va/policy.json +101 -101
  291. package/packs/world-bank/endpoints.json +122 -122
  292. package/packs/world-bank/policy.json +101 -101
@@ -0,0 +1,80 @@
1
+ # Treasury International Capital (TIC): foreign holdings of U.S. Treasury and other securities
2
+ Depth: standard. Key: none. The TIC system's published text tables on ticdata.treasury.gov. Major Foreign
3
+ Holders of Treasury Securities by country, monthly: the latest 13 months (SLT Table 5) and the history from
4
+ March 2000 (mfhhis01.txt), in billions. SLT Table 1: foreign holdings, net purchases and valuation changes of
5
+ U.S. long-term securities (Treasuries, agency bonds, corporate bonds, equities) by country, monthly from
6
+ September 2011, in millions.
7
+
8
+ ## When to use
9
+ - Who holds the U.S. debt abroad: holdings of Treasury securities by Japan, China, the UK and others;
10
+ rankings; trends; the foreign-official part (central banks and governments) and its split into bills and
11
+ bonds/notes.
12
+ - Foreign holdings of U.S. corporate bonds, agency bonds and stocks by country; net foreign purchases or
13
+ sales by month (long-term securities, Table 1).
14
+ - Not here: total debt held by the public and intragovernmental holdings (treasury: Debt to the Penny, MSPD);
15
+ the Fed's holdings and the full who-holds-what balance sheet (fed-board Z.1, table L.210); the balance of
16
+ payments and international investment position (bea); exchange rates (treasury, fred).
17
+
18
+ ## Endpoints
19
+ | Endpoint | Returns | Parameters (all filter the published file; none is sent) |
20
+ |---|---|---|
21
+ | `major_foreign_holders` | slt_table5.txt, long: `country`, `kind`, `period` (YYYY-MM), `holdings_billions`; the latest 13 months | `country` (a name or a list) |
22
+ | `major_foreign_holders_history` | mfhhis01.txt, the same columns plus `comparison_only`; March 2000 to the last full year | `country`, `from`, `to` (YYYY-MM), `include_comparison` |
23
+ | `holdings_by_country` | slt_table1.txt as published: `country`, `country_code`, `date`, then `for_lt_<type>_<pos|net|valchg>` for total, treas, agcy, corp, eqty | `country` (name or 5-digit code), `from`, `to` |
24
+
25
+ `kind` is `country`, `all_other`, `grand_total` or `foreign_official` (the rows "Of Which: Foreign
26
+ Official", "... Treasury Bills", "... T-Bonds & Notes").
27
+
28
+ ## Spec examples
29
+ ```json
30
+ {"description": "China's and Japan's holdings of Treasury securities, the latest 13 months",
31
+ "requests": [{"name": "mfh", "endpoint": "major_foreign_holders",
32
+ "params": {"country": ["Japan", "China, Mainland", "Grand Total"]}}]}
33
+ ```
34
+ ```json
35
+ {"description": "China's Treasury holdings since 2010, monthly",
36
+ "requests": [{"name": "china", "endpoint": "major_foreign_holders_history",
37
+ "params": {"country": "China, Mainland", "from": "2010-01"}},
38
+ {"name": "china_recent", "endpoint": "major_foreign_holders", "params": {"country": "China, Mainland"}}]}
39
+ ```
40
+ ```json
41
+ {"description": "Japan's holdings of U.S. long-term securities by type, 2026",
42
+ "requests": [{"name": "japan_lt", "endpoint": "holdings_by_country", "params": {"country": "Japan", "from": "2026-01"}}]}
43
+ ```
44
+
45
+ ## Data format and traps
46
+ - Units differ: Major Foreign Holders is in billions of dollars, SLT Table 1 in millions. Values are kept as
47
+ published text (one decimal in billions); convert with `Number()` before arithmetic.
48
+ - The measures differ. Major Foreign Holders counts all Treasury securities, bills included, at market value.
49
+ Table 1's `for_lt_treas_pos` counts long-term Treasuries only (no bills). The two are not interchangeable.
50
+ - Custody bias, as the files note: holdings are attributed to the country where the securities are held in
51
+ custody, not the owner. Belgium, Luxembourg, the Cayman Islands, Ireland and the UK hold securities for
52
+ others; China's holdings held through Belgian custody show up under Belgium. Say "held in custody in" or
53
+ quote Treasury's caveat when ranking countries.
54
+ - Names change between files: `Korea, South` (table 5 and most years) vs `Korea` (some years of the history); history rows before about
55
+ 2011 include groups such as "Oil Exporters" and "Carib Bnkng Ctrs" (footnote marks like "2/" are removed from
56
+ labels). Check the names in the rows before filtering a long series.
57
+ - Revisions: the latest 13 months (table 5) are revised each month and after each annual survey, so the same
58
+ month can differ by a few tenths from the history file (UK, December 2025: 863.2 vs 863.1, files of
59
+ 2026-11-07). Use table 5 for the last 13 months and the history for older months, and say so.
60
+ - Series breaks: the history repeats June in 2002-2011 (March in 2000). The first value is the new series (based
61
+ on the June benchmark survey), the second the previous series "for comparison only". By default only the first
62
+ is kept; `include_comparison: true` adds the second with `comparison_only` True. Do not compare across a break
63
+ without saying so.
64
+ - In those break years the published file puts January in a 14th column, one line above its row label; the
65
+ pack reads it from there (Japan, January 2005: 679.5).
66
+ - "n.a." marks a country not shown separately in that month (Luxembourg before June 2002): keep it, and never
67
+ treat it as zero.
68
+ - `All Other` and `Grand Total` are rows: drop them (filter `kind = country`) before ranking or summing
69
+ countries. The foreign-official rows are part of the grand total, not more countries.
70
+ - Table 1's file ends with a definitions footer; rows without a YYYY-MM `date` are dropped.
71
+
72
+ ## Access
73
+ No key. `fetch` reads the three files whole (largest about 1 MB) and filters them locally. Manual: open
74
+ https://ticdata.treasury.gov/resource-center/data-chart-center/tic/Documents/slt_table5.txt (or mfhhis01.txt,
75
+ slt_table1.txt) in a browser, save it, and `ingest` the .txt file. The older `mfh.txt` at the same address stopped
76
+ at January 2023: do not use it. Release calendar and notes: https://home.treasury.gov/data/treasury-international-capital-tic-system.
77
+
78
+ ## Citation and terms
79
+ "U.S. Department of the Treasury, Treasury International Capital (TIC) System, Major Foreign Holders of Treasury
80
+ Securities (or SLT Table 1), ticdata.treasury.gov, retrieved <date>." Public domain (17 U.S.C. 105).
@@ -1,226 +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
- }
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
+ }