게시된 공휴일
공식 캘린더는 전국·지역별 적용 범위, 실제 휴일 적용일 및 출처의 정의를 유지합니다.
방법론 읽기 →모든 API
날짜 및 캘린더 API
공휴일, 경제 지표 발표 일정 및 구독 캘린더입니다.
첫 요청
빠른 시작 →curl --request GET \
--url "https://api.narwhalapi.com/v1/calendars/holidays/IDN/next?from_date=2026-08-01" \
--header "Authorization: Bearer $NARWHAL_API_KEY"응답 예시 예시 응답 · 실제 요청 아님
{
"country": "IDN",
"coverage": [
{
"scope": "collective_leave",
"subdivision_codes": []
},
{
"scope": "national_public",
"subdivision_codes": []
}
],
"holiday": {
"date": "2026-08-17",
"name": "Independence Day",
"local_name": "Proklamasi Kemerdekaan",
"subdivision_codes": [],
"scope": "national_public"
}
}엔드포인트
공휴일 API
GET공개된 특정 연도의 공휴일 목록을 조회합니다./v1/calendars/holidays/{country}/{year}
GET특정 날짜의 공휴일을 찾습니다./v1/calendars/holidays/{country}/on/{date}
GET다음 공휴일을 찾습니다./v1/calendars/holidays/{country}/next
경제 캘린더 API
GET지정한 날짜 범위의 경제 지표 발표 목록을 조회합니다./v1/economics/calendar
GET경제 지표 발표 정보를 조회합니다. 필요하면 version_id를 지정할 수 있습니다./v1/economics/calendar/{release_id}
공휴일과 경제 지표 발표 캘린더 피드
POSTNarwhal API 키로 구독을 생성하면 ICS 피드 URL이 한 번만 반환됩니다./v1/calendars/subscriptions
GETICS 피드를 가져옵니다./v1/calendars/subscriptions/{token}.ics
DELETE구독을 취소합니다./v1/calendars/subscriptions/{subscription_id}
출처 및 방법론
발표 일정
경제 지표 발표에는 기준 기간, 공표 상태, 시간대 및 일정의 상세 수준이 유지됩니다.
캘린더 구독
취소 가능한 ICS 피드가 선택한 이벤트를 전달하며, 새로 고침 시점은 캘린더 클라이언트가 제어합니다.
데이터 범위
데이터 범위 보기 →공휴일 데이터 범위는 국가 및 연도별로 공개됩니다. 발표 일정에는 정확한 시각, 날짜, 기간 범위 또는 기한이 명시될 수 있습니다. 공휴일이라고 해서 은행이 휴무하거나 거래소가 휴장한다는 뜻은 아닙니다.
ARG
AUS
BRA
CAN
CHN
DEU
FRA
GBR
HKG
IDN
ITA
JPN
IND
MEX
NLD
NZL
RUS
SAU
SGP
TUR
EST
IRL
LVA
LTU
USA
ZAF
POL
CZE
SVN
HRV
PRT
AUT
BEL
COL
DNK
ESP
LUX
NOR
SVK
SWE
TWN
PHL관련 페이지 둘러보기
자주 묻는 질문
이 날짜를 캘린더에 추가할 수 있나요?
캘린더 구독을 만들어 공휴일, 경제 지표 발표 또는 둘 모두에 대한 취소 가능한 ICS 피드를 받으세요.
모든 경제 지표 발표에 정확한 시각이 정해져 있나요?
아니요. 임의의 시각을 지정하지 않고 발표 기관이 명시한 일정의 상세 수준을 그대로 유지합니다.