# Trading Hours

# Hours API

The trading hours endpoint allows you to see the full trading schedule for a market on a given day.

You can specify a particular date by passing the date query string parameter. The date format must be yyyy-mm-dd. If the date parameter is omitted then the current date is used.

Note

The Trading Hours endpoint is not available on all plans. Contact our team for more details.

Notice

Unlike other API endpoint, the trading hours endpoint does not support CSV format or multiple FinIDs. This is due to the nested structure of the API results.

# Examples

https://api.tradinghours.com/v3/markets/hours?fin_id=us.nyse
https://api.tradinghours.com/v3/markets/hours?fin_id=gb.lse
https://api.tradinghours.com/v3/markets/hours?fin_id=gb.lse&date=2020-12-24

# Response

# Response Fields

In the response, phase_type is a structured field. The options for this field are Primary Trading Session, Pre-Trading Session, Post-Trading Session, Pre-Open, Pre-Close, Call Auction, Intermission, Trading-at-Last, and Other.

Primary Trading Session is the only session type that is considered "open".

phase_name is free-form and will match the terminology used by the market itself.

# Example Responses

{
    "data": {
        "date": "2020-09-24",
        "is_open": true,
        "has_settlement": true,
        "holiday": null,
        "schedule": [
            {
                "phase_type": "Pre-Trading Session",
                "phase_name": "Pre-Opening Session",
                "phase_memo": null,
                "status": "Closed",
                "start": "2020-09-24T06:30:00-04:00",
                "end": "2020-09-24T09:30:00-04:00"
            },
            {
                "phase_type": "Primary Trading Session",
                "phase_name": "Core Trading Session",
                "phase_memo": null,
                "status": "Open",
                "start": "2020-09-24T09:30:00-04:00",
                "end": "2020-09-24T16:00:00-04:00"
            },
            {
                "phase_type": "Pre-Close",
                "phase_name": "Closing Imbalance Period",
                "phase_memo": null,
                "status": "Closed",
                "start": "2020-09-24T15:45:00-04:00",
                "end": "2020-09-24T16:00:00-04:00"
            },
            {
                "phase_type": "Post-Trading Session",
                "phase_name": "Extended Hours",
                "phase_memo": null,
                "status": "Closed",
                "start": "2020-09-24T16:00:00-04:00",
                "end": "2020-09-24T20:00:00-04:00"
            }
        ]
    }
}
{
    "data": {
        "date": "2020-12-24",
        "is_open": true,
        "has_settlement": true,
        "holiday": "Christmas",
        "schedule": [
            {
                "phase_type": "Primary Trading Session",
                "phase_name": "Continuous Trading (Early Closure)",
                "phase_memo": null,
                "status": "Open",
                "start": "2020-12-24T08:00:00+00:00",
                "end": "2020-12-24T12:30:00+00:00"
            },
            {
                "phase_type": "Post-Trading Session",
                "phase_name": "Post Close (Early Closure)",
                "phase_memo": null,
                "status": "Closed",
                "start": "2020-12-24T12:40:00+00:00",
                "end": "2020-12-24T13:15:00+00:00"
            }
        ]
    }
}

# Simplified Hours API

Sometimes you don't need information on every trading phase. If you just want to know the regular trading hours, pre-trading hours, and post-trading hours then you can use the Simplified Trading Hours Endpoint.

Overnight Trading Sessions

Some markets have overnight trading sessions. To represent this in the API we use what we call "24hr+ time". In some cases the end time may exceed 24:00. This indicates that the market closes the following day.

For example, if the start time is 16:00 and the end time is 32:00, that means the market opens at 4:00pm and closes the next day at 8:00am.

# Examples

https://api.tradinghours.com/v3/markets/hours-simplified?fin_id=us.nyse
https://api.tradinghours.com/v3/markets/hours-simplified?fin_id=JP.JPX
https://api.tradinghours.com/v3/markets/hours-simplified?fin_id=JP.JPX.INDEXSPECIAL

# Response

{
    "data": [
        {
            "day": "Sunday",
            "open": false,
            "time_start": null,
            "time_end": null,
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": null,
            "pre_hours_end": null,
            "post_hours_start": null,
            "post_hours_end": null
        },
        {
            "day": "Monday",
            "open": true,
            "time_start": "09:30",
            "time_end": "16:00",
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": "06:30",
            "pre_hours_end": "09:30",
            "post_hours_start": "16:00",
            "post_hours_end": "20:00"
        },
        {
            "day": "Tuesday",
            "open": true,
            "time_start": "09:30",
            "time_end": "16:00",
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": "06:30",
            "pre_hours_end": "09:30",
            "post_hours_start": "16:00",
            "post_hours_end": "20:00"
        },
        {
            "day": "Wednesday",
            "open": true,
            "time_start": "09:30",
            "time_end": "16:00",
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": "06:30",
            "pre_hours_end": "09:30",
            "post_hours_start": "16:00",
            "post_hours_end": "20:00"
        },
        {
            "day": "Thursday",
            "open": true,
            "time_start": "09:30",
            "time_end": "16:00",
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": "06:30",
            "pre_hours_end": "09:30",
            "post_hours_start": "16:00",
            "post_hours_end": "20:00"
        },
        {
            "day": "Friday",
            "open": true,
            "time_start": "09:30",
            "time_end": "16:00",
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": "06:30",
            "pre_hours_end": "09:30",
            "post_hours_start": "16:00",
            "post_hours_end": "20:00"
        },
        {
            "day": "Saturday",
            "open": false,
            "time_start": null,
            "time_end": null,
            "lunch": false,
            "lunch_start": null,
            "lunch_end": null,
            "pre_hours_start": null,
            "pre_hours_end": null,
            "post_hours_start": null,
            "post_hours_end": null
        }
    ]
}