> For the complete documentation index, see [llms.txt](https://docs-swft.en.swft.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-swft.en.swft.pro/trade-api/k-line-data.md).

# K-line data

**1. Request Url**

`https://{host}/market/history/kline` 

**2. Request Param**

| Parameter name | Is it necessary | description                                                                                                                         |
| -------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| channelId      | yes             | Channel number                                                                                                                      |
| timestamp      | yes             | Millisecond timestamp（UTC+8）                                                                                                        |
| sign           | yes             | See "[Signature Generation](/trade-api/generate-signature.md#generate-signature)"                                                   |
| symbol         | yes             | symbol                                                                                                                              |
| period         | yes             | Return data time granularity, that is, the time interval of each candle (1min, 5min, 15min, 30min, 60min, 1day, 1mon, 1week, 1year) |

**3.Request Example**

```
{
     "channelId":"swft-channel",
     "sign":"102027D292DD0707E0D899459D91C759858D7367D223CB239A8EC3A90C30B122",
     "timestamp":"1557653925555",
     "symbol":"BTC/USDT",
     "period":"5min"
 }
```

**4.Response Data**

```
{
  "data":[
    {
      "amount":"9",
      "close":"64584.05",
      "count":728,
      "high":"64678.86",
      "low":"64542.78",
      "open":"64640.77",
      "ts":"1634799300",
      "vol":"598187"
    },
    {
      "amount":"27",
      "close":"64644.22",
      "count":1605,
      "high":"64673.56",
      "low":"64403.50",
      "open":"64503.61",
      "ts":"1634799000",
      "vol":"1784771"
    },
    {
      "amount":"43",
      "close":"64503.61",
      "count":2806,
      "high":"64537.95",
      "low":"64165.55",
      "open":"64267.67",
      "ts":"1634798700",
      "vol":"2785947"
    },
    {
      "amount":"10",
      "close":"63798.99",
      "count":793,
      "high":"63821.82",
      "low":"63732.67",
      "open":"63770.11",
      "ts":"1634709600",
      "vol":"694601"
    }
  ],
  "resCode":"800",
  "resMsg":"success",
  "resMsgEn":""
}
```

**5.Response Data Explanation**

| Description | Is Array | Parameter name | Data type |
| ----------- | -------- | -------------- | --------- |
| amount      | Y        | amount         | String    |
| close       | Y        | close          | String    |
| count       | Y        | count          | String    |
| high        | Y        | high           | String    |
| low         | Y        | low            | String    |
| open        | Y        | open           | String    |
| ts          | Y        | ts             | String    |
| vol         | Y        | vol            | String    |