Make API 連携で Narwhal API を使う

セットアップする内容

Make は HTTP モジュールで Narwhal API にデータをリクエストし、解析したフィールドを後続のモジュールに渡します。GET リクエスト、Authorization ヘッダー、レスポンスの解析を備え、最初のモジュールでスケジュールを設定したシナリオができあがります。Narwhal は1つのアカウントと1つの 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 とクエリを設定するときは、これらの値をそれぞれのリクエストとセットで入力してください。

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 に設定し、後続のモジュールを設定するときにその出力から祝日のフィールドを選びます。祝日名をマッピングするときは、同じ祝日の項目から取った日付を並べて使ってください。

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 から発表時刻、トピック、ステータスをマッピングしていますが、後続のモジュールで必要なら各発表データの期間も使えます。

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 を使います。

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 でコモディティのスポット価格を扱う

コモディティのリクエストで、Brent のスポット価格を USD で取得します。レスポンスには price フィールドが1つあり、後続のモジュールに data.price としてマッピングできます。このリクエストは、スポットコードに BRENT、URL に USD を使います。スポットコードには、たとえば XAU、XAG、XPT、XPD、XCU、BRENT、WTI があります。

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 リストを使います。

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 もマッピングできます。

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 はそのリストを1行につき1項目に展開します。Iterator には data.releases のようなリストフィールドそのものを設定し、各項目のフィールドを後続のモジュールにマッピングします。

1回の実行でオペレーションはいくつ使いますか?

Make はモジュールの実行1回につきオペレーションを1つ使い、クォータは Make 側で設定されます。シナリオのスケジュールで使うオペレーション数を考えるときは、モジュールの実行回数を数えてください。