bybit . API V5 . 웹소켓 Kline . 실시간 캔들 수신

 

 

 

웹소켓으로 실시간 캔들 수신 

 

 

웹소켓 구독 해지 공통사항 : https://igotit.tistory.com/4946

 

웹소켓 Kline 요청하기.  

subscribe Topic 

kline.{interval}.{symbol} e.g., kline.30.BTCUSDT

 

interval 설정 가능값 : 1 3 5 15 30 60 120 240 360 720 D W M 

 

subscribe 구문 예 

파이썬 pybit 패키지 이용한 요청예 . 리니어 BTCUSDT 의 5분 봉 실시간 캔들 정보 요청한것. 

from pybit.unified_trading import WebSocket
from time import sleep
ws = WebSocket(
    testnet=True,
    channel_type="linear",
)
def handle_message(message):
    print(message)
ws.kline_stream(
    interval=5,
    symbol="BTCUSDT",
    callback=handle_message
)
while True:
    sleep(1)

 

 

웹소켓 Kline . 수신 데이터 예 

{
    "topic": "kline.5.BTCUSDT",
    "data": [
        {
            "start": 1672324800000,
            "end": 1672325099999,
            "interval": "5",
            "open": "16649.5",
            "close": "16677",
            "high": "16677",
            "low": "16608",
            "volume": "2.081",
            "turnover": "34666.4005",
            "confirm": false,
            "timestamp": 1672324988882
        }
    ],
    "ts": 1672324988882,
    "type": "snapshot"
}

 

각 데이터 항목 의미 

 

Parameter	Type	Comments
topic	string	Topic name
type	string	Data type. snapshot
ts	number	The timestamp (ms) that the system generates the data
data	array	Object
> start	number	The start timestamp (ms)
> end	number	The end timestamp (ms)
> interval	string	Kline interval
> open	string	Open price
> close	string	Close price
> high	string	Highest price
> low	string	Lowest price
> volume	string	Trade volume
> turnover	string	Turnover
> confirm	boolean	Weather the tick is ended or not
> timestamp	number	The timestamp (ms) of the last matched order in the candle

 

항목 상세 설명 

 

- volume : 계약(contract) 단위의 거래량. 현물에서는 base currency 단위의 거래량 

  - -  리니어  BTCUSDT 이면 conteact 1BTC 이므로 BTC 단위의 거래량.  

  - -   인버스 BTCUSD 이면 contract 1USD 이므로 USD 단위의 거래량 

  - -  현물  BTCUSDT 이면 base currency 가 BTC 이므로 BTC 단위의 거래량. 

 

- turnover : quote currency 단위의 거래량.

 - -  리니어 BTCUSDT 이면 turnover 는 USDT 단위의 거래량.

 - - 인버스 BTCUSD 이면 turnover 는 BTC 단위의 거래량. 

 - - 현물 BTCUSDT 이면 turnover 는 USDT 단위의 거래량. 

 

volume 이든 turnover 든 값 자체가 차이가 날뿐 증가 감소 양상은 동일함. 

 

- confirm : 봉 완성 시점에만 이 값이 true 가 된다. 그 외는 false .  

 

 

상위 정리

 

bybit api v5 . 활용방법 정리

 

 

 

연관

과거 캔들 데이터 확보 

 

bybit . API V5 . rest . Get Kline . 캔들 백데이터

 

 

 

 

 

 

---

첫 등록 : 2024.08.25

최종 수정 : 

단축 주소 : https://igotit.tistory.com/5778

---