getHolidays API

The getHolidays API provides a comprehensive list of market holidays for specified stock exchanges, such as Nasdaq and NYSE, enabling users to align trading strategies and applications with market closures. It delivers structured holiday data, including dates and names, in JSON format.

Access Market Holiday Schedules by Exchange

This API is ideal for developers building trading platforms, financial calendars, or compliance tools, supporting use cases like integrating holiday data into trading calendars, adjusting algorithmic trading strategies, ensuring compliance with market closure dates, aligning portfolio management updates, and notifying users of upcoming closures. Additionally, it enables AI-driven applications, such as predictive trading models that factor in market holidays for better forecasting and compliance systems that automatically validate trading schedules against regulatory requirements.

Key Features

  • 📅 Exchange-Specific Holiday Data - Retrieve holiday schedules for specific exchanges like Nasdaq or NYSE.
    Users can specify an exchangeId, such as 537 for Nasdaq UTP Delayed, to access a complete list of holidays for that exchange. This feature ensures developers can tailor applications to account for market-specific closures, critical for accurate trading and scheduling tools.

  • 📋 Structured Holiday Output - Receive clear, consistent holiday data in JSON format.
    Each response includes an array of holiday objects with date and name fields, making it easy to parse and display in calendars, trading platforms, or compliance dashboards. This structured format simplifies integration and enhances user experience.

  • 🌐 Support for Multiple Exchanges - Access holiday data across various global exchanges.
    By specifying different exchange IDs, users can retrieve holiday schedules for multiple markets in a single API, streamlining workflows for applications that monitor or operate across diverse exchanges, such as portfolio management tools.

  • 🔐 Secure Authentication - Access data with a Base64-encoded application key.
    The API requires a T parameter for secure authentication, ensuring only authorized users can retrieve holiday data. This allows developers to confidently integrate the API into production systems, safeguarding sensitive financial applications.

Available Data Fields

Each API call returns a collection of market holidays with the following fields:

Field Meaning Data Type
date Date of Holiday Date String (YYYY-MM-DD)
name Name of Holiday String

Query Parameters

The API accepts the following parameters to customize your request:

Parameter Meaning Data Type
T Application Key which authenticates you with CloudQuote (required) Base64 string
exchangeId The ID # of the exchange you are requesting data for Number

Popular Exchanges:

  • 537 = Nasdaq UTP Delayed
  • 321 = NYSE Consolidated Tape Delayed

Use Cases

  • 📆 Trading Calendar Integration - Build accurate financial calendars with market holiday data.
    Developers can use holiday data to populate calendars in trading platforms, ensuring users are aware of market closures. This helps traders plan activities and avoid scheduling trades on non-operational days, enhancing platform reliability.

  • 🤖 Algorithmic Trading Adjustments - Adjust trading algorithms to account for market holidays.
    By integrating holiday schedules, developers can program algorithms to pause or adjust strategies during exchange closures, preventing erroneous trades. This is crucial for automated systems relying on precise market availability.

  • 🔍 Compliance and Reporting Tools - Ensure regulatory compliance with accurate holiday data.
    Financial institutions can use the API to verify market closure dates for compliance reporting or audit trails, ensuring adherence to regulatory requirements. The structured data simplifies integration into compliance dashboards.

  • 📊 Portfolio Management Systems - Align portfolio updates with market schedules.
    Portfolio managers can retrieve holiday data to schedule rebalancing or performance reviews around market availability, ensuring accurate calculations and timely updates. This supports efficient portfolio oversight across multiple exchanges.

  • 🔔 User Notifications - Notify users of upcoming market closures.
    Applications can leverage holiday data to send alerts or reminders about exchange closures, improving user experience on financial apps or investor portals. This keeps users informed and engaged with market schedules.

Why Choose FinancialContent's getHolidays API?

  • 🚀 High Reliability - Dependable data delivery for critical applications.
    With 99.99% uptime, the API ensures consistent access to holiday schedules, even during high-demand periods. Developers can trust it for applications where timing and accuracy are paramount.

  • 🔄 Seamless Integration - Easily combine with other FinancialContent APIs.
    The API integrates smoothly with other FinancialContent data feeds, allowing developers to build comprehensive solutions that combine holiday schedules with price or tick data, perfect for holistic financial platforms.

  • 📈 Scalable Across Exchanges - Support for multiple exchange holiday schedules.
    Designed to handle queries for various exchanges, the API scales effortlessly to provide holiday data for global markets, making it ideal for applications targeting diverse financial ecosystems.

  • 📚 Developer-Friendly Support - Robust documentation and dedicated assistance.
    FinancialContent offers detailed API documentation, sample code, and responsive support to ensure smooth integration. Our team helps developers at every step, from setup to advanced use cases.

Optimized for High-Speed Access

The getHolidays API is built for performance, adhering to industry best practices for fast and reliable data delivery. Its RESTful endpoints use lightweight JSON formatting to minimize payload size, enabling quick parsing and efficient bandwidth usage. Global edge servers reduce latency for users worldwide, while caching strategies accelerate repeated queries. Rate limiting and pagination ensure stability under high traffic, and asynchronous request handling supports efficient processing of large exchange datasets. This performance-driven design allows developers to create responsive applications with minimal delays.

Sample Request

GET /api/fcon/getHolidays?T=your_base64_key&exchangeId=537

Sample Response (JSON)

{
  "rows": [
    {
      "date": "2025-01-01",
      "name": "New Year's Day"
    },
    {
      "date": "2025-07-04",
      "name": "Independence Day"
    },
    ...
  ]
}

About the Vendor

FinancialContent is one of the largest providers of stock market data, business news and content syndication tools for online publishers