청산

실시간 선물 청산 이벤트 스트림입니다. 다른 피드와 달리 청산은 이벤트 기반이라, 청산 건당 한 번의 메시지가 전달되며 스냅샷이나 "현재 상태"는 없습니다. 구독한 {symbol}@{exchange} 페어에서 청산이 발생할 때까지는 스트림이 대기 상태로 유지됩니다.

연결

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'

구독

params는 {symbol}@{exchange} 항목의 리스트입니다. symbol은 거래소 네이티브 API 심볼입니다.

schema

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

example

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

응답

protojson 인코딩된 pb.Liquidation입니다.

필드	설명
id	TokenId — 내부 통합 토큰 id
e	Exchange — 예: bybit
d	Timestamp — 이벤트 시각 (ms, UTC)
s	Symbol — 거래소 네이티브 API 심볼
b	Base
q	Quote
sd	Side — 청산된 포지션의 방향 (buy 또는 sell)
p	Price — 청산 가격
pusd	PriceUsd — USD 환산 청산 가격 (옵션)
v	Volume — 기준 자산 단위 청산량
vusd	VolumeUsd — USD 환산 청산량 (옵션)

예시

{
  "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

연결 유지는 서버가 자동으로 처리합니다 — DataMaxi+ 서버가 30초마다 WebSocket 프로토콜 Ping 프레임을 전송하며, 표준 WebSocket 라이브러리는 자동으로 Pong 응답합니다. 연결을 유지하기 위해 클라이언트가 애플리케이션 수준 {"method":"PING"}을 보낼 필요는 없습니다.

전체 동작은 WebSocket API › Ping을 참고하세요.

요금

각 구독 요청은 params 안의 페어 수와 무관하게 1 credit이 과금됩니다. 연결 자체는 무료입니다.