一目了然
与这个本地库涵盖 207 个国家的目录相比，Narwhal 的节假日覆盖范围较小且较新。Narwhal API 由 Nusantara Ventures, LLC 拥有并运营。
| 需求 | Narwhal API | date-holidays |
|---|---|---|
| 免费额度 | ✓ 12 个月内每月 $10 免费额度，无需绑卡 | ✓ 免费本地库，无请求限制 |
| 最低价付费方案 | $20 起充值，每 1,000 次调用 $2 至 $10 | 没有付费套餐 |
| 更新速度 | 按数据集的更新计划，保留时间戳 | 需要自行更新软件包 |
| 历史 | 所有账户均可获取完整历史，仅限可用记录 | 计算得出的伊斯兰历日期：1970 至 2080 年 |
| 覆盖范围 | 经济数据、汇率、节假日及已公布的大宗商品数据 | 207 个国家（含行政区划） |
| 接口 | REST 和 MCP；WebSocket 未公布 | 本地 JavaScript；无 REST、WebSocket 或 MCP |
| SDK 支持 | ✓ 官方 Python 和 TypeScript SDK | ✓ 该库是 npm 包 |
| 免费额度的商业使用 | ✓ 可用于商业应用，转售需定制协议 | ✓ 代码采用 ISC；数据采用 CC BY-SA 3.0 |
按用量计价
本地运行不产生请求费用；托管、更新以及数据的署名和相同方式共享义务由你自行管理。
| 每月请求数 | Narwhal API | date-holidays |
|---|---|---|
| 1,000 | 按每 1,000 次调用 $2 计，共 $2.00 | 本地库：$0 |
| 10,000 | 按每 1,000 次调用 $2 计，共 $20.00 | 本地库：$0 |
| 100,000 | 按每 1,000 次调用 $2 计，共 $200.00 | 本地库：$0 |
几分钟即可切换
列出 2026 年美国公共假日
date-holidays
date-holidays 是作为本地 JavaScript 库运行，而不是 HTTP API，因此没有对方的请求示例。
Narwhal API
# Change: URL and key
url="https://api.narwhalapi.com"
url="$url/v1/calendars/holidays/USA/2026"
curl \
"$url" \
-H "Authorization: Bearer YOUR_API_KEY"团队为何切换
免费开始构建
每个 Narwhal 账户都可获得 12 个月、每月 $10 的免费额度，并允许商业应用使用。可以用这笔额度做仪表板、定时数据抓取或智能体集成。用量增长后可从 $20 起追加充值，账户和认证方式保持不变。
连接你的应用和智能体
REST 和托管 MCP 通过同一个账户访问相同的数据。应用可以获取 JSON，智能体则使用托管工具，每次调用只从共享额度余额中扣费一次。只有一个余额，合并后的整体用量也便于做预算。
把日历类任务放在一起
Narwhal 提供 48 个国家的节假日数据。通过三个有文档的操作，可以获取整年的假日、查询某个日期，或查找下一个假日。再把经济数据发布日期和汇率加入同一工作流，调度逻辑和国别数据就能共用一个账户。
对方更合适的情形
date-holidays 适合需要在不进行网络调用的情况下覆盖大量国家和行政区划的离线 JavaScript 应用。它列出 207 个国家，在本地运行，没有请求限制，也没有订阅费用。托管和更新由你自行管理。代码采用 ISC 许可，数据采用 CC BY-SA 3.0，需要署名并遵守相同方式共享的义务。数据部分来自 Wikipedia 而非官方公报，且计算得出的伊斯兰历日期可能与实际观月结果不同。
常见问题
有免费的 date-holidays 替代方案吗？
有。Narwhal 为每个账户在 12 个月内每月提供 $10 的免费额度，允许商业应用使用，并同时支持 REST 和托管 MCP 访问。Narwhal 2026 年覆盖 37 个国家，2027 年覆盖 31 个国家，采用政府官方来源，由其托管运营，并共用一个额度余额。
date-holidays 的数据来源和伊斯兰历日期有何不同？
date-holidays 部分使用 Wikipedia，而不是仅依赖政府官方发布。其伊斯兰历日期是按 1970 至 2080 年计算得出的，可能与实际观月结果不同。Narwhal 对其范围较小、较新的国家和年份使用政府官方来源。
我的应用需要改什么？
替换请求 URL 和认证方式，再把 JSON 响应映射到应用的字段即可。示例使用 JavaScript 的标准 fetch 和 Python 的 requests，因此普通的 HTTP 客户端就能完成集成。请把密钥保存在服务端，并在展示或计算中保留响应里的单位、日期和缺失值。
Narwhal 额度用完会怎样？
额度余额由 REST 和 MCP 调用共用。余额为零时，API 会返回 HTTP 402 `insufficient_credits`，且不会向你收取超出余额的费用。免费额度不会结转，付费额度在最后一次充值 12 个月后过期。
已审核: