Narwhal API vs Calendarific

Connect public holidays to economic releases, country indicators and FX through Narwhal's REST and hosted MCP interfaces. One account covers the whole workflow. Calendarific specializes in holiday data, with national and regional coverage and plan-specific update schedules.

Decision

Choose Narwhal for public holidays alongside country economics and release calendars, with a free commercial allowance shared by your application and agent.

At a glance

The example uses Calendarific's national-holiday filter and Narwhal's US country-year route.

RequirementNarwhal APICalendarific
Free tier✓ 3,000 requests/month✓ 500 calls/month; attribution
Cheapest paid planBasic: $60/month; $600/year availableStarter: $12/month; $100/year available
Update speedDataset schedule; timestamps retainedFree: quarterly; Enterprise: daily
HistoryFree: 12 months; Basic: 5 years; available records onlyFree: limited past and future years
CoverageEconomics, FX, holidays and published commodities230+ countries and 3,300+ regions
InterfacesREST and MCP; WebSocket not publishedREST; WebSocket and MCP not published
SDKsNot publishedNot published
Commercial use on free tier✓ Commercial apps; resale needs EnterpriseNot published; free attribution required

Price at your usage

Starter offers monthly billing; Enterprise requires annual payment and covers 50 million monthly calls.

Requests per monthNarwhal APICalendarific
1,000Free: $0/monthStarter: $12/month
10,000Basic: $60/monthStarter: $12/month
100,000Basic: $60/monthEnterprise: $4,000/year

Switch in a few minutes

List US public holidays in 2026

Calendarific

# Change: URL and key
curl --get \
  "https://calendarific.com/api/v2/holidays" \
  --data-urlencode "api_key=YOUR_API_KEY" \
  --data-urlencode "country=US" \
  --data-urlencode "year=2026" \
  --data-urlencode "type=national"

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"

Why teams switch

Start building for free

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.

Connect your app and your agent

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.

Keep calendar jobs together

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.

When they are the better pick

Calendarific is the better pick for holiday coverage across more than 230 countries and 3,300 regions. Its catalogue includes national holidays, local observances and religious holidays, with filters for narrowing the results. Starter removes attribution and includes complete historical and upcoming data. Enterprise adds daily updates. That range suits products built primarily around regional holiday information, particularly when coverage breadth is the deciding factor.

Questions

Is there a free Calendarific alternative?

Yes. Narwhal Free includes 3,000 successful requests per month, commercial app use and both REST and hosted MCP access. Use public holidays alongside economic release schedules and FX in one application.

How do updates and attribution differ by plan?

Calendarific lists quarterly dataset updates on Free and Starter, weekly updates on Business and daily updates on Enterprise. Starter removes the attribution requirement and includes 10,000 monthly calls. It costs $12 with monthly billing or $100 paid annually; Enterprise is billed annually and includes 50 million monthly calls.

What changes in my application?

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.

What happens at Narwhal's monthly limit?

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.

Test Narwhal with the same job

Check the published coverage, inspect the response contract, and make a first request before choosing a provider.