usfiscaldata · 查询美国财政公开数据

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

编辑构造材料（未运行）：
数据集 Debt to the Penny；日期 2026-01-01 到 2026-01-31；只取 record_date 与 tot_pub_debt_out_amt，每页 100 行。

输出

编辑示例 · 未运行

import requests

url = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny"
response = requests.get(url, params={
    "fields": "record_date,tot_pub_debt_out_amt",
    "filter": "record_date:gte:2026-01-01,record_date:lte:2026-01-31",
    "sort": "record_date",
    "page[size]": 100,
    "page[number]": 1,
}, timeout=30)
response.raise_for_status()
payload = response.json()
print(payload["data"])
print(payload["meta"]["total-pages"])

这是查询代码，未请求实际债务数字。

用 Treasury Fiscal Data API 读取债务、收支和汇率等数据，核对分页与字段口径。

具体任务

构造指定区间的财政债务查询：用 Treasury Fiscal Data API 读取债务、收支和汇率等数据，核对分页与字段口径。

必需材料

所需数据集及指标定义

日期范围和返回格式

可选材料

需要保留的字段

分页上限与已有响应

使用门槛

能够读 JSON/表格，知道日期、币种与统计口径；API 无需 key。

这个 Skill 额外提供的方法

先核对 endpoint Quick Guide，再选 fields/filter/sort；按 meta.total-pages 和 links.next 判定是否完整。

编辑示例（未运行）

构造指定区间的财政债务查询

任务：构造指定区间的财政债务查询

输入：
编辑构造材料（未运行）：
数据集 Debt to the Penny；日期 2026-01-01 到 2026-01-31；只取 record_date 与 tot_pub_debt_out_amt，每页 100 行。

结果片段：
```python
import requests

url = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v2/accounting/od/debt_to_penny"
response = requests.get(url, params={
    "fields": "record_date,tot_pub_debt_out_amt",
    "filter": "record_date:gte:2026-01-01,record_date:lte:2026-01-31",
    "sort": "record_date",
    "page[size]": 100,
    "page[number]": 1,
}, timeout=30)
response.raise_for_status()
payload = response.json()
print(payload["data"])
print(payload["meta"]["total-pages"])
```
这是查询代码，未请求实际债务数字。

这是依据固定入口方法撰写的编辑示例，没有运行上游 Skill 或访问真实账号。先核对 endpoint Quick Guide，再选 fields/filter/sort；按 meta.total-pages 和 links.next 判定是否完整。

首次任务

请使用已安装的 usfiscaldata Skill。
任务：构造指定区间的财政债务查询。

我的必需材料：
- 所需数据集及指标定义：[粘贴我的实际材料或路径；缺少时写明]
- 日期范围和返回格式：[粘贴我的实际材料或路径；缺少时写明]

可选补充：
- 需要保留的字段：[可选，未提供时不要假定存在]
- 分页上限与已有响应：[可选，未提供时不要假定存在]

请先确认材料是否足够，只处理我提供的范围。只读取官方公开统计，不把财政汇率当实时交易报价；字段单位与修订频率必须从数据集元数据确认。交付可直接审阅的代码或查询片段，明确尚未执行或验证的部分。不要代入页面例子的虚构数据。
验收：
1. 接口路径及字段来自目标数据集当前说明。
2. 检查总页数，未取完时明确标为部分数据。
3. 数值字符串、字符串 null 与单位在计算前正确处理。

验收方法

接口路径及字段来自目标数据集当前说明。

检查总页数，未取完时明确标为部分数据。

数值字符串、字符串 null 与单位在计算前正确处理。

依赖与准备

需要完整 Skill 目录，保留 references/datasets-fiscal.md、references/parameters.md、references/api-basics.md、references/datasets-debt.md 等引用。网络访问 Treasury Fiscal Data API；Python 示例需 requests，分析可选 pandas；保留 parameters 与 response-format 参考，分页从 1 开始。

使用边界

只读取官方公开统计，不把财政汇率当实时交易报价；字段单位与修订频率必须从数据集元数据确认。

财政报表数据不等于实时市场行情，不据单一序列提供投资结论。

页面中的例子为编辑撰写，未运行上游 Skill；不代表平台兼容认证或生产实测。

排错

取回数字无法计算：先处理字符串 null 并按 meta.dataTypes 转型，金额优先使用精确数值。

只有一页却宣称全量：核对 meta.total-pages 与 links.next，按有界分页继续。

固定来源

https://github.com/K-Dense-AI/scientific-agent-skills/blob/65d6e786832e2c52832713117bbbf5096b56f77f/skills/usfiscaldata/SKILL.md

许可

MIT。许可原文：https://github.com/K-Dense-AI/scientific-agent-skills/blob/65d6e786832e2c52832713117bbbf5096b56f77f/LICENSE.md

仓库热度

K-Dense-AI/scientific-agent-skills 仓库 47,152 Stars（2026-09-30 核验）；这是父仓库指标，不是单个 Skill 的评分。

先看看示例

输入

输出

方法说明