所有 API

节假日 API

通过 REST 或 MCP 按国家和年份获取节假日。按国家和区域范围查询某个日期或查找下一个假日。

首次请求

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"
  }
}

日历订阅

通过 Narwhal API，为团队选定的国家和日期范围创建可订阅的 ICS 订阅源。可根据现有覆盖范围，选择包含节假日、经济数据发布日期或两者。订阅源可用于 Google 日历、Apple 日历、Outlook 等日历客户端。

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": "example-subscription",
  "url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
  "expires_at": "2026-12-31T23:59:59Z",
  "refresh_note": "calendar clients control refresh latency"
}