在 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 发出一次请求，即使后续操作把这些字段一起用在同一封邮件或同一行表格中也是如此。

发布于。

后续步骤