殖利率曲線 API 參考文件

透過 REST 和 MCP 取得9個國家與地區的公債殖利率曲線。讀取單一來源日期的資料或分頁歷史資料，數值以十進位百分比字串表示。

請求

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

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"

美國請求

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"

德國請求

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"

日本請求

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"

加拿大請求

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"

瑞典請求

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"

挪威請求

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"

澳大利亞請求

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"

歐元區請求

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"

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

參數

名稱	類型	必填	含義
`country`	路徑·ISO alpha-3	是	支援的國家代碼:USA、GBR、DEU、JPN、CAN、SWE、NOR、AUS、EMU。美國:名目平價殖利率(美國財政部)。英國:連續複利名目零息殖利率(英格蘭銀行)。德國:Svensson 即期殖利率(德意志聯邦銀行)。日本:固定期限日本公債到期殖利率(日本財務省)。加拿大:零息(貼現)殖利率(加拿大央行)。瑞典:政府票券與公債基準殖利率(瑞典央行)。挪威:政府債券零息殖利率(挪威央行)。澳洲:政府公債到期殖利率(澳洲儲備銀行)。歐元區:AAA 評等政府公債即期利率(歐洲中央銀行)。
`date`	YYYY-MM-DD 字串	否	省略則取最新已收錄的觀測值。指定值會選取該確切期間；沒有資料的期間會回傳 404。
`version_id`	UUID 字串	否	選用的不可變發布版本。省略則讀取目前已收錄的曲線。
`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。

回應

回應範例已儲存的來源範例 · 非即時請求

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

欄位	類型	含義
`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 評等政府公債即期利率(歐洲中央銀行)。
`date`	YYYY-MM-DD 字串	此曲線上所有資料點共用的來源日期。
`yields`	陣列	可用的到期期限，由短到長排列。即使只有一個到期期限，仍為陣列。
`yields[].maturity`	字串	支援的期限標籤之一。
`yields[].tenor`	字串	`tenor` 以標準的期間格式表示到期期限，因此無論來源寫作 6m 還是 0.5y，六個月在每個國家都是 P6M。
`yields[].yield_percent`	十進位數值字串	殖利率（百分比），保留來源的小數精度。

數值保留為十進位字串。不會自行補上來源時間戳記或發布日期。Request IDs, cost and balance are returned in headers.

API 錯誤處理：錯誤碼、額度與重試

狀態	含義
`400`	國家語法、日期、年份、範圍、期限、limit 或游標無效。
`401`	缺少 API 金鑰，或金鑰遭拒。
`404`	沒有任何可用的觀測值符合指定的日期、年份、範圍或所選期限。
`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日起。美國財政部的曲線依其每日發布時程更新。英格蘭銀行的目標是在次一營業日 Europe/London 時間中午前發布。德意志聯邦銀行每日發布曲線。日本財務省於次一營業日日本時間 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 版再利用。Narwhal 將來源資料整理成 API 格式。此版本並非由日本財務省製作。資料來源授權

加拿大: 零息（貼現）殖利率。每日歷史資料自 1986 年 1 月 2 日。到期期限： 0.25年至30年，每0.25年一級；1991年以前最長為25年。

來源: 加拿大央行