개요

API 구성

빗썸 API는 Public API, Private API, WebSocket 세 가지로 구분됩니다.

구분	인증	설명
Public API	불필요	시세, 호가, 캔들, 체결 내역 등 시장 데이터를 조회합니다.
Private API	JWT(JSON Web Token) 인증 필요	계좌 조회, 주문, 입출금 등 사용자 자산과 관련된 기능을 수행합니다.
WebSocket	Public: 불필요 / Private: JWT 인증 필요	실시간 시세, 호가, 체결, 내 주문, 내 자산 데이터를 스트리밍으로 수신합니다.

Base URL

구분	Base URL
REST API	`https://api.bithumb.com`
Public WebSocket	`wss://ws-api.bithumb.com/websocket/v1`
Private WebSocket	`wss://ws-api.bithumb.com/websocket/v2/private`

REST API의 버전(/v1 또는 /v2)은 엔드포인트마다 다르며, 각 API 페이지 경로에 표시됩니다. Public WebSocket은 v1, Private WebSocket은 v2 경로를 사용합니다.

Public API

인증 없이 호출할 수 있는 시장 데이터 조회 API입니다.

거래 대상 목록 조회

빗썸에서 제공하는 거래 대상 페어(Trading Pairs) 목록을 조회합니다.

캔들 조회

분/일/주/월 단위 캔들 데이터를 조회합니다.

체결(Trade) 내역 조회

최근 체결된 거래 내역을 조회합니다.

현재가(Ticker) 조회

요청 시점의 종목 스냅샷(현재가, 거래량 등)을 조회합니다.

호가(Orderbook) 조회

지정한 거래 대상 페어의 호가 정보를 조회합니다.

경보제 조회

투자 주의가 필요한 거래 대상 페어와 경보 유형 및 단계를 조회합니다.

공지사항 조회

빗썸 공지사항을 조회합니다.

입출금 수수료 조회

빗썸에 상장된 가상자산의 입출금 수수료 정보를 조회합니다.

Private API

Private API를 호출하려면 JWT 인증이 필요합니다. API KEY와 SECRET KEY로 JWT 토큰을 생성하고, Authorization 헤더에 토큰을 포함하여 요청하세요.

API 레퍼런스의 코드 샘플에서는 편의상 '발급받은 API KEY'를 직접 입력하는 형태로 제공됩니다. 실제 프로젝트에서는 .env 파일 등을 활용하여 키를 안전하게 관리하세요. 자세한 방법은 개발 환경 설정하기를 참고하세요.

계좌

전체 자산 조회

보유 중인 자산 정보를 조회합니다.

주문

주문 가능 정보

거래 대상 페어별 주문 가능 정보(수수료, 제약사항 등)를 조회합니다.

개별 주문 조회

개별 주문 내역을 조회합니다.

주문 리스트 조회

주문 목록을 조회합니다.

다건 주문 조회

주문 ID 목록으로 주문을 조회합니다. (v2, 최대 100건)

대기 주문 목록 조회

체결 대기(wait) 또는 주문 대기(watch) 상태의 주문 목록을 조회합니다. (v2)

종료 주문 목록 조회

처리 완료(done) 또는 취소(cancel)된 주문 목록을 조회합니다. (v2, 최대 7일)

주문 요청

지정가/시장가 주문을 요청합니다. (v2)

다건 주문 요청

여러 건의 주문을 한 번에 요청합니다. (v2, 최대 20건)

주문 취소 접수

주문 취소를 요청합니다. (v2)

다건 주문 취소 접수

여러 건의 주문을 일괄 취소 요청합니다. (v2, 최대 30건)

TWAP(Time-Weighted Average Price) 주문

TWAP - 주문 요청

TWAP 주문을 요청합니다.

TWAP - 주문 내역 조회

TWAP 주문 목록을 조회합니다.

TWAP - 주문 취소

TWAP 주문 취소를 요청합니다.

출금

출금 가능 정보

해당 통화의 출금 가능 정보를 조회합니다.

개별 출금 내역을 조회합니다.

가상자산 출금 목록을 조회합니다.

원화 출금 목록을 조회합니다.

가상 자산 출금을 요청합니다.

가상 자산 출금을 취소합니다.

등록된 출금 계좌로 원화 출금을 요청합니다.

출금 허용 주소 리스트 조회

등록된 출금 허용 주소 리스트를 조회합니다.

입금

개별 입금 내역을 조회합니다.

가상자산 입금 목록을 조회합니다.

원화 입금 목록을 조회합니다.

원화 입금을 요청합니다.

입금 주소 생성을 요청합니다.

전체 입금 주소를 조회합니다.

가상자산별 입금 주소를 조회합니다.

기타

입출금 현황

입출금 현황과 블록 상태를 조회합니다.

API 키 리스트 조회

API 키 리스트와 만료 일자를 조회합니다.

WebSocket

WebSocket을 사용하면 실시간 데이터를 스트리밍으로 수신할 수 있습니다. REST API는 클라이언트가 반복 요청(폴링)해야 하지만, WebSocket은 한 번 연결하면 서버가 데이터를 지속적으로 푸시합니다. 빈번한 시세 업데이트가 필요한 경우 WebSocket을 사용하세요.

접속 제한: IP당 초당 최대 10회 연결 요청

Public WebSocket

인증 없이 시장 데이터를 실시간으로 수신합니다.

엔드포인트: wss://ws-api.bithumb.com/websocket/v1

타입	설명
현재가 (Ticker)	종목의 현재가, 변동률, 거래량 등 실시간 시세 스냅샷
체결 (Trade)	실시간 체결 내역 (체결가, 체결량, 매수/매도 구분)
호가 (Orderbook)	실시간 매수/매도 호가 및 잔량

현재가 (Ticker)

종목의 현재가, 변동률, 거래량 등 실시간 시세 스냅샷을 수신합니다.

체결 (Trade)

실시간 체결 내역(체결가, 체결량, 매수/매도 구분)을 수신합니다.

호가 (Orderbook)

실시간 매수/매도 호가와 잔량을 수신합니다.

Private WebSocket

JWT 인증을 통해 사용자 개인 데이터를 실시간으로 수신합니다.

엔드포인트: wss://ws-api.bithumb.com/websocket/v2/private

타입	설명
내 주문 및 체결 (MyOrder)	내 주문 상태 변경, 체결 내역을 실시간으로 수신
내 자산 (MyAsset)	보유 자산 잔액 변동을 실시간으로 수신

내 주문 및 체결 (MyOrder)

내 주문의 접수, 체결, 완료, 취소 이벤트를 실시간으로 수신합니다. (Private v2)

내 자산 (MyAsset)

보유 자산의 변동을 실시간으로 수신합니다. (Private v2)

MyOrder v1 스펙은 v2와 동시 운영 후 종료될 예정입니다. 신규 개발 시 v2를 사용하고, 기존 v1 사용자는 Private v2 마이그레이션 가이드를 참고하여 전환하세요. v1 응답 스펙은 내 주문 및 체결(MyOrder) v1 페이지에서 확인할 수 있습니다.

WebSocket 상세 문서

기본 정보

WebSocket 엔드포인트, 접속 제한 등 기본 정보를 확인합니다.

요청 방법 및 포맷

WebSocket 요청 메시지 구조와 포맷을 확인합니다.

테스트 및 요청 예제

WebSocket 연결 테스트 방법과 요청 예제를 확인합니다.

웹소켓 에러

WebSocket 에러 코드와 처리 방법을 확인합니다.

연결 관리

Ping/Pong, 연결 유지, 재접속 전략을 확인합니다.