宏观经济 国债收益率 · REST 接口
美国国债收益率。获取 1 个月至 30 年各标准期限的历史收益率数据,日频历史可追溯至 1962 年。支持按日期或日期区间查询,每个数据点对应特定期限国债的市场收益率,便于观察长短期利率变化。
GET /fed/v1/treasury-yields上游时效说明
每日更新
上游历史范围
数据可追溯至 1962 年 1 月 2 日
适用场景
- 绘制利率走势、对比短期与长期收益率、经济研究。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
date | string | No | 收益率观测的日历日期(YYYY-MM-DD)。 |
date.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
date.gt | string | No | 筛选大于该值。 |
date.gte | string | No | 筛选大于或等于该值。 |
date.lt | string | No | 筛选小于该值。 |
date.lte | string | No | 筛选小于或等于该值。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 50000。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 date,排序方向默认为 asc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].date | string | 收益率观测的日历日期(YYYY-MM-DD)。 |
results[].yield_10_year | number | 美国国债 10 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_1_month | number | 美国国债 1 个月期固定期限市场收益率(按投资基准报价)。 |
results[].yield_1_year | number | 美国国债 1 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_20_year | number | 美国国债 20 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_2_year | number | 美国国债 2 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_30_year | number | 美国国债 30 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_3_month | number | 美国国债 3 个月期固定期限市场收益率(按投资基准报价)。 |
results[].yield_3_year | number | 美国国债 3 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_5_year | number | 美国国债 5 年期固定期限市场收益率(按投资基准报价)。 |
results[].yield_6_month | number | 美国国债 6 个月期固定期限市场收益率(按投资基准报价)。 |
results[].yield_7_year | number | 美国国债 7 年期固定期限市场收益率(按投资基准报价)。 |
status | enum: OK | 本次请求响应的状态。 |
响应示例
{
"count": 1,
"request_id": 1,
"results": [
{
"date": "1962-01-02",
"yield_10_year": 4.06,
"yield_1_year": 3.22,
"yield_5_year": 3.88
}
],
"status": "OK"
}原文:Massive 文档 ↗