Your reliable source for financial date calculations: business days, holiday lookups, and settlement date logic across various global market calendars.
Get Started NowThis API provides programmatic access to essential financial calendar functions, simplifying tasks such as:
All endpoints are hosted at: https://fincalapi.com
Explore the core functionalities of the Financial Calendar API:
/todayReturns holiday and trading status across all (or one) supported calendars for today or a specified date.
/announcementsReturns recent FinCal API updates: newly added calendars, data corrections, and new endpoint announcements.
/calendarsLists all supported calendar codes with display name, country, timezone, region, and holiday count.
/upcomingReturns upcoming holidays and early-close events across all or a specific calendar for a configurable look-ahead window.
/endpointsComplete human-readable reference listing all public FinCal API endpoints with descriptions, parameters, and live examples.
View All Endpoints →/day_statusProvides a comprehensive status for a given date, indicating if it's a holiday, weekend, early close, and its closing time.
View Details & Examples →/is_early_closeDetermines if a given date is an early close day for a specified calendar, also providing the closing time.
View Details & Examples →/settlement_dateCalculates the T+N settlement date based on a base date and a specified financial calendar.
View Details & Examples →/holidays/rangeRetrieves a list of holidays within a specified date range for a chosen calendar.
View Details & Examples →/next_n_holidaysFetches the next 'N' upcoming holidays for a given calendar from a specified start date.
View Details & Examples →/previous_business_dayGets the closest previous business day for a specified date and calendar.
View Details & Examples →/next_business_dayGets the closest next business day for a given date and calendar.
View Details & Examples →/next_settlement_dateFinds the next valid settlement date after a given base date.
View Details & Examples →/is_valid_settlement_dateChecks if a specified date is considered a valid settlement date for a given calendar.
View Details & Examples →/is_holidayA simpler check to determine if a date is a holiday on the specified calendar (returns boolean).
View Details & Examples →The API supports various financial market holiday calendars:
Securities Industry and Financial Markets Association (U.S.) calendar.
View Details & Examples →Securities Industry and Financial Markets Association (U.K.) calendar.
View Details & Examples →Securities Industry and Financial Markets Association (Japan) calendar.
View Details & Examples →NYSE American (AMEX) equity market holiday calendar (shares NYSE schedule).
View Details & Examples →The API is designed for easy integration into various platforms:
Leverage WEBSERVICE for direct data retrieval.
Automate complex date calculations within Excel.
Use IMPORTDATA for seamless integration with your sheets.
Access data programmatically using the requests library.
For legacy Excel support, refer to the Legacy Web Query Guide.
The Financial Calendar API is currently free for all users for basic and testing needs.
No hidden fees, just straightforward access to robust financial date calculations.
Use the API right away — no installation, just a quick and easy registration to get your API key for basic usage. No marketing emails, no spam.
Try a Sample Request