모든 API

경제 캘린더 API

예정된 경제 지표 발표와 공표 상태를 추적하세요. 불확실한 일정을 정확한 시각으로 간주하지 않고 GDP, 물가, 노동, 무역 및 수익률 곡선의 발표 캘린더를 만드세요.

정상 운영 중94.13% uptime, last 30일674 ms 일반 응답 시간

첫 요청

한 달의 발표 목록

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "releases": [
    {
      "release_id": "00000000-0000-4000-8000-000000000201",
      "revision": 0,
      "country": "USA",
      "series_id": "usa-consumer-prices",
      "name": "Consumer prices",
      "topic": "consumer_prices",
      "family": "prices",
      "period": "2026-09",
      "status": "scheduled",
      "at": "2026-10-14T12:30:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}

중앙은행의 금리 결정 찾기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-12-09&end_date=2026-12-09" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "releases": [
    {
      "release_id": "52e78613-4f51-4cc8-b8dd-a4c3cc798c50",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-monetary-policy-press-conference",
      "name": "Monetary policy press conference",
      "topic": "policy_communication",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:30:00Z",
      "timezone": "America/New_York",
      "values": []
    },
    {
      "release_id": "ed7bb0f9-6b9b-4e27-9b43-d891742ec3d4",
      "revision": 1,
      "country": "USA",
      "series_id": "usa-policy-rate-decision",
      "name": "Policy rate decision",
      "topic": "policy_rate",
      "family": "policy_rate",
      "status": "scheduled",
      "at": "2026-12-09T19:00:00Z",
      "timezone": "America/New_York",
      "values": []
    }
  ],
  "next_cursor": null
}

캘린더 구독

curl --request POST \
  --url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
  --header "Authorization: Bearer $NARWHAL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'
응답 예시
{
  "subscription_id": "00000000-0000-4000-8000-000000000301",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2027-10-22T09:00:00Z"
}

엔드포인트

GET발표 목록 조회/v1/economics/calendar

지정한 날짜 범위의 경제 지표 발표 목록을 조회합니다.

매개변수

  • countries선택

    ISO alpha-3 코드입니다. 예: USA. 여러 나라는 파라미터를 반복하며 최대 50개입니다.

  • start_date선택

    기간의 첫날입니다. 기본값은 오늘로부터 30일 전입니다.

  • end_date선택

    기간의 마지막 날입니다. 기본값은 오늘로부터 335일 후입니다. 기간은 최대 366일입니다.

  • limit선택

    페이지당 발표 건수이며 1에서 100 사이입니다. 기본값은 100입니다.

  • cursor선택

    next_cursor와 같은 필터로 이어서 조회합니다.

목록의 각 발표

  • release_id문자열

    자세히 읽을 발표입니다.

  • name문자열

    Narwhal의 표준 영어 이름입니다. 예: Producer prices. 날짜는 포함하지 않습니다.

  • topic문자열

    시리즈가 측정하는 대상으로, 모든 나라에서 같습니다. 예: consumer_prices, gdp.

  • period문자열

    발표가 다루는 기간입니다. 예: 2026-09, 2026-Q3.

  • status문자열

    발표의 상태입니다. 예: scheduled.

  • at / date / between / by문자열

    발표 기관이 밝힌 시점입니다. 정확한 시각, 하루, 며칠의 범위, 마감일 중 하나입니다. 날짜를 알 수 없으면 None입니다.

  • values배열

    발표된 수치입니다. 발표 전에는 배열이 비어 있습니다.


전체 레퍼런스 →
GET발표 하나 가져오기/v1/economics/calendar/{release_id}

경제 지표 발표 정보를 조회합니다. 필요하면 version_id를 지정할 수 있습니다.

매개변수

  • release_id필수

    발표의 UUID입니다.

  • version_id선택

    이전 버전의 UUID입니다. 생략하면 현재 버전을 받습니다.

발표

  • version문자열

    변경되지 않는 버전으로, version_id로 다시 전달할 수 있습니다.

  • name문자열

    Narwhal의 표준 영어 이름입니다. 예: Producer prices. 날짜는 포함하지 않습니다.

  • topic문자열

    시리즈가 측정하는 대상으로, 모든 나라에서 같습니다. 예: consumer_prices, gdp.

  • period문자열

    발표가 다루는 기간입니다. 예: 2026-09, 2026-Q3.

  • status문자열

    발표의 상태입니다. 예: scheduled.

  • at / date / between / by문자열

    발표 기관이 밝힌 시점입니다. 정확한 시각, 하루, 며칠의 범위, 마감일 중 하나입니다. 날짜를 알 수 없으면 None입니다.

  • values배열

    발표된 수치입니다. 발표 전에는 배열이 비어 있습니다.


전체 레퍼런스 →

활용 사례

다음 CPI 발표일

다음 미국 CPI가 언제 나오는지 UTC와 뉴욕 시간으로 확인합니다.

가이드 읽기 →

발표 전 알림

캘린더 피드나 매일 실행하는 스크립트로 발표 전에 알림을 받습니다.

가이드 읽기 →

내 시간대의 발표 시각

UTC 발표 시각을 서머타임을 반영해 현지 시간으로 바꿉니다.

가이드 읽기 →

FOMC 회의와 의사록

예정된 FOMC 금리 결정과 의사록을 나열합니다.

가이드 읽기 →

중앙은행 회의

중앙은행의 결정일을 날짜순으로 나열합니다.

가이드 읽기 →

데이터 범위

114개국. 그중 43개국은 발표 기관에서 직접 일정을 읽고, 나머지 71개국은 외부 캘린더의 날짜이며 참고용으로 표시됩니다.

114개 국가 모두 보기

출처

공식 발표 기관 55곳: 통계청, 부처, 중앙은행. 발표 기관 자체의 날짜와 수치가 항상 외부 캘린더보다 우선합니다.

  • Instituto Nacional de Estadística y Censos (INDEC)아르헨티나
  • Australian Bureau of Statistics (ABS)호주
  • Statistics Austria오스트리아
  • Eurostat7개국
  • Statbel벨기에
  • National Bank of Belgium벨기에
  • Banco Central do Brasil브라질
  • National Statistical Institute (NSI)불가리아
  • Statistics Canada캐나다
  • Central Bank of Chile (BCCh)칠레
  • National Statistics Institute of Chile (INE)칠레
  • Croatian Bureau of Statistics (CBS)크로아티아
출처 55개 모두 보기
  • Czech Statistical Office (ČSÚ)체코
  • Statistics Denmark덴마크
  • Statistics Estonia에스토니아
  • European Commission (DG ECFIN)유로 지역
  • Statistics Finland핀란드
  • Finnish Customs (Tulli)핀란드
  • National Institute of Statistics and Economic Studies (INSEE)프랑스
  • French Customs프랑스
  • Federal Statistical Office of Germany (Destatis)독일
  • Hellenic Statistical Authority (ELSTAT)그리스
  • Hungarian Central Statistical Office (KSH)헝가리
  • Statistics Iceland아이슬란드
  • Ministry of Statistics and Programme Implementation (MoSPI)인도
  • Central Statistics Office (CSO)아일랜드
  • Italian National Institute of Statistics (Istat)이탈리아
  • Statistics Bureau of Japan일본
  • Cabinet Office of Japan일본
  • Japan Customs일본
  • Central Statistical Bureau of Latvia (CSB)라트비아
  • State Data Agency of Lithuania리투아니아
  • STATEC룩셈부르크
  • Department of Statistics Malaysia (DOSM)말레이시아
  • INEGI멕시코
  • Statistics Netherlands (CBS)네덜란드
  • Stats NZ뉴질랜드
  • Statistics Norway (SSB)노르웨이
  • Statistics Poland폴란드
  • Statistics Portugal (INE)포르투갈
  • National Bank of Romania (BNR)루마니아
  • Federal State Statistics Service (Rosstat)러시아
  • Bank of Russia러시아
  • Singapore Department of Statistics (SingStat)싱가포르
  • Singapore government open-data publications싱가포르
  • Statistical Office of the Republic of Slovenia (SURS)슬로베니아
  • National Statistics Institute of Spain (INE)스페인
  • Spanish Tax Agency (AEAT)스페인
  • Statistics Sweden (SCB)스웨덴
  • Directorate-General of Budget, Accounting and Statistics (DGBAS)대만
  • Turkish Statistical Institute (TurkStat)튀르키예
  • Office for National Statistics (ONS)영국
  • Bureau of Labor Statistics (BLS)미국
  • Bureau of Economic Analysis (BEA)미국
  • US Census Bureau미국

관련 API

공휴일 API

국가별 공휴일입니다. 전국과 지역 범위로 구분합니다.

API 탐색 →

경제 데이터 API

물가, 고용, 생산, 무역, 금리에 관한 공식 지표입니다.

API 탐색 →

요금

선불 크레딧, 1,000회당 2달러, 플랜이나 등급 없음.

요금 보기 →

자주 묻는 질문

모든 발표에 정확한 시각이 정해져 있나요?

아니요. 공표 기관이 날짜, 범위 또는 기한만 명시할 수도 있습니다. 응답은 최상위 at, date, between, by 중 한 필드로 해당 정밀도를 유지합니다.

이전 버전을 조회할 수 있나요?

변경할 수 없는 버전을 선택하려면 발표 상세 정보 요청에 version_id 매개변수를 사용하세요.

무료 경제 캘린더 API가 있나요?

네. 모든 Narwhal 계정은 매월 10달러의 무료 크레딧을 받으며 카드가 필요 없고 기한도 없습니다. 캘린더 요청은 1회 호출이며 1,000회당 2달러이므로 무료 크레딧으로 월 5,000회를 쓸 수 있습니다.

캘린더에 컨센서스 전망이 있나요?

네. 외부 캘린더에 전망이 있을 때만 제공됩니다. 값에는 이전값 옆에 컨센서스가 붙고, 발표 후에는 실제값이 붙습니다. 컨센서스는 공표된 수치가 아니라 전망이며, 알려진 것이 없으면 빠집니다. 중요도 등급은 없습니다.

발표 시각은 어느 시간대인가요?

정확한 발표 시각(at 필드)은 UTC입니다. timezone 필드에는 발표 기관의 IANA 시간대(예: Asia/Jakarta)가 들어 있어 현지 시각으로 표시할 수 있습니다. 날짜만 있는 발표에는 시각이 없습니다.

캘린더는 이력을 얼마나 반환하나요?

한 번의 요청은 최대 366일 구간을 다룹니다. 기본값은 오늘 30일 전부터 335일 후까지입니다. 더 긴 범위는 구간별로 나누어 가져오세요. 내용이 바뀐 발표는 이전 버전을 유지하며 version_id로 읽습니다.

캘린더를 ICS 피드로 받을 수 있나요?

네. 캘린더 구독을 만들면 캘린더 앱이 구독할 수 있는 비공개 .ics 링크가 반환됩니다. 발표, 공휴일 또는 둘 다를 1~50개국, 최대 366일 구간으로 담을 수 있습니다. 만드는 데 1회 호출이 듭니다.

AI 에이전트가 MCP로 캘린더를 읽을 수 있나요?

네. Narwhal MCP 서버에는 economics_list_releases와 economics_get_release가 있으며, REST 엔드포인트와 같은 두 가지 작업입니다.

속도 제한은 어떻게 되나요?

무료 크레딧만 있는 계정은 분당 50회, 유료 크레딧이 있으면 분당 500회입니다. 하나의 네트워크 주소는 분당 120회로 제한됩니다. 429 응답에는 Retry-After가 포함되며 비용이 들지 않습니다.

데이터를 쓰기 전에 무엇을 확인해야 하나요?

발표 일정은 정확히 그 시각에 공표된다는 보장이 아닙니다. 시점의 정밀도와 시간대를 보존하고 취소된 발표를 명시적으로 처리하세요. 예정된 발표 시각과 Narwhal이 발표를 확인한 시각은 서로 다른 사건을 나타냅니다.