檢查殖利率曲線是否倒掛

使用 API

用較長期限的殖利率減去較短期限的殖利率。常用判斷中，順序維持為 10 年期減 2 年期：結果為負，代表 2 年期殖利率較高。Python 腳本還會計算 10 年期減 3 個月期的利差，讓你從同一條曲線讀出兩種比較。

美國曲線包含 1m、1.5m、2m、3m、4m、6m、1y、2y、3y、5y、7y、10y、20y 與 30y 這些期限。請用期限標籤選出計算所需的殖利率。回應中既包含常見倒掛判斷所用的較短期限與較長期限，也包含美國曲線上的其他點。

1. 取得你的 API 金鑰 取得免費金鑰，並存放在環境變數 NARWHAL_API_KEY 中。請求使用 Authorization: Bearer YOUR_KEY，REST 與 MCP 共用同一組金鑰。
2. 取得美國曲線並計算利差 使用 GET /v1/economics/USA/yield-curve 讀取曲線的 date、curve_type 與 yields。腳本讀取每個 maturity 與 yield_percent，然後輸出日期、以基點表示的兩個利差，以及 2 年期與 10 年期殖利率的比較結果。
   Python：10 年期減 2 年期利差

   import os
   import requests
   
   curve = requests.get(
       "https://api.narwhalapi.com/v1/economics/USA/yield-curve",
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   ).json()
   y = {row["maturity"]: float(row["yield_percent"]) for row in curve["yields"]}
   print("curve date", curve["date"])
   print("10y - 2y  =", round((y["10y"] - y["2y"]) * 100), "bp")
   print("10y - 3m  =", round((y["10y"] - y["3m"]) * 100), "bp")
   print("inverted (2y > 10y):", y["2y"] > y["10y"])

3. 結合日期讀取正負號 利差小於零，代表所選的這一組期限已倒掛。請把輸出的曲線日期與結果一起保留，並在描述時寫明所比較的期限。最後一行使用 2y > 10y，這與 10 年期減 2 年期利差為負是同一個條件。
4. 需要選擇日期或期限時 使用 date 選擇某一天，或使用選用的 maturity 篩選條件只回傳一個期限。如果想像指令碼那樣在同一個回應中同時取得兩個殖利率，請不要使用期限篩選條件。美國的回應中 curve_type 為 nominal_par。對於歷史區間，請對所需的每個期限使用歷史端點。所有帳戶都可讀取完整歷史。

使用試算表或不寫程式的方式

Narwhal 的債券殖利率頁面會呈現曲線與利差。開啟經濟數據可進入相應頁面；如果想自己做殖利率相減，也可以使用試算表。複製數值時請連同曲線日期一起保留，使結果對應某個明確的公布日。

把 10 年期殖利率填入 B10，2 年期殖利率填入 B8，數值保持 API 回傳的樣子。用下面的公式相減，結果以百分點為單位；乘以 100 即為以基點表示的利差。把數值移到其他儲存格時，請保持相減的順序。

=B10-B8

各種情況適合的方式

歷史資料使用 GET /v1/economics/USA/yield-curve/history?start=...&end=...&maturity=...，所有帳戶皆可取得完整歷史。

應該用哪個利差來判斷倒掛？

常用的判斷有 10 年期減 2 年期與 10 年期減 3 個月期，兩者可能不一致。由於「曲線倒掛」這個說法沒有指明較短的期限，請在結果旁寫明所用的組合。每種判斷都是把 10 年期殖利率與各自對應的較短期限比較。

2026 年 10 月 23 日，美國 10 年期減 2 年期利差為 +31 bp，10 年期減 3 個月期利差為 +78 bp，兩者均為正。其他國家的期限不同：英國曲線從 0.5y 開始，以半年為間隔，因此請查看所請求國家回傳的期限標籤。

殖利率曲線有多新？

回應中的 date 是最近一個已公布的日期，週末與假日沒有新的曲線。美國範例的日期是 2026 年 10 月 23 日，星期五。為利差加標籤時請使用回應中的日期；你請求資料的那一天可能與曲線的公布日不同。

基點是百分點的百分之一嗎？

是的，一個基點是一個百分點的百分之一。對以百分比表示的殖利率相減，得到的是以百分點為單位的差值。將該差值乘以 100 即為基點，正負號保持不變。2026 年 10 月 23 日，美國 10 年期減 2 年期的差值 0.31 個百分點等於 31 bp。

計算範例：2026 年 10 月 23 日

2026 年 10 月 23 日，美國曲線上 10 年期殖利率為 5.00%，2 年期為 4.69%，3 個月期為 4.22%。兩次相減都從 10 年期殖利率出發。常用判斷使用 2 年期殖利率，另一種常見比較則用 3 個月期殖利率重複一遍。

對於 2026 年 10 月 23 日，用 5.00% 減去 4.69% 得到 0.31 個百分點。將 0.31 乘以 100 得到 31 bp。正號表示 10 年期殖利率高於 2 年期殖利率，因此這一組合沒有倒掛。同一天，用 5.00% 減去 4.22% 得到 0.78 個百分點，再乘以 100，即得到 10 年期減 3 個月期的利差為 78 bp。

2026 年 10 月 23 日，美國 20 年期殖利率為 5.37%，30 年期為 5.33%。這些期限同樣包含在回傳的曲線中。這裡的計算使用 10 年期殖利率，分別搭配 2 年期與 3 個月期殖利率，進行常見的倒掛判斷。