Local Time

Markets Local Time

This endpoint allows you to check the local time at any market or trading venue.

Bulk requests and CSV downloads are supported. Use the FinID obtained from the List Markets.

We recommend using bulk requests whenever possible to avoid hitting rate limits.

Schema

FieldFormatDescription
fin_idStringThe FinID for the market.
timezoneStringGives the timezone the market utilizes in Olson timezone identifier format.
iso_8601ISO 8601Shows the full current local time at the market.
dateDateShows the date at the market, part of the iso_8601 field.
timeTimeShows the time at the market, including seconds.
offsetOffsetShows the offset value for the market.
dayStringShows the current day of the week for the market.

Query String Parameters

Supported query string parameters are listed in the table below:

ParameterSupported ValuesDefaultDescription
fin_idValid FinID(s)N/ASpecify which market(s) to show data for.
formatCSV, JSONJSONSpecify output format

Examples

Remember to use your authentication token for all requests.

Get Local Time for Single FinID

https://api.tradinghours.com/v3/markets/local-time?fin_id=us.nyse

Get Local Time for Two FinIDs

https://api.tradinghours.com/v3/markets/local-time?fin_id=us.nyse,jp.jpx

Get Local Time for Single MIC

https://api.tradinghours.com/v3/markets/local-time?mic=XNYS

Get Local Time for Three FinIDs in CSV Format

https://api.tradinghours.com/v3/markets/local-time?fin_id=us.nyse,jp.jpx,gb.lse&format=csv

Sample JSON Response

{
    "data": [
        {
            "fin_id": "JP.JPX",
            "timezone": "Asia\/Tokyo",
            "iso_8601": "2021-07-12T10:56:52+09:00",
            "date": "2021-07-12",
            "time": "10:56:52",
            "offset": "+09:00",
            "day": "Monday"
        },
        {
            "fin_id": "US.NYSE",
            "timezone": "America\/New_York",
            "iso_8601": "2021-07-11T21:56:52-04:00",
            "date": "2021-07-11",
            "time": "21:56:52",
            "offset": "-04:00",
            "day": "Sunday"
        }
    ]
}