REST 接口 · 文档目录

宏观经济 国债收益率 · REST 接口

美国国债收益率。获取 1 个月至 30 年各标准期限的历史收益率数据,日频历史可追溯至 1962 年。支持按日期或日期区间查询,每个数据点对应特定期限国债的市场收益率,便于观察长短期利率变化。

GET /fed/v1/treasury-yields
上游时效说明

每日更新

上游历史范围

数据可追溯至 1962 年 1 月 2 日

适用场景

  • 绘制利率走势、对比短期与长期收益率、经济研究。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
datestringNo收益率观测的日历日期(YYYY-MM-DD)。
date.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
date.gtstringNo筛选大于该值。
date.gtestringNo筛选大于或等于该值。
date.ltstringNo筛选小于该值。
date.ltestringNo筛选小于或等于该值。
limitintegerNo限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 50000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 date,排序方向默认为 asc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].datestring收益率观测的日历日期(YYYY-MM-DD)。
results[].yield_10_yearnumber美国国债 10 年期固定期限市场收益率(按投资基准报价)。
results[].yield_1_monthnumber美国国债 1 个月期固定期限市场收益率(按投资基准报价)。
results[].yield_1_yearnumber美国国债 1 年期固定期限市场收益率(按投资基准报价)。
results[].yield_20_yearnumber美国国债 20 年期固定期限市场收益率(按投资基准报价)。
results[].yield_2_yearnumber美国国债 2 年期固定期限市场收益率(按投资基准报价)。
results[].yield_30_yearnumber美国国债 30 年期固定期限市场收益率(按投资基准报价)。
results[].yield_3_monthnumber美国国债 3 个月期固定期限市场收益率(按投资基准报价)。
results[].yield_3_yearnumber美国国债 3 年期固定期限市场收益率(按投资基准报价)。
results[].yield_5_yearnumber美国国债 5 年期固定期限市场收益率(按投资基准报价)。
results[].yield_6_monthnumber美国国债 6 个月期固定期限市场收益率(按投资基准报价)。
results[].yield_7_yearnumber美国国债 7 年期固定期限市场收益率(按投资基准报价)。
statusenum: 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 文档 ↗