API로 경제지표 캘린더 직접 만들기

API 사용 방법

발표일에는 경제 캘린더를 사용하세요. 각 발표에는 시각, 국가, 이름 필드와 함께 대상 기간, 주제, 상태, 시간대 필드가 있습니다. 서비스나 대시보드에 출력된 일정표보다 많은 정보가 필요하다면 이 필드들을 발표와 함께 보관하세요.

1. API 키 설정 무료 키를 받아 NARWHAL_API_KEY 환경 변수에 저장하세요. 스크립트는 이 변수를 읽어 키를 Authorization: Bearer YOUR_KEY로 https://api.narwhalapi.com에 보냅니다. Narwhal은 REST와 MCP에 같은 키를 사용합니다.
2. 국가와 날짜 선택하기 countries 파라미터를 반복해서 지정하고 start_date, end_date를 함께 전달하세요. 이 예시는 2026년 11월 9일부터 13일까지 USA, GBR, JPN을 사용합니다. 다른 일정을 원하면 국가 목록과 날짜 인수를 바꾸되, 요청 대상은 /v1/economics/calendar로 유지하세요.
3. 발표를 가져와 정렬하기 키를 환경 변수에 둔 상태로 Python 스크립트를 실행하세요. 스크립트는 모든 페이지에서 발표를 모으고 at이 있는 레코드를 골라 시각, 국가, 이름을 함께 정렬합니다. 출력되는 일정은 UTC 시각이며, 마지막에 요청한 날짜 범위의 발표 건수가 표시됩니다.
   Python: 3개국의 일주일치 발표

   import os
   import requests
   
   HEADERS = {"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"}
   
   
   def calendar(countries, start, end):
       cursor = None
       while True:
           params = {
               "countries": countries,
               "start_date": start,
               "end_date": end,
               "limit": 100,
           }
           if cursor:
               params["cursor"] = cursor
           r = requests.get(
               "https://api.narwhalapi.com/v1/economics/calendar",
               params=params,
               headers=HEADERS,
               timeout=10,
           )
           r.raise_for_status()
           body = r.json()
           yield from body["releases"]
           cursor = body.get("next_cursor")
           if not cursor:
               return
   
   
   rows = sorted(
       (x["at"], x["country"], x["name"])
       for x in calendar(["USA", "GBR", "JPN"], "2026-11-09", "2026-11-13")
       if "at" in x
   )
   for at, country, name in rows:
       print(at, country, name)
   print(len(rows), "releases")

4. 표시할 필드 선택하기 더 자세한 캘린더에는 at(UTC), country, name, period, topic, status, timezone을 표시하세요. 스크립트는 시각, 국가, 이름만 출력합니다. 발표의 판을 구분해야 할 때는 stage를 함께 두세요. values 배열은 수치가 공표되기 전까지 비어 있으므로, 수치가 나오기 전에도 예정된 발표를 표시할 수 있습니다.

웹사이트, 캘린더 앱, 시트 사용하기

Narwhal 웹사이트에서 발표를 보려면 경제 캘린더를 여세요. 국가별 경제 캘린더 페이지가 있어, 요청을 작성하지 않고 해당 국가의 일정을 읽고 싶을 때 바로 쓸 수 있는 방법입니다.

캘린더 피드를 쓰면 같은 발표가 캘린더 앱에 표시됩니다. 방법은 경제 지표 발표 전에 알림 받기를 따라 하세요. 시트를 선호한다면 스크립트의 출력인 UTC 시각, 국가, 발표 이름을 담을 수 있습니다. 시트 방식은 API 출력에서 시작하며, 코드 없이 일정을 보고 싶다면 웹사이트와 피드를 쓸 수 있습니다.

상황별 계산 방법

영국에서 GDP가 두 번 나오는 이유는 무엇인가요?

발표의 두 판이 같은 시각에 나올 수 있으며, stage로 구분할 수 있습니다. 예를 들어 첫 추정치와 월별 수치가 같은 예정 시각을 가질 수 있습니다. 이 필드는 속보치, 선행치, 최초치, 확정치도 구분하므로 발표 이름과 시각만으로는 판이 같아 보일 수 있습니다.

이름과 함께 stage 또는 release_id를 표시해 항목을 구분하세요. 2026년 11월 12일 07:00 UTC에 영국 일정에는 GDP가 두 번 포함됩니다. 그 일정을 표시할 때는 두 항목을 모두 유지하고, 각 이름 옆에 판 또는 식별자가 보이게 하세요.

한 번의 요청으로 몇 건의 발표가 반환되나요?

한 페이지에는 최대 100건의 발표가 반환됩니다. limit으로 페이지 크기를 정하고 cursor를 전달해 결과를 이어서 가져오세요. 한 페이지는 요청한 일정의 일부입니다. 같은 국가와 날짜로 더 가져올 발표가 있는지는 next_cursor로 판단하세요.

next_cursor가 null이거나 빌 때까지 계속하세요. API가 409 cursor_expired를 반환하면 커서 없이 요청을 다시 시작합니다. 그 요청에도 국가와 날짜 선택을 그대로 유지해 원하는 일정을 처음부터 가져오세요.

캘린더에 포함할 수 있는 국가는 어디인가요?

countries를 생략하면 지원하는 모든 국가가 반환됩니다. 국가 코드는 최대 50개까지 지정할 수 있습니다. 유로 지역에는 EMU를 사용하세요.

Python 예시는 국가 목록을 전달하며, 이는 요청에서 반복되는 countries 파라미터가 됩니다. 모든 국가의 캘린더가 필요하면 요청에서 이 파라미터를 빼세요. 날짜 범위는 그대로 두고, 발표를 UTC 시각 순으로 정렬하기 전에 모든 페이지를 수집하세요.

계산 예시: 2026년 11월 9일부터 13일

2026년 11월 9일부터 13일까지, 먼저 미국 항목을 세어 보세요. 도매 판매, 소비자 물가, 임금 및 소득, 신규 실업수당 청구, 원유 재고, 재정 수지, 생산자 물가로 미국은 7건입니다. 일본은 같은 날짜 범위에 가계 지출과 국제수지 2건이 있습니다.

다음으로 영국의 GDP 항목을 따로 세세요. 건설 생산, 재화·서비스 무역, 산업 생산, 서비스 생산과 합하면 2026년 11월 9일부터 13일까지 영국은 6건입니다. 국가별 건수를 더하면 일정 전체의 합계가 나옵니다.

UTC 시각을 날짜순으로 읽어 보세요. 2026년 11월 9일에는 미국 도매 판매가 15:00, 일본 가계 지출이 23:30, 일본 국제수지가 23:50입니다. 2026년 11월 10일에는 미국 소비자 물가와 임금 및 소득이 13:30으로 같은 시각입니다. 2026년 11월 12일에는 미국 신규 실업수당 청구가 13:30, 원유 재고가 17:00, 재정 수지가 19:00입니다. 미국 생산자 물가는 2026년 11월 13일 13:30입니다.

2026년 11월 9일부터 13일까지 가장 붐비는 시간대는 11월 12일 07:00 UTC이며, 영국 발표 6건이 모두 몰려 있습니다. 정렬된 일정에서 이 묶음에는 GDP 두 판과 함께 건설 생산, 재화·서비스 무역, 산업 생산, 서비스 생산이 들어 있습니다.