본문으로 건너뛰기

투자자동화2] 내 주식 투자를 도와줄 비서 앱 제작 (~ing)

Develiper

2026.08.04

투자자동화2] 내 주식 투자를 도와줄 비서 앱 제작 (~ing) 본문 이미지

스마트머니 수급을 읽어주는 나만의 퀀트 대시보드, 'QuantHold' 개발기


왜 만들게 됐나

주식 투자를 하면서 늘 아쉬웠던 건, 시중의 증권사 앱들이 "내가 지금 사야 하는지 팔아야 하는지"에 대한

명확한 판단 근거를 주지 않는다는 점이었습니다. 주가 지수만 보고 매매하기엔 정보가 너무 얕고, 그렇다고

매번 수급 데이터를 직접 찾아 분석하기엔 시간이 부족했죠.

시장을 실제로 움직이는 건 개인 투자자가 아니라 외국인과 연기금 같은 '스마트머니'입니다. 이들의

현물·선물 순매수 동향, 기관 내에서도 연기금(장기 가치 자금)과 금융투자(단기 차익거래) 자금의 성격

차이, 개인 물량 소화 양상, KOSPI/KOSDAQ 지수 흐름을 종합적으로 봐야 시장의 진짜 방향을 가늠할 수

있습니다.

그래서 이 흐름을 자동으로 진단하고, 여러 증권사 계좌에 흩어진 포트폴리오를 하나로 모아 관리해주는

개인용 웹 앱을 직접 만들기 시작했습니다. 이름은 QuantHold.


앱이 하는 일

QuantHold는 한 문장으로 말하면 "시장 수급의 질(Quality)을 진단하고, 계좌별 종목에 대한

매수·매도·추가매수 의사결정을 도와주는 라이트 모드 퀀트 대시보드"입니다. 핵심 기능은 크게 네 갈래로

나뉩니다.

1. 스마트머니 수급 & 지수 레이더 (Market Flow Dashboard)

외국인/기관(연기금·금융투자 분리)/개인의 현물·선물 순매수 동향과 KOSPI·KOSDAQ 지수를 한 화면에서

복합적으로 보여줍니다. 단순히 "오늘 지수가 올랐다"가 아니라 "누가 사서 올랐는지, 그 매수 주체가 얼마나

신뢰할 수 있는 자금인지"까지 판단할 수 있도록 설계했습니다.

2. 퀀트 스크리너 & 팩터 스코어

보유·관심 종목에 대해 여러 팩터를 점수화하여 시각화하고, 재무 추세 차트를 함께 보여줌으로써 종목별

매수/매도 판단에 참고할 수 있는 정량 지표를 제공합니다.

3. 다계좌 통합 포트폴리오 관리

여러 증권사에 흩어진 계좌들을 하나로 묶어, 계좌별 확정 실현 손익과 실수령 배당금을 정밀하게

합산·추적합니다. 계좌마다 따로 로그인해서 확인해야 했던 번거로움을 없애고, 전체 자산 흐름을 한눈에

파악할 수 있게 했습니다.

4. 배당락일 D-Day 캘린더 (Macro Calendar View)

보유 종목의 배당락일까지 남은 일수(D-Day)와 배당금 지급 예정일을 캘린더 형태로 제공합니다. 배당 투자자

입장에서 배당락 타이밍을 놓치지 않도록 돕는 실용적인 기능입니다.

한국사이트 스크린샷


어떻게 만들고 있나

기술 스택은 다음과 같습니다.

- 프론트엔드: React 18 + TypeScript, Vite 빌드

- 상태 관리: Zustand

- 서버 상태/데이터 페칭: TanStack Query (React Query)

- 차트 시각화: Recharts

- PWA 지원: vite-plugin-pwa를 통해 모바일에서도 앱처럼 설치·구동 가능

- 외부 데이터 연동: 한국투자증권 Open API(KIS), 한국은행 경제통계시스템(ECOS), 금융감독원

전자공시(DART) 등 공공·증권사 API를 조합해 실시간 시세, 거시경제 지표, 기업 공시 데이터를 가져오는

구조로 설계

아키텍처는 관심사를 명확히 분리했습니다. services/api 하위에 각 외부 API별 클라이언트를 두고,

services/quantEngine.ts에서 팩터 스코어링과 의사결정 로직을 계산하며, store에서 포트폴리오 전역 상태를

관리하고, components는 대시보드·모달·차트 단위로 잘게 쪼개 재사용성을 높였습니다. 반응형 웹으로

설계해 데스크톱과 모바일 모두에서 동일한 경험을 제공하는 것을 목표로 하고 있습니다.


진행 상황

현재 로컬 개발 서버(포트 3030)에서 다음 기능들이 동작하는 단계까지 왔습니다.

- 다계좌 통합 실현 손익 및 배당금 합산 로직 완성

- 배당락일 D-Day 캘린더 UI 및 데이터 연동 완료

- 스마트머니 3대 주체(외국인/연기금/개인) 수급 대시보드 1차 구현

- 종목 상세 모달, 팩터 스코어 차트, 재무 추세 차트 등 핵심 UI 컴포넌트 구현

- PWA 설치 프롬프트 등 모바일 최적화 작업 진행

아직 개인용 로컬 환경에서 실사용하며 기능을 다듬어가는 초기~중기 단계이고, 실제 API 연동의 안정성과

데이터 정합성을 지속적으로 검증하고 있습니다.


앞으로의 계획

1. 알림 기능 고도화: 배당락일 임박, 특정 팩터 스코어 임계치 도달 시 알림을 제공하는 기능 추가

2. 의사결정 엔진 정교화: 단순 팩터 스코어를 넘어, 수급 데이터와 재무 데이터를 결합한 종합 매매 시그널

로직 고도화

3. 백테스트 기능: 과거 데이터를 기반으로 스크리닝 전략의 성과를 검증할 수 있는 백테스트 모듈 추가

4. 배포 환경 정비: 로컬 개발 환경을 넘어 개인 서버 또는 클라우드 배포를 통한 상시 접근 가능한 구조로

전환

5. UI/UX 개선: 라이트 모드 기반의 현재 UI를 다크 모드까지 지원하도록 확장하고, 모바일 반응형 완성도를

높이는 작업

투자 의사결정을 감이 아니라 데이터에 기반해서 내리고 싶다는 개인적인 니즈에서 출발한 프로젝트이지만,

만들다 보니 점점 "내가 정말 쓰고 싶은 툴"의 형태를 갖춰가고 있습니다. 앞으로도 계속 업데이트하면서

진행 상황을 공유하겠습니다.


더 고도화하고 테스트하면서 수정 개선 보완해서 다음주 마지막 주차까지는 완성해서 사용해 보도록 하겠습니다.

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

디
디디DD2026.08.05

"내가 정말 쓰고 싶은 툴" 이게 정말 중요한것 같아요. 서비스 타겟에 있어서도 "사람들이 쓰고 싶게 만드는게 만드는 것"이 역시나 가장 중요한 것이고요.
금융계열차트라면 Rechart보다 Lightweight Charts 라이브러리를 한 번 사용해보세요. 웬만한 생각하는 그림은 다 그릴 수 있을거에요.

Develiper 프로필 이미지
Develiper2026.08.06

감사합니다. 한 번 해보겠습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기