# Historical transaction record

**1. Request Url**

`https://{host}/marketApi/history/trade`

**2. Request Param**

| Parameter name | Is it necessary | description                                                                                       |
| -------------- | --------------- | ------------------------------------------------------------------------------------------------- |
| channelId      | yes             | Channel number                                                                                    |
| timestamp      | yes             | Millisecond timestamp（UTC+8）                                                                      |
| sign           | yes             | See "[Signature Generation](https://docs-swft.en.swft.pro/generate-signature#generate-signature)" |
| symbol         | yes             | symbol                                                                                            |

**3.Request Example**

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

**4.Response Data**

```
{
    "data":[
        {
            "amount":"0.016019",
            "direction":"buy",
            "price":"64486.20",
            "trade-id":102547488829,
            "ts":1634798182
        },
        {
            "amount":"0.000004",
            "direction":"sell",
            "price":"64479.12",
            "trade-id":102547488828,
            "ts":1634798182
        },
        {
            "amount":"0.098946",
            "direction":"buy",
            "price":"64505.74",
            "trade-id":102547488447,
            "ts":1634798098
        }
    ],
    "resCode":"800",
    "resMsg":"success",
    "resMsgEn":""
}
```

**5.Response Data Explanation**

| Description | Is Array | Parameter name | Data type |
| ----------- | -------- | -------------- | --------- |
| amount      | yes      | amount         | String    |
| direction   | yes      | direction      | String    |
| price       | yes      | price          | String    |
| trade-id    | yes      | trade-id       | String    |
| ts          | yes      | ts             | String    |