美国联邦债务月度明细数据API

## 美国联邦债务月度明细数据API 该接口提供美国联邦政府债务的 月度变化 和 财年至今（Fiscal Year-to-Date, FYTD）累计变化 数据，详细记录每个月的 借贷（增加） 和 偿还（减少） 金额。 数据将债务分为 公共持有债务（Debt Held by the Public） 和 内部政府持有债务（Intragovernmental Holdings） 两大类别，并进一步拆分为 本金（Principal）、应计应付利息（Accrued Interest Payable） 和 未摊销溢价/折价净额（Net Unamortized Premiums/Discounts）。所有金额均四舍五入到 百万美元。### 📌 状态 覆盖美国联邦政府全部历史财政年度，持续维护更新至当前年度。 ### 📥 数据来源 数据源自美国财政部（U.S. Department of the Treasury）官方财务系统。 ### 📆 覆盖时间范围 - 起始年份：2005年4月起完整月度数据。 - 数据频率：每月发布一次，反映该月内的债务变动。 ### ⭐ 核心功能 - 月度债务变动：查看任意月份内联邦债务的净增加（借贷）或净减少（偿还）金额。 - 财年至今累计变动：获取从财年开始至某月的债务累计变动额。 - 债务分类明细：区分公共持有债务和内部政府持有债务。 - 结构拆解：提供本金、利息、溢价/折价三个维度的变动明细。 ### 🎯 适用场景 - 追踪美国财政部每月借贷行为。 - 分析债务结构的月度变化（本金 vs. 利息 vs. 折溢价）。 - 评估财年至今的财政融资进度。 - 构建高频债务流量模型。 *** ### 错误码说明 | 错误码 | 返回message | 含义 | | ---- | ---- | ---- | | 0 | success | 成功 | | 40001 | Missing valid token in request | 请求中缺少Token | | 40002 | Invalid token | Token无效 | | 50001 | Too Many Requests: API call frequency limit exceeded | 请求过多：超出 API 调用频率限制 | | 50002 | Unknown error | 未知错误 | ### 注意事项 1. 单位说明：所有数值字段均以百万美元为单位，数值已四舍五入。因此在使用时建议将返回数值乘以 1,000,000 以获得精确的美元金额。 3. 与 debt_to_penny 的区别：debt_to_penny 数据集包含 TPDO 及其分项，且内部政府持有债务包含 FFB 债务。本数据集提供更详细的债务结构明细（如本金、利息和溢价/折价的拆解），但不汇总 TPDO。 4. 该端点返回的是 变动量（即当月比上月末增加或减少的金额），而非月末余额。如果返回记录中 change_category 或其他标识区分了“月度变动”和“财年至今变动”，请参考实际字段。 6. 数据滞后：数据更新可能存在 1–2 个工作日的滞后。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/6/3 | 初始版本发布 |