Now Live: Cboe Europe real-time data for all major European stocks.

Markets

Market endpoints answer operational questions about exchanges themselves: which ones are open right now, what are their trading hours, and how far back does data go for a given instrument?

Exchanges High demand

The exchanges endpoint provides a comprehensive list of all available equity exchanges. It returns an array containing detailed information about each exchange, such as exchange code, name, country, and timezone. This data is updated daily.

Route

/exchanges

API credits cost

1 per request

Parameters Response
Sign in to query

type

string

The asset class to which the instrument belongs

Supports: American Depositary Receipt, Bond, Bond Fund, Closed-end Fund, Common Stock, Depositary Receipt, Digital Currency, ETF, Exchange-Traded Note, Global Depositary Receipt, Limited Partnership, Mutual Fund, Physical Currency, Preferred Stock, REIT, Right, Structured Product, Trust, Unit, Warrant

Example: ETF

name

string

Filter by exchange name

Example: NASDAQ

code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XBUE

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

The separator used in the CSV response data

Default: ;

show_plan

boolean

Adds info on which plan symbol is available

Default: false

data

array of object

List of exchanges

Attributes

title

string

Title of exchange

name

string

Name of exchange

code

string

Market identifier code (MIC) under ISO 10383 standard

country

string

Country to which stock exchange belongs to

timezone

string

Time zone where exchange is located

access

object

Info on which plan symbol is available (displayed then show_plan is true)

Attributes

global

string

Level of access to the symbol

plan

string

The individual plan name for the symbol

plan_business

string

The business plan name for the symbol

status

string

Response status

Copy for LLM
View as Markdown

Request example

https://api.twelvedata.com/exchanges?apikey=demo

Response

{
    "data": [
        {
            "title": "Argentinian Stock Exchange",
            "name": "BCBA",
            "code": "XBUE",
            "country": "Argentina",
            "timezone": "America/Argentina/Buenos_Aires",
            "access": {
                "global": "Pro",
                "plan": "Pro",
                "plan_business": "Basic"
            }
        }
    ],
    "status": "ok"
}

Exchanges schedule

The exchanges schedule endpoint provides detailed information about various stock exchanges, including their trading hours and operational days. This data is essential for users who need to know when specific exchanges are open for trading, allowing them to plan their activities around the availability of these markets.

Route

/exchange_schedule

API credits cost

100 per request

This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Parameters Response
Sign in to query

date

string

If a date is provided, the API returns the schedule for the specified date; otherwise, it returns the default (common) schedule.

The date can be specified in one of the following formats:
  • An exact date (e.g., 2021-10-27)
  • A human-readable keyword: today or yesterday
  • A full datetime string in UTC (e.g., 2025-04-11T20:00:00) to retrieve the schedule corresponding to the day in the specified time.
When using a datetime value, the resulting schedule will correspond to the local calendar day at the specified time. For example, 2025-04-11T20:00:00 UTC corresponds to:
  • 2025-04-11 in the America/New_York timezone
  • 2025-04-12 in the Australia/Sydney timezone

Example: 2021-10-27

mic_name

string

Filter by exchange name

Example: NASDAQ

mic_code

string

Filter by market identifier code (MIC) under ISO 10383 standard

Example: XNGS

country

string

Filter by country name or alpha code, e.g., United States or US

Example: United States

data

array of object
Attributes

title

string

Official name of exchange

name

string

Name of exchange

code

string

Market identifier code (MIC) under ISO 10383 standard

country

string

Country to which stock exchange belongs to

time_zone

string

Time zone where exchange is located

sessions

array of object

Exchange trading hours

Attributes

open_time

string

Opening time of the session

close_time

string

Closing time of the session

session_name

string

Name of the session

session_type

string

Type of the session

Copy for LLM
View as Markdown

Request example

https://api.twelvedata.com/exchange_schedule?apikey=your_api_key

Response

{
    "data": [
        {
            "title": "NASDAQ/NGS (Global Select Market)",
            "name": "NASDAQ",
            "code": "XNYS",
            "country": "United States",
            "time_zone": "America/New_York",
            "sessions": [
                {
                    "open_time": "04:00:00",
                    "close_time": "09:30:00",
                    "session_name": "Pre market",
                    "session_type": "pre"
                }
            ]
        }
    ]
}

Cryptocurrency exchanges

The cryptocurrency exchanges endpoint provides a daily updated list of available cryptocurrency exchanges. It returns an array containing details about each exchange, such as exchange names and identifiers.

Route

/cryptocurrency_exchanges

API credits cost

1 per request

Parameters Response
Sign in to query

format

string

The format of the response data

Supports: JSON, CSV

Default: JSON

delimiter

string

Specify the delimiter used when downloading the CSV file

Default: ;

data

array of object

List of cryptocurrency exchanges

Attributes

name

string

Name of cryptocurrency exchange

status

string

Response status

Copy for LLM
View as Markdown

Request example

https://api.twelvedata.com/cryptocurrency_exchanges?apikey=demo

Response

{
    "data": [
        {
            "name": "Binance"
        },
        {
            "name": "Coinbase Pro"
        },
        {
            "name": "Kraken"
        },
        {
            "name": "OKX"
        }
    ],
    "status": "ok"
}

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.

Route

/market_state

API credits cost

1 per request

Parameters Response
Sign in to query

exchange

string

The exchange name where the instrument is traded.

Example: NYSE

code

string

The Market Identifier Code (MIC) of the exchange where the instrument is traded.

Example: XNYS

country

string

The country where the exchange is located. Takes country name or alpha code.

Example: United States

array of object
Attributes

name

string

The full name of exchange

code

string

Market identifier code (MIC) under ISO 10383 standard

country

string

Country where the exchange is located

is_market_open

boolean

Indicates if the market is currently open

time_after_open

string

Time after market opening in HH:MM:SS format; if currently closed - returns 00:00:00

time_to_open

string

Time to market opening in HH:MM:SS format; if currently open - returns 00:00:00

time_to_close

string

Time to market closing in HH:MM:SS format; if currently closed - returns 00:00:00

Copy for LLM
View as Markdown

Request example

https://api.twelvedata.com/market_state?apikey=demo

Response

[
    {
        "name": "NYSE",
        "code": "XNYS",
        "country": "United States",
        "is_market_open": true,
        "time_after_open": "02:39:03",
        "time_to_open": "00:00:00",
        "time_to_close": "05:20:57"
    }
]