Python Wrapper for Bithumb API - grruju/uju GitHub Wiki

Installation

pip install pybithumb

Import

from pybithumb import Bithumb

Public API

암호화폐 목록

빗썸이 지원하는 암호화폐 목록을 얻어온다.

print(Bithumb.get_tickers())

['BTC', 'ETH', 'LTC', 'ETC', 'XRP', 'BCH', 'QTUM', 'BTG', 'EOS', 'ICX', 'TRX', 'ELF', 'OMG', 'KNC', 'GLM', 'ZIL', 'WAXP', 'POWR', 'LRC', 'STEEM', 'STRAX', 'ZRX', 'REP', 'XEM', 'SNT', 'ADA', 'CTXC', 'BAT', 'WTC', 'THETA', 'LOOM', 'WAVES', 'TRUE', 'LINK', 'ENJ', 
'VET', 'MTL', 'IOST', 'TMTG', 'QKC', 'HDAC', 'AMO', 'BSV', 'ORBS', 'TFUEL', 'VALOR', 'CON', 'ANKR', 'MIX', 'CRO', 'FX', 'CHR', 'MBL', 'MXC', 'FCT', 'TRV', 'DAD', 'WOM', 'SOC', 'EM', 'BOA', 'FLETA', 'SXP', 'COS', 'APIX', 'EL', 'BASIC', 'HIVE', 'XPR', 'VRA', 'FIT', 'EGG', 'BORA', 'ARPA', 'APM', 'CKB', 'AERGO', 'ANW', 'CENNZ', 'EVZ', 'CYCLUB', 'SRM', 'QTCON', 'UNI', 'YFI', 'UMA', 'AAVE', 'COMP', 'REN', 'BAL', 'RSR', 'NMR', 'RLC', 'UOS', 'SAND', 'GOM2', 'RINGX', 'BEL', 'OBSR', 'ORC', 'POLA', 'AWO', 'ADP', 'DVI', 'GHX', 'MIR', 'MVC', 'BLY', 'WOZX', 'ANV', 'GRT', 'MM', 'BIOT', 'XNO', 'SNX', 'RAI', 'COLA', 'NU', 'OXT', 'LINA', 'MAP', 'AQT', 'WIKEN', 'CTSI', 'MANA', 'LPT', 'MKR', 'SUSHI', 'ASM', 'PUNDIX', 'CELR', 'LF', 'ARW', 'MSB', 'RLY', 'OCEAN', 'BFC', 'ALICE', 'CAKE', 'BNT', 'XVS', 'CHZ', 'AXS', 'DAI', 'MATIC', 'BAKE', 'VELO', 'BCD', 'XLM', 'GXC', 'BTT', 'VSYS', 'IPX', 'WICC', 'ONT', 'LUNA', 'AION', 'META', 'KLAY', 'ONG', 'ALGO', 'JST', 'XTZ', 'MLK', 'WEMIX', 'DOT', 'ATOM', 'SSX', 'TEMCO', 'HIBS', 'BURGER', 'DOGE', 'KSM', 'CTK', 'XYM', 'BNB', 'SUN', 'XEC', 'PCI', 'SOL']

최근 체결가격

get_current_price 함수는 최근 체결 가격을 조회한다.

for coin in Bithumb.get_tickers()[:5]:
    print(coin, Bithumb.get_current_price(coin))

BTC 78568000.0
ETH 4697000.0
LTC 229200.0
ETC 64400.0
XRP 1329.0

시장 현황 상세정보

get_market_detail 함수는 00시 기준으로 시가/고가/저가/종가/거래량 정보를 반환한다.

for coin in  Bithumb.get_tickers():
    print(coin, Bithumb.get_market_detail(coin))

BTC (76498000.0, 78746000.0, 76261000.0, 78588000.0, 1260.7801685)
ETH (4651000.0, 4699000.0, 4629000.0, 4699000.0, 7710.88377203)
LTC (226500.0, 229700.0, 226300.0, 229200.0, 2414.08790075)
ETC (64250.0, 64500.0, 64000.0, 64400.0, 20317.59633999)
XRP (1325.0, 1334.0, 1320.0, 1329.0, 11575639.48943114)

매수/매도 호가

get_orderbook 함수는 호가 정보를 가져온다. 기본적으로 5개를 가져오며, limit 파라미터로 30개까지 지정할 수 있다.

for coin in  Bithumb.get_tickers():
    print(coin, Bithumb.get_orderbook(coin))

시간별 가격정보

시가/종가/고가/저가/거래량 정보를 DataFrame으로 반환한다.

df = Bithumb.get_candlestick("BTC")
print(df.tail(5))

                           open        high         low       close       volume
time
2021-10-16 00:00:00  73679000.0  76605000.0  73102000.0  74339000.0  4313.858489
2021-10-17 00:00:00  74319000.0  75283000.0  73926000.0  74727000.0  2922.465535
2021-10-18 00:00:00  74776000.0  77000000.0  73717000.0  76297000.0  4088.309876
2021-10-19 00:00:00  76329000.0  77200000.0  75493000.0  76498000.0  3374.366920
2021-10-20 07:00:00  76498000.0  78746000.0  76261000.0  78616000.0  1264.517067

chart_intervals 파라미터로 조회 간격을 조정할 수 있다.

• 1m, 3m, 5m, 10m, 30m, 1h, 6h, 12h, 24h

df = Bithumb.get_candlestick("BTC", chart_intervals="30m")
print(df.tail(5))

                           open        high         low       close      volume
time
2021-10-20 05:30:00  78432000.0  78746000.0  78407000.0  78660000.0   78.082516
2021-10-20 06:00:00  78653000.0  78669000.0  78023000.0  78169000.0   75.424302
2021-10-20 06:30:00  78175000.0  78633000.0  78157000.0  78459000.0  100.155448
2021-10-20 07:00:00  78461000.0  78626000.0  78269000.0  78290000.0   80.078140
2021-10-20 07:32:00  78311000.0  78357000.0  78259000.0  78357000.0    6.885242

웹소켓

WebSocket을 이용해서 현재가, 호가, 체결에 대한 정보를 수신한다.

• 첫 번째 파라미터로 수신정보를 입력하며 ticker, orderbook, transaction을 사용할 수 있다.
• 두 번째 파라미터는 구독할 필터를 설정하며 암호화폐의 티커를 입력한다. 현재 버전에서는 원화 시장만을 지원한다.

if __name__ == "__main__":
    wm = WebSocketManager("ticker", ["BTC_KRW"])
    for i in range(10):
        data = wm.get()
        print(data)
    wm.terminate()

주의할 사항은 multiprocessing을 위해 __name__ guard를 반드시 써줘야한다는 것이다.

PyQt5와 함께 웹소켓을 사용하는 예제는 다음과 같다.

• 버튼을 클릭하면 웹소켓에서 가격정보를 가져와서 화면에 출력한다.
• https://gist.github.com/mr-yoo/a3d1f8a4152f94cf61e4bc566659cd20

Private API

로그인

connectkey와 secretkey를 사용해서 로그인한다. 두 key를 생성하는 방법은 링크를 참조한다.

bithumb = Bithumb("conkey", "seckey")

수수료 조회

for coin in  Bithumb.get_tickers():
    print(coin, bithumb.get_trading_fee(coin))

잔고 조회

for coin in Bithumb.get_tickers():
    print(coin, bithumb.get_balance(coin))

매수/매도 주문

비트코인을 1100만원에 1개 매수/매도한다.

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

매수/매도 잔량 확인

quanity = bithumb.get_outstanding_order(desc)

매수/매도 주문 취소

status = bithumb.cancel_order(desc)