用途:通过美国财政部免费的 Fiscal Data REST API 查询联邦财政数据,无需 API 密钥或注册。基础地址为 https://api.fiscaldata.treasury.gov/services/api/fiscal_service,端点路径可能变化,应以各数据集的 API Quick Guide 为准。
主要能力与数据集:国债类包括 Debt to the Penny(/v2/accounting/od/debt_to_penny,逐日)、Historical Debt Outstanding、Schedules of Federal Debt;每日与月度报表包括 DTS Operating Cash Balance、DTS Deposits & Withdrawals、Monthly Treasury Statement;利率与汇率包括 Treasury 证券平均利率、Treasury Reporting Rates of Exchange、公债利息支出;证券与拍卖包括拍卖数据、即将拍卖、回购;储蓄债券包括 I Bonds 利率、债券发行赎回与到期。
使用方式:安装依赖 uv pip install requests pandas。请求支持 fields、filter、sort、format(json/csv/xml)、page[size]、page[number] 等参数,过滤运算符有 lt、lte、gt、gte、eq、in,多个条件用逗号分隔。响应包含 data、meta(count、total-count、total-pages、labels、dataTypes)与 links 分页信息。
限制与注意:数据行值以字符串返回,null 显示为字符串 "null",需要自行转换;分页时小结果集可用 page[size]=10000 单次请求,多页需自行实现遍历。选择较少字段可能触发自动聚合,可能误加不应相加的余额或利率,应先查看完整行粒度。DTS 金额单位为百万,自 2022 年 4 月 18 日起 TGA 期末余额读 open_today_bal,close_today_bal 为空;MTS 各表金额字段与行层级不同,紧凑月度汇总用 mil_amt;利息支出用 month_expense_amt 与 fytd_expense_amt,FYTD 不可跨月相加;拍卖用 auction_date 表示事件时间,record_date 为发布日期;I Bond 利率需 issue_year_month 与 earning period。汇率是每美元外币单位,除以汇率得美元,属政府报告汇率而非实时交易报价,需保留 record_date 与 effective_date 并检查修订。具体各数据集字段含义和更多代码示例请查阅附带的参考文件。