개요

빗썸 Open API의 전체 구성과 인증 방식을 안내합니다.

API 구성

빗썸 API는 Public API와 Private API로 구분됩니다.

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

Base URL

REST API:      https://api.bithumb.com

Public API

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

거래 대상 목록 조회

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

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

체결(Trade) 내역 조회

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

현재가(Ticker) 조회

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

호가(Orderbook) 조회

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

경보제 조회

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

Private API

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

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

계좌

전체 계좌 조회

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

주문

주문 가능 정보

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

개별 주문 조회

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

주문 리스트 조회

주문 목록을 조회합니다.

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

주문 취소 접수

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

TWAP(Time-Weighted Average Price) 주문

TWAP - 주문 요청

TWAP 주문을 요청합니다.

TWAP - 주문 내역 조회

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

TWAP - 주문 취소

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

출금

출금 가능 정보

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

개별 출금 조회

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

코인 출금 리스트 조회

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

원화 출금 리스트 조회

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

가상 자산 출금 요청

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

원화 출금 요청

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

출금 허용 주소 리스트 조회

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

입금

개별 입금 조회

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

코인 입금 리스트 조회

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

원화 입금 리스트 조회

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

원화 입금을 요청합니다.

입금 주소 생성 요청

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

전체 입금 주소 조회

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

개별 입금 주소 조회

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

기타

입출금 현황

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

API 키 리스트 조회

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