使用情境

每個頁面只處理一項任務，例如確定正確的營業日，或依通膨調整租金，並展示完成該任務的 Narwhal 請求與真實回應。

行事曆與發布

掌握資料與決議的公布時間。

行事曆與發布
應用案例涵蓋內容
在你自己的應用程式中顯示財經日曆在產品中提供財經日曆：依使用者篩選國家、依檢視者時區顯示發布時間、依國家快取，並處理被調整的發布，讓應用程式內的財經日曆與官方公布的時間保持一致，使用者看到的時間準確無誤。
在公布之前查看數據的公布時間、所屬期間和前值透過日曆 API 查找某個國家接下來的高關注度經濟數據公布，包括 UTC 與當地公布時間、所屬期間和前值，好讓你在數據公布之前就能查看，提前做好準備、心中有數。
向交易台或值班團隊傳送經濟數據公布提醒為交易台或值班團隊建立經濟數據公布提醒:每則訊息都包含 UTC 時間、交易台的當地時間、所屬期間與前值，讓交易台和值班團隊在數據公布前就能掌握關鍵資訊，不必再臨時去查。
為報導查詢下週發布的數據和最新數值取得本週將發布的經濟數據，以及通膨、失業率和 GDP 的最新數值，並同時拿到報導所需的參考期和發布日期，寫稿時就能寫對統計月份。適合新聞編輯室用 Narwhal API 查詢經濟數據。
央行利率追蹤：政策利率與市場隱含利率路徑先讀取多個國家央行的目前政策利率與利率歷史，再加入未來會議的市場隱含降息、維持、升息機率，把央行政策利率與市場隱含的利率路徑放在同一份資料裡一起追蹤，一目瞭然。

假日與營業日

圍繞休市日做好安排。

假日與營業日
應用案例涵蓋內容
兩國假日不同時，如何計算跨境交易的交割日兩國假日不同時，計算跨境交易的交割日：把交易清單對照兩國的國定假日列表跑一遍，並標出日期因假日而改變的交易，直接得到可覆核的營業日結果，也方便逐筆核對每個日期。
為薪資計算列出各國各年的國定假日為薪資計算按年取得各國的國定假日，並透過每個項目的 scope 和行政區劃代碼，區分全國性假日與地區性假日。指定國家和年份呼叫一次，就能拿到薪資計算所需的假日清單。
預計送達日計算：在結帳時承諾跨兩國的送達日期預計送達日計算可在購物車顯示送達日期，並考量下單截止時間、承運天數，以及出貨國與送達國的國定假日，讓跨兩國訂單在結帳時就能向客戶承諾可靠的送達日期，並避開假日。
避開多國假日安排會議與發布用假日日曆 API 找出多個國家都不是國定假日的日子，用來安排會議、發布或維護時段，讓跨國團隊的排程避開所有休息日，不再撞上任何一個國家的假期，也不必逐國去查日曆。
為服務等級協議（SLA）執行按工作日計時的違約計時器為服務台建立按工作日計時的違約計時器：說明合約必須定義哪些內容，以及 Narwhal 的假日資料如何為合約所在國家的計時提供日曆，讓違約時間的計算有據可依、便於覆核。
圍繞國定假日和伊斯蘭曆（回曆）規劃旅遊用 Narwhal API 依各國的國定假日、連假和回曆日期來規劃行程與預訂。API 不包含預訂或價格資料，只提供日期，讓你把旅遊日程排在合適的時間，避開各國的假期。

預測市場

在產品或研究中使用市場賠率。

預測市場
應用案例涵蓋內容
向客戶與交易員顯示降息、維持與升息的機率在客戶畫面或交易檯顯示降息、維持、升息的市場機率：如何措辭、四捨五入、標註時間，以及如何從 Narwhal 更新資料，讓客戶和交易員看到的機率措辭一致、帶有日期。
建立總經事件的市場賠率儀表板利用 Narwhal 預測的主題與事件端點，建立呈現 CPI、非農就業、失業率、衰退與利率決策市場賠率的總經事件賠率儀表板，並說明各形態的讀取方法和 Python 範例。
針對同一事件，篩查兩個預測市場之間的價差在 Narwhal 的一次呼叫中，篩查 Kalshi 與 Polymarket 的交易台可以同時拿到兩邊的報價、規則文字和結算來源，從而對照各自的賠付條件來解讀價差。適用於尋找預測市場套利的候選。
Polymarket 歷史資料:取得預測市場賠率與結算結果做研究需要 Polymarket 歷史資料等預測市場資料時，可透過 Narwhal API 取得賠率歷史與已結算事件的結果，並從回應中讀取 as_of、stale 與 final,直接用於研究。
把市場機率用作輸入訊號，並衡量預期變動的變化輪詢 Narwhal 的政策利率路徑，讀取市場對央行決策的機率，並計算兩次讀數之間預期變動的變化量（單位為基點）。這是把預測市場用作交易訊號的做法，附完整腳本範例。

通膨、利率與總體經濟

用官方統計進行調整、對標與監控。

通膨、利率與總體經濟
應用案例涵蓋內容
把過去的預算與合約金額換算成現行價格為報告把過去的預算與合約金額換算成現行貨幣價值，完成通膨調整：選定基準月份和指數，再用 API 提供的 CPI 為數字加上標註，並提供 Python 換算範例與標註寫法。
計算有下限與上限的 CPI 租金調整用 Narwhal API 中的兩個 CPI 觀測值，計算有下限與上限的租約年度 CPI 租金調整，並附上一支可以直接執行的 Python 腳本，方便你直接套用到自己的租約。
對照兩個國家的通膨，檢查加薪是否跟上物價用 Narwhal 的通膨端點，把加薪幅度與兩個國家的 CPI 年增率對照，具體檢查加薪是否跟上物價，並算出實質購買力的變化，看看薪水是否仍能買到一年前的東西。
殖利率利差：每日記錄曲線利差並依門檻標記為風險團隊做每日殖利率曲線檢查：從歷史路由儲存殖利率利差，依門檻標記，並連同來源日期記錄每一次執行，讓你直接得到可追溯的利差序列和警示，供風險團隊每天查看與覆核。
取得國家股權風險溢酬與資金成本輸入值取得任一涵蓋國家的股權風險溢酬，拆分為成熟市場溢酬和國家風險溢酬，並用它計算權益成本與 WACC，取得估算資金成本所需的各項輸入值，方便直接用於估值模型，估值時更省事。
比較新興市場的通膨、政策利率與成長用一個 API 比較印尼、巴西、墨西哥、印度等新興市場的通膨、央行政策利率與 GDP 成長。先測試各國資料涵蓋情況，缺少月度資料時退回 World Bank 年度序列，並附 Python 範例。
用即時官方資料設計經濟學教學習題圍繞實質利率與 GDP 中的物價成長設計課堂經濟學教學資料練習。使用來自官方來源的即時通膨、政策利率與 GDP 資料，並附上請求範例、回應與 Python 計算過程，協助老師和學生完成兩個練習。

關於這些應用案例

每個應用案例會說明任務，展示真實的請求與回應，並連結到相關的操作指南與 API 頁面以了解詳情。

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

透過 API 取得這些資料

試試看請求。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"
取得免費 API 金鑰閱讀快速入門指南