1. API 정보

빗썸 WebSocket은 인증 없이 사용할 수 있는 Public 타입과 인증을 거쳐야 사용할 수 있는 Private 타입으로 구분됩니다.

Public (v1)

• 엔드포인트: wss://ws-api.bithumb.com/websocket/v1
• 스트림: ticker, trade, orderbook

Private (v2)

• 엔드포인트: wss://ws-api.bithumb.com/websocket/v2/private
• 스트림: myOrder, myAsset

메시지 압축

WebSocket은 데이터 전송 효율을 개선하기 위해 permessage-deflate 확장을 사용한 메시지 압축을 지원합니다.

클라이언트가 WebSocket 연결 과정에서 permessage-deflate를 요청하고 서버가 이를 수락하면, 해당 연결에서 전송되는 메시지에 압축이 적용됩니다. 압축을 요청하지 않거나 지원하지 않는 클라이언트는 압축 없이 기존과 동일하게 연결할 수 있습니다.

일반적인 WebSocket 라이브러리는 압축 요청과 수신 메시지의 압축 해제를 자동으로 처리합니다. 압축 적용 여부와 관계없이 구독 요청 및 수신 메시지의 JSON 구조는 동일합니다.

WebSocket 프레임을 직접 처리하거나 자체 WebSocket 클라이언트를 구현한 경우에는 RFC 7692 규격을 참고하세요.

2. 요청 수 제한 안내

• WebSocket 연결 요청은 IP 기준 초당 10회로 제한됩니다(Public, Private 동일).
• 제한을 초과한 요청에는 429 Too Many Requests 응답이 반환됩니다.
• 과도한 연결 요청이 지속되는 경우, 해당 IP가 차단되어 10분 간 WebSocket 사용이 일시적으로 제한될 수 있습니다. 제한이 해제될 때까지 잠시 대기한 후 재요청하세요.

3. 데이터 타입

각 정보는 스냅샷과 실시간 정보로 구분되며, WebSocket으로 각 정보를 요청할 수 있습니다.

요청 방식에 따라 받아볼 수 있는 데이터는 달라질 수 있으며 스냅샷과 실시간 둘 다, 또는 하나의 정보만 요청할 수도 있습니다.

• 스냅샷 : 요청 당시의 상태를 의미합니다.
• 실시간 : 요청 정보가 스트림 형태로 지속적으로 전달됩니다.

Public 타입

별다른 인증 없이 수신할 수 있는 데이터입니다. v1 응답 스펙을 사용합니다(스냅샷, 실시간 정보 제공).

• ticker: 현재가
• trade: 체결
• orderbook: 호가

Private 타입

인증을 해야만 수신할 수 있는 데이터 타입입니다. v2 응답 스펙을 사용합니다.

인증에 대한 자세한 내용은 요청 방법 및 포맷 페이지를 확인하시기 바랍니다.

• myOrder: 내 주문
• myAsset: 내 자산