操作指南

每頁用簡短的回答解決一個問題：營業日、發布時間、通膨計算、大宗商品單位、匯率、賠率與 API 任務，並附上請求與數字。

假日與營業日

國定假日、營業日天數與結算日。

假日與營業日
指南	涵蓋內容
計算兩個日期之間的營業日	使用 Python 或試算表計算兩個日期之間的營業日。計入起訖日期、扣除國定假日，並處理補假日期及地區行事曆。
在日期上加上營業日	使用 Python、Excel 或 Google Sheets 在日期上加上營業日。跳過週末與假日、處理跨年度計算，並依照附有具體日期的感恩節範例操作。
計算 T+1 或 T+2 交割日	使用 Python 或試算表計算 T+1 及 T+2 交割日。跳過週末與相關國家的假日，並參考美股及 USD/JPY 的計算範例。
檢查指定日期是否為國定假日	使用 Narwhal API 或試算表查詢指定日期是否為國定假日。透過 2026 年聖誕節範例，處理地區項目、補假日及適用範圍。
列出多個國家的國定假日	使用 Python 指令碼或行事曆頁面，列出五個國家在 2026 年的國定假日。比較共同日期、處理地區資料列並排除休假日。
在程式碼中加入假日檢查	在 Python 或 JavaScript 中加入有快取的假日檢查、使用試算表公式，並以 2026 年感恩節當週為例處理尚未發布的行事曆。

發布日期與央行

資料與決議何時公布，以及如何收到通知。

發布日期與央行
指南	涵蓋內容
尋找下一次 CPI 發布日期	使用經濟行事曆 API 或國家頁面，查詢美國 CPI 發布日期。查看發布資料的統計月份、預定 UTC 時間及紐約時間。
將發布時間換算為你的時區	使用 Python 或試算表，將經濟數據的 UTC 發布時間換算為當地時間。以 2026 年 11 月的 CPI 發布為例，處理日光節約時間與日期變更。
在經濟數據發布前收到提醒	透過行事曆訂閱源或每天執行一次的 Python 腳本設定經濟數據公布提醒。你會看到美國 CPI 的範例，以及 UTC、紐約時間與雅加達時間對應的提醒時間，方便直接套用。
建立經濟行事曆	依你選擇的國家和日期製作帶有 UTC 發布時間的經濟日曆。可以使用 Python 腳本、網站上的日曆，或在日曆應用程式中訂閱的資料流，取得按時間排序、清晰可讀的發布時程。
查詢 FOMC 會議日期與會議紀錄	使用經濟行事曆 API 查詢排定的 FOMC 利率決策與會議紀錄，使用行事曆訂閱來源，並讀取 UTC、紐約與雅加達的發布時間。
將所有中央銀行會議列於同一份清單	使用 Python 指令碼依日期順序列出中央銀行決策日期，查找不需寫程式的會議指南，並了解何時應使用經濟行事曆取得確切時間。
追蹤中央銀行利率變動	使用 Python 追蹤央行利率變動：讀取政策利率歷史資料、比較單一利率與區間、使用來源日期，並透過 Narwhal API 執行每日檢查。

經濟數據

來自官方統計的通膨、成長與殖利率。

經濟數據
指南	涵蓋內容
CPI 年增率與月增率怎麼計算	CPI 年增率與月增率：說明如何從 API 直接取得現成的通膨率，或用指數水準在 Python 或試算表中自行算出。附美國計算範例，以及月度資料缺漏時的處理建議。
按通膨調整價格	通膨調整價格可以用 CPI 指數、Python 腳本或試算表公式完成。你可以看到 2025 年 11 月的 100 美元到 2026 年 9 月會變成多少，並附有實際計算資料。
比較各國通膨	用 Python 或試算表比較各國通膨率。頁面介紹如何先替已公布的通膨率排序、保留發布日期，並處理各國統計期間不同的情況，最終得到一份可直接用於報告的排名結果。
計算實質利率	根據名目殖利率與通膨率計算實質利率。頁面提供費雪公式、Python API 程式碼、試算表公式和附日期的美國範例，幫助你清楚得到實質利率的算法與結果，並保留相應日期。
檢查殖利率曲線是否倒掛	比較美國公債殖利率，判斷殖利率曲線是否倒掛。頁面提供 Python 程式碼、試算表公式，以及附日期、以基點表示利差的範例，幫助你讀出 10 年期與 2 年期的利差與結果。
GDP 成長率計算：由 GDP 水準求出	GDP 成長率計算：介紹如何以 Python 或試算表，由季度 GDP 水準算出成長率並換算成年化率，同時比較名目成長與美國實質 GDP 成長，並附完整計算範例。
使用 Python 取得世界銀行資料	學習如何用 Narwhal API 在 Python 中取得世界銀行資料：查找指標、讀取年度觀測值、建立 DataFrame，並查看每日擷取上限。
透過 ID 取得加拿大統計局資料表	使用加拿大統計局資料表 ID 尋找資料表、複製向量編號，再透過 Python requests 與 Narwhal API 讀取 CPI 歷史資料或批次取得最新數值。
如何比較各國政策利率	使用 Python 比較各國政策利率、處理單一利率與目標區間，並建立包含幣別、利率工具及來源日期的排序表格。

大宗商品

依您使用的單位與貨幣查看原油、黃金、白銀與銅。

大宗商品
指南	涵蓋內容
油價換算公升與加侖的計算方法	本頁示範油價換算公升的方法：把布蘭特或 WTI 的每桶美元價格，用 Python、試算表公式或大宗商品換算器，換算成每公升、每美制加侖和每英制加侖的價格，一步到位。
用你的貨幣查詢大宗商品價格	介紹如何取得以台幣等本國貨幣計價的黃金價格：黃金可直接用你的幣別取得，其他大宗商品則用匯率換算，並計算每金衡盎司與每公克的印尼盾價格，每一步都附有完整的計算範例。
計算金銀比	用 Python 或試算表計算金銀比。取得以每金衡盎司美元計的金價與銀價，對相同日期或時間的價格進行除法，頁面還提供 Python 腳本、表格公式與附日期的計算範例。
銅價每公斤與每公噸的換算方法	本頁示範銅價每公斤與每公噸的換算：把每磅美元報價換成每公斤和每公噸的價格，並提供 API 程式碼、試算表公式，以及每種換算的計算範例，兩種單位一次完成，每一步都能直接重現。
下載金屬價格歷史 CSV 檔	用 Python 將每日金價歷史下載為 CSV，或直接使用網站上的歷史表格。查看附日期的範例、分頁詳情以及各項歷史的起始時間，也就是每組歷史資料最早從哪一天開始。
設定大宗商品價格提醒	用 Python、Zapier 或 Make 設定排程執行的商品價格警示。將金價與你的門檻值比較並儲存狀態，只在價格穿越門檻值時才發出警示，避免同一則警示反覆出現，也不會漏掉穿越。

匯率

過去日期的匯率、交叉匯率與平均值。

匯率
指南	涵蓋內容
取得過去某一天的匯率	歷史匯率查詢怎麼做？用 Narwhal API 或貨幣頁面取得指定日期的匯率，讀懂回傳的報價，並在試算表裡處理沒有資料的日期與小數值，讓換算結果能對應到具體日期。
交叉匯率計算：如何用兩組貨幣對求出	交叉匯率計算：以 Python 或試算表，由兩個美元報價算出歐元兌印尼盾。了解該用哪個方向做除法、日期如何影響結果，以及直接匯率與計算結果為什麼會不同，並附完整的計算範例。
計算月平均匯率	月平均匯率計算：介紹如何以 Python 或試算表，由每日觀測值求出月平均匯率。附2026年9月 USD/IDR 的計算範例，並說明在會計和發票中使用時需要注意什麼。
查詢發票日期的匯率	介紹如何用 Python 或試算表查詢發票匯率：處理週末、選定幣別方向，並把有日期的歐元發票換算成美元，讓你直接得到可直接使用的結果，並附上完整的計算步驟與範例。

預測市場

賠率、機率與提醒。

預測市場
指南	涵蓋內容
預測市場賠率轉機率的計算方法（含試算表）	示範預測市場賠率轉機率的方法：把預測市場價格與其他賠率格式換算成隱含機率，並用 Python 或試算表去除超額部分（overround），再比較同一問題下的各個結果。
Polymarket Kalshi API 比較：同一問題的報價差距	用同一個聯準會問題做 Polymarket Kalshi API 比較：先讀取兩個平台對該問題的報價，再在腳本或試算表中計算二者之間的差距，並查看各平台的規則與綜合機率，一次看清。
查看 Fed 降息機率	透過 API 或利率決策機率頁面取得 Fed 降息機率，以及維持不變與升息的機率，並查看以基點表示的預期變動，另附一個標明日期的會議範例，方便你直接套用到自己的模型。
預測賠率變動時收到提醒	用定時執行的 Python 腳本或無程式碼工作流程設定預測市場賠率提醒。你會學到如何保存上一次的賠率、選擇門檻，並對每次讀數進行比較，在賠率變動時及時收到提醒。

API 任務

Webhook、串流、快取、回補與代理。

API 任務
指南	涵蓋內容
Narwhal Webhook 接收設定	介紹如何做 Webhook 接收：建立 Narwhal 目的地，驗證投遞簽章，處理重複事件，並藉由投遞歷史或事件日誌找回錯過的事件，還附有可直接執行的 Python 接收端範例。
透過 WebSocket 接收即時資料事件	介紹如何用 Python 接收 WebSocket 即時資料：連線 Narwhal API 的事件與預測串流，依國家和主題篩選，儲存游標，並處理斷線重新連線和各類錯誤，附帶可執行的範例腳本。
快取回應並處理 429 錯誤	依資料類型快取 API 回應，處理 Retry-After，並區分速率限制與餘額不足，附有 Python 程式碼和一個計算每月成本的完整範例，幫助你把 API 開銷控制在預期之內。
回補歷史資料	本頁介紹如何透過游標分頁下載歷史資料，將回傳的列儲存到檔案，在回填中斷後從上次的位置接著繼續，並檢查每個序列回傳的第一個日期是哪一天，一步步完成完整回填，不遺漏任何資料。
安排每日資料拉取	示範每日排程抓取資料：用 Python 和 cron 每天抓取金價和 USD/IDR 並附加到 CSV，也可以改用無程式碼流程。文中還介紹了執行時間、失敗處理，以及每月的用量和費用估算。
讓 LLM 代理程式存取 Narwhal	LLM agent 金融資料：用 API 金鑰和 MCP 把 LLM 代理程式接入 Narwhal，了解用戶端設定、唯讀資料工具、額度說明，以及代理程式中連線錯誤的排解方法。
從 Alpha Vantage 遷移到 Narwhal	Alpha Vantage 替代方案：把每個 function 對應到 Narwhal API 的端點，將 apikey 參數換成 Bearer 標頭，並核對 CPI、股票和外匯資料是否一致，讓現有程式碼平穩切換到 Narwhal。

關於這些操作指南

每篇教學回答一個問題，附帶可運作的請求與標有日期的範例，可與資料來源核對。

所有範例都使用同一組免費 API 金鑰，前 12 個月每月附帶 $10 的免費額度。

透過 API 取得這些資料

試試看請求。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"

取得免費 API 金鑰閱讀快速入門指南

常見問題

操作指南和教學有什麼差別？

操作指南回答一個問題，例如計算兩個日期之間的營業日天數。教學則在您已經使用的工具中設定 Narwhal 資料，例如試算表、Python 或 Postgres。

需要 API 金鑰嗎？

程式碼範例需要免費 API 金鑰，前 12 個月每月附帶 $10 的免費額度。部分操作指南無需金鑰，也可透過試算表或公開頁面使用。

範例使用哪些語言？

以 Python 和試算表公式為主，在適合的任務中也會用到 JavaScript、SQL 與無程式碼工具。