
# Get Order History (USER_DATA)

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

Weight(IP): 10

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


<strong>Request parameters</strong>


| Parameter | Type    | Required? | Description |
|-----------|---------|-----------|-------------|
| symbol    | String  | No        | Filter by trading pair. |
| limit     | Integer | No        | Number of records per page, 1-100. Default 100. |
| startTime | Long    | No        | Start time (ms). Must be less than or equal to `endTime`. |
| endTime   | Long    | No        | End time (ms). Must be within 90 days of `startTime`. |
| page      | Integer | No        | Page index starting from 0. Default 0. |

</div>
<div class='api-align'>
  <div class='code-wrap'>
<strong>Request example</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>Response parameters</strong>


Returns an array of objects identical to [Get Order Info](/products/futures/Transaction_API/GetSingleOrderInfo#response-parameters).

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

  <div class='code-wrap'>
<strong>Response example</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>
