TradingHours.com API Reference

# 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

Field Format Description
fin_id String The FinID for the market.
timezone String Gives the timezone the market utilizes in Olson timezone identifier format.
iso_8601 ISO 8601 Shows the full current local time at the market.
date Date Shows the date at the market, part of the iso_8601 field.
time Time Shows the time at the market, including seconds.
offset Offset Shows the offset value for the market.
day String Shows the current day of the week for the market.

# Query String Parameters

Supported query string parameters are listed in the table below:

Parameter Supported Values Default Description
fin_id Valid FinID(s) N/A Specify which market(s) to show data for.
format CSV, JSON JSON Specify output format

If you use a query string parameter that isn't supported, the API will ignore the invalid query string parameters and execute the ones it recognizes.

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

← Timezones →