TradingHours.com API Reference

# Market Status (Enterprise)

# Real-Time Market Status (Enterprise)

This API is the same as the Market Status API above, except the Enterprise API can also specify a particular time.

# Past & Future Times

This API also allows you to check a market's status at any time past, present or future. Use the time query string parameter to specify a date and time. The time parameter should be in ISO 8601 format. E.g. 2020-02-27T01:23:45-05:00.

If the time parameter is omitted the current time is used.

Note

The time parameter is not accessible on all plans. Contact our team for more details.

# Examples

http://api.tradinghours.com/v3/markets/status?fin_id=us.nyse&time=2020-11-27T12:55:00-04:00

Bulk API requests are also supported

http://api.tradinghours.com/v3/markets/status?fin_id=us.nyse,jp.jpx&time=2020-11-27T12:55:00-04:00

CSV format is also supported

http://api.tradinghours.com/v3/markets/status?fin_id=us.nyse,jp.jpx&format=csv&time=2020-11-27T12:55:00-04:00

# Response

{
    "data": {
        "JP.JPX": {
            "fin_id": "JP.JPX",
            "exchange": "Japan Exchange Group",
            "market": "Tokyo Stock Exchange",
            "products": null,
            "local_time": "2020-09-12T04:03:19+09:00",
            "status": "Closed",
            "reason": null,
            "until": "2020-09-14T08:00:00+09:00",
            "next_bell": "2020-09-14T12:30:00+09:00"
        },
        "US.NYSE": {
            "fin_id": "US.NYSE",
            "exchange": "New York Stock Exchange",
            "market": "Cannonical",
            "products": null,
            "local_time": "2020-09-11T15:03:19-04:00",
            "status": "Open",
            "reason": "Primary Trading Session",
            "until": "2020-09-11T15:45:00-04:00",
            "next_bell": "2020-09-11T16:00:00-04:00"
        }
    },
    "meta": {
        "utc_time": "2020-09-11T19:03:19+00:00",
        "time": "2020-09-11T19:03:19+00:00"
    }
}

# Fields Explained

  • local_time - The local time at the market
  • status - Open or Closed. Open if it is currently a primary trading session. Closed otherwise (including pre- and post-trading sessions)
  • reason - Explanation of the current response including current phase(s), holidays, and irregular schedules
  • until - End of the current phase.
  • next_bell - The time when the market opens or closes next
  • utc_time - The time in UTC
  • time - The current time in the same timezone as was specified in the time query string parameter.

Note

until is not always the same as next_bell. For example, if it is currently a post-trading session, until will indicate the end of the post-trading session and next_bell will be the following morning when markets officially open.

Note

If the time query sting parameter was omitted then the time field in the response will be the same as utc_time.

# Request Caching

The results of the status API will not change until until. So it is safe to cache results until this time. Caching requests and using bulk API calls will help you avoid exceeding the rate limits.

← Trading Hours →