IBKR 미국주식 그리드 트레이딩 봇

01배경과 요구사항

고객은 미국 주식을 격자(그리드)로 반복 매매하고 싶어 했습니다. 가격이 일정 간격 내려갈 때마다 조금씩 사고, 다시 그만큼 오르면 파는 것을 정해 둔 범위 안에서 계속 되풀이하는 전략입니다. 사람이 직접 하려면 밤새 수십 개의 지정가 주문을 관리해야 합니다.

그리드에는 처음 켤 때 흔히 나는 사고가 하나 있습니다. 현재가 위아래 ±20% 전 범위에 매수 주문을 깔면, 현재가보다 높은 가격의 매수 지정가는 넣는 순간 바로 체결됩니다. 프로그램을 켜자마자 위쪽 매수 주문이 한꺼번에 나가 의도하지 않은 대량매수가 됩니다.

요청은 네 가지였습니다. 국내 계좌 대신 IBKR 계좌로 미국주식 그리드를 자동 운영할 것, 시작 직후 대량매수가 나가지 않을 것, 매수가 체결되면 매도가, 매도가 체결되면 다시 매수가 자동으로 걸릴 것. 그리고 PC를 껐다 켜도 매매내역과 실현손익이 남아 있어야 했습니다.

02구현 방식

IB Gateway나 TWS에 ib_insync로 붙어 그리드 엔진을 돌립니다. 주문은 모두 취소하기 전까지 유효한 지정가(GTC)입니다.

• 현재가를 조회해 ±20% 범위를 잡고, 설정한 간격(예: $0.50)마다 격자 레벨을 만듭니다.
• 각 레벨에 지정가 매수를 깔되 현재가 아래 레벨에만 둡니다.
• 매수가 체결되면 매수가에 간격을 더한 가격에 매도를 걸고, 그 매도가 체결되면 같은 레벨에 매수를 다시 겁니다. 이 왕복이 계속 이어집니다.
• 현재가가 움직이면 범위를 다시 계산합니다. 범위를 벗어난 미체결 매수는 취소하고 빈 격자에는 매수를 채웁니다.

명세서에는 ±20% 전 범위에 매수를 배치한다고 적혀 있었습니다. 그대로 만들면 위쪽 매수가 즉시 체결되어 사고가 납니다. 그래서 현재가 아래는 매수 대기, 위는 매도 대기로 나눠 깔았습니다. 이 동작은 설정 화면의 체크박스로 두어서 고객이 필요하면 직접 바꿀 수 있습니다.

03어려웠던 부분

• 각 레벨은 빈칸, 매수대기, 보유, 매도대기, 차단, 완료 가운데 한 상태를 가집니다. 체결과 취소, 범위 재계산이 겹쳐도 레벨마다 지금 상태가 분명해서 주문이 꼬이지 않습니다.
• 증권사가 거부한 주문은 그 레벨을 차단 상태로 둡니다. 이렇게 하지 않으면 프로그램이 빈자리로 잘못 알고 1초마다 같은 주문을 다시 냅니다. 범위를 벗어나 프로그램이 스스로 취소한 주문과는 구분합니다.
• 2주 중 1주만 체결된 채 주문이 취소되면 체결된 1주를 보유로 돌리고 매도를 겁니다. 추적에서 빠지는 주식이 없습니다.
• 게이트웨이 연결이 끊기면 10초, 20초, 40초, 60초로 간격을 늘려 가며 다시 붙습니다. 알림은 끊길 때마다 한 번만 보내고, 다시 연결되면 실제 잔고와 미체결 주문을 새로 맞춥니다.

04주요 기능

• 여러 종목을 쉼표로 입력하면 같은 설정으로 동시에 운영합니다.
• 대시보드에서 보유 포지션과 평균단가, 현재가, 그리드 범위, 미체결 주문을 봅니다.
• 매매내역은 CSV 파일로 남습니다. 재시작해도 누적 실현손익과 거래내역이 유지되고, 오늘과 누적 통계를 따로 집계합니다.
• 프리마켓과 애프터마켓에서도 체결되도록 설정할 수 있습니다.
• 매수와 매도 체결, 주문 취소, 연결 끊김과 복구를 텔레그램으로 알립니다.
• 격자 간격, 격자당 수량, 종목을 화면에서 바꿔 저장하고 불러옵니다. Live와 Paper 계좌 전환도 같은 화면에 있습니다.

05제작 과정 (약 2주)

• 첫 주에는 IB Gateway 연결과 현재가 구독을 붙이고 격자 엔진을 만들었습니다. 지정가 매수와 매도를 짝지어 배치하고, 체결되면 반대주문을 만드는 부분까지입니다.
• 둘째 주 전반에는 시작 대량매수 방지, 거부와 부분체결 처리, 재연결을 넣고 대시보드와 CSV 저장, 텔레그램 알림을 붙였습니다.
• 마지막 며칠은 Paper 계좌에서 체결과 짝짓기를 확인하고 소액 실계좌로 점검했습니다. 그 뒤 .exe로 빌드하고 사용설명서를 써서 넘겼습니다.

06납품 결과물

• 실행 프로그램(.exe, 대시보드 포함)
• 그리드 트레이딩 엔진과 시작 대량매수 방지 장치
• 매매내역 CSV 저장, 오늘과 누적 통계
• 텔레그램 알림 봇 연동
• 한글 사용설명서와 IBKR API, IB Gateway 설정 가이드
• 납품 후 30일 무료 AS (협의 범위 내)

07기술 스택

08관련 사례