auto-pie — 개인용 주식 자동 리밸런싱 데스크톱 앱
auto-pie는 목표 비중에 맞게 주식 포트폴리오를 자동으로 리밸런싱하는 개인용 데스크톱 앱이다. Electron 프론트엔드와 Python FastAPI 백엔드를 조합한 하이브리드 아키텍처를 채택했다.
프로젝트 개요
| 항목 | 내용 |
|---|---|
| 상태 | 개인 사용 중 |
| 유형 | 개인 프로젝트 |
| 주요 기술 | Electron, Python FastAPI |
기획 배경
주식 포트폴리오를 목표 비중에 맞게 유지하려면 주기적으로 각 종목의 현재 비중을 계산하고 매수·매도 수량을 수동으로 산출해야 한다. 이 반복 작업을 자동화하기 위해 개발했다.
주요 기능
| 기능 | 설명 |
|---|---|
| 계좌 조회 | 현재 보유 종목 및 수량, 평가금액 조회 |
| 주식 검색 | 종목명·티커 검색 |
| 매수·매도 | 앱에서 직접 주문 실행 |
| 자동 리밸런싱 | 목표 비중 입력 시 매수·매도 수량 자동 산출 및 실행 |
기술 구현
아키텍처
Electron이 UI 레이어를 담당하고, Python FastAPI 서버가 증권사 API 연동 및 리밸런싱 로직을 처리하는 구조다. Electron에서 FastAPI 서버를 내부적으로 실행하여 단일 앱처럼 동작한다.
- Electron: 데스크톱 UI, 시스템 트레이 연동
- Python FastAPI: 증권사 API 통신, 리밸런싱 계산 엔진
리밸런싱 알고리즘
각 종목의 현재 비중과 목표 비중 차이를 계산하여 매수·매도 수량을 산출한다. 잔여 현금 및 최소 주문 단위(1주)를 반영한 정수 최적화로 실제 실행 가능한 주문만 생성한다.
현황
개인 사용 목적으로 개발한 도구로, 실제 포트폴리오 관리에 활용 중이다.