Make API 연동으로 Narwhal API 사용하기

Narwhal API와 Make를 함께 쓰면 공휴일, 발표일, 경제 데이터, 원자재 현물 가격, 환율, 예측 시장 확률을 시나리오로 가져올 수 있습니다. 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에서 원자재 현물 가격 사용하기

원자재 요청으로 Brent 현물 가격을 USD로 가져옵니다. 응답에는 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 같은 목록 필드 자체로 설정한 다음, 각 항목의 필드를 이후 모듈에 매핑하세요.

한 번 실행하면 작업(operation)은 몇 개 쓰이나요?

Make는 모듈 실행 1회당 작업을 1개 사용하며, 할당량은 Make 쪽에서 정해집니다. 시나리오 스케줄이 쓰는 작업 수를 따질 때는 모듈 실행 횟수를 세어 보세요.

에 게시되었습니다.

다음 단계