2026 年 10 月 24 日,針對 2026 年 10 月 28 日的聯準會會議,預測市場給出的降息機率為 0.7%,維持不變為 91.9%,升息為 7.5%。向政策路徑發送一次請求,即可傳回之後每次會議的降息、維持不變與升息機率,以及以基點表示的預期變動。
用 API 讀取政策路徑
使用 GET /v1/predictions/policy-paths/federal-reserve 可一次讀取各次會議的機率。回應包含 as_of 時間戳記和 meetings[] 清單。每次會議都帶有事件識別碼、決策日期、機率與預期變動,因此同一個請求既能取得各次會議的資料,也能取得累計路徑。
輸出以這組機率的時間戳記開頭。之後每一行對應一次會議,行首是會議日期。請把會議日期與 as_of 區分開:前者標明你所讀機率對應的會議,後者標明這組回傳值的時間。
- 取得你的 API 金鑰 建立一把免費金鑰,並將其存放在名為
NARWHAL_API_KEY的環境變數中。Narwhal 的各資料 API 共用一個帳戶和一把 API 金鑰,REST 與 MCP 也共用該金鑰。腳本在建立請求標頭時會讀取這個變數,因此請求路徑之前先把金鑰放進去。 - 請求政策路徑 用 Python 腳本在
Authorization: Bearer YOUR_KEY請求標頭中發送金鑰。它會先印出回應時間戳記,再印出每次會議的日期,以及降息、維持不變與升息機率、預期變動和累計變動。import os import requests path = requests.get( "https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve", headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}, timeout=10, ).json() print("as of", path["as_of"]) for m in path["meetings"]: print( m["resolves_at"][:10], f"cut {float(m['p_cut']):.1%} hold {float(m['p_hold']):.1%} " f"hike {float(m['p_hike']):.1%}", f" expected {m['expected_change_bps']} bp, " f"cumulative {m['cumulative_change_bps']} bp", ) - 逐次讀取每次會議 將
p_cut視為降息機率,p_hold視為維持不變的機率,p_hike視為升息機率。腳本會把這些機率顯示為保留一位小數的百分比。日期取自resolves_at。 - 把時間戳記與機率一起保存 將
as_of與會議數值一起帶入您的模型或儀表板。如果還想透過/v1/predictions/scalar/{event_id}取得該會議各具體結果的幅度,請保留event_id。
不寫程式或在試算表中查看機率
開啟聯準會利率決策機率,無需發送 API 請求即可查看機率。想直接查看聯準會機率時使用這個頁面;若要把這些值放進模型或儀表板,則使用政策路徑端點。
在試算表中貼上降息、維持不變與升息的機率,並用 =SUM 加總。未經四捨五入的值之和為 1。如果貼上的是為顯示而四捨五入的百分比,合計可能與此略有出入。請把日期與貼上的數字放在一起,讓試算表能說明它包含的是哪一組機率。
各種情況適合的方式
| 情況 | 最適合的方式 | 原因 |
|---|---|---|
| 直接查看機率 | 聯準會利率決策機率頁面 | 不用程式碼查看聯準會機率 |
| 模型或儀表板 | 政策路徑端點 | 一併讀取各次會議的機率與預期變動 |
| 特定的變動幅度,例如 25 或 50 bp | 該次會議的純量事件 | 透過 event_id 讀取具體結果 |
政策路徑把每次會議的降息、維持不變與升息機率歸在一起。若要查看某個具體變動幅度,請將該次會議的 event_id 用於 /v1/predictions/scalar/{event_id}。對同一次會議而言,歸在一起的機率與具體變動幅度回答的是不同的問題。
累計變動是什麼意思?
累計值是依會議順序逐次相加的預期變動之和。每個 expected_change_bps 是各結果變動幅度(以基點計)依機率加權的平均值。cumulative_change_bps 欄位給出截至你所讀會議的這一合計。
以 2026 年 10 月 24 日的數據為例,預期變動在 2026 年 10 月 28 日為 +1.7 bp,2026 年 12 月 9 日為 +19.7 bp,2027 年 1 月 27 日為 +7.4 bp。累計值依序為 +1.7 bp、+21.4 bp 和 +28.8 bp。1 月的累計值可理解為這幾次會議合計的預期淨變動。
2026 年 10 月 24 日,2027 年 1 月 27 日的會議降息機率為 1.8%,維持不變為 67.4%,升息為 30.8%。該次會議維持不變的機率最大,但預期變動為正值。預期變動已計入各結果的幅度與機率;而維持不變的機率只描述該次會議不變動的可能性。
三個機率之和是否等於 1?
是的,未經四捨五入的機率之和為 1,而顯示出來的百分比可能有捨入誤差。2026 年 10 月 24 日,2026 年 10 月 28 日的會議降息機率為 0.7%,維持不變為 91.9%,升息為 7.5%。由於每個值都保留一位小數,這些數值相加為 100.1%。
還能讀取哪些其他央行?
政策路徑還支援歐洲央行、英格蘭銀行、日本銀行、加拿大央行、澳洲準備銀行和印尼央行。把政策路徑中的 federal-reserve 換成你要讀取的銀行對應的機構名稱即可。
歐洲央行使用 european-central-bank,英格蘭銀行使用 bank-of-england,日本銀行使用 bank-of-japan。其餘的機構名稱為 bank-of-canada、reserve-bank-of-australia 和 bank-indonesia。
計算範例:讀取 2026 年 12 月 9 日的會議
數據截至 2026 年 10 月 24 日。回應時間戳記為 2026-10-24T00:00:00Z。對於 2026 年 12 月 9 日的會議,先讀機率,再讀該次會議的預期變動。77.3% 的升息機率表示升息的可能性。+19.7 bp 的預期變動是各結果幅度依機率加權的平均值。若要查看 25 或 50 bp 的具體升息幅度,請將該次會議的 event_id 用於其純量事件。
| 欄位 | 數值 |
|---|---|
| 降息機率 | 1.2% |
| 維持不變機率 | 21.5% |
| 升息機率 | 77.3% |
| 四捨五入後的機率合計 | 100.0% |
| 預期變動 | +19.7 bp |
| 累計變動 | +21.4 bp |
把顯示的機率相加:1.2% + 21.5% + 77.3% = 100.0%。要得到累計變動,把 2026 年 10 月 28 日的預期變動 +1.7 bp 與 2026 年 12 月 9 日的預期變動 +19.7 bp 相加,結果是截至 12 月會議的 +21.4 bp。
發布於 。