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

FieldFormatDescription
idStringThe identifier used for a specific calendar. For countries we use the 2-letter country code.
nameStringFull name of the country or religion.
typeStringEither "regional" or "religious."

Query String Parameters

Supported query string parameters are listed in the table below:

ParameterSupported ValuesDefaultDescription
formatCSV, JSONJSONSpecify 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

FieldFormatDescription
calendarStringCalendar identifier.
countryStringFull name of the country, if applicable.
dateDateShows the date of the holiday.
nameStringName of the holiday.
typeStringEither Public, Religious, or Other. Other is used for unofficial holidays.
memoStringAdditional information if required.

Query String Parameters

Supported query string parameters are listed in the table below:

ParameterSupported ValuesDefaultDescription
calendarValid Calendar IDN/ASpecify which calendar to show data for.
formatCSV, JSONJSONSpecify output format
startyyyy-mm-ddCurrent dateShow holidays starting at this date
endyyyy-mm-ddOne year from current dateShow 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",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-09-15",
			"name": "First Day of Hispanic Heritage Month",
			"type": "Other",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-10-11",
			"name": "Columbus Day",
			"type": "Public",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-10-11",
			"name": "Indigenous Peoples' Day",
			"type": "Other",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-10-31",
			"name": "Halloween",
			"type": "Other",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-02",
			"name": "Election Day",
			"type": "Other",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-07",
			"name": "Daylight Saving Time ends",
			"type": "Other",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-11",
			"name": "Veterans Day",
			"type": "Public",
			"memo": null
		},
		{
			"calendar": "US",
			"country": "United States",
			"date": "2021-11-25",
			"name": "Thanksgiving Day",
			"type": "Public",
			"memo": null
		},
		...
	],
	"meta": {
		"start": "2021-08-09",
		"end": "2022-08-09"
	}
}