쓰던 자동매매 프로그램이 느릴 때, 엔진만 다시 짠 기록

01늦는 이유를 코드에서 찾다

받은 프로그램은 파이썬 1만 3천 줄, 모듈 90여 개였습니다. 의뢰인이 AI 도구의 도움을 받아 여러 버전에 걸쳐 고쳐 온 것이라 버전마다 검증 보고서가 붙어 있었고, 고쳤다가 되돌린 버전도 있었습니다. 엔진의 중심 함수 하나가 1,650줄이어서 한 군데를 고치면 다른 곳이 막히는 상태였습니다.

의뢰인이 남긴 보고서에 이런 줄이 있었습니다. "신호 통과 2.3초 뒤 소멸, 주문 미전송." 코드를 따라가 보니 원인은 네 군데였습니다.

앞의 세 가지는 매매 규칙과 상관이 없습니다. 규칙이 내린 판단을 증권사에 전달하는 길이 막혀 있던 것입니다. 그래서 규칙은 두고 길만 새로 내기로 했습니다.

02남긴 것과 다시 쓴 것

매매 규칙 파일은 원본과 한 글자도 다르지 않습니다. 파일마다 원본의 지문 값을 적어 두고, 시험을 돌릴 때마다 같은지 자동으로 확인합니다. 누군가 실수로 규칙을 건드리면 시험이 실패합니다.

화면을 그대로 쓸 수 있었던 이유는 화면과 엔진이 주소 22개로만 대화하고 있었기 때문입니다. 새 엔진이 같은 주소에서 같은 모양으로 답하면 화면은 바뀐 줄 모릅니다. 화면이 읽어 가는 값 110여 개를 뽑아 목록으로 만들고, 새 엔진의 응답이 그 목록을 다 채우는지 확인하는 시험부터 만들었습니다.

새 엔진은 주문을 판단할 때 증권사에 묻지 않습니다. 현금과 보유 수량은 프로그램이 들고 있는 장부에서 바로 읽고, 호가는 실시간으로 받고 있는 값을 씁니다. 증권사로 가는 요청은 모두 한 줄로 서고 주문과 취소가 늘 맨 앞에 섭니다. 조회는 그 뒤에 틈이 날 때 나갑니다.

주문을 보냈는데 응답이 없을 때는 다시 보내지 않습니다. 증권사가 받았는지 모르는 상태에서 한 번 더 보내면 두 번 살 수 있습니다. 주문 내역을 조회해 접수됐는지 확인될 때까지 그 종목의 새 주문을 막아 둡니다.

03실제 서버에 붙여 보고 고친 것

가짜 증권사를 붙인 시험은 첫날 통과했습니다. 문제는 한투 모의투자 서버에 붙인 10월 28일과 정규장 하루를 돌린 29일에 나왔습니다. 첫 납품까지 판을 아홉 번 새로 만들었습니다.

• 산 주식을 엔진이 계속 미체결로 알고 있었습니다. 한투는 주문을 받을 때 주문번호를 앞에 0을 채운 열 자리로 주고, 나중에 조회할 때는 0을 뗀 번호로 줍니다. 두 번호를 같은 주문으로 보지 못해 5분 넘게 손절 감시가 빠졌습니다. 비교 방식을 통일하고, 가짜 증권사도 한투와 같은 형식으로 답하게 고쳤습니다.
• 긴급정지를 누른 지 0.17초 뒤에 매수 주문이 하나 나갔습니다. 누르기 직전에 줄을 서 있던 주문이었습니다. 증권사로 보내기 바로 앞에서 한 번 더 확인하고, 이미 전송 중이던 주문은 접수되는 즉시 취소하도록 바꿨습니다.
• 일일 손실 제한이 엉뚱한 때 걸렸습니다. 원래 프로그램은 계좌 총평가금액이 줄어든 만큼을 그날 손실로 봤는데, 매도 주문이 걸려 있는 동안에는 한투가 그 주식의 평가액을 총액에서 빼고 알려 줍니다. 실제 손실의 여섯 배가 넘는 금액이 잡혀 그날 매매가 멈췄습니다. 프로그램이 직접 사고판 내역으로 손익을 계산하는 방식으로 바꿨고, 이 변경은 의뢰인 원본과 달라지는 부분이라 사유와 함께 문서에 남겼습니다.
• 감시 종목이 0개로 나온 날도 있었습니다. 한투가 배포하는 종목 목록 파일의 형식이 바뀌어 있었고, 원본의 해석 코드로는 모든 종목이 상품 유형 미확인으로 분류됐습니다. 의뢰인의 기존 프로그램에서도 같은 일이 생길 수 있는 문제였습니다.
• 실전에서는 넥스트레이드에서 거래되지 않는 종목을 SOR로 주문하면 거절됩니다. 모의투자 서버는 같은 주문을 조용히 한국거래소로 넘겨 받아 주기 때문에 모의로는 알 수 없었습니다. 실전 계좌로 한 주씩 내 보고 확인했고, 거절되면 그날은 그 종목을 한국거래소로 바로 다시 내도록 했습니다.
• 토스 순위가 가끔 예전 시각의 응답을 섞어 보냈습니다. 그 한 번에 감시 목록이 비었다가 다음 초에 다시 차면서 실시간 구독이 끊겼다 붙었습니다. 시각이 거꾸로 간 응답은 버리고 직전 응답을 쓰게 했습니다.

10월 29일 모의 정규장에서 잰 값입니다. 신호가 나온 뒤 주문을 보낼 때까지 매수 30건의 중앙값이 0.63초, 매도 29건이 0.50초였습니다. 한투 모의투자 서버는 주문 앞뒤로 1초쯤 다른 요청이 없어야 주문을 받아 주는 일이 많아 그만큼 기다린 시간이 들어 있습니다. 실전 서버에는 이 기다림을 두지 않습니다.

04장중에 프로그램이 꺼진 일

납품 전에 저희 PC에서 실전 소액으로 밤새 켜 두고 지켜봤습니다. 10월 29일 오전 9시, 정규장이 열린 직후에 프로그램이 꺼졌습니다.

처음에는 코드 오류를 의심했습니다. 윈도우가 남긴 기록을 열어 보니 프로그램이 자기 실행 파일의 일부를 디스크에서 다시 읽으려다 실패한 것이었습니다. 프로그램 폴더가 구글 드라이브 안에 있었습니다. 구글 드라이브는 PC에 가상 드라이브로 붙는데, 구글 드라이브 앱이 새벽에 스스로 재시작하면서 드라이브가 잠깐 사라졌다가 돌아왔습니다. 그 전에 켜 둔 프로그램은 몇 시간 뒤 필요한 파일 조각을 읽으려는 순간 죽습니다.

증상이 원인보다 몇 시간 늦게, 아무 때나 나타나기 때문에 코드 문제로 오해하기 쉽습니다. 그 뒤로 시험은 C 드라이브의 일반 폴더에 복사해서 돌렸고, 의뢰인께 드린 사용안내서에 구글 드라이브나 원드라이브 같은 동기화 폴더에서 실행하지 말라는 안내를 넣었습니다.

05납품 뒤에 이어진 수정

의뢰인은 모의투자로 일주일을 쓰신 뒤 아홉 가지를 정리해 보내 주셨습니다. 로그와 대조해 하나씩 확인했고, 그중 일곱 가지를 반영한 수정판을 11월 9일에 만들었습니다.

• 팔 때 쓰는 기준 다섯 가지를 화면에서 직접 정하고 싶다는 요청이 있었습니다. 원본에는 이 숫자들이 규칙 코드 안에 고정돼 있었습니다. 규칙 파일은 건드리지 않고 엔진 쪽에 칸을 만들었고, 칸이 기본값이면 원본 함수를 그대로 부릅니다. 기본값일 때 원본과 같은 판단이 나오는지 155만 가지 입력으로 대조했습니다.
• 연결 점검을 연달아 누르면 실패로 나왔습니다. 한투는 접속 토큰을 1분에 한 번만 내주는데, 화면은 키를 확인하라고 안내하고 있었습니다. 남은 초를 보여 주며 기다렸다가 이어서 진행하도록 고쳤습니다.
• 일일 손실 제한에 걸린 날 한도를 올려 다시 시작해도 정지가 풀리지 않았습니다. 다시 시작할 때 그날 손실이 새 한도 안이면 풀리게 했습니다.
• 화면의 마지막 저장 시각이 한 시간씩 어긋나 보인다는 항목은 저희가 엔진을 옮기면서 만든 실수였습니다. 기록 시각을 넣어야 할 자리에 마지막 체결 시각을 넣었습니다. 원래 뜻으로 되돌렸습니다.

나머지 두 가지 가운데 하나는 주문 통로를 조회와 완전히 나누는 구조 변경이라 따로 판단하기로 했습니다. 수정판에서 팔 때 쓰는 기준을 끈 경우의 매도는 가짜 증권사 시험으로만 확인했고, 장중 모의 확인은 아직 남아 있습니다.

06납품물과 기술

• 압축을 풀어 바로 실행하는 Windows 폴더. 파이썬 실행 환경이 함께 들어 있어 따로 설치할 것이 없다
• 08:00부터 20:00까지 운영. 프리마켓과 애프터마켓은 넥스트레이드 지정가, 정규장 실전은 SOR
• 모의와 실전 전환. 실전으로 시작할 때는 금액을 숫자로 다시 보여 주고 계좌번호 끝 네 자리를 입력받는다. 셀 금액과 손실 한도 같은 금액 설정 다섯 가지는 모의와 실전이 따로 저장된다
• API 키와 계좌번호는 실행 중 메모리에서만 쓰고 파일에 남기지 않는다
• 한투 서버 없이 주문 흐름을 검사하는 자동 시험 113건, 한국어 사용안내서

모의투자 서버는 넥스트레이드 주문을 받지 않습니다. 그래서 프리마켓과 애프터마켓 주문은 모의로 확인할 수 없었고, 실전 계좌에서 한 주를 접수했다가 바로 취소하는 방법으로 경로를 확인했습니다.

07관련 사례와 더 보기

한투 API가 돌려주는 오류와 대응은 KIS API 에러코드 정리에 따로 적어 두었습니다.