所有 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 表示沒有下一頁。