키움 멀티슬롯 자동매매 + 웹 관리자 종목풀 동기화 (다중 PC)

01배경 · 고객 요구사항

고객은 이미 키움 조건검색 기반 자동매매를 여러 대의 PC에서 돌리고 있었습니다. 문제는 "오늘 매매할 종목 풀"을 PC마다 따로 관리해야 했다는 것. 운영자가 종목을 골라도 각 PC에 일일이 옮겨 넣어야 했고, PC가 늘어날수록 손이 배로 들고 실수도 잦았습니다.

요청은 명확했습니다. ① 운영자가 웹 한 곳에서 매매 종목 풀을 관리하면, ② 등록된 모든 PC의 자동매매가 그 목록을 자동으로 반영하고, ③ 각 PC는 여전히 자기 키움 조건검색으로 독립 판단해 매매하는 것.

착수 전 가장 중요했던 것은 요구 범위를 정확히 못박는 일이었습니다. "운영자가 사면 유저도 같이 산다(카피트레이딩)"가 아니라 "종목 리스트만 공유하고 매매는 각자 한다"는 점을 대화로 명확히 구분한 뒤 시작했습니다. 이 한 줄의 차이가 서버 권한 설계와 책임 범위를 완전히 갈랐기 때문입니다.

02구현 방식

중앙 종목 풀 서버(FastAPI + SQLite, EC2)를 두고, 여러 대의 자동매매 클라이언트가 이 서버를 주기적으로 폴링해 종목 풀을 맞춰오는 서버-클라이언트 동기화 구조로 설계했습니다. 흐름은 이렇습니다:

• 웹 관리자 → 운영자가 매매할 종목 풀을 등록·삭제 (직접 입력·종목명 검색·CSV 업로드, 모바일 반응형)
• 종목 풀 서버 → 등록된 풀을 저장하고 GET /api/symbols로 제공 · 세션 로그인(웹)과 X-API-Key(클라이언트) 이중 인증
• 다중 PC 클라이언트 → 각 PC가 3초 주기로 폴링해 종목 풀을 캐시에 반영 (여러 대가 동시에 같은 풀을 바라봄)
• 교집합 매수 → "서버 종목 풀 ∩ 키움 조건검색" 교집합에 든 종목만 매수 (운영자 선별 + 유저 조건식 이중 필터)

핵심은 "제어권 공유"가 아니라 "데이터(종목 풀) 공유"라는 점입니다. 서버는 종목 목록만 배포하고, 실제 매수/매도 판단과 주문은 각 PC의 조건검색과 매매 룰이 독립적으로 수행합니다. 덕분에 PC를 몇 대로 늘려도 운영자는 웹 한 곳만 관리하면 됩니다.

연결이 끊겼을 때의 규칙도 명확히 했습니다. 서버 폴링이 끊기고 일정 시간(기본 60초)이 지나면 신규 매수를 차단하되, 이미 보유한 종목의 매도(청산)는 그대로 진행합니다. "종목 풀을 못 받았다고 손절까지 멈추는" 위험을 원천 차단한 설계입니다.

03해결한 기술 난제

• 분할매수 무한 루프 하드 가드 — 각 포지션 사이클에서 2/3차 매수를 단계별 1회만 발송. 체결 통보 누락·다른 슬롯 라우팅·미체결 정리 어떤 경우에도 재발송 불가, 전량 매도 후에만 초기화
• 같은 계좌 중복 배정 차단 — 이미 실행 중인 슬롯과 같은 계좌를 다른 슬롯에 지정하면 시작을 거부해, 통보 편향 라우팅으로 인한 오매수를 사전 예방
• 서버 끊김 시 매수 차단 — 폴링이 끊기고 설정 시간(기본 60초)이 지나면 신규 매수만 정지, 보유 종목 청산은 계속
• 종목명 자동 조회 — 키움 OCX를 쓸 수 없는 리눅스 서버 환경에서 종목코드→종목명을 외부 금융 데이터로 폴백 조회·캐시
• API 키 입력 정제 — 클립보드 복붙 시 개행·공백·보이지 않는 문자를 제거하고 형식을 실시간 검증, 표시/숨김 토글 제공
• 설정 무손실 마이그레이션 — 손절·수익실현·분할매수 스키마가 바뀌어도 기존 사용자 설정을 자동 변환해 재입력 없이 업데이트

04핵심 기능

• 웹 관리자 종목 풀 — 종목 등록·삭제(직접 입력·종목명 검색·CSV 업로드), 종목명 자동 조회, 모바일 반응형
• 다중 PC 3초 동기화 — 등록된 모든 PC가 3초 폴링으로 같은 종목 풀을 실시간 공유
• 종목풀 ∩ 조건검색 교집합 매수 — 운영자 선별 종목과 각 PC의 조건검색이 겹치는 종목만 진입
• 3슬롯 멀티계좌 병렬 — 슬롯별 독립 계좌·조건검색·매매 룰로 동시 운용
• 고급 청산 — 매수 건수별 단계별 손절, 순서 무관 독립 분할매수(불타기·물타기), 익절 후 트레일링 스탑
• 이중 인증·운영 관리 — 세션 로그인(웹) + X-API-Key(클라이언트), API 키 발급/폐기·접속 로그·비밀번호 변경
• 운영 안전장치 — [중지]=손절도 정지 옵션, 숫자 입력 마우스 휠 무시(오변경 방지), SQLite 포지션 영속화(재시작 복원)

05제작 과정 (약 3~4주)

• 1주차 · 범위 확정·서버 설계 — "종목 리스트 공유 vs 카피트레이딩" 스코프 못박기, 종목 풀 서버(FastAPI)·DB 스키마·이중 인증 설계
• 2주차 · 웹 관리자·동기화 — 종목 CRUD·CSV·종목명 조회 웹 관리자, 클라이언트 3초 폴링 동기화, 교집합 매수 게이트 구현
• 3주차 · 고급 청산·안전 가드 — 단계별 손절·독립 분할매수·트레일링 스탑, 분할매수 무한 루프 하드 가드 + 계좌 중복 배정 차단
• 4주차 · 배포·검증 — EC2(systemd + Nginx) 서버 배포, 다중 PC 동기화·끊김 시나리오 점검, 소액 실계좌 검증 후 인수인계

06납품 결과물

• 자동매매 클라이언트 실행 파일 (GUI 포함 · 키움 OpenAPI+ 32bit)
• 종목 풀 서버 (FastAPI) + EC2 배포 설정 (systemd 서비스 · Nginx 리버스 프록시)
• 웹 관리자 페이지 (종목 풀 관리·API 키 발급/폐기·모바일 반응형)
• 사용설명서 + 서버·API 키 설정 가이드
• 납품 후 30일 무료 AS (협의 범위 내)

07기술 스택

08관련 사례 · 더 보기