Get Auto Deleverage History

Type: GET
Description: /future/user/v1/auto-deleverage/history

---

Rate Limit
200/s/apikey

---

Request Parameters

Name	Type	Required	Default	Description	Range
id	integer	FALSE	1	Page number
direction	string	FALSE	NEXT	NEXT; PREVIOUS
limit	integer	FALSE	10	Page size
startTime	integer	FALSE	N/A	Start time	Default queries the last 90 days
endTime	integer	FALSE	N/A	End time
symbol	string	FALSE	N/A	Trading pair

---

Request Example

curl -G "https://fapi.xt.com/future/user/v1/auto-deleverage/history" \
  -H "validate-appkey: $APPKEY" \  # Required
  -H "validate-timestamp: $TIMESTAMP" \  # Required
  -H "validate-singature: $SIGNATURE" \  # Required
  -H "Content-Type: application/x-www-form-urlencoded" \  # Required
  -d "symbol=btc_usdt" \ 
  -d "page=1" \
  -d "size=10" \ 
  -d "startTime=1762074200000"  \
  -d "endTime=1762074242467" \

---

Response Example

{
    "error": {
      "code": "",
      "msg": ""
    },
    "msgInfo": "",
    "result": {
      "hasNext": false,   // Whether there is a next page
      "hasPrev": false,   // Whether there is a previous page
      "items": [          // Data list
        {
          "id": "2876543210987654321",                      // string, ADL record ID (Long to string)
          "symbol": "BTCUSDT",                              // string, trading pair
          "positionSide": "LONG",                           // string, "LONG" long / "SHORT" short
          "quantity": "0.028",                              // string, ADL reduced quantity (contracts)
          "price": "67234.50",                              // string, ADL execution price
          "realizedProfit": "-87.60",                       // string, realized PnL from ADL (usually negative)
          "createdTime": 1735698765432,                     // number, ADL timestamp (ms)
          "welfareAccount": false,                          // boolean, welfare account indicator
          "uid": 10086,                                     // number, user UID (raw Long)
          "accountId": 900123456789                         // number, account ID (raw Long)
        }
      ]
    },
    "returnCode": 0
}

---

Error Codes

Error code	Description
invalid_direction	direction incorrect
invalid_limit	limit parameter incorrect
invalid_symbol	Trading pair does not exist

---