자피어 자동화로 Narwhal API 데이터 가져오기

설정할 내용

Zapier는 예약된 트리거를 데이터를 요청하고 응답을 사용하는 작업에 연결합니다. 결과로 Narwhal을 호출하고 필요한 필드를 이메일, Slack 작업, 시트 행에 전달하는 Zap이 만들어집니다. 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 단계를 추가해 한 번에 한 행씩 처리하세요. 시트 행에 공휴일 날짜와 이름을 넣는 경우처럼, 그 행의 필드를 필요로 하는 작업에서 사용합니다.

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 목록을 한 행씩 처리하세요.

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을 선택하세요.

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를 사용합니다.

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를 사용합니다.

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가 있습니다. 목록을 한 행씩 처리하면 각 통화와 그 환율을 이후 작업에 전달할 수 있으며, 통화 필드가 작업이 받는 환율이 어느 통화의 것인지 알려 줍니다.

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 목록을 한 행씩 처리하세요.

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

Zapier가 Narwhal 웹훅을 받을 수 있나요?

네. Zapier의 Catch Hook URL을 Narwhal 웹훅 대상으로 쓸 수 있습니다. 웹훅은 모든 계정에서 사용할 수 있으며 전송 1회당 호출 1회 비용이 듭니다. 예약된 GET Zap은 Narwhal에 데이터를 요청하고, Catch Hook은 자신의 URL로 전송된 웹훅을 받습니다.

Zap이 요청을 이렇게 많이 쓰는 이유는 무엇인가요?

성공한 GET 요청 1건당 호출 1회 비용이 듭니다. 따라서 URL 6개를 호출하는 시간당 Zap은 하루 144회, 한 달 4,320회를 호출하며 1,000회당 $2 기준으로 약 $8.64입니다. 트리거가 실행되는 빈도뿐 아니라 Zap이 호출하는 URL 수도 세어 보세요. 여러 데이터 영역을 요청하는 Zap은 URL마다 요청을 보내며, 이후 작업에서 같은 이메일이나 시트 행에 해당 필드를 함께 사용하더라도 마찬가지입니다.