在 Zapier 中使用 Narwhal API

你可以用 Zapier 和 Narwhal 把國定假日、發布日期、經濟資料、大宗商品、匯率和預測市場賠率匯入電子郵件、Slack 或試算表資料列。把 Schedule by Zapier 連接到 Webhooks by Zapier 的 GET 請求，然後在後續動作中使用回傳的欄位。

你將完成的設定

Zapier 把排程觸發器連接到請求資料並使用回應的動作。你最後會得到一個呼叫 Narwhal 的 Zap，並把需要的欄位傳給電子郵件、Slack 動作或試算表資料列。Narwhal 用同一個帳號和同一把 API 金鑰涵蓋其各個資料 API；REST 和 MCP 共用這把金鑰。Webhooks by Zapier 是 Zapier 的進階應用程式，所以在設定請求之前，請確認你的 Zapier 方案包含 Webhooks by Zapier。

設定你的 API 金鑰

  1. 建立免費金鑰 在 narwhalapi.com/signup 取得免費金鑰。無論你選擇哪個資料領域，Zap 中的 Narwhal 請求都使用這把金鑰。
  2. 儲存金鑰 把金鑰存放在名為 NARWHAL_API_KEY 的環境變數中。請求標頭需要金鑰的值，並在前面加上 Bearer。
  3. 加入請求標頭 在 Webhooks by Zapier 中，使用 GET 方法的 Custom Request，並加入標頭 Authorization: Bearer YOUR_KEY。把 YOUR_KEY 換成你的 Narwhal 金鑰；URL 的基礎位址是 https://api.narwhalapi.com。

不寫程式碼擷取資料

  1. 加入排程觸發器 使用 Schedule by Zapier 作為觸發器。依據你希望多久向後續動作傳送一次資料，把它設定為每天或每小時執行。
  2. 加入資料請求 加入 Webhooks by Zapier，並使用 GET 方法的 Custom Request。輸入所需領域的 URL 和 Authorization 標頭；這裡的請求設定把每個 URL 與要使用的回應欄位配成一對。
  3. 使用回傳的欄位 加入電子郵件、Slack 或試算表資料列動作，並依名稱對應回傳的欄位。例如，大宗商品回應有 price，而國定假日回應有 holidays。
  4. 處理資料列清單 當資料列以清單欄位的形式送達時，加入 Looping 或 Formatter 步驟，一次處理一列。在需要它們的動作中使用該列的欄位，例如試算表資料列中的國定假日日期和名稱。
Webhooks by Zapier，各領域的 Custom Request
Header: Authorization: Bearer YOUR_KEY

Holidays    GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
            (field: holidays)
Releases    GET https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-11-01&end_date=2026-11-30&limit=100
            (field: releases)
Economics   GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2025-09
            (field: observations)
Commodity   GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD  (field: price)
FX          GET https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR
            (field: rates)
Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
            (field: meetings)

按排程定時執行

Schedule by Zapier 可以每天或每小時觸發一次請求。觸發器決定 Zap 何時向 Narwhal 請求資料，後續動作使用該請求回傳的欄位。請依據你要傳入電子郵件、Slack 或試算表資料列的資料來設定排程。

Zapier 中的國定假日

國定假日請求回傳 2026 年 USA 的 holidays。每個國定假日都有 date 和 name，可以在後續動作中一起使用。要把個別國定假日放入試算表資料列，請在對應這些欄位之前，用 Looping 或 Formatter 步驟一次處理 holidays 清單中的一列。

Custom Request 設定
Method: GET
URL: https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
Header: Authorization: Bearer YOUR_KEY
Read field: holidays

Zapier 中的發布日期

經濟日曆請求回傳 2026 年 11 月 USA 的 releases。每個發布都有 at、period、topic 和 status。當動作需要發布日期及其背景時，使用這些欄位；如果想為每個發布單獨設定一個動作，就一次處理 releases 清單中的一列。日曆提供發布日期，而經濟資料請求使用帶有期間和數值的觀測值。當你的動作需要的欄位是發布時間、主題或狀態時，請選擇日曆 URL。

Custom Request 設定
Method: GET
URL: https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-11-01&end_date=2026-11-30&limit=100
Header: Authorization: Bearer YOUR_KEY
Read field: releases

Zapier 中的經濟資料

CPI 請求要求從 2025 年 9 月開始的 USA 觀測值，並回傳 observations。每個觀測值都有 period 和 value。需要把數值與其對應的期間放在一起時，請把兩個欄位都對應到動作中；用 Looping 或 Formatter 步驟一次處理一個觀測值。Narwhal 的經濟資料包括 CPI、通膨、GDP 和殖利率；這個請求使用 CPI。

Custom Request 設定
Method: GET
URL: https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2025-09
Header: Authorization: Bearer YOUR_KEY
Read field: observations

所有帳戶都可讀取完整歷史。如果序列在請求的開始日期之後才開始，回應將從其第一個觀測值開始。

Zapier 中的大宗商品

大宗商品請求從 price 讀取以 USD 計價的 Brent 現貨價格。把這個欄位對應到需要價格的電子郵件、Slack 或試算表資料列動作中。大宗商品現貨代碼包括 XAU、XAG、XPT、XPD、XCU、BRENT 和 WTI 等；這個請求在 URL 中使用 BRENT 和 USD。

Custom Request 設定
Method: GET
URL: https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
Header: Authorization: Bearer YOUR_KEY
Read field: price

Zapier 中的匯率

匯率請求以 USD 為基準貨幣，請求 EUR 和 IDR。讀取 rates，其中每個項目都有 currency 和 rate。一次處理清單中的一列，就可以把每種貨幣及其匯率傳給後續動作，由貨幣欄位標明動作收到的是哪種貨幣的匯率。

Custom Request 設定
Method: GET
URL: https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,IDR
Header: Authorization: Bearer YOUR_KEY
Read field: rates

Zapier 中的預測

美國聯準會政策利率路徑請求回傳 meetings。每次會議都有 resolves_at、p_cut、p_hold 和 p_hike。在後續動作中，把會議的結算時間與降息、維持和升息機率一起使用；如果想分別使用每次會議，就一次處理 meetings 清單中的一列。

Custom Request 設定
Method: GET
URL: https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
Header: Authorization: Bearer YOUR_KEY
Read field: meetings

Zapier 能接收 Narwhal 的 Webhook 嗎？

可以。Zapier 的 Catch Hook URL 可以作為 Narwhal 的 Webhook 目的地。所有帳戶皆可使用 Webhook，每次投遞計為一次呼叫。排程的 GET Zap 會向 Narwhal 要求資料；Catch Hook 則接收傳送到其 URL 的 Webhook。

為什麼一個 Zap 會用掉這麼多請求？

每次成功的 GET 請求計為一次呼叫，因此每小時執行一次、呼叫六個 URL 的 Zap 每天產生 144 次呼叫，每月 4,320 次，以每 1,000 次 $2 計算約為 $8.64。除了觸發器的觸發頻率，也要計算 Zap 呼叫的 URL 數量。請求多個資料領域的 Zap 會對每個 URL 發出一次請求，即使後續動作把這些欄位一起用在同一封電子郵件或同一列試算表中也是如此。

發布於 。

後續步驟