Treasury Rates美国国债收益率
该接口按自定义起止日期区间返回美国国债全期限收益率曲线（Yield Curve）的每日历史与最新数据。单条记录完整对齐从 1 个月、3 个月、6 个月短端国库券，到 1 年、2 年、5 年、7 年、10 年中端国债，直至 20 年、30 年超长端国债的各期限到期收益率，是全球资产定价的无风险利率基准。
https://quote-fmp.com/stable/treasury-rates数据更新周期
2 Hours
接口说明
- 全市场股票估值模型的无风险利率之锚：10 年期美债收益率被公认为全球风险资产定价的“重力之锚”。通过该接口每日同步最新美债收益率，量化系统可动态更新现金流折现模型中的无风险利率输入，并结合股指盈利收益率实时计算股权风险溢价（ERP）所处历史分位。
- 收益率曲线形态监控与衰退倒挂预警：单条记录横向集齐了从 1 个月到 30 年共 11 个标准关键期限的利率点位。宏观量化团队可直接计算“10 年期减 2 年期”或“10 年期减 3 个月”期限利差序列，实时跟踪收益率曲线陡峭化、平坦化或倒挂加深信号，预判宏观经济周期拐点。
- 利率敏感型板块轮动与久期风格归因：短端利率直接反映美联储联邦基金利率政策预期，长端利率则隐含通胀与长期增长预期。将美债各期限利率的日频变化率作为宏观外生变量纳入行业轮动模型，可精准解释久期较长的纳指科技股与净息差驱动的银行股之间的风格切换。
- 配套投研接口：COT Report（COT 持仓报告） · Market Sector Performance Snapshot（板块表现快照） · S&P 500 Index（标普500成分股） · Commodities Quote（大宗商品报价）
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | date | 可选 | 2026-01-27 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-04-27 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码/stable/treasury-rates 专供美国国债收益率查询（可选 from, to），返回列表含 month1（1 月期）、month2（2 月期）、month3（3 月期）（如 month1=3.73）。
resp = requests.get(
"https://quote-fmp.com/stable/treasury-rates",
params={"from": "2026-01-27", "to": "2026-04-27", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 month1（1 月期）
df["month1"] = pd.to_numeric(df["month1"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按季度日历边界检索 2025Q1 美国国债收益率 | from=2025-01-01&to=2025-03-31 | 以闭区间 [2025-01-01, 2025-03-31] 查询 /stable/treasury-rates，精准过滤出当季的 month1、month2、month3 明细。 |
| 指定 2024 年末半年窗口同步美国国债收益率 | from=2024-07-01&to=2024-12-31 | 切换至 2024 年下半年区间查询 /stable/treasury-rates，与当期数据拼接成连续的 month1、month2、month3 时间序列。 |
/stable/treasury-rates 提供美国国债收益率的 month1（1 月期）与 month2（2 月期）共 13 列；遇到休市日或冷门代码返回空数组时应做跳过容错。
针对 /stable/treasury-rates 输出的 month1（3.73），建表时请用 (date) 作主键约束，并显式处理 null 字段。
返回数据
13 个字段本接口示例响应共包含 13 个字段（数值型 12 个，文本/日期/布尔型 1 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-07-29" | 日期 |
month1 | number | 3.73 | 1 月期 |
month2 | number | 3.83 | 2 月期 |
month3 | number | 3.83 | 3 月期 |
month6 | number | 3.97 | 6 月期 |
year1 | number | 4.04 | 1 年期 |
year2 | number | 4.22 | 2 年期 |
year3 | number | 4.29 | 3 年期 |
year5 | number | 4.37 | 5 年期 |
year7 | number | 4.51 | 7 年期 |
year10 | number | 4.67 | 10 年期 |
year20 | number | 5.21 | 20 年期 |
year30 | number | 5.2 | 30 年期 |
查看响应数据示例（原始 JSON）
[
{
"date": "2026-07-29",
"month1": 3.73,
"month2": 3.83,
"month3": 3.83,
"month6": 3.97,
"year1": 4.04,
"year2": 4.22,
"year3": 4.29,
"year5": 4.37,
"year7": 4.51,
"year10": 4.67,
"year20": 5.21,
"year30": 5.2
}
]常见问题解答（FAQ）
2 个问题对比美国国债收益率与 经济指标数据：/stable/treasury-rates 的调用方式和返回字段有哪些独特之处？
美国国债收益率（/stable/treasury-rates，可选 from, to）聚焦于提供 month1、month2 等 13 个字段；同属「Economics Data」的 Economics Indicators（经济指标数据）则提供 3 个字段。
对接美国国债收益率端点 /stable/treasury-rates 时，大跨度回溯与日常增量刷新分别怎么传参？
对接 美国国债收益率 时可在 /stable/treasury-rates 中传入 from/to 日期区间分批拉取；配合连接池复用与 15～30 秒超时设置，能大幅提升 month1 的同步吞吐率。
同模块相关接口对比
Economics Data本接口路径 /stable/treasury-rates，无必填参数。 同一模块「Economics Data」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。