2026년 11월 13일 금요일

모의투자 API 로 자동매매 봇을 돌려 보고 알게 된 것 — 모의 서버와 실제의 차이

증권사가 제공하는 모의투자 API 로 반도체 종목 묶음을 규칙대로 사고파는 연습용 봇을 만들어 돌리고 있다. 실제 돈이 걸리지 않으니 마음 편히 실험할 수 있다. 다만 "모의에서 됐으니 실제도 된다"는 생각은 여러 번 깨졌다. 모의 환경의 특성과, 실제든 모의든 자동매매 프로그램이 갖춰야 할 것들을 적는다.

모의 서버는 실제와 다르다

  • 비용이 다르다. 내가 쓴 모의 서버는 수수료와 세금이 실제보다 높게 잡혀 있었다. 모의 수익률을 그대로 실제 기대치로 옮기면 안 된다.
  • 안 되는 주문이 있다. 일부 주문 유형, 시간외 거래, 대체거래소 주문이 "모의투자에서는 지원하지 않는다"는 오류로 거부됐다. 정규장의 기본 지정가 주문만 된다고 보는 편이 맞았다.
  • 장 시작 전 주문도 거부된다. 미국 주식은 정규장 전 시간대의 주문이 거부됐다. 처음에 이 오류를 "일시적이라 다시 시도할 오류" 목록에 넣지 않아서, 그날의 진입 시도가 "거부"로 기록되고 다시 시도되지 않았다.
  • 큰 주문은 나뉘어 체결된다. 수량이 큰 주문이 한 번에 체결되지 않고 일부만 체결된 채 남았다. "주문 = 즉시 전량 체결"을 가정한 코드는 여기서 꼬인다.
  • 잔고가 늦게 반영된다. 미국 주식을 산 직후에도 예수금 조회값은 그대로였다. 결제 전 금액이었기 때문이다. 잔고 조회에 기대지 않고, 시작 금액에 체결 내역을 더하고 빼는 자체 장부로 자산을 계산하게 바꿨다.

자동매매 프로그램이 갖춰야 했던 것

  • 목록은 끝까지 읽는다. 체결 내역 조회가 20건씩 끊겨 왔는데 첫 장만 읽고 있었다. 거래가 많았던 날 21번째부터의 체결을 통째로 놓쳤다. "다음 장 있음" 표시를 확인해 끝까지 읽어야 한다.
  • 주문은 함부로 다시 보내지 않는다. 주문 요청이 시간 초과로 실패해도 서버에는 접수됐을 수 있다. 그대로 다시 보내면 주문이 두 번 나간다. 잠시 뒤 당일 주문 목록에서 같은 주문(종목, 방향, 수량, 가격)을 찾아보고, 없을 때만 다시 낸다. 목록 조회마저 실패하면 중복 위험이 있으니 다시 내지 않는다.
  • 재시도할 오류와 아닌 오류를 나눈다. 통신 실패나 요청 한도 초과는 간격을 두고 다시 시도한다. "장이 끝났다", "잔고가 부족하다" 같은 업무상 거부는 다시 보내도 같으니 시도하지 않는다.
  • 장부를 먼저 쓰고 주문한다. 주문을 보낸 뒤 기록하면, 그 사이 프로그램이 죽었을 때 "보냈는지 모르는 주문"이 생긴다. 기록을 먼저 남긴다.
  • 같은 계좌로 두 개를 돌리지 않는다. 개발용과 운영용이 같은 계좌를 보면 주문이 두 번 나간다. 개발할 때는 주문을 보내지 않고 시세만 받아 가상으로 체결하는 모드를 따로 만들어 쓴다.
  • 기본값은 "꺼짐". 프로그램이 재시작돼도 자동매매가 저절로 켜지지 않게 한다. 사람이 버튼을 눌러야 주문이 나간다.
  • 실제 서버로 나갈 길을 없앤다. 접속 주소를 설정이 아니라 코드에 모의 서버로 고정하고 요청마다 확인한다. 설정 실수 한 번으로 실제 계좌에 주문이 나가는 일을 구조적으로 막는다.

모의로는 알 수 없는 것

  • 내 주문이 가격에 주는 영향. 모의 체결은 실제 호가를 움직이지 않는다.
  • 체결 순서. 같은 가격의 대기열에서 내 차례가 언제 오는지.
  • 심리. 실제 돈이 줄어드는 것을 보면서도 규칙을 지킬 수 있는지는 모의로 검증되지 않는다.

정리

모의투자는 규칙의 수익성보다 프로그램의 견고함을 검증하는 데 더 쓸모가 있었다. 부분 체결, 끊겨 오는 목록, 시간 초과, 거부 코드. 이런 것들을 실제 돈 없이 겪어 볼 수 있다는 것이 가장 큰 가치다. 이 글은 프로그램을 만든 경험을 적은 것이며 자동매매나 특정 종목 투자를 권하지 않는다.

이 글은 산업과 제도, 도구를 만든 경험을 설명하기 위한 것이며 특정 종목이나 상품의 매수·매도를 권하지 않는다. 제도와 수치는 글을 쓴 시점(2026년 11월) 기준으로 바뀔 수 있고, 투자 판단과 그 결과는 각자의 책임이다.

댓글 없음:

댓글 쓰기

반도체 주식을 보기 전에 그려 두는 지도 — 설계, 파운드리, 메모리, 장비, 소재, 후공정

"반도체주"라고 한 묶음으로 부르지만, 그 안의 회사들은 하는 일도 돈 버는 방식도 전혀 다르다. 같은 뉴스에 어떤 회사는 오르고 어떤 회사는 내리는 이유가 여기에 있다. 종목을 들여다보기 전에 머릿속에 그려 두면 좋은 지도를 정리한...