WebSocket API에 대해 배워보자
Binance Futures API 개발에 입문하려면, 실시간 데이터를 효과적으로 처리하기 위해 WebSocket을 이해하는 것이 중요합니다.
이 튜토리얼에서는 Binance Futures의 WebSocket API를 사용하는 방법을 설명하고, 아래의 차이를 설명해 드리겠습니다.
(1) 공용 WebSocket
(2) 개인 WebSocket
WebSocket API란?
WebSocket은 앱과 Binance 서버 간의 지속적인 연결을 유지하여, 실시간으로 데이터를 주고받을 수 있게 해줍니다. 이를 통해 시장 데이터와 계좌 데이터를 즉시 처리할 수 있습니다.
- 주요 WebSocket 엔드포인트:
wss://ws-fapi.binance.com/ws-fapi/v1 - 테스트넷 WebSocket 엔드포인트:
wss://testnet.binancefuture.com/ws-fapi/v1
이 두 엔드포인트는 각각 공용 데이터와 개인 데이터 스트림에 접근할 수 있게 해줍니다.
연결 유지 방법
WebSocket 서버에 연결되면, 서버는 3분마다 ping 프레임을 전송합니다. 클라이언트는 이를 받은 후 pong 프레임으로 응답해야 하며, 만약 10분 동안 서버가 pong 프레임을 받지 못하면 연결이 끊깁니다. 따라서 이 ping-pong 메커니즘을 처리하여 연결이 끊기지 않도록 관리하는 것이 중요합니다.
WebSocket의 종류
1. 공용 WebSocket (Public WebSocket)
공용 WebSocket은 모든 사용자에게 접근 가능하며, 실시간 시장 데이터를 스트리밍하는 데 사용됩니다. 제공하는 데이터는 다음과 같습니다:
- 호가창 (Order Book): 실시간으로 매수/매도 주문 정보를 받을 수 있습니다.
- 거래 내역 (Trade History): 시장에서 발생하는 최신 거래를 볼 수 있습니다.
- 가격 변동 (Price Changes): 실시간 가격 변동을 추적할 수 있습니다.
이 엔드포인트는 wss://ws-fapi.binance.com/ws-fapi/v1에서 접근할 수 있으며, 누구나 시장 상황을 실시간으로 모니터링할 수 있습니다.
2. 개인 WebSocket (Private WebSocket)
개인 WebSocket은 listen key라는 고유 키를 사용하여, 개별 사용자의 개인 계좌 데이터에 접근합니다. 이를 통해 다음과 같은 정보를 실시간으로 받을 수 있습니다:
- 계좌 잔고
- 오픈 포지션
- 실시간 거래 내역
이 개인 WebSocket은 wss://fstream.binance.com/ws/{listenKey}에서 연결하며, 계정 관련 알림을 받고 싶을 때 사용됩니다. Listen key는 Binance API를 통해 발급받을 수 있습니다.
공용 WebSocket과 개인 WebSocket의 차이점
- 공용 WebSocket: 시장 데이터를 실시간으로 제공하며, 누구나 사용할 수 있습니다. 주로 호가창, 가격 변동, 거래 내역 등의 시장 정보 수집에 사용됩니다.
- 개인 WebSocket: 계정 정보와 관련된 데이터를 스트리밍하며, 사용자 개인의 포지션, 거래 내역, 잔고 변경 등을 실시간으로 알림 받을 수 있습니다.
결론
Binance WebSocket을 사용하면 실시간으로 데이터를 처리할 수 있는 두 가지 주요 방법이 있습니다. 공용 WebSocket은 시장 데이터를 모니터링하는 데 유용하고, 개인 WebSocket은 자신의 계좌와 거래 활동을 추적하는 데 필수적입니다. 두 가지 모두를 잘 활용하면 더욱 효율적인 자동 거래 시스템을 구축할 수 있습니다.
실시간 거래 시스템을 만들거나 시장을 모니터링하려는 개발자들에게 WebSocket은 필수적인 도구입니다.