Market status
Whether each entitled exchange is open now, in pre-market or after-hours trading, closed or on a holiday, with today's session and the next open and close, from the published exchange calendar. pre_market and after_hours apply to US exchanges only (04:00 to 20:00 New York time, or until four hours after an early close); other exchanges have no extended hours. The CRYPTO, FOREX, INDEX and BOND venues follow their own calendars in /v1/calendar, and INDEX says nothing about the market of any one index. next_open_at and next_close_at are null when no session falls within the next 14 days. Upcoming holidays and past sessions are in /v1/calendar. Default order: exchange MIC ascending. Results are limited to the entitled scope. Served from the OHLC security master, exchange calendars and reference tables. Access requires the operation capability on the API key.
/v1/market-status- Required capability
- calendar.read
- Data timing
- As published by the source
- Credits
- 5 credits per request.
Parameters
exchangesstringoptional · query- Exchange MICs; defaults to every entitled exchange with a published calendar. A malformed or repeated code returns 422 invalid-exchanges, a MIC the API does not serve 404 exchange-not-found, and one outside the key's markets 403 market-not-entitled.
limitintegeroptional · query- Maximum records per page.Default:
100 cursorstringoptional · query- Opaque cursor, expires after one hour; binds filters, order, resolved as_of, account/key and entitlement. Repeat the original query unchanged.
formatstringoptional · query- Response format. csv returns the data rows with a header row, for spreadsheet functions such as IMPORTDATA; nested fields become dotted columns and lists one JSON array cell, the next page cursor is returned in X-Next-Cursor and meta.errors in X-Meta-Errors. A result without rows is the header row alone, listing the documented fields of a row. Default json, or csv when format is omitted and the Accept header ranks text/csv above JSON; a format the Accept header does not admit returns 406 not-acceptable.
jsoncsv
Response fields
Returns data as an array of records. All example values are illustrative.
exchange_micstring- exchange mic
exchange_timezonestring- IANA timezone of the exchange.
local_datestring- Exchange-local date at server_time.
statusstring- Trading state at server_time. holiday is a weekday the exchange is closed; unknown means no calendar is published for local_date.
openpre_marketafter_hoursclosedholidayunknown sessionobject · null- Today's trading session; null when the exchange does not trade on local_date.
next_open_atstring · null- Next regular session open after server_time; null when not yet in the published calendar.
next_close_atstring · null- Next regular session close after server_time.
server_timestring- Instant the status describes.
Response metadata
Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.
When something goes wrong
An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.
Plans
Requires calendar.read. Access, recency and history depth come from the plan definitions the API enforces.
| Plan | Access | Recency | History |
|---|---|---|---|
| Free | Included | As published | Not date-bounded |
| Developer | Included | As published | Not date-bounded |
| Pro | Included | As published | Not date-bounded |
| Commercial | Included | As published | Not date-bounded |
| Scale | Included | As published | Not date-bounded |
Free requests are limited to AAPL, NVDA, JNJ, PEP, MSFT, SPY, QQQ.
History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans