> ## 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.

# 查询合约成交明细 (KEYED)

`适用于查询某合约订单成交明细`

#### 请求URL

`GET https://cloud-api.wooxpro.com/contract/private/trades`

#### 请求限制

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

#### 请求参数

> 请求

```shell theme={null}
curl -H 'X-API-KEY:{{AccessKey}}'
https://cloud-api.wooxpro.com/contract/private/trades?symbol=BTCUSDT&start_time=1662368173&end_time=1662368179
```

| 参数                | 类型     | 是否必填 | 描述                                                    |
| :---------------- | :----- | :--- | :---------------------------------------------------- |
| symbol            | String | 选填   | 合约交易对（如BTCUSDT）                                       |
| account           | String | 选填   | 交易用户<br />-`futures`=合约主账号<br />-`copy_trading`=跟单子账号 |
| start\_time       | Long   | 选填   | 开始时间(时间戳，精确到秒)                                        |
| end\_time         | Long   | 选填   | 结束时间(时间戳，精确到秒)                                        |
| order\_id         | Long   | 选填   | 订单ID                                                  |
| client\_order\_id | String | 选填   | 客户端订单ID                                               |

##### 注意

* 没有填写时间范围 `start_time`和`end_time`，默认查询最近7天数据
* 填写时间范围的话，`end_time` 必须比 `start_time` 的值大， 并且`start_time`和`end_time` 最大支持 90 天的查询间隔
* 每次请求最多返回200条，超过的将不会返回
* 支持查询订单类型：`limit`、`market`、`liquidate`、`bankruptcy`、`adl`、`trailing`

#### 响应详情

> 响应

```json theme={null}
{
  "code": 1000,
  "message": "Ok",
  "data": [{
    "order_id": "220921197409432",
    "trade_id": "1141853921",
    "symbol": "BTCUSDT",
    "side": 1,
    "price": "19313.3",
    "vol": "108",
    "exec_type": "Maker",
    "profit": false,
    "realised_profit": "-0.00832",
    "paid_fees": "0",
    "account": "futures",
    "create_time": 1663663818589
  }],
  "trace": "638d5048-ad21-4a4b-9365-d0756fbfc7ba"
}
```

| 字段               | 类型      | 描述                                                    |
| :--------------- | :------ | :---------------------------------------------------- |
| symbol           | String  | 合约交易对（如BTCUSDT）                                       |
| order\_id        | String  | 订单编号                                                  |
| trade\_id        | String  | 成交明细编号                                                |
| side             | Int     | 订单方向                                                  |
| price            | String  | 成交价格                                                  |
| vol              | String  | 成交量                                                   |
| exec\_type       | String  | 流动性类型<br />-`Taker`<br />-`Maker`                     |
| profit           | Boolean | 是否盈利                                                  |
| realised\_profit | String  | 已实现盈亏                                                 |
| paid\_fees       | String  | 手续费                                                   |
| account          | String  | 交易用户<br />-`futures`=合约主账号<br />-`copy_trading`=跟单子账号 |
| create\_time     | Long    | 成交创建时间(ms)                                            |