# 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"
    }
}