# 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.

**API credits cost:** `100` per request

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## Parameters

- `date` (string, optional)
  
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



- `mic_name` (string, optional)
  Filter by exchange name


- `mic_code` (string, optional)
  Filter by market identifier code (MIC) under ISO 10383 standard


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`



## Response

- `data` (array of object)
  - `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
    - `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


## Example Request

```bash
curl "https://api.twelvedata.com/exchange_schedule?apikey=demo"
```

## Example Response

```json
{
    "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"
                }
            ]
        }
    ]
}
```