美国每日国债未偿余额数据API

## 美国每日国债未偿余额数据API 该接口提供美国联邦政府每日未偿公共债务总额（Total Public Debt Outstanding, TPDO）数据，即通常所称的“精确到美分”的国债余额（debt to the penny）。数据包含债务总额，以及公共持有债务（Debt Held by the Public）和内部政府持有债务（Intragovernmental Holdings）的分项明细。数据每日更新，适用于宏观经济分析、债务趋势追踪、财政政策研究等场景。 ### 📌 状态 覆盖美国联邦政府全部公共债务，每日更新（每个工作日更新，反映前一个交易日的债务余额）。 ### 📥 数据来源 数据源自美国财政部（U.S. Department of the Treasury）官方财务系统，由财政服务局汇总发布。 ### 📆 覆盖时间范围 - 公共债务总额：1993 年 1 月 4 日起，每日数据 - 债务分项明细（公共持有债务 + 内部政府持有债务）： - 每日：2005 年 4 月 4 日起 - 月度：2001 年 9 月 30 日 — 2005 年 3 月 31 日 - 年度（财年）：1997 年 9 月 30 日 — 2001 年 9 月 30 日 - 分项数据首次出现之前，该字段显示 0.00 ### ⭐ 核心功能 - 每日国债余额查询：获取任意历史交易日或最新日期的美国国债未偿总额 - 债务结构分解：提供公共持有债务和内部政府持有债务的明细数据 - 灵活查询：支持按日期范围筛选、字段选择、多格式输出 ### 🎯 适用场景 - 宏观经济研究与债务规模追踪 - 金融新闻报道（实时获取最新债务数据） - 投资分析与财政健康状况评估 - 历史走势可视化 *** ### 错误码说明 | 错误码 | 返回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 | 未知错误 | ### 注意事项 - 债务定义：TPDO = 公共持有债务 + 内部政府持有债务。其中，内部政府持有债务包含联邦融资银行（Federal Financing Bank）发行的债务。 - 早期数据中，debt_held_public_amt 和 intragovernmental_hold_amt 字段可能为 0.00，表示该分项数据当时尚未单独统计。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/6/3 | 初始版本发布 |