다음 CPI 발표일 찾기

API 사용 방법

GET /v1/economics/calendar로 국가와 날짜 범위에 대한 발표 일정을 요청하세요. 요청에는 주제 필터가 없으므로 Python 코드가 캘린더 응답에서 소비자물가 발표를 선택합니다. 국가 매개변수를 생략하면 소비자물가 선택 결과에 여러 국가의 발표가 포함될 수 있으므로 미국 일정이 필요하면 countries=USA를 유지하세요.

1. 키 발급 무료 API 키를 발급받아 NARWHAL_API_KEY 환경 변수에 저장하세요. 요청은 Authorization: Bearer YOUR_KEY 헤더에 키를 담아 https://api.narwhalapi.com으로 전송되며, 스크립트는 환경 변수에서 해당 키를 읽습니다.
2. 국가와 날짜 범위 선택 미국 캘린더는 countries를 USA로 설정하고 start_date와 end_date로 요청 범위를 지정하며, 스크립트는 실행일과 그로부터 120일 후를 시작일과 종료일로 사용합니다. 여러 국가를 요청하려면 countries=USA&countries=GBR처럼 매개변수를 반복하고, 모든 국가의 발표를 반환하려면 countries를 생략하세요.
3. 예정된 소비자물가 발표 선택 캘린더를 요청한 다음 topic이 consumer_prices이고 status가 scheduled이며 at 값이 있는 발표만 남기세요. 스크립트는 일치하는 발표 중 at가 가장 이른 것을 선택해 기준 기간, UTC 발표 시각, 발표 기관의 시간대를 출력합니다.
   Python, 다음 미국 소비자물가 발표

   복사

   import os
   from datetime import date, timedelta
   import requests
   
   r = requests.get(
       "https://api.narwhalapi.com/v1/economics/calendar",
       params={
           "countries": "USA",
           "start_date": date.today().isoformat(),
           "end_date": (date.today() + timedelta(days=120)).isoformat(),
           "limit": 100,
       },
       headers={"Authorization": f"Bearer {os.environ['NARWHAL_API_KEY']}"},
       timeout=10,
   )
   r.raise_for_status()
   cpi = [
       x
       for x in r.json()["releases"]
       if x.get("topic") == "consumer_prices" and x["status"] == "scheduled" and "at" in x
   ]
   nxt = min(cpi, key=lambda x: x["at"])
   print(nxt["period"], nxt["at"], nxt["timezone"])

4. 발표 필드 확인 각 발표에는 release_id, country, name, topic이 있으며, period는 수치의 대상 월을 나타내고 status는 예정 발표의 상태를 설명합니다. 미국 소비자물가의 series_id는 usa-consumer-prices이며, 값이 있으면 at는 UTC 시각을, timezone은 발표 기관의 IANA 시간대인 America/New_York을 나타냅니다.
5. 나머지 페이지 조회 페이지당 발표는 최대 100개이며, 스크립트는 응답 페이지에 있는 발표를 읽습니다. 응답에 next_cursor가 있으면 이를 따라 나머지 페이지를 읽은 뒤 전체 캘린더 결과에서 조건에 맞는 가장 이른 발표를 선택하세요. 캘린더 엔드포인트는 경제 발표 API 문서를 확인하세요.

요청 제한 시간은 10초입니다. 스크립트가 JSON releases 배열을 읽기 전에 raise_for_status()를 호출하므로 HTTP 오류가 나면 소비자물가 선택 전에 처리가 중단되며, 선택 과정에서는 응답 배열의 발표 필드를 읽습니다.

코드 없이 날짜 찾기

경제 데이터 페이지를 열고 해당 국가의 인플레이션 페이지에서 다가오는 소비자물가 발표를 확인하세요. 각 국가의 인플레이션 페이지에는 다음 발표일이 있고, 경제 캘린더 페이지에는 국가별 예정 발표가 나열됩니다.

모델이나 대시보드에 캘린더 요청을 추가하지 않고 날짜를 확인하려면 국가 페이지를 사용하세요. 국가로 일정 범위를 좁힌 다음 발표일과 기준월을 함께 읽어 수치의 대상 월과 예정 발표일을 구분하세요.

휴대전화에서 알림을 받으려면 캘린더를 구독하세요. 피드는 발표를 Google Calendar, Outlook 또는 Apple Calendar에 추가하며, 설정 방법은 경제 발표 알림 설정 방법을 따르세요.

상황별 계산 방법

CPI 발표일은 확정된 날짜인가요?

발표는 게시될 때까지 status: scheduled 상태이며, at 시각은 변경될 수 있습니다. 예정 발표 시각을 사용하는 모델, 대시보드 또는 알림에 해당 날짜를 적용하기 전에 캘린더를 다시 조회하세요.

Basic 및 Pro 웹훅에는 일정 변경을 알리는 release.rescheduled 이벤트가 있습니다. 예정된 시각이 필요할 때는 캘린더의 at 필드에서 UTC 발표 시각을 확인하며, timezone은 발표 기관의 IANA 시간대를 나타냅니다.

기준월이 발표월보다 앞서는 이유는 무엇인가요?

period는 수치의 대상 월이므로 2026년 11월 10일로 예정된 발표는 2026년 10월을 다룹니다. 발표일은 11월이지만 period는 2026-10입니다.

CPI 수치의 대상 월을 확인할 때는 period를, 예정 발표 시각을 확인할 때는 at를 사용하세요. 두 필드를 구분해서 읽으면 발표일을 모델이나 대시보드에 가져올 때도 수치와 기준월의 연결을 유지할 수 있습니다.

발표에 시각이 없으면 어떻게 하나요?

발표에 date만 있으면 특정 시점이 아닌 날짜로 처리하세요. 일부 캘린더 발표에는 시간 없이 날짜만 있거나 기간이 지정되어 있으므로 모든 캘린더 항목에 정확한 UTC 발표 시각이 있는 것은 아닙니다.

Python 선택 조건에는 at이 필요하므로 해당 항목은 선택 결과에서 제외됩니다. 날짜나 기간만 있는 발표가 필요하면 정확한 시각이 있는 항목과 별도로 해당 캘린더 항목을 읽으세요. 날짜만으로는 다른 시간대로 변환할 시점을 알 수 없습니다.

계산 예시: 2026년 10월 미국 CPI

2026년 10월 미국 CPI 발표는 period: 2026-10부터 확인하세요. 예정된 at 값은 2026-11-10T13:30:00Z이며 발표 기관의 시간대는 America/New_York입니다.

UTC 값은 2026년 11월 10일 화요일 13:30으로 읽으세요. 뉴욕은 11월에 UTC-5인 EST를 사용하므로 13:30에서 다섯 시간을 빼면 같은 날 08:30이 됩니다.

2026년 10월 기준 기간의 출력값은 기간, 예정된 UTC 타임스탬프, 발표 기관의 시간대 순서입니다:

2026-10 2026-11-10T13:30:00Z America/New_York

2026년 11월 기준 기간의 발표는 2026년 12월 10일 13:30 UTC로 예정되어 있습니다. 2026년 12월 기준 기간의 발표는 2027년 1월 13일 13:30 UTC로 예정되어 있습니다.