TradingHours.com API Reference

# Regional & Religious Holidays

# Regional & Religious Holidays Endpoint

Market holidays often differ from public holidays. For example, most US markets close for Good Friday, but Good Friday is not officially a public holiday. In other cases, markets may be open despite public or religious holidays.

Regional and religious holidays can impact trading activity; namely, trading volume may be lower during a holiday even when markets are officially open.

For these reasons, TradingHours.com provides regional and religious holidays in addition to market holidays.

# List Calendars

To get the information on regional and religious holidays, you'll first need to enumerate the calendars available. There are calendars specifically for countries and major religions.

# Schema

Field Format Description
id String The identifier used for a specific calendar. For countries we use the 2-letter country code.
name String Full name of the country or religion.
type String Either "regional" or "religious."

# Query String Parameters

Supported query string parameters are listed in the table below:

Parameter Supported Values Default Description
format CSV, JSON JSON Specify output format

# Example

Remember to use your authentication token for all requests.

# List All Calendars

https://api.tradinghours.com/v3/calendars

# List All Markets in CSV Format

https://api.tradinghours.com/v3/calendars?format=csv

# Sample JSON Response

{
    "data": {
        "AF": {
            "id": "AF",
            "name": "Afghanistan",
            "type": "regional"
        },
        "AL": {
            "id": "AL",
            "name": "Albania",
            "type": "regional"
        },
        ...
        "ZW": {
            "id": "ZW",
            "name": "Zimbabwe",
            "type": "regional"
        },
        "Christian": {
            "id": "Christian",
            "name": "Christian",
            "type": "religious"
        },
        "Jewish": {
            "id": "Jewish",
            "name": "Jewish",
            "type": "religious"
        },
        ...
    }
}

# Get Holidays

Once you find the calendar you are looking for, you can lookup the events on that calendar within a specific date range.

# Schema

Field Format Description
calendar String Calendar identifier.
country String Full name of the country, if applicable.
date Date Shows the date of the holiday.
name String Name of the holiday.
type String Either Public, Religious, or Other. Other is used for unofficial holidays.
description String Additional information if required.

# Query String Parameters

Supported query string parameters are listed in the table below:

Parameter Supported Values Default Description
calendar Valid Calendar ID N/A Specify which calendar to show data for.
format CSV, JSON JSON Specify output format
start yyyy-mm-dd Current date Show holidays starting at this date
end yyyy-mm-dd One year from current date Show holidays until this date.

# Examples

Remember to use your authentication token for all requests.

# Get Holidays

https://api.tradinghours.com/v3/calendars/holidays?calendar=US

# Get Holidays in CSV Format

https://api.tradinghours.com/v3/calendars/holidays?calendar=US&format=csv

# Get Holidays in a Date Range

https://api.tradinghours.com/v3/calendars/holidays?calendars=US&start=2022-11-01&end=2022-11-30

# Sample JSON Response

{
	"data": [
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-09-06",
			"name": "Labor Day",
			"type": "Public",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-09-15",
			"name": "First Day of Hispanic Heritage Month",
			"type": "Other",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-10-11",
			"name": "Columbus Day",
			"type": "Public",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-10-11",
			"name": "Indigenous Peoples' Day",
			"type": "Other",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-10-31",
			"name": "Halloween",
			"type": "Other",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-02",
			"name": "Election Day",
			"type": "Other",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-07",
			"name": "Daylight Saving Time ends",
			"type": "Other",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-11",
			"name": "Veterans Day",
			"type": "Public",
			"description": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-25",
			"name": "Thanksgiving Day",
			"type": "Public",
			"description": null
		},
		...
	],
	"meta": {
		"start": "2021-08-09",
		"end": "2022-08-09"
	}
}

← Data Downloads →