안녕하세요! 지난 연재에서 우리는 가상 서버(AWS 라이트세일) 환경에 봇을 안착시키고, 프로세스가 불시에 종료되어도 직전의 상태와 주문 내역을 완벽히 복원해낼 수 있는 'SQLite 데이터베이스 연동 모듈'까지 완성했습니다. 이제 봇에게 영혼(서버)과 기억(DB)이 생겼으니, 드디어 실제 거래를 태워볼 시간입니다.
하지만 아무리 완벽하게 설계한 자동매매 봇이라도, 첫날부터 실전 계좌의 진짜 내 돈을 걸어 실행시키는 것은 극히 위험합니다. API 호출 인자 값 하나를 잘못 넣거나, 매수량 계산 공식의 소수점 처리 오차로 인해 순식간에 주문이 거부되거나 엉뚱한 주문이 들어갈 수 있기 때문입니다.
"내 진짜 돈은 지키면서, 실시간으로 요동치는 코인 호가창에 맞춰 매수/매도 주문이 제대로 나가고 체결되는지 테스트해볼 순 없을까?"
이 문제를 해결하기 위해 거래소들이 무료로 제공하는 연습용 서버가 바로 '테스트넷(Testnet)' 또는 **'샌드박스(Sandbox)'**입니다. 오늘 연재에서는 글로벌 표준 금융 통신 라이브러리인 CCXT를 활용하여, 단 1원의 리스크도 지지 않으면서 실시간 가상 화폐 주문을 처리하는 모의투자 시스템을 구축해 보겠습니다!
1. 거래소 테스트넷(Testnet)과 CCXT 샌드박스 설정
대부분의 메이저 거래소(Binance, Bybit 등)는 개발자를 위해 실제 시장 가격과 유사하게 움직이면서 무상으로 가상의 테스트 자금(USDT 등)을 리필해 주는 테스트용 API 환경을 별도로 개방하고 있습니다.
이번 가이드에서는 가상화폐 자동매매 개발에 가장 널리 쓰이는 멀티-거래소 표준 라이브러리 **CCXT(CryptoCurrency eXchange Trading)**를 활용하겠습니다. CCXT를 사용하면 코드 한 줄만으로 거래소 연결을 실전 모드에서 모의 테스트 모드로 간단히 전환할 수 있습니다.
🔑 Bybit/Binance 테스트넷 API 키 발급 가이드
- 거래소 테스트넷 사이트 (예: Bybit Testnet 또는 Binance Testnet)에 접속하여 별도의 회원가입을 진행합니다. (실제 거래소 계정과 분리되어 있습니다.)
- 가입 후 대시보드에서 **[API Key] -> [Create New Key]**를 선택합니다.
- API 권한 설정에서
Active Order(주문 생성) 및Account Read(잔고 조회) 권한을 부여합니다. - 발급된 API Key와 Secret Key를 복사하여 준비해 둡니다.
2. CCXT를 활용한 테스트넷 연동 및 잔고 조회
그럼 파이썬 코드를 작성하여 가상 거래소에 접속하고, 내 테스트 계좌에 충전되어 있는 가상의 달러(USDT) 자산을 읽어오는 모듈을 조립해 보겠습니다.
import ccxt
import json
def connect_testnet(config_path="token.json"):
"""
token.json 파일에서 API Key를 읽어와
테스트넷(Sandbox Mode) 거래소 인스턴스를 생성합니다.
"""
# API 키 파일 로드
with open(config_path, "r") as f:
config = json.load(f)
# Bybit 거래소를 기준으로 설정 (필요시 binance 등으로 변경 가능)
exchange = ccxt.bybit({
'apiKey': config['TESTNET_API_KEY'],
'secret': config['TESTNET_SECRET_KEY'],
'enableRateLimit': True, # API 호출 제한을 CCXT 내부적으로 준수하도록 함
})
# [CRITICAL] 샌드박스 모드를 True로 설정해야 실제 돈이 나가지 않고 테스트넷으로 붙습니다!
exchange.set_sandbox_mode(True)
return exchange
if __name__ == "__main__":
try:
# 가상 거래소 인스턴스 획득
exchange = connect_testnet()
# 지갑 잔고 조회 (통합 마진/현물 지갑 정보)
balance = exchange.fetch_balance()
# USDT 잔고 정보만 파싱하여 출력
usdt_balance = balance.get('USDT', {})
print("==== 테스트넷 연결 성공 ====")
print(f"보유한 가상 USDT 총액: {usdt_balance.get('total', 0.0)} USDT")
print(f"주문 가능 가상 USDT: {usdt_balance.get('free', 0.0)} USDT")
except Exception as e:
print(f"테스트넷 연결 중 오류가 발생했습니다: {e}")
3. 테스트넷 기반 모의 매수/매도 및 DB 기록 통합
이제 단순히 가격을 조회하는 단계를 넘어, 특정 가격에 기계적으로 주문을 밀어 넣고 체결 결과를 받아오는 함수를 작성해 봅시다. 이때, 주문이 무사히 성공하면 지난 연재에서 만들었던 TradeDatabase와 결합하여 데이터베이스에 주문 로그가 자동으로 기록되도록 파이프라인을 연결합니다.
import time
from datetime import datetime
# 이전 2화에서 만든 데이터베이스 모듈을 가져옵니다.
from database_module import TradeDatabase
def execute_mock_trade(exchange, db, symbol, side, amount, price=None):
"""
테스트넷에 매수/매도 주문을 접수하고 체결 내역을 데이터베이스에 영구 보존합니다.
- price가 None이면 시장가(Market) 주문, 값이 있으면 지정가(Limit) 주문을 실행합니다.
"""
try:
# [고급 기능] 거래소 규격에 맞는 가격/수량 소수점 정밀도 자동 포맷팅
# 거래소마다 코인의 소수점 자릿수 제약이나 최소 주문단위가 다릅니다.
# 소수점 오차가 있으면 거래소 엔진이 주문을 즉각 Reject하므로 아래 변환은 필수입니다.
exchange.load_markets()
formatted_amount = float(exchange.amount_to_precision(symbol, amount))
formatted_price = None
if price is not None:
formatted_price = float(exchange.price_to_precision(symbol, price))
print(f"\n[주문 실행] {symbol} {side} {formatted_amount}개 전송 중... (요청수량: {amount})")
# 1. 시장가 주문과 지정가 주문을 구분하여 요청
if price is None:
# 시장가 주문
order = exchange.create_order(
symbol=symbol,
type='market',
side=side.lower(), # 'buy' or 'sell'
amount=formatted_amount
)
else:
# 지정가 주문
order = exchange.create_order(
symbol=symbol,
type='limit',
side=side.lower(),
amount=formatted_amount,
price=formatted_price
)
print(f"[주문 완료] 거래소 주문 접수 성공 - ID: {order['id']}")
# 2. 체결 대기 및 상세 결과 파싱
# 테스트넷은 실제 체결 속도와 차이가 있을 수 있으므로 API에서 체결 세부정보를 다시 조회합니다.
time.sleep(1) # 잠시 후 체결 상태 업데이트 확인
order_info = exchange.fetch_order(order['id'], symbol)
# 체결 가격, 수량, 수수료 추출
filled_price = order_info.get('price', formatted_price) if order_info.get('price') else formatted_price
filled_amount = order_info.get('filled', formatted_amount)
# 수수료 계산 (수수료 정보가 누락되었을 경우 기본 요율 0.1%로 가산)
fees = order_info.get('fee', {})
fee_cost = fees.get('cost', filled_amount * filled_price * 0.001)
# 3. SQLite 데이터베이스에 영구 보존
db.record_trade(
symbol=symbol,
side=side.upper(),
price=filled_price,
amount=filled_amount,
fee=fee_cost,
order_id=order['id']
)
# 4. 실시간 정산 기록을 위한 자산 스냅샷 자동 반영
balance = exchange.fetch_balance()
total_balance = balance.get('total', {}).get('USDT', 0.0)
cash_balance = balance.get('free', {}).get('USDT', 0.0)
db.record_balance(total_balance=total_balance, cash=cash_balance)
return order_info
except Exception as e:
print(f"[주문 오류] 주문 실행 또는 DB 기록 중 문제가 생겼습니다: {e}")
return None
# 실행 예제
if __name__ == "__main__":
exchange = connect_testnet()
db = TradeDatabase("trade_bot.db")
# 비트코인(BTC/USDT) 가상 시장가 매수 테스트
# 실제 돈이 아님으로 안심하고 0.001 BTC를 시장가 매수해 봅니다.
order_result = execute_mock_trade(
exchange=exchange,
db=db,
symbol="BTC/USDT",
side="BUY",
amount=0.001
)
db.close()
⚠️ 리스크 경고: 테스트넷의 한계와 실전 매매의 함정
테스트넷은 안전한 훈련소 역할을 하지만, 실제 전장(Live Market)과는 결정적인 차이가 존재합니다. 이를 간과하면 실전 투입 후 당황스러운 경제적 손실을 입을 수 있습니다.
- 체결 괴리 (Thin Order Book): 테스트넷은 거래 참여자가 거의 없거나, 가상의 유동성 공급 프로그램(Market Maker)만 작동하므로 호가창이 매우 얇습니다. 따라서 수천만 원 상당의 큰 수량을 테스트넷에 던지면, 실제 시장보다 훨씬 극단적으로 불리한 가격에 체결(Slippage)되거나 아예 주문이 거부될 수 있습니다.
- 네트워크 가용성 이슈: 거래소들의 테스트넷 서버는 라이브 서버보다 컴퓨팅 자원 배정이 낮고 불안정하여 수시로 일시 정지되거나 리셋됩니다. API 호출 실패 에러가 더 빈번히 나므로 이를 봇 오작동으로 오해하지 않도록 예외 코드 블록을 세심히 감싸 두어야 합니다.
- 주문 한계 금액 제약: 비트코인은 최소 주문량이
0.0001 BTC등 매우 작지만, 일부 테스트넷에서는 테스트 편의를 위해 최소 수량 단위를 대폭 높여두어 소액 테스트 코드가 막힐 수 있습니다.
에필로그: 다음 단계는 '실전 거래 마찰비용 모델링!'
이로써 가상 자금을 통해 24시간 실시간 가격을 분석하고, 거래소 API에 합법적으로 매수/매도 전령을 보내 거래 기록을 DB에 쌓는 '모의 모의투자 실습' 과정이 정식 활성화되었습니다.
- 다음 편 예고 체크리스트:
- [ ] 백테스팅의 이상과 실전 매매의 슬픈 현실: 수수료와 슬리피지(Slippage)
- [ ] 주문을 던지는 찰나의 시간 차(API 레이턴시)가 만들어내는 가격 괴리 계산
- [ ] 봇의 누적 수익률 계산 시 주문 체결 딜레이를 반영하는 정밀 보정 공식 코딩
다음 시간에는 샌드박스 테스트에서 미처 보지 못했던 거래 비용의 진짜 적들, 즉 **'슬리피지(Slippage)와 네트워크 지연 등 거래 마찰 비용 모델링'**을 어떻게 코드로 설계하고 백테스터에 반영할지 파헤쳐 보겠습니다.
오늘도 유익하게 읽으셨다면 구독과 좋아요, 그리고 질문이 있다면 언제든 댓글로 남겨주세요. 감사합니다!