# 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 FinID
s. 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
}
]
}