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

n8n과 Narwhal API를 함께 쓰면 공휴일, 발표일, 경제 데이터, 원자재, FX, 예측 시장 확률을 워크플로로 가져올 수 있습니다. HTTP Request 노드가 API 키로 데이터를 가져오고, Schedule Trigger가 일정한 간격으로 워크플로를 시작할 수 있습니다.

설정할 내용

n8n은 워크플로의 노드를 서로 연결합니다. 이 설정을 따르면 시트나 이메일 같은 대상으로 넘길 수 있는 데이터 요청이 만들어집니다. Narwhal API 키를 자격 증명에 저장하고, 필요한 데이터에 맞게 HTTP Request 노드를 설정한 뒤, 응답 목록을 행마다 항목 하나로 나눕니다. REST와 MCP는 같은 키를 공유하므로, n8n 요청도 그 인터페이스들과 같은 키를 사용합니다.

API 키 설정

  1. 무료 키 만들기 narwhalapi.com/signup에서 계정을 만들고 무료 API 키를 받으세요. Narwhal API는 하나의 계정과 하나의 키로 모든 데이터 API를 이용하므로, n8n에서 연결하는 모든 분야에 같은 키를 사용합니다.
  2. 키 보관하기 키는 NARWHAL_API_KEY라는 환경 변수에 보관하세요. n8n 자격 증명을 설정할 때는 Bearer YOUR_KEY의 YOUR_KEY 부분에 그 키를 사용합니다.
  3. Header Auth 설정하기 HTTP Request 노드에서 Authentication을 Generic Credential Type으로 설정하고 Header Auth를 사용하세요. 이름은 Authorization, 값은 Bearer YOUR_KEY로 설정합니다. 키는 자격 증명에 저장됩니다.
    Header Auth 자격 증명
    Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

코드 없이 데이터 가져오기

기본 URL은 https://api.narwhalapi.com이며, 각 샘플에는 노드에 입력할 전체 URL이 들어 있습니다. 연결하는 분야마다 해당 URL과 응답 처리를 설정한 HTTP Request 노드를 따로 사용하세요. Header Auth 설정은 이 노드들 모두 같습니다.

  1. HTTP Request 노드 추가하기 메서드를 GET으로 설정하고, 가져오려는 분야의 URL을 입력하세요. 요청에는 Header Auth 자격 증명을 사용합니다. 아래의 분야별 샘플도 같은 인증 설정을 사용합니다.
  2. 쿼리 매개변수 추가하기 쿼리 매개변수는 노드의 쿼리 매개변수 목록에 넣으세요. 발표일의 경우 2026년 11월 발표 캘린더를 위해 캘린더 URL에 countries, start_date, end_date, limit을 사용합니다. countries에는 USA, start_date에는 2026-11-01, end_date에는 2026-11-30, limit에는 100을 입력하세요.
  3. 응답 목록 나누기 응답에 목록이 들어 있으면 HTTP Request 뒤에 Split Out 노드를 추가하세요. 요청에 맞게 필드를 holidays, releases, observations, rates, meetings 중 하나로 설정하면 행마다 항목 하나를 얻습니다.
  4. 대상 연결하기 만들어진 항목을 설정에 맞게 시트나 이메일 같은 대상 노드에 연결하세요. 해당 샘플에 표시된 필드를 읽으면 됩니다. Brent는 단일 응답 객체에서 {{ $json.price }}를 읽으세요.

일정에 맞춰 실행하기

Schedule Trigger 노드를 추가해 예를 들어 매일 07:00처럼 일정한 간격으로 워크플로를 시작하세요. 트리거가 데이터 요청을 시작하도록 HTTP Request 앞에 배치합니다. 목록 응답의 흐름은 Schedule Trigger, HTTP Request, Split Out, 그리고 대상 노드입니다.

요청하는 분야에 맞는 Split Out 필드를 사용하세요. Brent 응답은 단일 객체이므로 price 필드를 대상으로 넘기면 됩니다. 예약된 요청에 대해서는 매일 데이터 가져오기 예약하기도 참고하세요.

n8n에서 공휴일 사용하기

2026년 미국 공휴일을 요청하고 holidays 목록을 나누세요. 각 공휴일에는 date와 name이 있으며, 대상을 연결할 때 각 항목에서 해당 필드를 읽습니다. URL에는 국가와 연도가 모두 들어 있고, Split Out 노드에는 요청이 반환한 목록 필드를 사용합니다. 시트가 대상이라면 공휴일 날짜에 {{ $json.date }}, 이름에 {{ $json.name }}를 사용하세요.

공휴일 요청과 필드
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Holidays   GET https://api.narwhalapi.com/v1/calendars/holidays/USA/2026
           Split Out field: holidays            read: {{ $json.date }}, {{ $json.name }}

n8n에서 발표일 사용하기

캘린더 요청과 그 쿼리 매개변수로 2026년 11월 미국 경제 지표 발표일을 가져옵니다. releases 목록을 나누어 발표마다 항목 하나를 읽으세요. 응답 필드에는 at, period, topic, status가 있고, 샘플은 대상용으로 at과 topic을 읽습니다. Split Out 뒤에서 발표 시각에는 {{ $json.at }}, 주제에는 {{ $json.topic }}를 사용하세요.

발표일 요청과 필드
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Releases   GET https://api.narwhalapi.com/v1/economics/calendar
           query: countries=USA, start_date=2026-11-01, end_date=2026-11-30, limit=100
           Split Out field: releases            read: {{ $json.at }}, {{ $json.topic }}

n8n에서 경제 데이터 사용하기

Narwhal의 경제 데이터에는 CPI, 인플레이션, GDP, 수익률이 포함됩니다. 미국 경제 데이터에는 CPI 관측값 요청을 사용하고, 쿼리 매개변수 목록에 start=2025-09를 넣으세요. observations를 나누어 관측값마다 항목 하나를 얻고, 그 period와 value를 읽습니다. 각 관측값이 날짜 기준을 유지하도록 대상에서도 기간을 값과 함께 보관하세요.

CPI 요청과 필드
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Economics  GET https://api.narwhalapi.com/v1/economics/USA/cpi/observations
           query: start=2025-09
           Split Out field: observations  read: {{ $json.period }}, {{ $json.value }}

n8n에서 원자재 사용하기

원자재 URL로 Brent 현물 가격을 USD로 가져옵니다. 이 응답은 단일 객체이므로 샘플의 표현식으로 price를 바로 읽으면 됩니다. 현물 코드에는 예를 들어 XAU, XAG, XPT, XPD, XCU, BRENT, WTI가 있습니다. 여기서의 요청은 URL에 BRENT와 USD를 사용합니다.

Brent 요청과 필드
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Commodity  GET https://api.narwhalapi.com/v1/commodities/spot/BRENT/USD
           read: {{ $json.price }}

n8n에서 FX 사용하기

URL에 USD, 쿼리 매개변수 목록에 currencies=EUR,IDR를 넣어 환율을 가져옵니다. 반환된 rates 목록을 나누고 각 항목에서 currency와 rate를 읽으세요. 각 행에 환율과 함께 통화도 넣으려면 두 필드를 모두 대상으로 보내세요. 요청하는 통화는 EUR와 IDR이고, 기준 통화는 USD입니다.

FX 요청과 필드
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

FX         GET https://api.narwhalapi.com/v1/fx/rates/USD
           query: currencies=EUR,IDR
           Split Out field: rates  read: {{ $json.currency }}, {{ $json.rate }}

n8n에서 예측 데이터 사용하기

연방준비제도 정책 경로 예측을 가져온 뒤 meetings 목록을 개별 항목으로 나누세요. 각 회의에는 resolves_at, p_cut, p_hold, p_hike가 있습니다. 샘플은 resolves_at와 p_hold를 읽으므로, 그 표현식으로 회의의 결정 시각과 동결 확률을 대상에 넘기세요. 인하 확률은 p_cut, 인상 확률은 p_hike를 읽어 대상에서 쓸 수 있습니다.

예측 요청과 필드
Authentication: Generic Credential Type > Header Auth
                (name Authorization, value Bearer YOUR_KEY)

Predictions GET https://api.narwhalapi.com/v1/predictions/policy-paths/federal-reserve
           Split Out field: meetings  read: {{ $json.resolves_at }}, {{ $json.p_hold }}

API 키를 URL에 넣어도 되나요?

키는 Header Auth 자격 증명에 보관하세요. 요청 URL은 엔드포인트용이며, 자격 증명이 Authorization: Bearer YOUR_KEY를 헤더로 붙여 줍니다. 쿼리 매개변수는 각 요청 노드의 쿼리 매개변수 목록에 넣으세요.

429는 어떻게 처리하나요?

HTTP Request 노드에서 Retry On Fail을 켜고 Retry-After 값을 따르세요. 이 응답과 캐시에 대한 자세한 내용은 응답 캐시하고 429 오류 처리하기를 참고하세요.

에 게시되었습니다.

다음 단계