Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Websocket
Public
    Tickers ChannelCandlestick ChannelDepth ChannelPublic Trades ChannelRPI Depth ChannelLiquidation Channel
Private
Reality
SBE
Public

Liquidation Channel

Description

Liquidation Channel.

Data is pushed once per second (1s/interval). Each push contains the aggregated liquidation data for the previous second: only the record with the highest liquidation quantity for long and short positions respectively per trading pair is included. Both Unified Trading Account and Classic Account liquidation data are covered. For any given trading pair within a single second, at most 2 records are delivered (1 for long, 1 for short).

Code
{ "args": [ { "instType": "usdt-futures", "topic": "liquidation" } ], "op": "subscribe" }

Request Parameters

ParametersTypeRequiredDescription
opStringYesOperation
subscribe Subscribe
unsubscribe Unsubscribe
argsList<Object>YesSubscribed channel
> instTypeStringYesProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringYesTopic
liquidation Liquidation channel
Code
{ "event": "subscribe", "arg": { "instType": "usdt-futures", "topic": "liquidation" }, "connId": "xxxxxxxxxx" }

Response Parameters

ParametersTypeDescription
eventStringEvent
argObjectSubscribed channel
> instTypeStringProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringTopic
liquidation Liquidation channel
codeStringError code
msgStringError message
connIdStringConnection ID
Code
{ "data": [ { "symbol": "BTCUSDT", "side": "buy", "price": "89000", "amount": "37.722858", "ts": "1736371332162" } ], "arg": { "instType": "usdt-futures", "topic": "liquidation" }, "action": "update", "ts": 1736371332162 }

Push Parameters

ParametersParameter TypeDescription
argObjectSubscribed successful channel
> instTypeStringProduct type
usdt-futures USDT futures
coin-futures Coin-M futures
usdc-futures USDC futures
> topicStringTopic
liquidation Liquidation channel
actionStringData push action
snapshot Full data
update Incremental data
dataList<Object>Subscribed data
>symbolStringSymbol name
>sideStringPosition side
buyLong position liquidation
sellShort position liquidation
>priceStringLiquidation price
>amountStringLiquidation amount
Unit: quote coin. For example, 37.722858 means 37.722858 quote coins of the position were liquidated.
>tsStringLiquidation time (Unix millisecond timestamp)
RPI Depth ChannelPlace Order Channel
JSON
JSON
JSON