코인 자동매매 봇의 반복 오류, 원인은 내 코드가 아니라 라이브러리였다
업비트 API로 돌아가는 코인 자동매매 봇을 운영하고 있습니다. 변동성 돌파 전략으로 여러 코인을 동시에 보고, 20초마다 현재가를 조회해서 손절 조건과 매수·매도 신호를 확인하는 구조입니다. 봇이 이상하면 텔레그램으로 알림이 오게 해뒀는데, 어느 날부터 같은 알림이 계속 쌓이기 시작했습니다.
main_trade.py 루프 오류: string indices must be integers, not 'str'
파이썬을 써본 분이라면 익숙한 에러입니다. 딕셔너리인 줄 알고 x['key']로 접근했는데 실제로는 문자열이었다는 뜻입니다. 당연히 제 코드 어딘가에서 데이터를 잘못 다루고 있다고 생각했습니다.
첫 번째 벽: 어디서 났는지 모른다
문제는 에러 메시지만 있고 위치가 없다는 점이었습니다. 메인 루프 전체를 감싸는 예외 처리가 이렇게 돼 있었습니다.
while True:
try:
run_one_cycle()
except Exception as e:
print(f"루프 오류: {e}")
notify(f"루프 오류: {e}")
time.sleep(20)
봇이 죽지 않게 하려고 넣은 코드인데, 대가로 어느 줄에서 터졌는지가 사라졌습니다. 코드를 읽으면서 딕셔너리에 접근하는 곳을 하나씩 의심해봤지만 정적 분석으로는 찾지 못했습니다. 에러가 항상 나는 게 아니라 가끔 나는 것도 추측을 어렵게 했습니다.
traceback 한 줄로 끝난 추적
결국 예외 처리 안에 traceback.print_exc() 한 줄을 추가하고 봇을 재시작한 뒤, 에러가 다시 날 때까지 기다렸습니다.
except Exception as e:
traceback.print_exc() # 추가
print(f"루프 오류: {e}")
여기서 한 번 헤맸습니다. 봇은 감시 스크립트가 띄우고, 표준출력과 표준에러를 서로 다른 로그 파일로 보냅니다. print는 stdout으로 가지만 traceback.print_exc()는 stderr로 갑니다. 한참 동안 stdout 로그만 보면서 “왜 안 찍히지” 했습니다.
stderr 로그에 찍힌 traceback의 마지막 줄은 제 코드가 아니었습니다.
File ".../site-packages/pyupbit/quotation_api.py", line 266, in get_current_price
price = {x['market']: x['trade_price'] for x in price}
TypeError: string indices must be integers, not 'str'
라이브러리 안에서 무슨 일이 있었나
pyupbit의 get_current_price()는 여러 코인을 한 번에 조회할 때 목록을 잘라서 여러 번 요청하고, 결과를 리스트에 이어 붙입니다. 대략 이런 흐름입니다.
price = []
for chunk in chunks(tickers):
price_sliced = request_ticker(chunk) # 정상이면 [ {...}, {...} ]
price += price_sliced
price = {x['market']: x['trade_price'] for x in price}
업비트 API가 정상일 때는 price_sliced가 딕셔너리의 리스트입니다. 그런데 API가 순간적으로 에러를 돌려주면 응답이 리스트가 아니라 딕셔너리 하나({"error": {...}})로 옵니다. 파이썬에서 리스트에 딕셔너리를 +=로 더하면, 에러가 나는 대신 딕셔너리의 키 문자열들이 리스트에 끼어 들어갑니다.
>>> a = [{"market": "KRW-BTC"}]
>>> a += {"error": {"name": "..."}}
>>> a
[{'market': 'KRW-BTC'}, 'error']
그다음 줄에서 'error'['market']을 실행하니 문자열 인덱스 에러가 난 겁니다. 에러 응답을 확인하지 않은 채 +=로 합친 것과, 리스트의 +=가 아무 반복 가능한 객체나 받아준다는 파이썬 특성이 겹친 결과였습니다.
실제 피해는 어느 정도였나
다행히 주문을 넣는 코드는 이 함수와 별개라서, 주문 자체는 정상적으로 처리되고 있었습니다. 대신 에러가 날 때마다 그 20초 동안 한 번 돌아야 할 작업이 통째로 건너뛰어졌습니다.
| 작업 | 에러 발생 시 |
|---|---|
| 손절 조건 확인 | 그 회차 건너뜀 |
| 매수·매도 신호 판단 | 그 회차 건너뜀 |
| 텔레그램 명령 처리 | 그 회차 건너뜀 |
| 이미 넣은 주문 | 영향 없음 |
급락장에서 손절 확인이 연속으로 몇 번 빠졌다면 손실이 커질 수 있는 구조였습니다.
고친 방법
라이브러리 파일을 직접 고치면 다음 업데이트 때 사라지니, 제 코드에서 감쌌습니다.
def get_current_prices(tickers):
try:
return pyupbit.get_current_price(tickers) or {}
except TypeError:
# pyupbit가 API 에러 응답을 리스트에 섞는 버그. 이번 회차만 건너뜀
return {}
가격이 비어 있을 때 아래 로직이 “조회 실패”로 처리하는 방어 코드는 원래 있었기 때문에, 빈 딕셔너리를 돌려주는 것으로 충분했습니다. 이렇게 하면 다음 20초 회차에 정상적으로 다시 조회합니다. traceback.print_exc()는 지우지 않고 남겨뒀습니다. 다음에 원인 모를 에러가 나면 바로 위치를 볼 수 있게요.
남기고 싶은 교훈
- 죽지 않게 감싸는 예외 처리에는 traceback을 같이 남긴다. 메시지만 찍으면 봇은 살아 있어도 원인은 영영 모릅니다.
- stdout과 stderr가 어디로 가는지 알아둔다. 백그라운드로 도는 프로세스라면 특히 그렇습니다.
- 외부 API의 에러 응답은 모양이 다를 수 있다. 정상일 때 리스트를 주는 API도 에러 때는 딕셔너리를 줄 수 있습니다. 라이브러리가 이걸 처리해줄 거라고 믿지 않는 게 안전합니다.
“내 코드가 틀렸겠지”라는 가정은 대부분 맞습니다. 하지만 그 가정 때문에 추적 도구를 켜는 걸 미루면 시간이 많이 듭니다. 이번에는 코드를 한 시간 읽는 것보다 traceback 한 줄이 빨랐습니다.