# 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 marketstatus
- 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 schedulesuntil
- End of the current phase.next_bell
- The time when the market opens or closes nextutc_time
- The time in UTCtime
- The current time in the same timezone as was specified in thetime
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.