1. 처음 사용하는 경우: 이 순서대로 시작하세요
- 설정 → 증권에서 키움 REST API 정보를 입력하고 토큰 확인으로 연결을 확인합니다. 실전 계좌를 사용할 경우 아래의 실전투자 계좌별 API Key에도 계좌별 키를 등록합니다.
- 상단의 ↻ 동기화를 눌러 계좌 자산, 보유종목, 실현손익 등 기본 데이터를 한 번 가져옵니다.
- 계좌통합관리 → 계좌관리에서 계좌 별칭과 목적을 지정합니다. 예:
중개형ISA / 장기, 일반계좌 / 단기.
- 계좌통합관리 → 원금·입출금에서 키움 거래내역 가져오기를 실행하고 원금 검증의 차이가 큰지 확인합니다.
- 대시보드에서 총자산·원금·평가손익·실현수익과 보유종목이 정상적으로 보이는지 확인합니다.
- 필요하면 설정 → 메신저/AI에서 AI API Key와 텔레그램/디스코드를, 설정 → 연동에서 StockScanner를 연결합니다.
- 자동 주문 기능은 바로 실전으로 시작하지 말고 자동 리밸런싱은 관찰/모의, 자동 주식수집은 관찰/모의, 자동 손절등록은 DRY RUN으로 먼저 결과를 확인한 뒤 실전으로 전환합니다.
초보자 권장 흐름
설정 → 동기화 → 계좌관리 → 원금 검증 → 대시보드 확인 → 자동 기능은 관찰/DRY RUN → 이상 없을 때 실전
2. 상단 아이콘과 기본 조작
- ? : 이 사용 매뉴얼을 엽니다. 매뉴얼 밖의 어두운 영역이나 × 버튼을 눌러 닫을 수 있습니다.
- ☾ / ☀ : 다크/라이트 테마를 전환합니다. 선택한 테마는 브라우저에 저장됩니다.
- ↻ 동기화 : 키움 REST API에서 최신 계좌 데이터를 즉시 가져옵니다. 수동 동기화는 장외에도 실행할 수 있고, 백그라운드 자동 동기화는 설정된 장중 조건에 맞춰 실행됩니다.
- 상단 상태 배지 : 현재 자동 동기화 가능 여부와 최근 동기화 완료 시각을 보여줍니다. 데이터가 이상할 때 가장 먼저 최근 동기화 시각을 확인하세요.
- ⚙ : 설정 화면으로 이동합니다. 증권, 메신저/AI, 연동, 보안, 운영 탭으로 나뉩니다.
- ↩ : 현재 관리자 세션에서 로그아웃합니다.
3. 대시보드: 내 계좌 상태를 한눈에 보는 화면
기간·계좌·종목 필터
- All은 전체 기간, Day / Week / Month / Year는 해당 기간의 변화를 봅니다. Day는 1~6일, Week는 1~5주, Month는 1~11개월까지 숫자를 직접 지정할 수 있습니다.
- 계좌 필터를 선택하면 특정 계좌만, 종목 필터를 선택하면 특정 보유종목과 관련된 흐름을 확인할 수 있습니다.
- 화면의 계좌명은 가능하면 저장한 별칭을 사용하며 계좌번호 노출을 최소화합니다.
지표와 그래프 읽는 법
- 총자산은 현재 계좌의 자산 규모, 입금/뱅킹 원금은 실제 넣고 뺀 자금 기준, 평가손익은 보유 중인 종목의 미실현 손익, 실현 수익은 매도 완료 손익입니다.
- 기타 수익에는 원금과 분리해 관리하는 배당/분배금 등의 항목이 반영될 수 있습니다.
- 자산/원금/수익과 수익률 흐름 그래프의 범례를 누르면 해당 선을 강조해서 볼 수 있습니다.
- 계좌별 자산·성과는 계좌 목적·평가일과 함께 총자산, 자산비중, 원금, 현금/주식 구성, 평가손익, 실현·기타수익, 수익률과 수익 기여도를 한 표에서 보여줍니다. 마지막 전체 행에서 합산 금액도 확인할 수 있습니다.
- 보유종목 통합 분석은 같은 종목을 여러 계좌에 보유해도 합산수량, 통합 평단가, 평가금액, 평가손익, 수익률과 보유 계좌를 한 줄에서 확인할 수 있습니다.
- 보유종목 대응 현황은 StockScanner가 연결된 경우 가격·거래량 기반 대응 신호와 근거를 참고자료로 보여줍니다.
대시보드의 시장 정보
- 대시보드의 시장·AI 요약에는 KOSPI, NASDAQ, VIX, USD/KRW 핵심 지표와 최신 AI 브리핑 일부만 간단히 표시합니다.
- 주요 일정은 대시보드에서는 전체 월간 달력이 아니라 현재 주의 일정만 한 줄 형태로 요약됩니다.
- 현금/보유종목 비중, 국내 투자자 수급, 국내외 이벤트, 분산투자 후보, StockScanner 마켓맵, AI 근거 상태와 전체 브리핑은 별도 AI 현황판에서 확인합니다.
사용 예
최근 4주 성과를 보고 싶다면 Week 왼쪽 숫자를 4로 바꾸고 Week를 누릅니다. 특정 ISA 계좌만 보고 싶으면 계좌 필터에서 해당 별칭을 선택합니다.
4. AI 현황판: 시장과 내 포트폴리오를 함께 해석하기
- 새로고침은 현재 수집된 시장/포트폴리오 데이터를 다시 불러오고, 실시간 요약 생성은 현재 데이터를 바탕으로 AI 브리핑을 새로 만듭니다.
- 기본 데이터에는 KOSPI/KOSDAQ, NASDAQ, S&P 500, 미국 VIX, 미국 공포탐욕지수, 미국 10년물, USD/KRW, 국내 투자자 수급, 주요 뉴스/이벤트, 보유종목 관련 데이터가 포함될 수 있습니다.
- 포트폴리오 원형 그래프는 최신 동기화 스냅샷을 기준으로 현금과 종목별 비중을 표시합니다.
- 국내 투자자 수급 그래프는 개인·외국인·기관의 누적 순매수 흐름을 비교합니다. 일부 원천이 일시 실패하면 정상 캐시가 사용될 수 있으며, 화면의 근거/상태 문구를 함께 확인하세요.
- 주요 일정은 이 화면에서도 현재 주만 요약되며, 월 전체는 별도 주요 일정 캘린더 메뉴에서 확인합니다.
- AI 제공자는 OpenAI, Google Gemini, Anthropic Claude를 선택할 수 있습니다. API Key가 없거나 호출에 실패하면 가능한 범위에서 로컬 데이터 요약을 표시합니다.
- AI 문장은 의사결정 보조용입니다. 실제 주문은 대시보드/AI 현황판에서 자동으로 실행되지 않습니다.
사용 예
장중 급락이 보이면 먼저 지수/VIX/환율과 투자자 수급을 확인하고, 이어서 AI 요약의 리스크와 대응 조건을 읽은 뒤 보유종목 대응 현황과 함께 비교합니다.
5. 주요 일정 캘린더: 신규상장 + 국내외 경제일정
- 주요 일정 캘린더 메뉴에서는 해당 월의 신규상장 일정과 국내외 주요 경제일정을 달력 전체로 확인합니다.
- 경제일정의 표시 시간은 KST(한국시간) 기준입니다. 같은 날 일정이 많으면 +N건 더 보기를 눌러 나머지를 펼칩니다.
- 대시보드와 AI 현황판에는 가독성을 위해 월간 전체가 아니라 현재 주의 일정만 표시합니다.
- 일정 데이터가 오래되었거나 일부 소스 조회가 실패한 경우 화면에 이전 조회 결과 또는 일부 오류 안내가 표시됩니다.
- 새로고침을 누르면 현재 월의 일정 데이터를 다시 요청합니다.
사용 예
이번 주 미국 CPI나 FOMC 같은 이벤트가 있는지 대시보드에서 빠르게 보고, 세부 시간과 월 전체 일정을 보고 싶을 때 주요 일정 캘린더 메뉴를 엽니다.
6. 계좌통합관리: 매매일지 · 계좌관리 · 원금·입출금 · 수동스냅샷
계좌통합관리 안에는 네 개의 탭이 있습니다. 처음에는 계좌관리 → 원금·입출금 → 매매일지 순서로 확인하면 이해하기 쉽습니다.
매매일지
- 수동 등록에서는 계좌, 일자, 종목, 매수/매도 수량과 평균가, 실현손익, 수익률, 전략, 태그, 진입 이유, 복기 내용을 직접 기록합니다.
- 키움 매매일지 가져오기로 키움의 실현손익 데이터를 가져올 수 있습니다. 최근 목록은 계좌·기간·종목·손익 상태로 필터링합니다.
- 메신저 텍스트 등록은 텔레그램/디스코드 형식의 문장을 매매일지로 변환해 저장합니다. 예:
/trade 삼성전자 손익 +120000 수익률 3.2 #돌파 #복기.
- AI 주간 매매 요약은 한 주의 패턴, 잘한 점, 개선점, 다음 주 체크리스트를 정리합니다. AI 설정이 되어 있어야 AI 제공자 호출을 사용할 수 있습니다.
계좌관리
- 키움에서 불러온 계좌에 별칭과 목적을 저장합니다. 목적 예시는
장기, 배당, 단기처럼 자유롭게 지정할 수 있습니다.
- 대시보드와 여러 선택 목록은 계좌번호 대신 별칭을 우선 표시하므로 처음 설정할 때 별칭을 정리해두면 편합니다.
- 계좌가 보이지 않으면 먼저 상단 동기화를 실행하고, 계좌관리의 새로고침을 눌러 다시 확인합니다.
원금·입출금
- 키움 거래내역 가져오기는 입출금/배당 등 계좌의 자금 흐름을 가져와 자동 분류합니다. 확실하지 않은 거래는 미확인으로 남겨 원금 합계에서 잘못 섞이지 않도록 합니다.
- 원금 검증의 기본 개념은
스냅샷 원금 ≈ 자동 입출금 + 수동 입출금/조정입니다. 차이가 크면 누락된 입출금이나 분류되지 않은 거래를 확인합니다.
- 입금은 원금 증가, 출금은 원금 감소, 조정은 과거 데이터 보정에 사용합니다. 배당/분배는 투자성과로 취급하며 입금 원금과 분리합니다.
- 최근 입출금은 전체/입금/출금/조정/배당/미확인으로 필터링할 수 있습니다.
수동스냅샷
- API를 쓰지 못하는 계좌나 과거 기준점을 직접 넣고 싶을 때 평가일, 총자산, 입금 원금, 예수금, 주식 평가금, 매입금액, 평가손익을 입력합니다.
- 수동 스냅샷은 실제 API 데이터와 중복되지 않도록 평가일과 계좌를 확인한 뒤 등록하세요.
사용 예
처음 연결한 계좌의 원금 검증 차이가 300만원이라면 최근 입출금의 미확인 항목을 먼저 확인하고, 과거 누락분이 확실할 때만 조정으로 보정합니다.
7. StockScanner 연동: 보유종목 대응신호와 마켓맵 참고
- 설정 → 연동에서 StockScanner 사이트 URL과 Bearer API 토큰을 저장하면 연동 기능을 사용할 수 있습니다.
- 현재 StockManager 로그인 사용자명과 같은 StockScanner 계정에 보유종목을 자동 추가/갱신하며, 기존에 사용자가 직접 만든 즐겨찾기는 삭제하지 않습니다.
- 보유종목 카드에는 현재가, 평단가, 수익률, 보유비중과 StockScanner의 가격·거래량 기반 대응 신호를 표시합니다.
- 1차는 고점 대량거래 반전, 2차는 판정일까지 첫 하락폭의 회복 부족, 3차는 확정 첫 하락 저점의 종가 이탈과 거래량/이탈 깊이 확인을 의미합니다.
- 현재 구조는 추세 훼손 관찰, 저점 다지기, 첫 저점 회복, 반등 시도/확인/실패 같은 상태로 표현될 수 있습니다.
- StockScanner 신호는 참고정보입니다. 대시보드의 신호만으로 주문하지 않으며, 자동 손절등록에서도 Scanner 신호 자체를 단독 자동매도 트리거로 사용하지 않습니다.
- 대시보드/AI 현황판의 마켓맵과 분산투자 정보도 참조 사이트 연결 상태에 따라 제공됩니다.
8. 매수 신호: 희망매수가에 가까워지는 종목 관찰
- 시장 후보 자동분석은 StockScanner와 독립적으로 코스피·코스닥의 거래대금, 가격 모멘텀, 52주 고점 근접도, 외국인·기관 수급을 이용해 주도주 점수를 계산합니다. 시가총액 3,000억원 미만 종목은 주도주 후보에서 제외합니다.
- 장기투자 후보는 시가총액 상위 보통주를 대상으로 ROE, 영업이익률, 매출·이익 성장성, 부채비율, PER/PBR, 장기 추세를 별도 점수화합니다.
- 희망가 자동계산은 최근 일봉 차트의 스윙 저점, 반복 지지선, 돌파 후 리테스트 가격, 거래량 집중 매물대를 먼저 찾고 MA20/MA60·ATR·밸류에이션과 겹치는 가격대를 우선합니다. 기존 수동 희망가는 덮어쓰지 않습니다.
- 복합 매수 신호는 희망가 근접도를 중심으로 종목의 주도/장기 점수, 기술 추세, 펀더멘털을 함께 반영합니다. 따라서 단순 급락만으로 최고 신호가 되지 않도록 보완했습니다.
- 종목명 오른쪽의 60일 미니 차트는 최근 종가 흐름을 보여주며, 희망매수가는 점선, 자동 추천가는 보조 점선, 가장 오른쪽 점은 현재가를 표시합니다. 차트 히스토리는 15분 캐시합니다.
- 각 행의 ⋮⋮ 드래그 핸들을 잡아 위아래로 끌어 놓으면 종목 순서를 변경할 수 있습니다. PC의 마우스와 모바일/태블릿 터치를 모두 지원하며, 변경 후 수동 순서로 저장됩니다.
- 리스트 전체삭제는 현재 사용자의 매수 신호 종목, 희망매수가, 분류, 분석 점수와 저장 순서를 모두 지웁니다. 실수 방지를 위해 확인창을 한 번 더 표시합니다.
- StockScanner 보조후보는 별도 참고 입력입니다. 단기 후보를 자동으로 주도주로 간주하지 않으며, 시장 자체 분석 결과를 우선합니다.
- 화면이 열려 있는 동안 현재가는 10초 주기로 갱신합니다. 이는 체결용 틱 데이터가 아니라 관찰용 준실시간 시세입니다.
- 이 기능은 신호 관찰용이며 매수 주문을 자동 실행하지 않습니다.
사용 예
희망매수가 100,000원인 종목이 102,000원이면 신호 80점으로 표시되고, 100,000원에 도달하면 100점으로 가장 진하게 표시됩니다.
9. 자동 퀀트투자 > 리밸런싱 전략: 주식/현금 비중을 자동으로 맞추기
실전 주문 기능
처음에는 관찰(가상 체결)로 충분히 확인하고, 그 다음 모의투자, 마지막에 실전 순으로 사용하세요.
운용 모드
- 관찰 : 실제 증권 주문 없이 전략 계산과 가상 체결 흐름을 확인합니다.
- 키움 모의투자 : 모의 계좌 API를 사용해 주문 흐름을 검증합니다.
- 실전 자동주문 : 등록한 실전 계좌로 주문을 전송합니다. 시작할 때 계좌번호 확인 절차가 있습니다.
전략 설정의 핵심
- 운용 대상에서 시장(KRX/미국), 계좌, 종목, 초기 배정금액을 정합니다. 국내 종목은 종목명, KRX 6자리 코드(숫자/영문) 또는 한글 초성으로 검색할 수 있습니다.
- 목표 종목 비중은 전략 자산 중 주식으로 유지할 비율입니다. 기본 50%라면 나머지는 현금 50%를 뜻합니다.
- 허용 편차는 작은 움직임마다 거래하지 않도록 만드는 Band입니다. MA60 조절을 끈 50% 목표/5%p Band 예에서는 약 45~55% 범위를 벗어났을 때 리밸런싱 필요성이 생깁니다.
- MA60 이격도 자동 조절을 사용하면 현재가가 60일 이동평균에서 얼마나 떨어져 있는지에 따라 기본 목표비중을 위/아래로 조정합니다. 민감도와 최대 조정폭으로 변화 강도를 제한합니다.
- 비대칭 리밸런싱 Band은 상승장 매도와 하락장 매수 기준을 다르게 두어 너무 빠른 익절이나 너무 빠른 물타기를 줄이는 용도입니다.
- 주문·안전 설정에서 확인 주기, 최소 주문금액, 일일 주문 횟수/금액 한도, 초기 자금 대비 중단 손실률, 미체결 취소 대기, 수수료/세율 가정을 설정합니다.
- 국내 자동주문은 화면에 표시된 KRX 운용시간을 따르며, 장외/애프터마켓을 자동주문 대상으로 사용하지 않습니다.
저장 후 버튼 사용법
- 설정 수정 : 중지/일시정지 상태의 전략 설정을 다시 엽니다.
- 시작 / 실전 주문 시작 : 전략을 운용 상태로 바꿉니다.
- 일시정지 : 전략은 남겨두고 신규 자동판정을 멈춥니다.
- 긴급중단 : 신규 자동운용을 빠르게 중단할 때 사용합니다.
- 체결 대조 : 증권사 체결 상태와 StockManager 기록을 다시 맞춥니다. 미체결 주문번호가 있으면 취소 재요청 버튼이 나타날 수 있습니다.
- 전략 종료 : 더 이상 사용하지 않을 전략을 종료합니다. 실전 전략 종료 시 확인 절차가 있습니다.
수익 추이와 백테스트
- 전략 수익 추이에서 선택한 전략의 누적수익 금액과 수익률을 확인합니다. 기록은 기능 제공 이후 장이 열린 시간에 주기적으로 누적됩니다.
- 백테스트는 키움 과거 일봉을 자동 조회하거나 CSV(
date, open, close)를 사용해 현재 전략과 초기 비중 단순 보유를 비교합니다.
사용 예
삼성전자에 1,000만원을 배정하고 목표 50%, Band 5%p, MA60 사용으로 저장한 뒤 먼저 관찰 모드로 시작합니다. 카드의 현재 목표비중·예상 매수/매도수량과 운영 기록이 의도대로 나오는지 며칠 확인한 후 모의/실전으로 단계적으로 전환합니다.
10. 자동 퀀트투자 > 종사종팔: V4/V5 종가 분할매매 자동화
미국주식 자동주문종사종팔은 LOC/MOC 주문을 사용합니다. 먼저 관찰모드와 백테스트로 충분히 확인한 뒤 모의·실전으로 전환하세요.
- 운용 종목은 SOXL로 고정되지 않습니다. 미국 종목 검색에서 티커·한글/영문 종목명으로 NASDAQ·NYSE·AMEX 주식/ETF를 찾아 선택할 수 있으며 거래소와 티커가 자동 입력됩니다.
- 공통 규칙은 매수 lot마다 익절 LOC를 관리하고, 설정한 보유 거래일이 지나면 MOC로 청산하며, 매도가 발생하는 날에는 신규 매수를 하지 않는 것입니다.
- V4는 초기자금의 10%를 기본 일별 목표로 사용합니다. 10거래일마다 20~10거래일 전 구간 실현손익 합계가 양수이면 70%를 10등분해 일별 목표에 누적하며, 손실 구간은 목표를 줄이지 않습니다. 공개 글을 해석한 방식이며 원본 엑셀과의 동일성은 확인되지 않았습니다.
- V5는 첫 거래일을 초기자산 기준점으로 두고, 초기 20거래일까지 초기자금의 10%, 이후부터 전일 총자산의 10%를 목표투자금으로 사용합니다. Penguin Lab 방식으로 편도 비용의 2배를 익절 목표가에 추가 반영합니다. 기본 편도 비용은 V4 0.03%, V5 0.07%입니다.
- 기본 익절률은 V4 2.7%, V5 2.75%, 최대 보유기간은 10거래일입니다. 화면에서 조정할 수 있습니다.
- 실전/모의에서는 키움 미국주식 LOC 매수·LOC 매도·MOC 매도를 사용하고, 매수/매도 lot와 주문번호·체결수량을 별도 장부로 저장합니다.
- 같은 미국주식 계좌에서 자동 리밸런싱·자동 주식수집·다른 종사종팔 전략이 실행 중이거나 미체결 주문이 있으면 시작을 차단합니다.
- 수익 추이에서는 전략의 총자산과 현금 변화를 확인할 수 있고, 백테스트에서는 수익률·CAGR·MDD·Sharpe·익절/만기 횟수와 Buy & Hold 비교 그래프를 봅니다.
- 백테스트는 장기 액면분할을 일관되게 처리하기 위해 Yahoo Finance의 조정종가를 사용합니다. 실제 LOC/MOC 체결가격, 슬리피지, 세금·환전비용에 따라 실전 결과는 달라질 수 있습니다.
사용 예SOXL, TQQQ, QQQ, NVDA 등 원하는 미국 종목을 검색해 V5 관찰모드로 등록하고, 같은 종목을 백테스트 검색으로 선택해 과거 성과를 확인한 뒤 모의주문으로 전환합니다.
11. 자동 주식수집: 정해진 주기로 한 종목을 자동 적립매수
- 새 계획을 누르고 관찰/모의/실전 중 운용 모드, 시장, 계좌와 한 종목을 선택합니다.
- 매수 주기는 매 거래일 / 매주 / 매월 중 선택합니다. 매주는 요일을, 매월은 1~28일 중 날짜를 지정합니다.
- 매수 시간은 해당 시장의 현지시간 기준입니다. 주문은 정규장 지정가만 사용하며 국내 애프터마켓은 자동매수하지 않습니다.
- 금액 기준은 매회 정해진 금액으로 가능한 수량을 계산합니다. 1주 가격보다 적립금이 작아 매수하지 못한 금액은 다음 일정으로 이월됩니다.
- 수량 기준은 매회 정해진 주식 수를 주문합니다.
- 총 투자한도를 0으로 두면 별도 금액 한도 없이 일정/종료일까지 계속할 수 있습니다. 안전을 위해 실전에서는 적절한 한도를 지정하는 편이 관리하기 쉽습니다.
- 같은 계좌·같은 시장에서 실전/모의 자동 리밸런싱 또는 다른 자동 주식수집 계획과 충돌하면 동시에 시작하지 못하도록 제한됩니다.
- 저장 후 카드에서 시작, 일시정지, 긴급중단, 체결 대조, 계획 종료를 사용합니다. 실전 시작/종료는 계좌번호 확인 절차가 있습니다.
- 주문·체결 이력과 운영 기록에서 실제로 언제 어떤 수량/지정가가 계산되었는지 확인합니다.
사용 예
삼성전자를 매주 월요일 10:00에 5만원씩 모으고 싶다면 매주 → 월요일 → 10:00 → 금액 기준 → 50,000원으로 설정합니다. 처음에는 관찰 모드로 일정 계산을 확인한 뒤 모의/실전으로 전환합니다.
12. 자동 손절등록: 단계형 손절 + 수익보호 + 예외 종목
기본은 DRY RUN입니다.
DRY RUN은 실제 보유수량과 현재가로 발동 여부를 계산하지만 증권사 주문은 보내지 않습니다. 반드시 DRY RUN으로 먼저 검증하세요.
기본 2단계 손절
- 1차 손절률에 도달하면 설정한 1차 매도비율만큼 부분손절 대상으로 계산합니다.
- 2차 최종 손절률에 도달하면 남은 매도가능수량을 최종손절 대상으로 계산합니다.
- 가격이 한 번에 2차 구간 아래로 갭 하락하면 1차를 따로 실행하지 않고 남은 매도가능수량 전체를 최종손절 대상으로 처리합니다.
- 연속 확인 횟수는 순간적인 가격 튐을 줄이기 위한 조건입니다. 예를 들어 2회/10초 주기이면 손절 조건이 연속된 확인에서 유지되어야 단계가 진행됩니다.
- 시작/종료 시간 밖에서는 신규 자동손절 판정을 실행하지 않습니다.
수익보호 기능
- Trailing Stop은 지정한 수익률 이상 오른 뒤 추적 고점을 기록하고, 고점에서 설정한 비율만큼 내려오면 남은 수량의 수익 보호를 시도합니다.
- Break-even Stop은 지정 수익률에 도달한 뒤 평단 부근 또는 설정한 보호폭 위를 방어선으로 사용합니다.
- StockScanner 1·2·3차 대응신호는 함께 표시할 수 있지만 그 신호만으로 자동매도하지는 않습니다.
안전 설정과 실전 시작
- 일일 최대 주문 횟수와 일일 최대 예상손실액을 설정하면 한도를 넘는 신규 손절 주문을 차단할 수 있습니다. 0은 제한 없음입니다.
- 실전 모드에서 감시 시작을 누르면 대상 계좌번호를 다시 입력하고 시장가 자동매도 위험 확인에 체크해야 합니다.
- 실전 주문 직전 실제 잔고, 매도가능수량, 외부 미체결, 최신 호가를 다시 확인합니다. 주문 결과가 불명확한 경우 자동으로 같은 주문을 반복 전송하지 않습니다.
- Emergency Stop은 신규 자동손절 주문을 즉시 막습니다. 이미 증권사에 접수된 주문을 자동 취소하는 기능은 아니며 기존 주문은 체결 대조를 계속합니다.
- 손절 후에는 재매수 차단이 생성될 수 있으며, 차단 중인 종목은 자동 리밸런싱이나 자동 주식수집의 자동매수에서도 보호됩니다.
자동손절 예외 종목 지정
- 대상 계좌를 먼저 저장한 뒤 자동손절 예외 종목에서 종목명 또는 KRX 6자리 코드로 검색해 예외 등록을 누릅니다.
- 예외 종목은 현재 보유 중이어도 자동손절 감시와 자동매도 대상에서 빠집니다. 목록의 예외 해제를 누르면 다시 감시할 수 있습니다.
- 보유종목 감시 표에서도 각 종목의 예외 지정 / 예외 해제를 바로 사용할 수 있습니다.
- 예외 등록/해제는 기존에 저장한 종목별 1차/2차 손절률 설정을 지우지 않습니다.
종목별 개별 설정과 이력
- 보유종목 감시 표의 종목별 1차/2차 값을 수정하고 저장하면 전역 기본값보다 그 종목 설정이 우선합니다.
- DRY RUN에서 최종손절 상태까지 테스트한 종목은 재무장으로 다시 테스트할 수 있습니다.
- 손절 주문 / Dry Run 이력에서는 발동가, 기준가, 수량, 체결수량, 주문번호, 상태를 확인하고, 운영 기록에서 판정/차단 사유를 확인합니다.
사용 예
평단 100,000원, 1차 -5% / 50%, 2차 -7%, 연속 확인 2회로 설정했다면 단순 예시에서 약 95,000원 구간은 절반 부분손절, 약 93,000원 구간은 남은 수량 최종손절 기준이 됩니다. 먼저 DRY RUN 즉시점검으로 계산값을 확인한 뒤 실전으로 바꾸세요.
13. 설정: 증권 · 메신저/AI · 연동 · 보안 · 운영
증권
- 모의/실제 투자 구분, 투자 시작일, 동기화 일수와 키움 REST API 정보를 관리합니다.
- 토큰 확인은 저장된 설정으로 키움 연결이 가능한지 검사합니다. 실전 계좌는 실전투자 계좌별 API Key에서 계좌별 키/Secret을 별도로 등록할 수 있습니다.
- 계좌 입력은
1234-5678 [중개형ISA]처럼 적으면 계좌번호와 별칭을 함께 등록할 수 있습니다. TXT 파일 여러 개로 계좌 API 키를 일괄 등록/갱신하는 기능도 있습니다.
메신저/AI
- 텔레그램 Bot Token/Chat ID/Webhook, 디스코드 Webhook/Bot/Channel을 설정하고 테스트 전송으로 확인합니다.
- 일일/주간 리포트의 사용 여부와 전송 시각, 그래프 이미지 첨부, 주간 AI 요약을 설정할 수 있습니다.
- 실시간 AI 브리핑의 사용 여부와 시작/종료 시각을 설정합니다.
- OpenAI/Gemini/Claude 제공자, 모델, API Key, Base URL을 설정하고 AI 연결 테스트로 저장 전 연결을 확인할 수 있습니다.
연동
- StockScanner 참조 사이트 URL과 API 토큰을 저장합니다. 연결되면 보유종목 대응 현황, 참조 후보, 마켓맵/분산투자 정보 등에 사용됩니다.
보안
- 관리자 계정명과 비밀번호를 변경합니다. 새 비밀번호는 화면의 최소 길이 조건을 만족해야 합니다.
- API Key, Secret, AI API Key, Bot Token, Webhook URL 같은 비밀값은 화면/API 응답/로그에서 원문을 다시 보여주지 않고 설정 여부 중심으로 표시합니다.
14. 운영/백업: 문제가 생겼을 때 확인할 곳
- 운영 메뉴에서는 DB 상태, 동기화 실행 여부와 함께 자동화 통합 현황을 확인합니다. 계좌 자동동기화, AI 시장요약, 메신저 리포트, 자동 리밸런싱, 자동 주식수집, 자동 손절등록, 매매일지 자동수집의 worker 상태와 최근 실행 결과를 한 화면에서 볼 수 있습니다.
- 자동화 카드는 실행 중 / 대기 / 일시정지 / 비활성 / 오류 상태, 최근 실행시각, 다음 예정시각, 활성·중지 수와 최근 메시지를 표시합니다. 주의/오류 항목은 별도 영역에 모아 보여주며 관리 화면을 누르면 해당 설정이나 자동주문 메뉴로 이동합니다.
- 주문을 발생시키지 않는 계좌 동기화·AI 시장요약·메신저 리포트는 운영 화면에서 지금 동기화 / 지금 생성 / 일간·주간 전송을 실행할 수 있습니다. 자동 리밸런싱·자동 주식수집·자동 손절등록은 실전 주문 안전 확인을 유지하기 위해 운영 화면에서 직접 시작하지 않고 각 관리 화면에서만 제어합니다.
- 최근 자동화 활동에서는 계좌 동기화, 자동주문 전략, 손절, 적립매수 등의 최근 실행/상태 메시지를 시간순으로 함께 확인합니다.
- 설정 → 운영의 동기화 이력에서도 시작 시각, 상태, 구분, 메시지를 확인할 수 있습니다. 비정상적으로 오래 끝나지 않은 이력은 중단 상태로 정리될 수 있습니다.
- DB 백업은 현재 SQLite DB의 일관된 백업 파일을 생성합니다. 백업에는 암호화 설정을 복원하는 데 필요한 정보가 포함될 수 있으므로 외부 공개 저장소에 올리지 마세요.
- DB 복원은 백업 DB를 업로드해 현재 데이터를 교체합니다. 복원 전 기존 DB는 서버 백업 위치에 별도 보관됩니다.
/api/health는 Docker healthcheck와 서비스 상태 모니터링에 사용할 수 있습니다.
15. 자주 생기는 상황과 확인 순서
- 대시보드에 데이터가 없어요.
- 설정 → 증권에서 API 정보를 확인하고 토큰 확인 → 상단 ↻ 동기화 → 계좌통합관리 → 계좌관리 순서로 확인하세요. API를 쓸 수 없는 계좌라면 수동스냅샷을 등록할 수 있습니다.
- AI 요약에 근거 부족 또는 캐시 사용 문구가 나옵니다.
- 일부 시장 데이터 원천이 일시적으로 실패했거나 최신성이 부족한 경우입니다. 새로고침 후 다시 생성해보고, 중요한 판단은 화면에 표시된 원천 시각과 실제 시장 데이터를 함께 확인하세요.
- 자동 리밸런싱/자동 주식수집이 매수하지 않아요.
- 운용 상태, 시장시간, 최소 주문금액/총 한도, 일일 한도, 미체결 주문, 같은 계좌·시장 자동전략 충돌, 자동손절 재매수 차단 여부를 확인하고 운영 기록과 체결 대조를 봅니다.
- 자동 손절이 동작하지 않아요.
- 대상 계좌가 저장되었는지, DRY RUN/실전 모드와 감시 상태, 감시 시간, 연속 확인 횟수, 해당 종목이 예외로 등록되지 않았는지, ETF/ETN/신용 등 자동 제외 대상이 아닌지 확인합니다.
- 주문 상태가 '접수 불명' 또는 미체결로 남습니다.
- 같은 주문을 즉시 다시 만들지 말고 해당 기능의 체결 대조를 먼저 실행하세요. 증권사 주문번호가 확인되면 미체결 취소 재요청 버튼을 사용할 수 있습니다.
- 원금 검증 차이가 큽니다.
- 원금·입출금에서 키움 거래내역을 다시 가져오고 미확인 항목, 누락 입출금, 배당/분배금 오분류 여부를 확인하세요. 확실한 과거 누락만 수동 조정으로 보정합니다.
16. 자동주문 기능을 사용할 때 꼭 기억할 점
- 관찰/DRY RUN 결과와 실전 체결 결과는 호가, 슬리피지, 거래정지, 주문 가능수량, 네트워크 상태 때문에 달라질 수 있습니다.
- 자동 리밸런싱, 자동 주식수집, 자동 손절등록의 긴급중단/Emergency Stop은 주로 신규 자동주문을 막기 위한 기능입니다. 이미 증권사에 접수된 주문은 별도 체결/취소 확인이 필요할 수 있습니다.
- 자동화 전략을 변경할 때는 실행 중인 전략을 먼저 일시정지하고, 설정 수정 후 다시 시작하는 방식이 안전합니다.
- 운영 → 자동화 통합 현황에서는 계좌 자동동기화, AI 시장요약, 메신저 리포트, 자동 리밸런싱, 자동 주식수집, 자동 손절등록, 매매일지 자동수집의 worker 상태와 최근 실행/오류를 한 번에 확인할 수 있습니다.
- 실전 사용 전에는 DB 백업을 받아두고, 모의/관찰 모드에서 주문 수량·가격·시간대가 의도와 맞는지 확인하세요.