파이썬 pybit 설치부터 첫 API 호출까지 — 바이비트 자동매매 기초

바이비트 API 키를 발급받았다면, 이제 파이썬에서 바이비트와 통신할 수 있는 라이브러리를 설치할 차례입니다. 오늘은 pybit 설치부터 잔고 조회, 현재가 확인까지 직접 따라해볼 수 있도록 정리했습니다.

pybit이 뭔가요?

pybit은 바이비트가 공식으로 지원하는 파이썬 SDK입니다. REST API를 직접 호출하는 것보다 훨씬 간편하게 주문, 잔고 조회, 시세 확인 등을 할 수 있습니다.

 

설치 방법

터미널(명령 프롬프트)을 열고 아래 명령어를 입력합니다.

pip install pybit python-dotenv

pybit은 바이비트 API 라이브러리이고, python-dotenv는 API 키를 안전하게 관리하기 위한 도구입니다.

설치가 잘 됐는지 확인하려면:

python -c "from pybit.unified_trading import HTTP; print('설치 완료!')"

 

프로젝트 구조 만들기

자동매매 프로젝트 폴더를 하나 만들고, 기본 파일을 준비합니다.

my_trading_bot/
├── .env            ← API 키 저장 (절대 GitHub에 올리지 마세요)
├── .gitignore      ← .env 파일 제외 설정
├── main.py         ← 메인 코드
└── requirements.txt ← 필요한 라이브러리 목록

.env 파일:

BYBIT_API_KEY=여기에_발급받은_API_KEY
BYBIT_API_SECRET=여기에_발급받은_API_SECRET

.gitignore 파일:

.env

 

첫 번째 코드: 잔고 확인하기

from pybit.unified_trading import HTTP
from dotenv import load_dotenv
import os

load_dotenv()

session = HTTP(
    api_key=os.getenv("BYBIT_API_KEY"),
    api_secret=os.getenv("BYBIT_API_SECRET"),
    testnet=True  # 테스트넷에서 먼저 테스트
)

# USDT 잔고 확인
result = session.get_wallet_balance(accountType="UNIFIED")
coins = result['result']['list'][0]['coin']

for coin in coins:
    if float(coin['walletBalance']) > 0:
        print(f"{coin['coin']}: {coin['walletBalance']} USDT")

 

두 번째 코드: 비트코인 현재가 확인하기

# BTC/USDT 현재가
ticker = session.get_tickers(category="linear", symbol="BTCUSDT")
price = ticker['result']['list'][0]['lastPrice']
print(f"BTC 현재가: {price} USDT")

 

세 번째 코드: 과거 캔들 데이터 가져오기

# 최근 100개 1시간봉 데이터
klines = session.get_kline(
    category="linear",
    symbol="BTCUSDT",
    interval="60",  # 60분봉
    limit=100
)

for candle in klines['result']['list'][:5]:
    print(f"시가: {candle[1]}, 고가: {candle[2]}, 저가: {candle[3]}, 종가: {candle[4]}")

이 캔들 데이터가 바로 자동매매 전략의 입력 데이터가 됩니다. EMA, RSI, 볼린저 밴드 같은 기술적 지표를 이 데이터로 계산합니다.

 

자주 발생하는 오류와 해결법

"Invalid API key" — .env 파일에 키를 정확히 입력했는지 확인하세요. 앞뒤 공백이 들어가면 안 됩니다.

"IP not allowed" — API 키 발급 시 설정한 IP와 현재 접속 IP가 다릅니다. 바이비트에서 IP 설정을 확인하세요.

"testnet=True인데 실전 키 사용" — 테스트넷 키와 실전 키는 별도입니다. 테스트넷에서 발급받은 키를 사용해야 합니다.

 

마무리

pybit 설치와 기본 API 호출까지 완료했습니다. 이제 바이비트와 대화할 수 있는 준비가 된 거예요. 다음 글에서는 이 데이터를 활용해서 EMA 지표를 계산하고, 실제 매매 신호를 만드는 방법을 다루겠습니다.

 

※ 이 글은 투자 권유가 아닙니다. 암호화폐 투자는 원금 손실 위험이 있으며, 모든 투자 판단과 책임은 투자자 본인에게 있습니다.