웹소켓 / K라인 채널

엔드포인트: /ws/v1/futures/market

설명

실시간 K라인(캔들) 데이터를 제공합니다.
가장 빠른 푸시 주기는 1초입니다. 트리거 이벤트가 발생하지 않으면 데이터가 푸시되지 않습니다.
트리거 이벤트에는 체결이 포함됩니다.

채널 이름

kline${period}

참고: ${period}는 K라인 주기를 나타냅니다.
예를 들어, 1분 K라인은 kline1min을 사용합니다.

지원되는 주기는 아래와 같습니다:

주기	값
1분	1min
5분	5min
15분	15min
30분	30min
1시간	1hour
6시간	6hour
12시간	12hour
1일	1day
1주일	1week
1개월	1mon

구독 매개변수

매개변수	필수 여부	타입	예시	설명
op	예	string	sub	작업: 구독은 sub, 구독 취소는 unsub
channel	예	string	kline1min	채널 이름
symbol	예	string	BTC-USDT	거래쌍

응답 매개변수

매개변수	필수 여부	타입	예시	설명
errno	예	int	0	상태 코드
errmsg	예	string	success	상태 메시지
op	예	string	sub	작업: sub 또는 unsub
channel	예	string	kline1min	채널 이름
symbol	예	string	BTC-USDT	거래쌍

푸시 데이터 필드

매개변수	필수 여부	타입	예시	설명
channel	예	string	kline1min	채널 이름
symbol	예	string	BTC-USDT	거래쌍
id	예	long	1499184000	K라인 ID
amount	예	string	37593	체결 수량 (계약 수)
count	예	int	1	체결 횟수
open	예	string	1935.2000	시가
close	예	string	1879.0000	종가
low	예	string	1856.0000	저가
high	예	string	1940.0000	고가
vol	예	string	71031537.978665	거래대금

푸시 예시

JSON

{
  "channel": "kline1min",
  "symbol": "BTC-USDT",
  "id": 1499184000,
  "amount": "37593",
  "count": 1,
  "open": "1935.2000",
  "close": "1879.0000",
  "low": "1856.0000",
  "high": "1940.0000",
  "vol": "71031537.978665"
}