봇 오류 로그 읽는 법, 자주 나오는 오류 메시지 의미 정리

바이낸스 선물 자동매매 봇 오류 메시지를 정리했다.
-1121, -2019, KeyError, IndexError 등 자주 나오는 오류들이 무엇을 의미하는지 확인할 수 있다.
이 글에서는 바이낸스 API 오류 코드와 파이썬 오류를 실전 경험 기반으로 정리한다.

봇이 돌아가다 멈추면 이유를 알아야 한다.
터미널을 열면 오류 메시지가 줄줄이 나와 있다.
영어라서 뭔 말인지 모르겠고, 구글 검색해도 답이 안 나올 때가 있다.

나도 처음엔 오류 메시지를 봐도 뭔 뜻인지 몰랐다.
그냥 AI한테 오류 내용을 붙여넣고 "이거 왜 그래요"라고 물었다.
오류 메시지의 뜻을 미리 알아두면 원인을 더 빠르게 찾을 수 있다

 

봇 로그 파일을 여는 방법 

봇이 실행되면서 기록을 남기는 파일이 로그 파일이다.
언제 진입했는지, 오류가 났는지, 신호가 없었는지가 전부 여기에 찍힌다.

WinSCP에서 서버에 접속하면 봇 폴더 안에 .log 파일이 있다.
이 파일을 더블클릭하면 메모장으로 열린다.
가장 최근 내용이 아래쪽에 찍혀 있다.

PUTTY에서도 실시간으로 볼 수 있다.
봇 실행 중에 터미널에 출력되는 내용이 그대로 로그다.

오류가 나면 대부분 빨간 글씨로 찍히거나 ERROR, Exception, Traceback 같은 단어가 보인다.
이 단어들이 보이면 그 아랫줄을 확인하면 된다.

 

바이낸스 API 오류 코드별 원인과 해결법 

바이낸스에서 요청이 잘못됐을 때 돌려보내는 오류 코드들이다.
숫자 앞에 마이너스(-) 기호가 붙어 있으면 바이낸스 API 오류다.

바이낸스 API 오류 코드

자주 나오는 코드들을 하나씩 설명한다.

 

 

-1121 Invalid symbol 

코인 심볼이 잘못됐다는 뜻이다.
바이낸스 선물에서 XRP는 XRPUSDT로 입력해야 한다.
XRP/USDT, xrpusdt, XRPUSD 같은 형식은 인식하지 못한다.
봇 설정 파일에서 심볼 표기를 확인하면 된다.

 

 

-2019 Margin is insufficient 

증거금이 부족하다는 뜻이다.
잔고가 포지션을 열기에 모자란 상태다.
잔고를 확인하거나 레버리지를 낮추거나 포지션 크기를 줄이면 해결된다.

 

-1003 Too many requests 

API 요청을 너무 자주 보냈다는 뜻이다.
바이낸스는 분당 API 요청 횟수에 제한이 있다.
봇이 캔들 데이터를 너무 짧은 주기로 계속 요청하면 이 오류가 난다.
요청 간격을 늘리거나 불필요한 API 호출을 줄이면 된다.

 

-4003 Quantity less than zero 

주문 수량이 너무 작다는 뜻이다.
바이낸스 선물은 코인마다 최소 주문 수량이 정해져 있다.
잔고가 너무 적거나 레버리지가 낮을 때 주문 수량이 최솟값 아래로 내려가면 나온다.

 

 

-2011 CANCEL_REJECTED 

취소하려는 주문이 이미 없다는 뜻이다.
이미 체결됐거나 다른 이유로 사라진 주문을 취소하려 할 때 나온다.
봇 로직에서 주문 취소 전에 주문 존재 여부를 먼저 확인하도록 수정하면 된다.

 

파이썬 오류 메시지별 원인과 해결법

바이낸스 API 오류가 아닌 파이썬 자체에서 나오는 오류들이다.

파이썬 오류 메시지 - 봇에서 자주 나오는 것만 정리

 

ConnectionError 

인터넷 연결이 끊겼거나 바이낸스 서버에 접속이 안 된다는 뜻이다.
VPS 네트워크 상태를 확인하거나 바이낸스 서버 점검 여부를 확인하면 된다.
봇 코드에 재시도 로직이 있으면 잠시 후 자동으로 복구된다.

 

ReadTimeoutError / Timeout 

바이낸스 서버가 일정 시간 안에 응답을 안 보냈다는 뜻이다.
서버가 일시적으로 느리거나 점검 중일 때 나온다.
ConnectionError와 비슷하게 재시도로 해결되는 경우가 많다.

 

KeyError 

딕셔너리에서 없는 키를 접근하려 할 때 나온다.
API 응답 구조가 바뀌었거나 예상과 다른 데이터가 왔을 때 주로 발생한다.
오류 메시지에 어떤 키가 없는지 나오니까 그걸 확인하면 된다.

 

IndexError 

리스트에서 없는 인덱스를 접근하려 할 때 나온다.
캔들 데이터가 충분히 없을 때 자주 발생한다.
예를 들어 지표 계산에 100개 캔들이 필요한데 50개밖에 없으면 이 오류가 난다.
봇 시작 시 캔들 데이터가 충분히 쌓일 때까지 기다리는 로직이 필요하다.

 

TypeError 

타입이 맞지 않을 때 나온다.
숫자를 넣어야 하는 곳에 문자열이 들어갔거나, 반대의 경우에 발생한다.
설정 파일에서 값을 수정할 때 따옴표("")를 빠뜨리거나 잘못 넣으면 이 오류가 나기도 한다.

 

오류를 AI한테 해결하는 법 

오류 메시지를 봐도 원인을 모르겠으면 AI한테 그대로 붙여넣으면 된다.
이때 주의할 점이 있다.

오류 메시지 한 줄만 보내면 안 된다.
Traceback이라고 써있는 부분부터 마지막 오류 줄까지 전부 복사해서 붙여넣어야 한다.
Traceback은 어느 파일의 몇 번째 줄에서 오류가 났는지 알려주는 경로다.
이게 있어야 AI가 어디서 문제가 났는지 정확하게 찾아준다.

"이 오류가 왜 나는지, 어떻게 고치면 되는지 알려줘"라고 붙이면 된다.
봇 코드도 함께 붙여넣으면 더 정확한 답이 나온다.

한 가지 더, 같은 오류가 반복되면 봇 코드에 예외 처리를 넣는 게 낫다.
AI한테 "이 오류가 날 때 봇이 멈추지 않고 다음 신호까지 기다리도록 예외 처리 추가해줘"라고 요청하면 된다.

 

결론

오류 메시지는 크게 두 종류다.
바이낸스 API 오류 코드(-1121, -2019 등)와 파이썬 자체 오류(KeyError, IndexError 등)다.

숫자에 마이너스가 붙어 있으면 바이낸스 API 오류다. 설정이나 잔고를 확인하면 된다.
영어 단어로 끝나는 오류면 파이썬 오류다. Traceback 내용 전체를 AI한테 붙여넣으면 해결책이 나온다.

오류 메시지를 무서워할 필요 없다.
봇이 오류를 내는 건 문제가 있다는 신호를 보내는 것이다.
신호를 읽을 줄 알면 고칠 수 있다.봇이 돌아가다 멈추면 이유를 알아야 한다.
터미널을 열면 오류 메시지가 줄줄이 나와 있다.
영어라서 뭔 말인지 모르겠고, 구글 검색해도 답이 안 나올 때가 있다.

나도 처음엔 오류 메시지를 봐도 뭔 뜻인지 몰랐다.
그냥 AI한테 오류 내용을 붙여넣고 "이거 왜 그래요"라고 물었다.
그런데 오류 메시지의 뜻을 미리 알아두면 원인을 더 빠르게 찾을 수 있다.
이 글에서는 봇에서 자주 나오는 오류 메시지들을 정리한다.