Zapier と Narwhal API の連携

Zapier と Narwhal で、祝日、公開日、経済データ、コモディティ、為替、予測市場のオッズを、メール、Slack、スプレッドシートの行に取り込めます。Schedule by Zapier を Webhooks by Zapier の GET リクエストにつなぎ、返されたフィールドをあとのアクションで使います。

セットアップする内容

Zapier は、スケジュールされたトリガーを、データをリクエストして結果を使うアクションにつなぎます。Narwhal を呼び出し、必要なフィールドをメール、Slack のアクション、スプレッドシートの行に渡す Zap ができあがります。Narwhal はデータ API 全体で1つのアカウントと1つの 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 のステップを追加して、1行ずつ処理します。スプレッドシートの行に祝日の日付と名前を入れるときのように、その行のフィールドを、必要とするアクションで使います。
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 があり、あとのアクションで組み合わせて使えます。スプレッドシートの行に祝日を1件ずつ入れるには、フィールドを割り当てる前に、Looping か Formatter のステップで holidays のリストを1行ずつ処理します。

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 のリストを1行ずつ処理します。カレンダーが提供するのは公開日で、経済データのリクエストは期間と値を持つ観測値を使います。アクションに必要なのが公開時刻、トピック、ステータスなら、カレンダーの 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 があります。値とそれが表す期間を一緒に使いたいときは、両方のフィールドをアクションに割り当てます。観測値を1行ずつ処理するには、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 に USD を付けた BRENT を使います。

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 があります。リストを1行ずつ処理すると、各通貨とそのレートをあとのアクションに渡せます。通貨フィールドが、アクションの受け取るレートがどの通貨のものかを示します。

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 の予測

Federal Reserve の政策金利パスのリクエストは、meetings を返します。各会合に resolves_at、p_cut、p_hold、p_hike があります。あとのアクションで、会合の決着時刻を、利下げ、据え置き、利上げの確率と並べて使います。会合ごとに使いたいときは、meetings のリストを1行ずつ処理します。

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はすべてのアカウントで利用でき、配信1回につき呼び出し1回分の料金がかかります。スケジュール実行のGET ZapはNarwhalにデータを問い合わせ、Catch Hookは自身のURLに送られたWebhookを受信します。

1つの Zap で多くのリクエストを使うのはなぜですか。

成功したGETリクエスト1件につき呼び出し1回分の料金がかかります。そのため、6つのURLを呼び出す毎時のZapは、1日144回、月4,320回の呼び出しとなり、1,000回あたり$2で約$8.64です。トリガーの実行頻度だけでなく、Zapが呼び出すURLの数も数えてください。複数のデータ領域をリクエストするZapはURLごとにリクエストを送ります。後続のアクションが同じメールやシートの行でそれらのフィールドをまとめて使う場合でも同じです。

公開。

次のステップ