---
title: "Market state"
method: GET
path: "/market_state"
tags: ["reference_data"]
---

# Market state

`GET /market_state`

The market state endpoint provides real-time information on the operational status of all available stock exchanges. It returns data on whether each exchange is currently open or closed, along with the time remaining until the next opening or closing. This endpoint is useful for users who need to monitor exchange hours and plan their trading activities accordingly.

## Query parameters

- `exchange` string
- `code` string
- `country` string

## Response `200`

- MarketStateResponseItem[]
  - `name` string, required — The full name of exchange
  - `code` string, required — Market identifier code (MIC) under ISO 10383 standard
  - `country` string, required — Country where the exchange is located
  - `is_market_open` boolean, required — Indicates if the market is currently open
  - `time_after_open` string, required — Time after market opening in <code>HH:MM:SS</code> format; if currently closed - returns <code>00:00:00</code>
  - `time_to_open` string, required — Time to market opening in <code>HH:MM:SS</code> format; if currently open - returns <code>00:00:00</code>
  - `time_to_close` string, required — Time to market closing in <code>HH:MM:SS</code> format; if currently closed - returns <code>00:00:00</code>

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)