# Get a Batch of Trade Records of a Contract

#### /sapi/v1/market/history/trade

Request type: GET

Signature verification: No

Interface permission: Read

Rate Limit: For public interface to get market data such as Get Kline data, Get Market Data Overview, Get Contract Information,Get market in-depth data, Get premium index Kline, Get real-time forecast capital rate kline, Get basis data, Get the last Trade of a Contract and so on： （1）For restful interfaces, products, (future, coin margined swap, usdt margined Contracts)800 times/second for one IP at most

Interface description: The interface supports cross margin mode and isolated margin mode. The request parameter "contract\_code" supports the contract code of futures, in that the format is BTC-USDT-210625; and supports contract type: BTC-USDT, BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ.

### Request Address

| Environment                         | Address                                     |
| ----------------------------------- | ------------------------------------------- |
| Online                              | [https://api.sunx.io](https://api.sunx.io/) |
| Online (preferred by aws customers) | [https://api.sunx.io](https://api.sunx.io/) |

### Request Parameter

| Parameter      | Data Type | Required | Description                           | Value Range                                                                                               | Default Value |
| -------------- | --------- | -------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------- | ------------- |
| contract\_code | string    | true     | contract code or contract type        | swap: "BTC-USDT"... , future: "BTC-USDT-210625" ... or BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ |               |
| size           | int       | true     | Number of Trading Records Acquisition | \[1, 2000]                                                                                                |               |

### Response Parameter

| Parameter       | Data Type    | Required | Description                                                                     | Value Range  |
| --------------- | ------------ | -------- | ------------------------------------------------------------------------------- | ------------ |
| ch              | string       | true     | Data belonged channel，Format： market.$contract\_code.trade.detail               |              |
| \<data>         | object array | true     |                                                                                 |              |
| amount          | decimal      | true     | Quantity(Cont.). Sum of both buy and sell sides                                 |              |
| direction       | string       | true     | The direction to buy or sell is the direction of the taker (active transaction) |              |
| id              | long         | true     | Unique Transaction Id(symbol level)                                             |              |
| price           | decimal      | true     | Price                                                                           |              |
| ts              | long         | true     | Order Creation Time                                                             |              |
| quantity        | decimal      | true     | trading quantity(coin)                                                          |              |
| trade\_turnover | decimal      | true     | trade turnover(quoted currency)                                                 |              |
| \</data>        |              | false    |                                                                                 |              |
| id              | long         | true     | Unique Order Id(symbol level).                                                  |              |
| ts              | long         | true     | Latest transaction time                                                         |              |
| \</data>        |              | false    |                                                                                 |              |
| status          | string       | true     |                                                                                 | "ok"，"error" |
| ts              | long         | true     | Time of Respond Generation, Unit: Millisecond                                   |              |

### Request Example

```
GET https://api.sunx.io/sapi/v1/market/history/trade?contract_code=BTC-USDT&size=1
```

### Response Example

```
{
    "ch": "market.BTC-USDT.trade.detail",
    "ts": 1757932114663,
    "status": "ok",
    "data": [
        {
            "id": 100000016279612,
            "ts": 1757932102168,
            "data": [
                {
                    "amount": 2,
                    "quantity": 0.002,
                    "trade_turnover": 229.4006,
                    "ts": 1757932102168,
                    "id": 1000000162796120000,
                    "price": 114700.3,
                    "direction": "sell"
                }
            ]
        }
    ]
}
```