Liquidation

Real-time futures liquidation event stream. Unlike the other feeds, liquidations are event-driven — you receive one message per liquidation, no snapshot, no "current state". Subscribe to any {symbol}@{exchange} pair and the stream stays idle until a liquidation fires.

Connect

websocat

websocat wss://api.datamaxiplus.com/ws/v1/liquidation -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

wscat

wscat -c wss://api.datamaxiplus.com/ws/v1/liquidation -H 'X-DTMX-APIKEY: $YOUR_API_KEY'

Subscribe

params is a list of {symbol}@{exchange} entries. symbol is the exchange-native API symbol.

schema

{ "method": "SUBSCRIBE", "params": [ string ], "id": int32 }

example

{
  "method": "SUBSCRIBE",
  "params": ["BTC-USDT@bybit", "ETH-USDT@binance"],
  "id": 1
}

Response

protojson-encoded pb.Liquidation.

Field	Description
id	TokenId — Internal unified token id
e	Exchange — e.g. bybit
d	Timestamp — Event time in ms (UTC)
s	Symbol — Exchange-native API symbol
b	Base
q	Quote
sd	Side — buy or sell (the side that was liquidated)
p	Price — Liquidation price
pusd	PriceUsd — Liquidation price in USD (optional)
v	Volume — Liquidation volume in base units
vusd	VolumeUsd — Liquidation volume in USD (optional)

Example

{
  "id": "bitcoin",
  "e": "bybit",
  "d": 1776826789123,
  "s": "BTC-USDT",
  "b": "BTC",
  "q": "USDT",
  "sd": "buy",
  "p": 76321.5,
  "pusd": 76321.5,
  "v": 0.125,
  "vusd": 9540.18
}

Ping / Keepalive

Send {"method":"PING"} periodically to keep the connection alive.

Pricing

Each successful subscribe request costs 1 credit regardless of how many pairs are in params. Connection itself is free.