# GET Market Trading Hours

### Overview

The **Market Trading Hours API** provides the basic trading hours for different markets, including the start and end times for normal trading sessions, pre-market, and post-market sessions.

### Endpoint

* Base Path: `/common/basic/markets`
* Full Path: `https://data.infoway.io/common/basic/markets`

### Request Frequency

This API shares the same rate limits as other endpoints. The number of allowed requests per second depends on your subscription plan. Please refer to the [**Rate Limit**](https://docs.infoway.io/en-docs/getting-started/api-limitation/rest-api-limitation) for details.

### Error Codes

See the [HTTP Error Codes](https://docs.infoway.io/en-docs/getting-started/error-codes/rest-api-error-codes) section for reference.

### Authentication

Each request must include your **API Key** in the header.

| **Header** | **Type** | **Required** | **Description**                                 |
| ---------- | -------- | ------------ | ----------------------------------------------- |
| `apiKey`   | String   | Yes          | Your API Key associated with your current plan. |

### Example Response

```json
{
  "ret": 200,
  "msg": "success",
  "traceId": "7b32f9db-852b-4234-aafb-5766f9ba385e",
  "data": [
    {
      "market": "CN",
      "remark": "A 股市场",
      "trade_schedules": [
        {
          "begin_time": "09:30:00",
          "end_time": "11:30:00",
          "type": "NormalTrade"
        },
        {
          "begin_time": "13:00:00",
          "end_time": "14:57:00",
          "type": "NormalTrade"
        }
      ]
    },
    {
      "market": "HK",
      "remark": "港股市场",
      "trade_schedules": [
        {
          "begin_time": "09:30:00",
          "end_time": "12:00:00",
          "type": "NormalTrade"
        },
        {
          "begin_time": "13:00:00",
          "end_time": "16:00:00",
          "type": "NormalTrade"
        }
      ]
    },
    {
      "market": "US",
      "remark": "美股市场",
      "trade_schedules": [
        {
          "begin_time": "04:00:00",
          "end_time": "09:30:00",
          "type": "PreTrade"
        },
        {
          "begin_time": "09:30:00",
          "end_time": "16:00:00",
          "type": "NormalTrade"
        },
        {
          "begin_time": "16:00:00",
          "end_time": "20:00:00",
          "type": "PostTrade"
        }
      ]
    }
  ]
}
```

### Response Fields

| **Field**         | **Type** | **Required** | **Description**                                                                  | **Example / Values** |
| ----------------- | -------- | ------------ | -------------------------------------------------------------------------------- | -------------------- |
| `market`          | String   | Yes          | The market code.                                                                 | `US`, `HK`, `CN`     |
| `remark`          | String   | Yes          | Description of the market.                                                       | `US Stock Market`    |
| `trade_schedules` | Array    | Yes          | List of trading sessions, including pre-market, normal trading, and post-market. | See below            |

### Trade Session Fields

Each entry in the `trade_schedules` array will contain the following fields:

| **Field**    | **Type** | **Required** | **Description**                                                  | **Example** |
| ------------ | -------- | ------------ | ---------------------------------------------------------------- | ----------- |
| `begin_time` | String   | Yes          | Start time of the trading session in `HH:mm:ss` format.          | `04:00:00`  |
| `end_time`   | String   | Yes          | End time of the trading session in `HH:mm:ss` format.            | `09:30:00`  |
| `type`       | String   | Yes          | Type of trading session: `PreTrade`, `NormalTrade`, `PostTrade`. | `PreTrade`  |

### Notes

* The `trade_schedules` array lists the various trading sessions for the market. These sessions can include pre-market, regular market hours, and post-market.
* Each market may have different session times based on its location and trading rules.