---
title: "경제 캘린더 API | Narwhal API"
description: "예정된 GDP, 물가, 노동, 무역 및 수익률 곡선 관련 발표와 각각의 공표 상태를 추적하세요. 일정이 불확실한 발표는 확정된 정확한 시각처럼 표시하거나 취급하지 않습니다."
url: "https://narwhalapi.com/ko/api/economic-calendar"
---

모든 API

# 경제 캘린더 API

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

[무료 API 키 받기](https://narwhalapi.com/ko/signup)
[문서 읽기 →](https://narwhalapi.com/ko/docs/api/economic-calendar.md)

## 첫 요청

### 한 달의 발표 목록

```
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` 배열 발표된 수치입니다. 발표 전에는 배열이 비어 있습니다.

---

[전체 레퍼런스 →](https://narwhalapi.com/ko/docs/api/economic-calendar.md)

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` 배열 발표된 수치입니다. 발표 전에는 배열이 비어 있습니다.

---

[전체 레퍼런스 →](https://narwhalapi.com/ko/docs/api/economic-calendar.md)

## 활용 사례

### 다음 CPI 발표일

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

[가이드 읽기 →](https://narwhalapi.com/ko/how-to/find-the-next-cpi-release-date.md)

### 경제 캘린더

선택한 국가와 날짜의 발표 캘린더를 만듭니다.

[가이드 읽기 →](https://narwhalapi.com/ko/how-to/build-an-economic-calendar.md)

### 발표 전 알림

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

[가이드 읽기 →](https://narwhalapi.com/ko/how-to/get-an-alert-before-an-economic-release.md)

### 내 시간대의 발표 시각

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

[가이드 읽기 →](https://narwhalapi.com/ko/how-to/convert-a-release-time-to-your-time-zone.md)

### FOMC 회의와 의사록

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

[가이드 읽기 →](https://narwhalapi.com/ko/how-to/find-fomc-meeting-dates-and-minutes.md)

### 중앙은행 회의

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

[가이드 읽기 →](https://narwhalapi.com/ko/how-to/list-all-central-bank-meetings.md)

## 데이터 범위

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

- 알바니아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/albania.md)
- 앙골라[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/angola.md)
- 아르헨티나[공식 일정](https://narwhalapi.com/ko/economics/calendar/argentina.md)
- 아르메니아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/armenia.md)
- 호주[공식 일정](https://narwhalapi.com/ko/economics/calendar/australia.md)
- 오스트리아[공식 일정](https://narwhalapi.com/ko/economics/calendar/austria.md)
- 아제르바이잔[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/azerbaijan.md)
- 바레인[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/bahrain.md)
- 방글라데시[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/bangladesh.md)
- 벨라루스[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/belarus.md)
- 벨기에[공식 일정](https://narwhalapi.com/ko/economics/calendar/belgium.md)
- 보스니아 헤르체고비나[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/bosnia-and-herzegovina.md)

114개 국가 모두 보기

- 보츠와나[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/botswana.md)
- 브라질[공식 일정](https://narwhalapi.com/ko/economics/calendar/brazil.md)
- 불가리아[공식 일정](https://narwhalapi.com/ko/economics/calendar/bulgaria.md)
- 카보베르데[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/cabo-verde.md)
- 캐나다[공식 일정](https://narwhalapi.com/ko/economics/calendar/canada.md)
- 칠레[공식 일정](https://narwhalapi.com/ko/economics/calendar/chile.md)
- 중국[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/china.md)
- 콜롬비아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/colombia.md)
- 코스타리카[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/costa-rica.md)
- 크로아티아[공식 일정](https://narwhalapi.com/ko/economics/calendar/croatia.md)
- 키프로스[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/cyprus.md)
- 체코[공식 일정](https://narwhalapi.com/ko/economics/calendar/czechia.md)
- 덴마크[공식 일정](https://narwhalapi.com/ko/economics/calendar/denmark.md)
- 도미니카 공화국[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/dominican-republic.md)
- 에콰도르[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/ecuador.md)
- 이집트[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/egypt.md)
- 엘살바도르[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/el-salvador.md)
- 에스토니아[공식 일정](https://narwhalapi.com/ko/economics/calendar/estonia.md)
- 에스와티니[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/eswatini.md)
- 유로 지역[공식 일정](https://narwhalapi.com/ko/economics/calendar/euro-area.md)
- 핀란드[공식 일정](https://narwhalapi.com/ko/economics/calendar/finland.md)
- 프랑스[공식 일정](https://narwhalapi.com/ko/economics/calendar/france.md)
- 조지아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/georgia.md)
- 독일[공식 일정](https://narwhalapi.com/ko/economics/calendar/germany.md)
- 가나[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/ghana.md)
- 그리스[공식 일정](https://narwhalapi.com/ko/economics/calendar/greece.md)
- 과테말라[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/guatemala.md)
- 홍콩[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/hong-kong.md)
- 헝가리[공식 일정](https://narwhalapi.com/ko/economics/calendar/hungary.md)
- 아이슬란드[공식 일정](https://narwhalapi.com/ko/economics/calendar/iceland.md)
- 인도[공식 일정](https://narwhalapi.com/ko/economics/calendar/india.md)
- 인도네시아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/indonesia.md)
- 아일랜드[공식 일정](https://narwhalapi.com/ko/economics/calendar/ireland.md)
- 이스라엘[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/israel.md)
- 이탈리아[공식 일정](https://narwhalapi.com/ko/economics/calendar/italy.md)
- 자메이카[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/jamaica.md)
- 일본[공식 일정](https://narwhalapi.com/ko/economics/calendar/japan.md)
- 요르단[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/jordan.md)
- 카자흐스탄[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/kazakhstan.md)
- 케냐[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/kenya.md)
- 키르기스스탄[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/kyrgyzstan.md)
- 라트비아[공식 일정](https://narwhalapi.com/ko/economics/calendar/latvia.md)
- 레바논[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/lebanon.md)
- 레소토[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/lesotho.md)
- 리투아니아[공식 일정](https://narwhalapi.com/ko/economics/calendar/lithuania.md)
- 룩셈부르크[공식 일정](https://narwhalapi.com/ko/economics/calendar/luxembourg.md)
- 마카오[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/macao.md)
- 말라위[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/malawi.md)
- 말레이시아[공식 일정](https://narwhalapi.com/ko/economics/calendar/malaysia.md)
- 몰타[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/malta.md)
- 모리셔스[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/mauritius.md)
- 멕시코[공식 일정](https://narwhalapi.com/ko/economics/calendar/mexico.md)
- 몰도바[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/moldova.md)
- 몽골[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/mongolia.md)
- 몬테네그로[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/montenegro.md)
- 모로코[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/morocco.md)
- 모잠비크[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/mozambique.md)
- 나미비아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/namibia.md)
- 네덜란드[공식 일정](https://narwhalapi.com/ko/economics/calendar/netherlands.md)
- 뉴질랜드[공식 일정](https://narwhalapi.com/ko/economics/calendar/new-zealand.md)
- 나이지리아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/nigeria.md)
- 북마케도니아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/north-macedonia.md)
- 노르웨이[공식 일정](https://narwhalapi.com/ko/economics/calendar/norway.md)
- 오만[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/oman.md)
- 파키스탄[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/pakistan.md)
- 팔레스타인[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/palestine.md)
- 파푸아뉴기니[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/papua-new-guinea.md)
- 파라과이[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/paraguay.md)
- 페루[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/peru.md)
- 필리핀[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/philippines.md)
- 폴란드[공식 일정](https://narwhalapi.com/ko/economics/calendar/poland.md)
- 포르투갈[공식 일정](https://narwhalapi.com/ko/economics/calendar/portugal.md)
- 루마니아[공식 일정](https://narwhalapi.com/ko/economics/calendar/romania.md)
- 러시아[공식 일정](https://narwhalapi.com/ko/economics/calendar/russia.md)
- 르완다[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/rwanda.md)
- 사우디아라비아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/saudi-arabia.md)
- 세르비아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/serbia.md)
- 세이셸[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/seychelles.md)
- 싱가포르[공식 일정](https://narwhalapi.com/ko/economics/calendar/singapore.md)
- 슬로바키아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/slovakia.md)
- 슬로베니아[공식 일정](https://narwhalapi.com/ko/economics/calendar/slovenia.md)
- 남아프리카공화국[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/south-africa.md)
- 한국[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/south-korea.md)
- 스페인[공식 일정](https://narwhalapi.com/ko/economics/calendar/spain.md)
- 스리랑카[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/sri-lanka.md)
- 수리남[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/suriname.md)
- 스웨덴[공식 일정](https://narwhalapi.com/ko/economics/calendar/sweden.md)
- 스위스[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/switzerland.md)
- 대만[공식 일정](https://narwhalapi.com/ko/economics/calendar/taiwan.md)
- 태국[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/thailand.md)
- 튀니지[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/tunisia.md)
- 튀르키예[공식 일정](https://narwhalapi.com/ko/economics/calendar/turkey.md)
- 우간다[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/uganda.md)
- 우크라이나[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/ukraine.md)
- 아랍에미리트[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/united-arab-emirates.md)
- 영국[공식 일정](https://narwhalapi.com/ko/economics/calendar/united-kingdom.md)
- 미국[공식 일정](https://narwhalapi.com/ko/economics/calendar/united-states.md)
- 우루과이[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/uruguay.md)
- 우즈베키스탄[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/uzbekistan.md)
- 베트남[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/vietnam.md)
- 잠비아[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/zambia.md)
- 짐바브웨[참고용 날짜](https://narwhalapi.com/ko/economics/calendar/zimbabwe.md)

## 출처

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

- Instituto Nacional de Estadística y Censos (INDEC)아르헨티나
- Australian Bureau of Statistics (ABS)호주
- Statistics Austria 오스트리아
- Eurostat 7개국
- 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 탐색 →](https://narwhalapi.com/ko/api/calendars/holidays.md)

### 경제 데이터 API

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

[API 탐색 →](https://narwhalapi.com/ko/api/economics.md)

### 요금

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

[요금 보기 →](https://narwhalapi.com/ko/pricing.md)

## 자주 묻는 질문

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

아니요. 공표 기관이 날짜, 범위 또는 기한만 명시할 수도 있습니다. 응답은 최상위 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이 발표를 확인한 시각은 서로 다른 사건을 나타냅니다.

## 무료 키로 시작하세요

매달 10달러 상당의 무료 크레딧을 드립니다. 카드는 필요하지 않습니다.매달 10달러 상당의 무료 크레딧. 카드는 필요하지 않습니다.

[무료 API 키 받기](https://narwhalapi.com/ko/signup)
