收益率曲线历史数据 API 参考

通过 REST 和 MCP 获取9个国家和地区的国债收益率曲线。读取单个来源日期的数据或分页历史数据，数值以十进制百分数字符串表示。

请求

GET /v1/economics/{country}/yield-curve/history

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/GBR/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

美国请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

德国请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/DEU/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

日本请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/JPN/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

加拿大请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/CAN/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

瑞典请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/SWE/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

挪威请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/NOR/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

澳大利亚请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/AUS/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

欧元区请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/EMU/yield-curve/history?start=2026-09-09&end=2026-09-10&limit=100&maturity=2y%2C10y" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

REST and MCP use the same Bearer key, response schema and credit balance. MCP tool: economics_get_yield_curve_history。

参数

名称	类型	必填	含义
`country`	路径·ISO alpha-3	是	支持的国家代码：USA、GBR、DEU、JPN、CAN、SWE、NOR、AUS、EMU。美国：名义平价收益率（美国财政部）。英国：连续复利名义零息收益率（英国央行，即英格兰银行）。德国：Svensson 即期收益率（德国联邦银行）。日本：固定期限日本国债到期收益率（日本财务省）。加拿大：零息（贴现）收益率（加拿大央行）。瑞典：政府票据和债券基准收益率（瑞典央行）。挪威：政府证券零息收益率（挪威央行）。澳大利亚：政府债券到期收益率（澳大利亚储备银行）。欧元区：AAA 评级政府债券即期利率（欧洲央行）。
`start`	YYYY-MM-DD 字符串	否	包含下界。省略时从第一个可用期间开始。
`end`	YYYY-MM-DD 字符串	否	包含上界，不能早于 start。省略时到最后一个可用期间为止。
`limit`	整数 · 1–1000	否	默认值 100。按日期或年份计数，而不是按单个收益率数据点计数。
`cursor`	不透明字符串	否	请原样传入 next_cursor，并保持国家、筛选条件和 limit 不变。游标在 24 小时后过期。
`as_of`	YYYY-MM-DD 字符串	否	返回截至该 UTC 日结束时已发布的曲线。
`curve_type`	字符串	否	可选的 curve_type 在两个路由上都用于指定曲线，仅适用于 NOR、AUS 和 EMU，这三个国家各提供两条曲线。省略时返回第一条曲线，响应会在 curve_type 中给出其名称。指定该国不提供的曲线时返回 400 错误。
`maturity`	逗号分隔字符串	否	在两个路由上均为可选。省略时返回完整的可用曲线。USA: 1m, 1.5m, 2m, 3m, 4m, 6m, 1y, 2y, 3y, 5y, 7y, 10y, 20y, 30y. GBR: 0.5y, 1y, 1.5y, 2y, 2.5y, 3y, 3.5y, 4y, 4.5y, 5y, 5.5y, 6y, 6.5y, 7y, 7.5y, 8y, 8.5y, 9y, 9.5y, 10y, 10.5y, 11y, 11.5y, 12y, 12.5y, 13y, 13.5y, 14y, 14.5y, 15y, 15.5y, 16y, 16.5y, 17y, 17.5y, 18y, 18.5y, 19y, 19.5y, 20y, 20.5y, 21y, 21.5y, 22y, 22.5y, 23y, 23.5y, 24y, 24.5y, 25y, 25.5y, 26y, 26.5y, 27y, 27.5y, 28y, 28.5y, 29y, 29.5y, 30y, 30.5y, 31y, 31.5y, 32y, 32.5y, 33y, 33.5y, 34y, 34.5y, 35y, 35.5y, 36y, 36.5y, 37y, 37.5y, 38y, 38.5y, 39y, 39.5y, 40y. DEU: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. JPN: 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 15y, 20y, 25y, 30y, 40y. CAN: 0.25y, 0.5y, 0.75y, 1y, 1.25y, 1.5y, 1.75y, 2y, 2.25y, 2.5y, 2.75y, 3y, 3.25y, 3.5y, 3.75y, 4y, 4.25y, 4.5y, 4.75y, 5y, 5.25y, 5.5y, 5.75y, 6y, 6.25y, 6.5y, 6.75y, 7y, 7.25y, 7.5y, 7.75y, 8y, 8.25y, 8.5y, 8.75y, 9y, 9.25y, 9.5y, 9.75y, 10y, 10.25y, 10.5y, 10.75y, 11y, 11.25y, 11.5y, 11.75y, 12y, 12.25y, 12.5y, 12.75y, 13y, 13.25y, 13.5y, 13.75y, 14y, 14.25y, 14.5y, 14.75y, 15y, 15.25y, 15.5y, 15.75y, 16y, 16.25y, 16.5y, 16.75y, 17y, 17.25y, 17.5y, 17.75y, 18y, 18.25y, 18.5y, 18.75y, 19y, 19.25y, 19.5y, 19.75y, 20y, 20.25y, 20.5y, 20.75y, 21y, 21.25y, 21.5y, 21.75y, 22y, 22.25y, 22.5y, 22.75y, 23y, 23.25y, 23.5y, 23.75y, 24y, 24.25y, 24.5y, 24.75y, 25y, 25.25y, 25.5y, 25.75y, 26y, 26.25y, 26.5y, 26.75y, 27y, 27.25y, 27.5y, 27.75y, 28y, 28.25y, 28.5y, 28.75y, 29y, 29.25y, 29.5y, 29.75y, 30y. SWE: 1m, 3m, 6m, 2y, 5y, 7y, 10y. NOR: 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y. AUS: 2y, 3y, 5y, 10y. EMU: 3m, 6m, 9m, 1y, 2y, 3y, 4y, 5y, 6y, 7y, 8y, 9y, 10y, 11y, 12y, 13y, 14y, 15y, 16y, 17y, 18y, 19y, 20y, 21y, 22y, 23y, 24y, 25y, 26y, 27y, 28y, 29y, 30y. 重复项会被去除，期限按顺序排列。不支持的标签返回 400。

使用游标翻页时，请保持国家、范围、期限选择（如适用）和 limit 不变。分页基于同一份不可变的发布快照。默认 limit 为 100 个期间，最大为 1,000。没有曲线的日期（例如周末），以及没有任何曲线的历史范围，都会返回 404 series_not_found。

响应

响应示例已保存的数据源示例 · 非实时请求

{
  "country": "GBR",
  "curve_type": "nominal_zero_coupon",
  "observations": [
    {
      "date": "2026-09-09",
      "yields": [
        {
          "maturity": "2y",
          "tenor": "P2Y",
          "yield_percent": "4.4821473122101274"
        },
        {
          "maturity": "10y",
          "tenor": "P10Y",
          "yield_percent": "5.2493002729396405"
        }
      ]
    },
    {
      "date": "2026-09-10",
      "yields": [
        {
          "maturity": "2y",
          "tenor": "P2Y",
          "yield_percent": "4.6509003413966044"
        },
        {
          "maturity": "10y",
          "tenor": "P10Y",
          "yield_percent": "5.3572243604351168"
        }
      ]
    }
  ],
  "next_cursor": null
}

字段	类型	含义
`country`	ISO alpha-3 字符串	所请求的国家或地区。
`curve_type`	"nominal_par" \| "nominal_zero_coupon" \| "spot_svensson" \| "constant_maturity_ytm" \| "zero_coupon" \| "constant_maturity_benchmark" \| "spot_svensson_aaa"	美国：名义平价收益率（美国财政部）。英国：连续复利名义零息收益率（英国央行，即英格兰银行）。德国：Svensson 即期收益率（德国联邦银行）。日本：固定期限日本国债到期收益率（日本财务省）。加拿大：零息（贴现）收益率（加拿大央行）。瑞典：政府票据和债券基准收益率（瑞典央行）。挪威：政府证券零息收益率（挪威央行）。澳大利亚：政府债券到期收益率（澳大利亚储备银行）。欧元区：AAA 评级政府债券即期利率（欧洲央行）。
`observations`	数组	按时间从早到晚排序。缺失的期间会被省略；有效但没有数据的范围返回空数组。
`observations[].date`	YYYY-MM-DD 字符串	这条曲线上所有数据点共用的来源日期。
`observations[].yields`	数组	可用的期限，按从短到长排序。即使只有一个期限，也仍以数组返回。
`observations[].yields[].maturity`	字符串	支持的期限标签之一。
`observations[].yields[].tenor`	字符串	`tenor` 以标准的期限格式表示到期期限，因此无论来源写作 6m 还是 0.5y，六个月在每个国家都是 P6M。
`observations[].yields[].yield_percent`	十进制字符串	收益率，以百分比表示，保留来源数据的小数精度。
`next_cursor`	字符串或 null	不透明的续页令牌；null 表示没有下一页。

数值保留为十进制字符串。不会虚构数据源时间戳或发布日期。Request IDs, cost and balance are returned in headers.

API 错误码与额度

状态	含义
`400`	国家格式、日期、年份、范围、期限、limit 或游标无效。
`401`	API 密钥缺失或被拒绝。
`404`	没有可用的观测值与指定的日期、年份、范围或所选期限相匹配。
`409`	发布快照已过期或已被撤回。请不带游标重新开始。
`429`	已达到速率限制。
`503`	已接收的数据无法安全地提供服务。

A successful response costs one call, including an empty history result. Errors cost nothing. 通用错误与响应头 →

覆盖范围与时效性

美国 · USA、英国 · GBR、德国 · DEU、日本 · JPN、加拿大 · CAN、瑞典 · SWE、挪威 · NOR、澳大利亚 · AUS、欧元区 · EMU · 美国：1990年1月2日起 · 英国：1979年1月2日起 · 德国：1997年8月7日起 · 日本：1974年起 · 加拿大：1986年1月2日起 · 瑞典：1983年1月3日起 · 挪威：2015年1月2日起 · 澳大利亚：2013年5月20日起 · 欧元区：2004年9月6日起。美国财政部的曲线随其每日发布更新。英国央行力争在下一个工作日伦敦时间正午前发布。德国联邦银行每日发布曲线。日本财务省在下一个工作日日本时间 09:30 发布。加拿大央行大约每周发布一次曲线，发布时间约在观测日期之后 2 至 3 周，因此最新的曲线通常已有 2 至 3 周的时滞。瑞典央行每个工作日发布。挪威央行每个工作日发布。澳大利亚储备银行在工作日发布 F2 表，通常在两天内。欧洲央行在下一个工作日发布曲线。周末和节假日可能没有新曲线。来源数据可能被修订。检查来源并不保证会有新的观测值。

缺失的期限会被省略。Narwhal 不会补全缺失的来源数据点，不会用较早的曲线替代，也不会编造数值。

美国: 名义平价收益率。每日历史始于 1990 年 1 月 2 日。期限： 1个月至30年。

来源: 美国财政部

英国: 连续复利名义零息收益率。每日历史始于 1979 年 1 月 2 日。期限： 0.5年至40年，每半年一级。

来源: 英格兰银行

德国: Svensson 模型即期收益率。每日历史始于 1997 年 8 月 7 日。期限： 1年至30年，每年一级。

来源: 德国联邦银行

日本: 固定期限日本国债到期收益率。每日历史始于 1974。期限： 1年至10年，另有15年、20年、25年、30年和40年。

来源: 日本财务省

日本的收益率数据依据公共数据许可协议 1.0（Public Data License 1.0）再利用。Narwhal 将来源数据整理为适合 API 的格式。此版本并非由日本财务省制作。数据源许可

加拿大: 零息（贴现）收益率。每日历史始于 1986 年 1 月 2 日。期限： 0.25年至30年，每0.25年一级；1991年以前最长为25年。

来源: 加拿大央行