Skip to main content

Get Cross Liquidation Orders

Frequency limit:10 times/1s (UID)

Description

HTTP Request

  • GET /api/v2/margin/crossed/liquidation-order
Request Example
curl "https://api.bitget.com/api/v2/margin/crossed/liquidation-order?startTime=1704100405000&endTime=1706174005091&limit=20" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \

Request Parameters

ParameterTypeRequiredDescription
typeStringNoswap
place_order
Default place_order
symbolStringNoTrading pairs, like BTCUSDT
This field only takes effect when type=place_order
Default all symbols
fromCoinStringNoSwap from coin
This field only takes effect when type=swap
toCoinStringNoSwap to coin
This field only takes effect when type=swap
startTimeStringNoStart time, Unix millisecond timestamp
endTimeStringNoEnd time, Unix millisecond timestamp
Maximum interval between start time and end time is 90 days
limitStringNoNumber of quiries
Default: 100, maximum: 500
idLessThanStringNoFor turning pages. The first query is not passed. When querying data in the second page and the data beyond, the last endId returned in the last query is used, and the result will return data with a value less than this one; the query response time will be shortened.
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1708654712083,
"data": {
"resultList": [
{
"symbol": "BTCUSDT",
"orderType": "market",
"side": "liquidation-sell",
"priceAvg": "43024.762472",
"price": "43024.762472",
"fillSize": "1",
"size": "1",
"amount": "43024.762472",
"orderId": "1131405566368010241",
"fromCoin": "",
"toCoin": "",
"fromSize": "",
"toSize": "",
"cTime": "1705474028200",
"uTime": "1705474028398"
}
],
"idLessThan": "1131405566368010241"
}
}

Response Parameters

ParameterTypeDescription
orderIdStringOrder no.
symbolStringTrading pair
This field only takes effect when type=place_order
orderTypeStringOrder type
market: market price
This field only takes effect when type=place_order
sideStringDirection
liquidation_sell: Settlement – sell
liquidation_buy: Settlement – buy
This field only takes effect when type=place_order
priceAvgStringOrder price
This field only takes effect when type=place_order
priceStringOrder price
This field only takes effect when type=place_order
fillSizeStringFilled quantity
This field only takes effect when type=place_order
sizeStringFilled quantity
This field only takes effect when type=place_order
amountStringFilled quantity
This field only takes effect when type=place_order
fromCoinStringExchange currency
This field only takes effect when type=swap
fromSizeStringExchange currency
This field only takes effect when type=swap
toCoinStringExchange currency
This field only takes effect when type=swap
toSizeStringExchange currency
This field only takes effect when type=swap
cTimeStringCreation time
uTimeStringUpdated time

How was your Reading Experience with us?