Use holidays, economic release calendars, country indicators and FX through one Narwhal account. REST and hosted MCP share the monthly quota, letting application code and agents use the same data. Nager.Date offers a free hosted public holiday API without an API key.
Choose Narwhal when holidays are part of a wider economics or FX workflow, with year, date and next-holiday operations alongside hosted MCP access.
The prices compare hosted holiday requests; offline Nager.Date products use separate sponsor licences.
| Requirement | Narwhal API | Nager.Date |
|---|---|---|
| Free tier | ✓ 3,000 requests/month | ✓ No key; no rate limits advertised |
| Cheapest paid plan | Basic: $60/month; $600/year available | Not published |
| Update speed | Dataset schedule; timestamps retained | Not published |
| History | Free: 12 months; Basic: 5 years; available records only | Year-based queries; depth not published |
| Coverage | Economics, FX, holidays and published commodities | 200+ countries |
| Interfaces | REST and MCP; WebSocket not published | REST; WebSocket and MCP not published |
| SDKs | Not published | Offline NuGet requires sponsor key |
| Commercial use on free tier | ✓ Commercial apps; resale needs Enterprise | MIT code; API data terms not published here |
The hosted public API is free; offline products use separate sponsor licences.
| Requests per month | Narwhal API | Nager.Date |
|---|---|---|
| 1,000 | Free: $0/month | Public API: $0 |
| 10,000 | Basic: $60/month | Public API: $0 |
| 100,000 | Basic: $60/month | Public API: $0 |
List US public holidays in 2026
# Change: URL
curl \
"https://nagerholidays.com/api/v4/Holidays/US/2026"# 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 Free includes 3,000 successful requests each month and permits commercial apps. Use that allowance for a dashboard, scheduled data fetches or an agent integration. Move to Basic for 100,000 monthly requests as usage grows, with the same account and authentication.
REST and hosted MCP reach the same data through one account. Your application can fetch JSON while an agent uses the hosted tools, with every successful call counted once against the shared allowance. One quota makes the combined workload straightforward to budget.
Narwhal publishes holidays for 37 countries. Fetch a whole year, look up a date or find the next holiday through three documented operations. Add economic release dates and FX to the same workflow, using one account for both your scheduling logic and country data.
Nager.Date is the better pick for a straightforward holiday application that needs no account or key. Its hosted API covers more than 200 countries and advertises no rate limits, making it a strong free option for holiday-only lookups. Browser access is supported. Its offline Docker and NuGet products use sponsor licence keys, so self-hosting or offline execution follows a separate access model from the free public endpoint.
Yes. Narwhal Free includes 3,000 successful requests per month, commercial app use and both REST and hosted MCP access. The allowance combines holiday lookups with country economics, FX and release calendars.
Nager.Date's hosted public API needs no key. Its Docker image and offline NuGet package require a sponsor licence key, while the project code uses the MIT licence. Hosted API requests and offline execution are separate products, so the zero-dollar request prices above describe the hosted service.
Replace the request URL and authentication, then map the JSON response into your application's fields. The examples use standard fetch in JavaScript and requests in Python, so integration fits an ordinary HTTP client. Keep your key on the server and carry the response's units, dates and missing values into your display or calculations.
The shared cap applies to successful REST and MCP requests together. There are no automatic overage charges. Basic includes 100,000 monthly requests; quotas reset each month even when you pay yearly.
The comparison uses Narwhal's current public contract and the following first-party competitor pages.
Reviewed: