所有 API

利率 API 总览

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

在线99.94% uptime, last 30天378 ms 典型响应

首次请求

获取收益率曲线

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国债收益率曲线/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 表示没有下一页。