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

2. 요청 수 제한 안내

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

3. 데이터 타입

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

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

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

Public 타입

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

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

Private 타입

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

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

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