Skip to main content

Get Market Liquidation History

HTTP request

GET /futures/liquidation-history

Request parameters

Parameter NameRequiredTypeNotes
markettruestringMarket name
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
sidestringPosition side
liq_pricestringLiquidation price.
(Long position) Forced liquidation price = Settlement price * (1 - forced liquidation margin rate)/(1 - maintenance margin rate)
(Short position) Forced liquidation price = Settlement price * (1 + forced liquidation margin rate)/(1 + maintenance margin rate)
liq_amountstringLiquidation amount
bkr_pricestringBankruptcy price.
(Long position) Bankruptcy price = Settlement price * (1 - forced liquidation margin rate)
(Short position) Bankruptcy price = Settlement price * (1 + liquidation margin rate)
created_atintData creation time

Response example

GET /futures/liquidation-history?market=LATUSDT

Response example

{
"code": 0,
"data": [
{
"market": " LATUSDT",
"side": "long",
"liq_price": "0.009061",
"liq_amount": "184378262",
"brk_price": "0.009038",
"created_at": 1691482451000
},
{
"market": " LATUSDT",
"side": "long",
"liq_price": "0.009030",
"liq_amount": "375947238",
"brk_price": "0.009016",
"created_at": 1691482829000
}
],
"pagination": {
"has_next": false
},
"message": "OK"
}