# 查询历史委托 (USER_DATA)

- **GET** ```/capi/v3/order/history```

权重(IP): 10

<div class='api-content-wrap'>
<div>


<strong>请求参数</strong>


| 参数名   | 类型    | 是否必填 | 说明 |
|----------|---------|----------|------|
| symbol   | String  | 否       | 按交易对过滤。 |
| limit    | Integer | 否       | 每页数量，1-100，默认 100。 |
| startTime| Long    | 否       | 起始时间（毫秒），需 ≤ `endTime`。 |
| endTime  | Long    | 否       | 结束时间（毫秒），与 `startTime` 间隔不超过 90 天。 |
| page     | Integer | 否       | 页码，从 0 开始，默认 0。 |

</div>
<div class='api-align'>
  <div class='code-wrap'>
<strong>请求示例</strong>

```powershell
curl "https://api-contract.weex.com/capi/v3/order/history?symbol=BTCUSDT&limit=100&page=0" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
```
  </div>
  </div>

</div>

<div class='api-content-wrap'>
  <div>
<strong>返回参数</strong>


返回数组，结构同[查询订单详情](/zh-CN/products/futures/Transaction_API/GetSingleOrderInfo)。

  </div>
  <div class='api-align'>

  <div class='code-wrap'>
<strong>返回示例</strong>

```json
[
  {
    "orderId": 702345678901234567,
    "symbol": "BTCUSDT",
    "side": "BUY",
    "positionSide": "LONG",
    "status": "FILLED",
    "type": "LIMIT",
    "time": 1764400000000,
    "price": "65000",
    "origQty": "0.01",
    "executedQty": "0.01",
    "avgPrice": "64999.5",
    "updateTime": 1764400001234,
    "clientOrderId": "hist-1",
    "cumQuote": "649.995",
    "timeInForce": "GTC"
  }
]
```
  </div>
    </div>
</div>