TradingHours.com API Reference

# Market Holidays

# Market Holidays Endpoint

This API allows you to easily access past and future holiday calendars for all markets.

Note

Market Holidays API endpoint is not available on all plans. Contact our team for more details.

Notice

Unlike other API endpoint, the market holidays endpoint does not support multiple FinIDs.

# Examples

https://api.tradinghours.com/v3/markets/holidays?fin_id=us.nyse

https://api.tradinghours.com/v3/markets/holidays?fin_id=us.nyse&format=csv

https://api.tradinghours.com/v3/markets/holidays?fin_id=us.nyse&start=2020-11-01&end=2020-11-30

# Response

{
    "data": [
        {
            "fin_id": "US.NYSE",
            "date": "2020-01-01",
            "name": "New Year's Day",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-01-20",
            "name": "Birthday of Martin Luther King, Jr",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-02-17",
            "name": "Washington's Birthday",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-04-10",
            "name": "Good Friday",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-05-25",
            "name": "Memorial Day",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-07-03",
            "name": "Independence Day",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": "Yes",
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-09-07",
            "name": "Labor Day",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-11-26",
            "name": "Thanksgiving Day",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-11-27",
            "name": "Market Holiday",
            "schedule": "Partial",
            "has_settlement": "Yes",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-12-24",
            "name": "Christmas",
            "schedule": "Partial",
            "has_settlement": "Yes",
            "observed": "Yes",
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2020-12-25",
            "name": "Christmas",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        },
        {
            "fin_id": "US.NYSE",
            "date": "2021-01-01",
            "name": "New Year's Day",
            "schedule": "Closed",
            "has_settlement": "No",
            "observed": null,
            "memo": null
        }
    ],
    "meta": {
        "start": "2020-01-01",
        "end": "2021-01-01"
    }
}

← Data Downloads →