运行中

美国历史未偿公共债务余额数据API

获取 API Key

首页 API 商店美国历史未偿公共债务余额数据API

💵

数据服务运行中

美国历史未偿公共债务余额数据API

RESTfulJSON查询

特色数据

联系报价

专属数据定制

更高调用配额

优先技术支持

获取免费 API Key 联系我们返回列表

概述

接口能力与数据说明

## 美国历史未偿公共债务余额数据API 该接口提供美国联邦政府自 1789 年至今，每个财政年度末未偿公共债务总额（Total Public Debt Outstanding, TPDO）的历史数据。数据覆盖从 1789 年第一个财政年度到当前年度的完整时间序列，适用于长期债务趋势分析、财政政策历史研究、宏观经济模型构建等场景。本接口为年度汇总数据，反映的是每个财政年度末的债务余额，不同于“精确到美分”数据集（Debt to the Penny）的日度数据。数据以财政年度为时间单位，包含由于财年起止日期历史上发生过的三次变更而导致的特殊年份处理。 ### 📌 状态覆盖美国联邦政府全部历史财政年度，持续维护更新至当前年度。 ### 📥 数据来源数据源自美国财政部（U.S. Department of the Treasury）官方财务系统，由财政服务局汇总发布。 ### 📆 覆盖时间范围 - 起始年份：1789 年（美国第一个财政年度） - 结束年份：当前最近一个完整财政年度 - 数据频率：按财政年度汇总（每年一条记录），遇到财年变更年份时会有特殊处理（如 1843 年有两条记录、1977 年只有一条记录） - 数据会在每年财政年度结束后更新，加入前一个财政年度的最终债务余额。 ### ⭐ 核心功能 - 全历史债务数据：获取自美国建国以来每个财政年度末的未偿公共债务总额，时间跨度超过 230 年。 - 财政年度灵活定义：接口自动处理美国财政部财年起止日期的历史变化（详见下方“数据覆盖时间范围”章节）。 - 灵活筛选与排序：支持按日期范围、年份等进行条件筛选和数据排序。 ### 🎯 适用场景 - 长期财政历史研究（追踪美国债务规模跨越两个多世纪的变化） - 宏观经济模型中的政府债务变量构建 - 学术研究与教育演示（展示美国建国以来的债务演变趋势） - 债务占 GDP 比率计算（需搭配历史 GDP 数据） - 财政政策效果的历史回顾分析 *** ### 错误码说明 | 错误码 | 返回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）与“债务精确到美分”（Debt to the Penny）数据集中的同一指标定义一致，均包含联邦融资银行（Federal Financing Bank, FFB）发行的债务。但本数据集不包含公共持有债务（Debt Held by the Public）和内部政府持有债务（Intragovernmental Holdings）的分项数据，仅提供总额。 - 在使用本数据时，请务必留意财政年度的历史定义变化，尤其是在进行跨时期比较或时间序列分析时。建议使用 record_calendar_year 字段做日历年筛选，或使用 record_fiscal_year 字段做财政年筛选，但需明确筛选年份的含义。 ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/6/3 | 初始版本发布 |

请求参数

调用接口所需的查询参数

暂无请求参数数据

数据字段

返回结果中的字段定义

暂无数据字段

查看样本数据

注册账号后可免费调用并查看样本数据，确认数据质量后再决定采购。

免费注册查看样本

代码示例

Python / R / Stata 调用示例

python

import requests

url = "https://api.cnopendata.com/v1/..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {}

resp = requests.get(url, headers=headers, params=params)
data = resp.json()
print(data)

立即获取 API Key，开始使用

注册即可获得免费配额，无需信用卡

免费注册

错误码

接口返回的状态码说明

错误码	Message	含义
`0`	`success`	请求成功
`400`	`PARAM_ERROR`	请求参数不合法
`401`	`UNAUTHORIZED`	未授权，请检查 API Key
`403`	`NO_PERMISSION`	权限不足
`404`	`NOT_FOUND`	资源不存在
`429`	`RATE_LIMIT`	请求频率超限
`500`	`INTERNAL_ERROR`	服务内部异常

加载中...

美国历史未偿公共债务余额数据API

该接口提供美国联邦政府自 1789 年至今，每个财政年度末未偿公共债务总额（Total Public Debt Outstanding, TPDO）的历史数据。数据覆盖从 1789 年第一个财政年度到当前年度的完整时间序列，适用于长期债务趋势分析、财政政策历史研究、宏观经济模型构建等场景。

本接口为年度汇总数据，反映的是每个财政年度末的债务余额，不同于“精确到美分”数据集（Debt to the Penny）的日度数据。数据以财政年度为时间单位，包含由于财年起止日期历史上发生过的三次变更而导致的特殊年份处理。

📌 状态

覆盖美国联邦政府全部历史财政年度，持续维护更新至当前年度。

📥 数据来源

数据源自美国财政部（U.S. Department of the Treasury）官方财务系统，由财政服务局汇总发布。

📆 覆盖时间范围

起始年份：1789 年（美国第一个财政年度）
结束年份：当前最近一个完整财政年度
数据频率：按财政年度汇总（每年一条记录），遇到财年变更年份时会有特殊处理（如 1843 年有两条记录、1977 年只有一条记录）
数据会在每年财政年度结束后更新，加入前一个财政年度的最终债务余额。

⭐ 核心功能

全历史债务数据：获取自美国建国以来每个财政年度末的未偿公共债务总额，时间跨度超过 230 年。
财政年度灵活定义：接口自动处理美国财政部财年起止日期的历史变化（详见下方“数据覆盖时间范围”章节）。
灵活筛选与排序：支持按日期范围、年份等进行条件筛选和数据排序。

🎯 适用场景

长期财政历史研究（追踪美国债务规模跨越两个多世纪的变化）
宏观经济模型中的政府债务变量构建
学术研究与教育演示（展示美国建国以来的债务演变趋势）
债务占 GDP 比率计算（需搭配历史 GDP 数据）
财政政策效果的历史回顾分析

错误码说明

错误码	返回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）与“债务精确到美分”（Debt to the Penny）数据集中的同一指标定义一致，均包含联邦融资银行（Federal Financing Bank, FFB）发行的债务。但本数据集不包含公共持有债务（Debt Held by the Public）和内部政府持有债务（Intragovernmental Holdings）的分项数据，仅提供总额。
在使用本数据时，请务必留意财政年度的历史定义变化，尤其是在进行跨时期比较或时间序列分析时。建议使用 record_calendar_year 字段做日历年筛选，或使用 record_fiscal_year 字段做财政年筛选，但需明确筛选年份的含义。

更新历史

版本	日期	变更说明
v1.0.0	2026/6/3	初始版本发布