Market status

Every price carries marketStatus and, when the market is not open, a reason. Only UNAVAILABLE blocks a trade: an order placed then answers UNAVAILABLE_MARKET. CLOSED is extended-hours trading and can be traded.

`marketStatus`	Meaning	Trade?
`OPEN`	Regular session	Yes
`CLOSED`	Pre-market or post-market. `reason` says which	Yes
`UNAVAILABLE`	No trading now: outside the trading window, maintenance, a holiday, or a halt	No

The trading day

A stock’s hours follow its chain, and marketStatus always reflects them: read it rather than a clock. For the stocks offered today, in New York time, on trading days:

Time	`marketStatus`	`reason`
04:00 – 09:30	`CLOSED`	`PRE_MARKET`
09:30 – 16:00	`OPEN`	—
16:00 – 17:30	`CLOSED`	`POST_MARKET`
17:30 – 04:00	`UNAVAILABLE`	`POST_MARKET` until midnight

Every night from 23:39 to 00:21 is a maintenance window, UNAVAILABLE. Weekends and market holidays are UNAVAILABLE all day.

Halts

A stock whose price moves sharply is halted, and reads UNAVAILABLE until trading resumes:

`reason`	Meaning
`FIVE_PERCENT_DEVIATION`	Trading paused after a 5% move
`TEN_PERCENT_DEVIATION`	Trading paused after a 10% move

Treat a status or a reason you do not recognise as UNAVAILABLE: values may be added.

Reading it

Read marketStatus from the price you are showing, and disable the order button on UNAVAILABLE. A market can become unavailable between the price and the order, so an order can still answer UNAVAILABLE_MARKET: show it as “trading is not available right now”, and let the investor try again when the status changes.

Get started

Guides

Concepts

Help

API reference

The trading day

Halts

Reading it