用途:通过美国财政部 Fiscal Data API 查询联邦财务数据,包括国债、政府支出与收入、利率、汇率、国债拍卖和储蓄债券等。
主要能力:API 完全免费开放,无需 API key 或注册。基础地址为 https://api.fiscaldata.treasury.gov/services/api/fiscal_service。支持指定字段、过滤、排序、输出格式与分页,过滤操作符包括 lt、lte、gt、gte、eq、in。数据覆盖国债(如 /v2/accounting/od/debt_to_penny 每日更新)、每日与每月报表、利率与汇率(如 /v1/accounting/od/rates_of_exchange)、证券拍卖与储蓄债券等。可通过参数省略分组字段触发自动汇总。
使用方式:用 requests 等 HTTP 客户端发起 GET 请求,例如获取最新国债:
import requests
BASE_URL = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service" resp = requests.get(f"{BASE_URL}/v2/accounting/od/debt_to_penny", params={ "sort": "-record_date", "page[size]": 1 }) print(resp.json()["data"][0])
响应包含 data、meta(总数、分页、字段标签与类型)和 links。所有值均以字符串返回,需要自行用 float() 或 pandas 转换,空值表现为字符串 "null"。
适用场景:查询与可视化美国联邦债务、财政收支、利率和汇率趋势,或构建数据分析脚本。
限制:API 无需认证;数据更新频率因数据集而异(每日、每月、每季度等);分页默认每页 100 条,具体上限与错误处理细节需参考官方文档;资料未提供更详细的收费、平台或效果信息。