빗썸 API 쉬운 사용법 - 잔고조회부터 주문까지 상세 설명

빗썸 API를 활용하면 가상자산 거래를 자동화할 수 있습니다. 이 포스팅에서는 파이썬을 이용해 빗썸 API에 연결하고, 계좌 잔고 확인, 실제 거래 수행 등을 하는 방법을 알아봅니다. API키만 있다면 누구나 쉽게 따라할 수 있게 실제 예제 코드와 함께 설명해드립니다.

이 포스팅에서는 빗썸 API 쉬운 사용법을 알아보았습니다.

인증키 발급

API를 사용하기 위해 먼저 인증키를 준비해야 합니다. 빗썸 홈페이지에서 API 키(Connect Key)와 시크릿 키(Secret Key)를 발급 받습니다. 이는 API 사용을 위한 필수 인증 수단입니다. 보안을 위해 API 키는 절대로 타인과 공유해서는 안 되며, 안전하게 보관해야 합니다. 하지만 단순히 시세 조회 목적이라면 API KEY를 발급 받지 않아도 이용할 수 있습니다.

빗썸 API 소개 페이지에서 API KEY 발급 페이지로 이동합니다.

API관리 페이지에 가면 API 1.0과 2.0 두 가지가 있습니다. 2.0은 아직 베타라 안전하게 1.0으로 신청합니다.

항목을 선택하고 보안 인증을 하면, API KEY 생성 버튼이 활성화됩니다. 이 버튼을 클릭하면 아래에 Connect Key와 Secret Key가 생성됩니다. Secret Key는 활성화 버튼을 누르면 사라지기 때문에, 미리 잘 적어둡니다.

활성화 버튼을 누르면 빗썸에서 SMS메시지가 옵니다. 메시지 하단에 url을 클릭하고 로그인하면 API가 활성화됩니다.

패키지 설치

빗썸 API 사이트에서 API 사용법을 확인하고, 직접 url을 소출해도 됩니다. 하지만 ‘pybithumb’ 패키지를 이용하면 더 쉽게 이용할 수 있습니다. API 제공하는 기능을 파이썬 함수 호출로 간단히 이용할 수 있습니다. pybithumb 패키지는 명령 프롬프트나 터미널에서 아래 명령어를 실행해 설치합니다.

pip install pybithumb

다음 아래와 같이 import 합니다.

from pybithumb import Bithumb

조회 기능

조회 기능은 API KEY를 입력하지 않아도 사용 가능합니다.

암호화폐 목록(get_tickers)

빗썸에서 지원하는 암호화폐의 목록을 리스트 자료로 반환합니다.

Bithumb.get_tickers()

최근 체결가격(get_current_price)

특정 암호화폐의 최근 체결 가격을 조회합니다.

Bithumb.get_current_price('BTC')

시장 현황 상세정보(get_market_detail)

00시 기준으로 시가, 고가, 저가, 종가, 거래량 정보를 확인합니다.

Bithumb.get_market_detail('BTC')

매수/매도 호가(get_orderbook)

get_orderbook() 메소드를 통해 실시간 호가 정보를 확인합니다. 호가창에서는 매수(bid)와 매도(ask) 주문의 가격과 수량을 확인할 수 있어, 시장의 수요와 공급 상황을 파악하는 데 매우 유용합니다. 이 정보를 활용하면 더 효과적인 매매 전략을 수립할 수 있습니다. 기본 5개씩, 최대 30개까지 가져올 수 있습니다.

Bithumb.get_orderbook('BTC')

시간별 가격정보(get_candlestick)

특정 암호화폐의 일자별 시가, 종가, 고가, 저가, 거래량 정보를 DataFrame 형식으로 반환한다.

Bithumb.get_candlestick("BTC")

chart_intervals 파라미터로 조회 간격을 설정할 수 있습니다. (1m, 3m, 5m, 10m, 30m, 1h, 6h, 12h, 24h)

Bithumb.get_candlestick("BTC", chart_intervals="5m")

웹소켓(실시간 가격)

WebSocket을 통해 현재가, 호가, 체결 정보를 실시간으로 수신합니다.

from pybithumb import WebSocketManager

wm = WebSocketManager("ticker", ["BTC_KRW"])

for i in range(10):
    data = wm.get()
    print(data)

wm.terminate()

내 계정 기능(Private API)

앞에서 발급한 API 키(Connect Key)와 시크릿 키(Secret Key)를 이용해서 로그인합니다. 로그인 후에는 내 계정 정보와 주문 등을 할 수 있습니다.

수수료 조회(get_trading_fee)

거래 수수료 정보를 확인합니다.

bithumb.get_trading_fee(order_currency='BTC')

잔고 조회(get_balance)

빗썸 API를 통해 계좌 정보를 조회하는 방법은 매우 직관적입니다. 아래와 같이 특정 암호화폐의 잔고 정보를 조회합니다. get_balance() 메소드를 사용하면 보유한 코인 수량과 원화 잔고를 한 번에 확인합니다.

bithumb.get_balance('BTC')

매수/매도 주문(buy_limit_order, sell_limit_order)

주문은 API 핵심 기능이라고 할 수 있습니다. buy_limit_order() 메소드를 사용하면 지정가 매수 주문을, sell_limit_order()로는 지정가 매도 주문을 실행합니다. 주문 시에는 반드시 최소 주문 수량과 유효 자릿수를 확인해야 하며, 이를 지키지 않으면 주문이 실패할 수 있습니다. 또한 cancel_order() 메소드를 통해 기존 주문을 취소할 수 있습니다.

desc = bithumb.buy_limit_order("BTC", 11000000, 1)
desc = bithumb.sell_limit_order("BTC", 11000000, 1)

매수/매도 잔량 확인

특정 주문의 잔량 정보를 확인합니다.

bithumb.get_outstanding_order(desc)

주문 취소(cancel_order)

매수/매도 주문을 취소합니다.

bithumb.cancel_order(desc)

빗썸 API는 가상자산 거래를 자동화하고 효율적으로 관리할 수 있는 강력한 도구입니다. 이 포스팅에서 다룬 기본 기능들을 잘 활용하면, 본인만의 자동매매 시스템을 구축할 수 있습니다. 단, API를 활용할 때는 항상 보안에 유의하고, 실제 거래 전에 충분한 테스트를 거쳐야 합니다.

빗썸 API 쉬운 사용법 – 잔고조회부터 주문까지 상세 설명