Skip to main content

Get Position Auto Deleverage History

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.

HTTP request

GET /futures/position-adl-history

Request parameters

Parameter NameRequiredTypeNotes
marketfalsestringMarket name
market_typetruestringMarket type.
Note: In spot related functions, only SPOT or MARGIN can be used.
In futures related functions, only FUTURES can be used.
position_idfalseintPosition ID
start_timefalseintQuery start time.
  • Data will not be filtered based on time by default
end_timefalseintQuery end time.
  • Data will not be filtered based on time by default
pagefalseintNumber of pagination. Default is 1
limitfalseintNumber in each page. Default is 10

Return parameters

Parameter NameTypeNotes
marketstringMarket name
market_typestringMarket Type
position_idintPosition ID
order_idintOrder id
deal_idintTxid
amountstringFilled volume
pricestringFilled price
sidestringBuy or sell
rolestringTaker or maker
created_atintData creation time

Request example

GET /futures/position-adl-history?market=CETUSDT&market_type=FUTURES&position_id=927266133&start_time=1636451914231&page=1&limit=100

Response example

{
"code": 0,
"message": "OK",
"data": [
{
"market": " CETUSDT",
"market_type": "FUTURES",
"position_id": 927266133,
"order_id": 8678890,
"deal_id": 3514376759,
"amount": "0.00000325"
"price": "30718.42",
"side": "buy",
"role": "maker",
"created_at": 1691482451000
}
],
"pagination": {
"has_next": false
}
}