用 Make API 串接 Narwhal API

用 Make 搭配 Narwhal API，可以把國定假日、發布日期、經濟數據、大宗商品現貨價格、匯率和預測市場賠率拉進情境。設定一個帶 API 金鑰的 HTTP 請求，然後把解析後的回應欄位對應到後續模組。

你將完成的設定

Make 透過 HTTP 模組向 Narwhal API 請求資料，並把解析後的欄位傳給後續模組。你會得到一個包含 GET 請求、Authorization 標頭和回應解析的情境，並在第一個模組上設定排程。Narwhal 以一個帳號、一把 API 金鑰涵蓋所有資料 API；REST 與 MCP 共用該金鑰。請求的基礎 URL 是 https://api.narwhalapi.com。經濟數據 API 包括 CPI、通膨、GDP 和殖利率。經濟日曆提供發布日期，下面的 CPI 觀測值請求提供期間和數值。

設定你的 API 金鑰

  1. 建立免費金鑰 在 narwhalapi.com/signup 取得免費 API 金鑰。把這把金鑰用於你新增到 Make 情境中的所有 Narwhal 請求，包括不同資料領域的請求。
  2. 把金鑰放在環境變數中 把金鑰放在名為 NARWHAL_API_KEY 的環境變數中。請求設定裡用 YOUR_KEY 作佔位符；在 Make 中填寫 Authorization 標頭時，把它換成你的金鑰。
  3. 設定請求標頭 標頭名稱用 Authorization，值用 Bearer YOUR_KEY。替換佔位符時要保留 Bearer 前綴，下面每個 GET 請求都使用同一個標頭。

不寫程式碼擷取資料

  1. 新增 HTTP 模組 在情境中新增 HTTP 模組，選擇 Make a request。把方法設為 GET，並填入你想擷取的資料領域的 URL。Brent 範例的 URL 是 https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD，它與清單類請求使用相同的標頭和解析設定。
  2. 填寫請求設定 新增帶有你金鑰的 Authorization 標頭，並把 Parse response 設為 Yes。對於帶查詢參數的請求，請使用下方設定中的值，例如發布日期所用的國家和日期範圍。
  3. 對應回應欄位 把解析後的欄位對應到後續模組。對國定假日、發布日期、觀測值、匯率或會議，請在對應的清單欄位上使用 Iterator；Brent 則直接對應 data.price 欄位。

以下是各領域的 HTTP 模組設定。發布日期、經濟數據和 FX 請求除端點外還帶有查詢字串值。在 Make 中填寫 URL 和查詢設定時，請讓這些值跟著各自的請求一起填入。

Make，各領域的 HTTP 模組
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes

Holidays    GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
            Iterator on: data.holidays          fields: date, name
Releases    GET https://api.narwhalapi.com/v1/economics/calendar
            Query string: countries=USA, start_date=2026-11-01,
                          end_date=2026-11-30, limit=100
            Iterator on: data.releases          fields: at, topic, status
Economics   GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations
            Query string: start=2025-09
            Iterator on: data.observations      fields: period, value
Commodity   GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
            map: data.price
FX          GET https://api.narwhalapi.com/v1/fx/rates/USD
            Query string: currencies=EUR,IDR
            Iterator on: data.rates             fields: currency, rate
Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
            Iterator on: data.meetings          fields: resolves_at, p_hold

按排程定時執行

透過第一個模組上的時鐘圖示開啟情境排程。可以把情境設為每 N 分鐘執行一次，或在指定時間執行。排程屬於情境的第一個模組，而 HTTP 模組保存 GET 方法、URL、標頭和 Parse response 設定。若每天擷取一次，請使用指定時間的排程選項；相關流程見排定每日資料擷取。

在 Make 中使用國定假日

請求 2026 年美國國定假日並使用 holidays 清單。每個假日都有 date 和 name，這兩個欄位都可以對應到後續模組。年份和國家包含在此請求的 URL 中。把 Iterator 設在 data.holidays 上，設定後續模組時從其輸出中選取假日欄位。對應假日名稱時，請搭配同一假日項目中的日期。

Make 國定假日請求
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes
Holidays    GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
            Iterator on: data.holidays          fields: date, name

在 Make 中使用發布日期

2026 年 11 月的美國發布日期使用經濟日曆。該請求把 start_date 設為 2026-11-01，end_date 設為 2026-11-30，limit 設為 100。每筆發布資料都有 at、period、topic 和 status 欄位。範例從 data.releases 對應發布時間、主題和狀態；如果後續模組需要，每筆發布資料上也有期間可用。

Make 發布日期請求
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes
Releases    GET https://api.narwhalapi.com/v1/economics/calendar
            Query string: countries=USA, start_date=2026-11-01,
                          end_date=2026-11-30, limit=100
            Iterator on: data.releases          fields: at, topic, status

在 Make 中使用經濟數據

在查詢字串中加上 start=2025-09，請求美國 CPI 觀測值。回應裡有 observations 清單，每筆觀測值都有 period 和 value。當後續模組需要把 CPI 數值與其期間一起使用時，請從 Iterator 輸出中對應這兩個欄位。此請求中，Iterator 的清單欄位使用 data.observations。

Make CPI 請求
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes
Economics   GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations
            Query string: start=2025-09
            Iterator on: data.observations      fields: period, value

在 Make 中使用大宗商品現貨價格

用大宗商品請求擷取以 USD 計價的 Brent 現貨價格。回應只有一個 price 欄位，可以作為 data.price 對應到後續模組。此請求使用 BRENT 作為現貨代碼，並在 URL 中使用 USD。現貨代碼例如有 XAU、XAG、XPT、XPD、XCU、BRENT 和 WTI。

Make Brent 請求
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes
Commodity   GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
            map: data.price

在 Make 中使用匯率

在端點中使用 USD，並在查詢字串中加上 currencies=EUR,IDR，即可請求 EUR 和 IDR 的匯率。回應的 rates 清單包含 currency 和 rate 欄位。把 Iterator 輸出對應到後續模組時，請讓貨幣欄位與其匯率一起保留，這樣對應後的值仍帶有回傳的貨幣。範例同時請求 EUR 和 IDR，Iterator 使用該請求回傳的 data.rates 清單。

Make FX 請求
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes
FX          GET https://api.narwhalapi.com/v1/fx/rates/USD
            Query string: currencies=EUR,IDR
            Iterator on: data.rates             fields: currency, rate

在 Make 中使用預測市場賠率

用聯準會政策路徑請求擷取 meetings 清單。每場會議都有 resolves_at、p_cut、p_hold 和 p_hike 欄位。範例從 Iterator 輸出中選取 resolves_at 和 p_hold。如果後續模組需要與維持不變機率一起使用，也可以對應該會議的 p_cut 和 p_hike。

Make 預測請求
Headers: Authorization = Bearer YOUR_KEY     Parse response: Yes
Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
            Iterator on: data.meetings          fields: resolves_at, p_hold

如何讀取清單?

開啟 Parse response 後，清單會出現在 data 下。Iterator 會把該清單拆成每列一項。把 Iterator 設為清單欄位本身，例如 data.releases，然後把每一項的欄位對應到後續模組。

一次執行會用掉多少次操作?

Make 每執行一個模組就算一次操作，配額由 Make 一側設定。估算情境排程會用掉多少操作時，請統計模組的執行次數。

發布於 。

後續步驟