已发布的假日
官方日历保留全国和地区适用范围、实际休假日期以及来源定义。
阅读方法说明 →所有 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
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
TWN
PHL探索相关页面
常见问题
我可以将这些日期添加到日历吗？
创建日历订阅，即可获得包含节假日、经济数据发布或两者的可撤销 ICS 订阅源。
每次经济数据发布都有确切时间吗？
不一定。日程会保留发布机构给出的时间精度，不会编造时间。