웹소켓 / 주문 채널

엔드포인트: /ws/v1/spot/order

채널 이름

order

설명

이 채널은 다음을 포함하여 현물 거래와 관련된 실시간 주문 이벤트를 푸시합니다: - 새로운 주문 생성 - 주문 취소 - 체결 업데이트

구독 매개변수

매개변수	필수 여부	타입	예시	설명
op	예	string	sub	작업: 구독은 sub, 구독 취소는 unsub
channel	예	string	order	채널 이름
token	예	string	57ba172a6be125cca2f449826f9980ca	사용자 토큰. 개인 센터 → OpenAPI에서 확인 가능
Nonce	예	string	1534927978_ab43c	요청마다 생성되는 임의의 Nonce. 형식: 타임스탬프_임의문자열(5). 시간 오차는 60초를 초과할 수 없으며, 각 Nonce는 한 번만 사용 가능합니다.
Signature	예	string	v490hupi0s0bckcp6ivb69p921	token, secret_key, nonce를 사용하여 생성된 요청 서명. 검증 규칙은 REST API 서명과 동일합니다.

구독 예시

JSON

{
  "op": "sub",
  "channel": "order",
  "token": "57ba172a6be125cca2f449826f9980ca",
  "Nonce": "1534927978_ab43c",
  "Signature": "v490hupi0s0bckcp6ivb69p921"
}

푸시 데이터 매개변수

매개변수	필수 여부	타입	예시	설명
channel	예	string	order	채널 이름
ts	예	number	1502448920	푸시 타임스탬프 (초)
order	예	object	아래 참조	주문 데이터

주문 객체 필드

매개변수	필수 여부	타입	예시	설명
symbol	예	string	BTC-USDT	거래쌍
order_id	예	string	BG5000181583375122413SZXEIX	주문 ID
side	예	string	SELL	주문 방향
order_type	예	string	LIMIT	주문 유형: LIMIT (지정가 주문), MARKET (시장가 주문)
amount	예	string	20	원본 주문 수량. 시장가 매수 주문의 경우 주문 금액을 나타냅니다.
entrust_time	예	number	1502448920	주문 제출 시간 (초)
price	예	string	68000	주문 가격. 시장가 주문의 경우 비어 있음
trigger_price	아니요	string	70000	조건부 주문의 트리거 가격
event	예	string	NEW	이벤트 유형: NEW (새 주문), CANCELED (주문 취소됨), TRADE (체결 발생)
status	예	string	NEW	주문 상태: NEW, PARTIALLY_FILLED, FILLED, PARTIALLY_CANCELED, CANCELED
last_amount	아니요	string	12	최근 체결 수량
last_price	아니요	string	68000	최근 체결 가격
last_fee	아니요	string	0.23	최근 체결 수수료
ts	아니요	number	1502448920	체결 타임스탬프 (초)

푸시 예시

JSON

{
  "channel": "order",
  "ts": 1710208544,
  "order": {
    "symbol": "ETH-USDT",
    "side": "BUY",
    "amount": "",
    "last_price": "",
    "last_fee": "",
    "last_amount": "",
    "price": "3800",
    "event": "NEW",
    "order_id": "BL2217102085443303CZQ2P",
    "order_type": "LIMIT",
    "status": "NEW",
    "ts": ""
  }
}