PERSONAL / TRADING SYSTEM

Interlock

Multi-Broker Order Control Plane

KIS와 토스증권의 API를 연결하고 주문 상태·리스크 검사·이벤트 기록을 관리하는 개인 투자 관제 시스템을 개발하고 있습니다.

기간
2026.06 — 현재
담당 역할
아키텍처 · 백엔드 개발
PythonKIS Open APIToss Open APIWebSocketSQLite

프로젝트 배경

개인 프로젝트. 증권사마다 다른 인증·시세·계좌·주문 API를 하나의 처리 흐름으로 연결하고, 주문 전 검증과 처리 이력을 관리하는 시스템입니다.

01

증권사별 차이를 분리

KIS WebSocket과 토스증권 REST API의 차이를 Adapter·Gateway 계층으로 분리했습니다. 주문 후보–리스크 승인–제출 직전 재검증–주문 전송–체결 대사를 상태 머신으로 관리합니다.

02

주문 전 리스크 검사

현금·단일 종목·레버리지·미체결 주문 노출을 합산하는 중앙 Risk Engine을 구현했습니다. 호가 괴리·슬리피지·매수 가능 금액·매도 가능 수량을 재검증하고, 조건을 벗어난 주문은 API 호출 전에 차단합니다.

환경변수 승인값·명시적 실행 옵션·중앙 Kill Switch를 조합해 주문 실행 조건을 제어했습니다.

03

이벤트 기록과 후속 처리

주문·체결·차단·오류 이벤트를 SQLite Event Outbox에 기록하고 중복 방지·재시도·알림 Worker를 구현했습니다. Docker Compose로 시세 감시·주문 대사·알림 Worker를 분리했습니다.

결과

소량 매수·매도 왕복 체결 흐름을 검증했습니다. 개인 프로젝트로 개발을 이어가고 있으며, 주문 제어와 기록·대사 구조를 중심으로 개선하고 있습니다.