> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询K线数据

`适用于查询市场价格K线数据, 单次请求限制500条数据`

#### 请求URL

`GET https://cloud-api.wooxpro.com/contract/public/kline`

#### 请求限制

参见 [速率限制详细](/cn/rate-limit)

#### 请求参数

> 请求

```shell theme={null}
curl https://cloud-api.wooxpro.com/contract/public/kline?symbol=BTCUSDT&step=5&start_time=1662518172&end_time=1662518172
```

| 参数          | 类型     | 是否必填 | 描述                                                                                             |
| :---------- | :----- | :--- | :--------------------------------------------------------------------------------------------- |
| symbol      | String | 必填   | 合约交易对（如BTCUSDT）                                                                                |
| step        | Long   | 必填   | K线间隔  步长: `1`, `3`, `5`, `15`, `30`, `60`, `120`, `240`, `360`, `720`, `1440`, `4320`, `10080` |
| start\_time | Long   | 必填   | 开始时间(时间戳，精确到秒)                                                                                 |
| end\_time   | Long   | 必填   | 结束时间(时间戳，精确到秒)                                                                                 |

#### 响应详情

> 响应

```json theme={null}
{
  "code": 1000,
  "trace": "0cc6f4c4-8b8c-4253-8e90-8d3195aa109c",
  "message": "Ok",
  "data": [{
    "timestamp": 1662518160,
    "open_price": "100",
    "close_price": "120",
    "high_price": "130",
    "low_price": "90",
    "volume": "941008"
    },
    {
    "timestamp": 1662518161,
    "open_price": "99",
    "close_price": "119",
    "high_price": "129",
    "low_price": "89",
    "volume": "941008"
    }
  ]
}
```

| 字段           | 类型     | 描述   |
| :----------- | :----- | :--- |
| timestamp    | Long   | 时间窗口 |
| open\_price  | String | 开盘价  |
| close\_price | String | 收盘价  |
| high\_price  | String | 最高价  |
| low\_price   | String | 最低价  |
| volume       | String | 成交量  |