Put public holidays, economic release dates and country indicators in one workflow with Narwhal. REST and hosted MCP share a single account and request allowance. HolidayAPI specializes in holiday data, with country, regional and language coverage organized into annual plans.
Choose Narwhal to combine public holidays with economic releases, country indicators and FX, using the same authentication and quota across application and agent requests.
The example retrieves US public holidays for 2026; HolidayAPI's paid plans use annual billing.
| Requirement | Narwhal API | HolidayAPI |
|---|---|---|
| Free tier | ✓ 3,000 requests/month | ✓ Free key; limit not published |
| Cheapest paid plan | Basic: $60/month; $600/year available | Countries: $249/year |
| Update speed | Dataset schedule; timestamps retained | Not published |
| History | Free: 12 months; Basic: 5 years; available records only | Paid: years 1 through 2050+ |
| Coverage | Economics, FX, holidays and published commodities | 250 countries; 3,680 subdivisions on higher plan |
| Interfaces | REST and MCP; WebSocket not published | REST; WebSocket and MCP not published |
| SDKs | Not published | ✓ Official Node library |
| Commercial use on free tier | ✓ Commercial apps; resale needs Enterprise | Not published; paid includes commercial use |
Countries includes one million monthly requests and commercial use, billed at $249 upfront annually.
| Requests per month | Narwhal API | HolidayAPI |
|---|---|---|
| 1,000 | Free: $0/month | Countries: $249/year |
| 10,000 | Basic: $60/month | Countries: $249/year |
| 100,000 | Basic: $60/month | Countries: $249/year |
List US public holidays in 2026
# Change: URL and key
curl --get \
"https://holidayapi.com/v1/holidays" \
--data-urlencode "key=YOUR_API_KEY" \
--data-urlencode "country=US" \
--data-urlencode "year=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.
HolidayAPI is the better pick for extensive regional or multilingual holiday coverage. Its Countries plan covers 250 countries and more than 100 languages, while States & Provinces adds 3,680 subdivisions. Both paid plans include commercial use and one million monthly requests without velocity throttling. If your product's main job is a localized holiday calendar across many regions, that specialist catalogue is a strong fit.
Yes. Narwhal Free includes 3,000 successful requests per month, commercial app use and both REST and hosted MCP access. The holiday API supports year, date and next-holiday lookups through the same account.
The $249 annual Countries plan includes one million requests each month, commercial use and holidays for years 1 through 2050+. Paid subscribers can store an offline copy while their subscription remains active. Its free plan limits offline storage to 24 hours; the published pricing does not state a free monthly request allowance.
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: