已發布的假日
官方行事曆保留全國與地區的適用範圍、實際放假日期及來源定義。
閱讀方法說明 →所有 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",
"from_date": "2026-08-01",
"coverage": [
{
"scope": "national_public",
"nationwide": true,
"subdivision_codes": []
},
{
"scope": "collective_leave",
"nationwide": true,
"subdivision_codes": []
}
],
"holiday": {
"date": "2026-08-17",
"name": "Independence Day",
"local_name": "Hari Kemerdekaan",
"subdivision_codes": [],
"nationwide": true,
"observed": null,
"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}
國定假日與財經日曆訂閱來源
POST使用 Narwhal API 金鑰建立訂閱，即可取得僅回傳一次的 ICS 訂閱來源 URL。/v1/calendars/subscriptions
GET取得 ICS 訂閱來源。/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
KOR
RUS
SAU
SGP
TUR
EST
IRL
LVA
LTU
USA
ZAF
POL
CZE
SVN
HRV
PRT
AUT
BEL
COL
DNK
ESP
LUX
NOR
SVK
SWE
PHL探索相關頁面
常見問題
我可以將這些日期加入行事曆嗎？
建立行事曆訂閱，即可取得提供國定假日、經濟數據發布或兩者資訊的可撤銷 ICS 訂閱來源。
每次經濟數據發布都有確切時間嗎？
不一定。時程會保留發布機構所提供的時間精確程度，不會自行編造時間。