用途:通过美国财政部开放的 Fiscal Data REST API 获取联邦财务数据,免费且无需注册或 API 密钥。基础地址为 https://api.fiscaldata.treasury.gov/services/api/fiscal_service,可通过数据集搜索浏览 54 个数据集和 179 张数据表;端点路径会随时间变化,使用前应在各数据集的 API Quick Guide 上核对。
主要能力:覆盖国债(Debt to the Penny 每日、Historical Debt Outstanding 年度、Schedules of Federal Debt 月度)、每日与月度报表(DTS 运营现金余额、DTS 存取款、Monthly Treasury Statement)、利率与汇率(国债平均利率、财政部汇率、公债利息支出)、证券与拍卖(国债拍卖、即将拍卖、回购)、储蓄债券(I Bonds 利率、发行赎回与到期)等。
使用方式:安装 uv pip install requests pandas,随后用 requests 请求端点,可用 fields、filter、sort、format、page[size]、page[number] 等参数;筛选运算符包括 lt、lte、gt、gte、eq、in,多个筛选以逗号分隔。响应为 JSON,含 data、meta(count、total-count、total-pages、labels、dataTypes、dataFormats)与 links;所有值均以字符串返回,需自行转换(如 float()、pd.to_datetime()),空值表现为字符串 "null"。多页结果需使用分页助手 fetch_all();省略分组字段会触发自动聚合。还可参考 api-basics.md、parameters.md、datasets-*.md、response-format.md、examples.md 等文件。
适用场景:需要以编程方式获取美国联邦债务、财政收支、利率汇率、国债拍卖与储蓄债券数据,并加载进 pandas 进行分析的研究、报告与数据管道。
限制:本文档未说明速率限制、配额或付费方案;端点路径可能变更,需以官方 Quick Guide 为准;多页结果不能仅靠单次请求获取;返回均为字符串,需自行做类型转换。其他细节暂未提供。