所有 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 →

常見問題

資料多久更新一次？

美國財政部的曲線依其每日發布時程更新。英格蘭銀行的目標是在次一營業日 Europe/London 時間中午前發布。德意志聯邦銀行每日發布曲線。日本財務省於次一營業日日本時間 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，此時請不帶游標重新開始。