所有 API

政府债券收益率曲线 API 总览

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

获取免费 API 密钥
阅读文档 →
在线100.00% uptime, last 30天324 ms 典型响应

首次请求

Get the United Kingdom收益率曲线

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

Get the United States收益率曲线

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

Get the Germany收益率曲线

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

Get the Japan收益率曲线

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

Get the Canada收益率曲线

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

Get the Sweden收益率曲线

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

Get the Norway收益率曲线

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

Get the Australia收益率曲线

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

Get the Euro area收益率曲线

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

获取历史数据

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"

端点

GET国债收益率曲线/v1/economics/{country}/yield-curve

某个国家的一条观测值：最新值，或你指定的数据源日期的值。

参数

  • country必填

    三位字母代码：USA、GBR、DEU、JPN、CAN、SWE、NOR、AUS、EMU。

  • date可选

    省略时返回最新的已收录观测值。传入该参数时，选取对应的确切期间；无数据的期间返回 404。

  • version_id可选

    可选的不可变发布版本。省略时读取当前已收录的曲线。

  • 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。

响应字段

  • countryISO alpha-3 字符串

    所请求的国家或地区。

  • curve_type"nominal_par" | "nominal_zero_coupon" | "spot_svensson" | "constant_maturity_ytm" | "zero_coupon" | "constant_maturity_benchmark" | "spot_svensson_aaa"

    美国：名义平价收益率（美国财政部）。英国：连续复利名义零息收益率（英国央行，即英格兰银行）。德国：Svensson 即期收益率（德国联邦银行）。日本：固定期限日本国债到期收益率（日本财务省）。加拿大：零息（贴现）收益率（加拿大央行）。瑞典：政府票据和债券基准收益率（瑞典央行）。挪威：政府证券零息收益率（挪威央行）。澳大利亚：政府债券到期收益率（澳大利亚储备银行）。欧元区：AAA 评级政府债券即期利率（欧洲央行）。

  • dateYYYY-MM-DD 字符串

    这条曲线上所有数据点共用的来源日期。

  • yields数组

    可用的期限，按从短到长排序。即使只有一个期限，也仍以数组返回。

  • yields[].maturity字符串

    支持的期限标签之一。

  • yields[].tenor字符串

    tenor 是以标准期限表示的到期时间，因此无论数据源写作 6m 还是 0.5y，六个月在每个国家都是 P6M。

  • yields[].yield_percent十进制字符串

    收益率，以百分比表示，保留来源数据的小数精度。

完整参考文档 →
GET国债收益率曲线历史数据/v1/economics/{country}/yield-curve/history

区间内的每条观察值，从旧到新排序，每页最多 1,000 条。沿着 next_cursor 继续读取，直到它为 null。

参数

  • country必填

    三位字母代码：USA、GBR、DEU、JPN、CAN、SWE、NOR、AUS、EMU。

  • start可选

    包含下界。省略时从第一个可用期间开始。

  • end可选

    包含上界，不能早于 start。省略时到最后一个可用期间为止。

  • limit可选

    默认值 100。按日期或年份计数，而不是按单个收益率数据点计数。

  • cursor可选

    请原样传入 next_cursor，并保持国家、筛选条件和 limit 不变。游标在 24 小时后过期。

  • as_of可选

    返回截至该 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。

响应字段

  • countryISO 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[].dateYYYY-MM-DD 字符串

    这条曲线上所有数据点共用的来源日期。

  • observations[].yields数组

    可用的期限，按从短到长排序。即使只有一个期限，也仍以数组返回。

  • observations[].yields[].maturity字符串

    支持的期限标签之一。

  • observations[].yields[].tenor字符串

    tenor 是以标准期限表示的到期时间，因此无论数据源写作 6m 还是 0.5y，六个月在每个国家都是 P6M。

  • observations[].yields[].yield_percent十进制字符串

    收益率，以百分比表示，保留来源数据的小数精度。

  • next_cursor字符串或 null

    不透明的续页令牌；null 表示没有下一页。

完整参考文档 →

使用场景

如何检查收益率曲线倒挂

比较两个收益率，用基点读出利差。

阅读指南 →

计算实际利率

用费雪公式从名义收益率中扣除通胀。

阅读指南 →

回填历史数据

分页下载整个序列，中断后可继续。

阅读指南 →

覆盖范围

  • 美国名义平价收益率。自 1990 年 1 月 2 日起每日发布。
  • 英国连续复利名义零息收益率。自 1979 年 1 月 2 日起每日发布。
  • 德国Svensson 即期收益率。自 1997 年 8 月 7 日起每日发布。
  • 日本固定期限日本国债到期收益率。自 1974 年起每日发布。
  • 加拿大零息（贴现）收益率。自 1986 年 1 月 2 日起每日发布。
  • 瑞典政府短期债券和债券基准收益率。自 1983 年 1 月 3 日起每日发布。
  • 挪威政府证券零息收益率。自 2015 年 1 月 2 日起每日发布。
  • 澳大利亚政府债券到期收益率。自 2013 年 5 月 20 日起每日发布。
  • 欧元区AAA 评级政府债券即期利率。自 2004 年 9 月 6 日起每日发布。

来源

Japan's yield data is reused under Public Data License 1.0. Narwhal formats the source data for the API. This version was not created by the Ministry of Finance, Japan. Source licence

Source: Sveriges Riksbank. The data date is shown alongside the data. Narwhal has no official collaboration or partnership with the Riksbank.

Source: Norges Bank. Values are shown as published.

Source Reserve Bank of Australia 2026. The RBA publishes this data free of charge at rba.gov.au and does not endorse Narwhal.

Source: ECB. The ECB publishes this data free of charge at ecb.europa.eu, and values are shown as published.

相关 API

经济数据 API

价格、劳动力、产出、贸易和利率的官方指标。

探索 API →

经济发布日历

发布日程、状态和发布版本。

探索 API →

常见问题

数据多久更新一次？

美国财政部的曲线随其每日发布更新。英国央行力争在下一个工作日伦敦时间正午前发布。德国联邦银行每日发布曲线。日本财务省在下一个工作日日本时间 09:30 发布。加拿大央行大约每周发布一次曲线，发布时间约在观测日期之后 2 至 3 周，因此最新的曲线通常已有 2 至 3 周的时滞。瑞典央行每个工作日发布。挪威央行每个工作日发布。澳大利亚储备银行在工作日发布 F2 表，通常在两天内。欧洲央行在下一个工作日发布曲线。周末和节假日可能没有新曲线。来源数据可能被修订。检查来源并不保证会有新的观测值。

值缺失时会怎样？

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

为什么各国的收益率曲线不同？

曲线指标因国家而异。请为每个值保留来源、曲线类型和期限。

一个国家会提供第二条曲线吗？

Norway: Use curve_type=constant_maturity_benchmark for Norges Bank generic rates: Treasury bills at 3, 6 and 12 months and government bonds at 3, 5, 7 and 10 years. 历史数据始于2019年1月2日。Australia: Use curve_type=zero_coupon for RBA table F17 zero-coupon yields, from 0.25 to 10 years in quarter-year steps. 历史数据始于2017年1月3日，RBA 在各行日期约1个月后添加相应行。Euro area: Use curve_type=spot_svensson_all_issuers for the ECB curve covering all euro area central government issuers: 3, 6 and 9 months, then 1 to 30 years in yearly steps, with daily history from 6 September 2004.

如何翻页读取历史数据？

请选择包含起止日期的区间。响应按从旧到新排序，每页最多 1,000 个来源日期。使用相同的筛选条件和 limit，沿着 next_cursor 继续读取，直到它为 null。游标保留其发布快照最长 24 小时；快照过期或被撤回时会返回 409，此时请不带游标重新开始。