# Timezones
# Timezones, Offsets, and Transitions
The timezones API allows you to lookup timezone offsets and Daylight Saving Time transitions times. This is essential for knowing precisely when markets will be open or closed. Common timezones include America/New_York
, Europe/London
, and Asia/Tokyo
.
This API endpoint is including in all subscriptions.
Note
You can see what timezone a market uses by using the market details endpoint.
# List Timezones
First you will need to enumerate all timezones. Timezones are in Olson Timezone format.
# Examples
https://api.tradinghours.com/v3/timezones
https://api.tradinghours.com/v3/timezones?format=csv
# Response
- Name - Olson timezone identifier
- Country Code
- Observes DST - Indicates if this timezone ever observes Daylight Saving Time_
{
"data": [
{
"name": "Africa/Abidjan",
"country_code": "CI",
"observes_dst": false
},
{
"name": "Africa/Accra",
"country_code": "GH",
"observes_dst": false
},
{
"name": "Africa/Addis_Ababa",
"country_code": "ET",
"observes_dst": false
},
...
{
"name": "Pacific/Wake",
"country_code": "UM",
"observes_dst": false
},
{
"name": "Pacific/Wallis",
"country_code": "WF",
"observes_dst": false
},
{
"name": "UTC",
"country_code": "??",
"observes_dst": false
}
]
}
# Timezone Transitions
# Examples
https://api.tradinghours.com/v3/timezones/transitions?timezone=america/new_york
https://api.tradinghours.com/v3/timezones/transitions?timezone=america/new_york&start=2020-01-01&end=2025-12-31
https://api.tradinghours.com/v3/timezones/transitions?timezone=america/new_york&format=csv
# Response
- Timestamp - Time when the transition begins. Number of seconds since January 1, 2070.
- Time - Time when the transition begins
- Offset - Offset from UTC in seconds
- Is DST - Indicates if the period is Daylight Saving Time or not
- Abbreviation - Common code used to identify the timezone
{
"data": [
{
"timestamp": 1604210400,
"time": "2020-11-01T06:00:00+0000",
"offset": -18000,
"is_dst": false,
"abbreviation": "EST"
},
{
"timestamp": 1615705200,
"time": "2021-03-14T07:00:00+0000",
"offset": -14400,
"is_dst": true,
"abbreviation": "EDT"
},
{
"timestamp": 1636264800,
"time": "2021-11-07T06:00:00+0000",
"offset": -18000,
"is_dst": false,
"abbreviation": "EST"
},
{
"timestamp": 1647154800,
"time": "2022-03-13T07:00:00+0000",
"offset": -14400,
"is_dst": true,
"abbreviation": "EDT"
},
{
"timestamp": 1667714400,
"time": "2022-11-06T06:00:00+0000",
"offset": -18000,
"is_dst": false,
"abbreviation": "EST"
},
{
"timestamp": 1678604400,
"time": "2023-03-12T07:00:00+0000",
"offset": -14400,
"is_dst": true,
"abbreviation": "EDT"
},
{
"timestamp": 1699164000,
"time": "2023-11-05T06:00:00+0000",
"offset": -18000,
"is_dst": false,
"abbreviation": "EST"
},
{
"timestamp": 1710054000,
"time": "2024-03-10T07:00:00+0000",
"offset": -14400,
"is_dst": true,
"abbreviation": "EDT"
},
{
"timestamp": 1730613600,
"time": "2024-11-03T06:00:00+0000",
"offset": -18000,
"is_dst": false,
"abbreviation": "EST"
},
{
"timestamp": 1741503600,
"time": "2025-03-09T07:00:00+0000",
"offset": -14400,
"is_dst": true,
"abbreviation": "EDT"
}
],
"meta": {
"start": "2020-09-12",
"end": "2025-09-12"
}
}