한국 주식 시장 데이터를 바탕으로 AI가 모의투자 판단을 보조하고, 사용자가 판단 근거를 확인할 수 있도록 만든 투자 보조 대시보드 프로젝트입니다.
이 저장소는 공개 포트폴리오용입니다. 실제 서비스 코드, 인증 정보, 계좌 정보, 서버 접속 정보, 운영 로그, 실거래 설정은 포함하지 않습니다.
KIS AI 트레이더의 목표는 AI가 무작정 매수하거나 매도하는 프로그램을 만드는 것이 아닙니다.
목표는 다음과 같습니다.
- AI가 어떤 데이터를 보고 판단했는지 사용자에게 보여주기
- 매수, 대기, 차단 이유를 화면에 설명하기
- 모의투자로 충분히 검증한 뒤 실거래 전환을 따로 준비하기
- 너무 보수적으로 아무것도 하지 않는 AI와, 근거 없이 막 매매하는 AI를 모두 피하기
- 사용자가 이해할 수 있는 화면으로 투자 판단 흐름을 정리하기
모의자산, 총 손익, AI 판단, 검증 상태, 시장 상태, 뉴스 요약을 한 화면에서 확인합니다.
보유 종목, 평가손익, 최근 매수/매도 기록, AI가 왜 샀고 왜 기다리는지 확인합니다.
AI가 보는 조건을 간단히 보여줍니다.
- 시장 상태
- 뉴스 흐름
- 후보 종목 여부
- 리스크 조건
- 자동매수 엔진 상태
- 실주문 잠금 상태
누적 수익과 하루 변화를 분리해서 보여줍니다. 사용자가 수익률을 오해하지 않도록 “누적 손익”과 “하루 변화”를 구분합니다.
관리자용 화면에서는 데이터 수집 상태, 시스템 상태, 자동매수 엔진 상태, 접속 기록 등을 확인합니다.
공개 저장소에는 운영 명령이나 서버 내부 정보는 포함하지 않습니다.
AI가 너무 보수적으로 아무것도 안 하거나, 반대로 근거 없이 막 매수하는 문제를 줄이기 위해 별도 행동균형 구조를 설계했습니다.
- 시장 국면에 따라 리스크 예산 조절
- 공시/시장경보 기반 신규 매수 차단
- 호가/체결강도 기반 진입 품질 확인
- 매수하지 않은 후보의 1일/3일/5일 후 결과 기록
- 수수료와 세금 차감 후 실제 수익성 라벨링
자세한 내용은 수익성 행동균형 설계에 정리했습니다.
처음에는 많은 정보를 한 화면에 보여주려고 했지만, 피드백을 통해 “직관적인 화면”이 더 중요하다는 것을 반영했습니다.
그래서 화면을 두 가지 방식으로 나누었습니다.
- 상세형: 데이터와 판단 근거를 자세히 보는 화면
- 간편형: 처음 보는 사람도 핵심만 빠르게 이해하는 화면
두 화면은 같은 데이터를 사용하지만, 보여주는 방식만 다르게 설계했습니다.
AI는 다음 원칙을 따르도록 설계했습니다.
- 근거 없이 매수하지 않기
- 조건이 맞는 후보를 계속 방치하지 않기
- 장이 열리지 않으면 신규 매수를 하지 않기
- 뉴스, 시장 상태, 보유 비중, 리스크를 함께 보기
- 목표 비중은 즉시 매수 명령이 아니라 최대 운용 기준으로 사용하기
- 실거래 주문은 별도 승인 전까지 잠금 상태로 유지하기
사용자는 모의투자에서 목표 운용 비중을 선택할 수 있습니다.
- 기본 자동
- 균형 운용
- 적극 운용
- 후보 중심 운용
- 직접 입력 비중
예를 들어 사용자가 60%를 입력하면 AI는 전체 자산 중 최대 60% 정도를 목표로 보되, 조건을 통과한 후보가 있을 때만 단계적으로 반영합니다.
검증기간이 끝났다고 바로 실거래로 바뀌지 않습니다.
실거래 전환은 별도 단계로 분리합니다.
- 모의투자 검증
- 검증 결과 확인
- 실계좌 조회 준비
- 위험 조건 점검
- 관리자 승인
- 첫 주문 별도 승인
이 저장소에는 실거래 설정이나 주문 실행 코드는 공개하지 않습니다.
- 프로젝트 개요
- 주요 화면 설명
- UI/UX 개선 방향
- AI 사용 방식 요약
- 발표용 정리 문서
- 실제 코드
- 인증 정보
- 계좌 정보
- 서버 주소와 접속 방법
- 환경변수 파일
- 운영 로그
- 실거래 주문 설정
- 내부 테스트 결과 원본
이 프로젝트를 하면서 가장 크게 느낀 점은 “기능이 많아도 사용자가 이해하지 못하면 좋은 서비스가 아니다”라는 점입니다.
그래서 단순히 기능을 추가하는 것보다, 사용자가 지금 무엇을 봐야 하는지, AI가 왜 기다리는지, 어떤 조건이 충족되지 않았는지를 더 직관적으로 보여주는 방향으로 개선했습니다.