BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)
마진·파생 상품을 다루는 BitMEX는 WebSocket API로 시장 데이터와 계정 정보를 실시간으로 제공합니다. 채널 이름이 영어 위주이고 종류가 많아 처음에는 혼란스럽지만, 이 문서는 BitMEX의 채널을 한눈에 파악하도록 돕습니다. BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)을 기준으로 공개 채널과 인증 채널을 구분해 설명합니다.
실전 구현에 바로 활용할 수 있게 핵심 용도와 구독 방식, 주의할 점을 간결하게 정리했습니다.
1. BitMEX WebSocket 기본 개념
BitMEX WebSocket의 접속 기본 주소는 다음과 같습니다.
wss://www.bitmex.com/realtime
연결 후 subscribe 명령으로 원하는 채널을 등록합니다. 예를 들어 XBTUSD의 체결과 오더북을 받으려면:
{
"op": "subscribe",
"args": [
"trade:XBTUSD",
"orderBookL2_25:XBTUSD"
]
}
많은 채널은 채널이름:심볼 형태로 심볼을 함께 지정합니다. BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)는 이 구독 패턴을 표준으로 다룹니다.
2. 공개 채널 (비인증, Public)
인증 없이 누구나 구독 가능한 Public WebSocket 채널입니다. 실시간 시세, 오더북, 체결, 펀딩 정보와 거래소 공지 등 시장 전반의 데이터가 포함됩니다. BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)의 공개 채널 목록을 이해하면 필요한 데이터만 골라 받을 수 있습니다.
| 채널 이름 | 설명 (한글) |
|---|---|
announcement |
거래소가 발행하는 사이트 공지 메시지 (점검·업데이트·이벤트 안내 등) |
chat |
공개 채팅 스트림, 소위 ‘트롤 박스’의 메시지를 전달 |
connected |
현재 접속자 수와 같은 연결 통계 정보 |
funding |
각 상품의 펀딩 비율 업데이트. 스왑 펀딩(보통 8시간 단위) 정보를 전송합니다. |
instrument |
상품의 상태와 시세 관련 업데이트 (마크 가격, 인덱스, 고저, bid/ask 등) |
insurance |
보험기금의 변동 및 일별 업데이트 정보를 제공 |
liquidation |
시장의 강제청산 주문 스트림. 청산 주문이 오더북에 추가되는 이벤트를 전달. |
orderBookL2_25 |
레벨2 오더북의 상위 25개 호가 레벨만 전송해 대역폭을 절감할 수 있음. |
orderBookL2 |
전체 레벨2 오더북 스트림. 모든 호가 수준의 변경을 포함하므로 데이터량이 큽니다. |
orderBook10 |
기존 방식의 상위 10단계 호가 정보. 상대적으로 가볍고 주요 호가 파악에 적합. |
publicNotifications |
전체 사용자 대상의 공개 알림 (짧은 공지·유지보수 안내 등) |
quote |
최상위 호가(Best Bid/Ask) 정보. 책의 맨 위만 빠르게 확인할 때 사용. |
quoteBin1m |
1분 단위로 집계된 호가(quote) 통계 |
quoteBin5m |
5분 단위 호가 집계 |
quoteBin1h |
1시간 단위 호가 통계 |
quoteBin1d |
1일 단위 호가 통계 |
settlement |
선물·스왑 상품의 정산 정보 |
trade |
실시간 체결(trade) 스트림. 각 거래의 가격, 수량, 방향을 즉시 수신. |
tradeBin1m |
1분 단위로 집계되는 체결(캔들/바) 데이터 |
tradeBin5m |
5분 단위 체결 집계 데이터 |
tradeBin1h |
1시간 단위 체결 집계 |
tradeBin1d |
1일 단위 체결 집계 |
tradeBin*, quoteBin*를 사용하고,
실시간 호가·체결 흐름은 orderBook*, trade, quote가 적합합니다.
3. 인증 채널 (Private – API 키 필요)
아래 채널들은 API 키 인증이 필요합니다. 본인 계정의 주문·포지션·마진·지갑 상태 등 민감한 정보를 실시간으로 받습니다. BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)에서 소개하는 주요 인증 채널의 용도를 정확히 이해해 두세요.
| 채널 이름 | 설명 (한글) |
|---|---|
affiliate |
추천 프로그램 관련 제휴 상태 정보(추천 수, 수수료/리베이트 등). |
execution |
개인 주문의 체결 이벤트 스트림. 하나의 주문에 여러 체결이 발생할 때 각각 푸시됩니다. |
order |
본인의 주문 상태 변경(신규, 부분체결, 전체결, 취소 등)을 실시간으로 전달합니다. |
margin |
계정의 잔액, 사용 가능 마진, 유지 마진 등 마진 관련 수치가 갱신됩니다. |
position |
보유한 포지션의 변동을 전송합니다. 진입·청산·평균가·미실현 PnL 등을 포함합니다. |
privateNotifications |
특정 사용자에게 전달되는 개인 알림 채널. 문서상 사용되지 않는 경우도 있습니다. |
transact |
입금·출금과 관련된 트랜잭션 상태 업데이트(요청, 처리, 완료 등). |
wallet |
지갑 잔액과 누적 입출금 내역을 전달합니다. 주소별 잔고와 자산 흐름을 모니터링할 때 유용합니다. |
4. 예시: 인증 후 Private 채널 구독
아래 예시는 연결 후 인증 메시지를 보내고 position, margin, order 채널을 구독하는 흐름을 보여줍니다.
먼저 인증으로 세션에 권한을 부여한 뒤 필요한 채널만 구독하는 것이 일반적입니다.
{
"op": "authKeyExpires",
"args": [
"API_KEY",
EXPIRES,
"SIGNATURE"
]
}
// 인증 성공 후
{
"op": "subscribe",
"args": [
"position",
"margin",
"order"
]
}
EXPIRES와 SIGNATURE는 서버 시간과 API Secret을 바탕으로 HMAC 방식으로 생성해야 합니다.
구현 시 서버 시간 동기화와 서명 생성 절차를 정확히 따르세요.
5. 정리
- 공개 채널은 시세, 호가, 체결, 펀딩, 청산, 공지 등 시장 데이터 전달에 적합합니다.
- 인증 채널은 내 계정 기준의 주문·포지션·마진·지갑·입출금 정보를 실시간으로 받는 데 사용합니다.
-
tradeBin*,quoteBin*은 집계(캔들/바) 데이터용이고,orderBook*,trade,quote는 실시간 흐름 데이터에 가깝습니다. - 실무에서는 필요한 채널만 선택해 구독해 대역폭과 연산 리소스를 절약하는 것이 중요합니다.
BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)을 바탕으로 채널 용도를 정리해 두면, 구독 설계와 파싱 로직을 빠르게 구현할 수 있습니다. 필요에 따라 각 채널의 메시지 포맷을 확인해 안정적으로 처리하세요.
함께 보면 좋은 엔터프라이즈 사례
🚀 이 주제, 우리 서비스에 어떻게 적용할까요?
BitMEX 실시간 데이터 WebSocket 채널 설명서 (trade, orderBookL2, margin, wallet 등)를 실제 서비스와 조직에 녹여보고 싶다면, 현재 아키텍처와 운영 방식을 한 번 점검해 보는 것부터 시작해 보세요. 팀 위키나 기술 블로그, 사내 스터디 주제로도 아주 좋습니다.
이 글이 도움이 됐다면, 비슷한 엔터프라이즈 사례 글들도 함께 살펴보면서 우리 조직에 맞는 운영 상용구를 정의해 보세요.
댓글
댓글 쓰기