토스증권 AutoTrader Pro
상세 기능별 사용자 종합 운영 매뉴얼
본 설명서는 프로그램 사용 중 발생할 수 있는 모든 궁금증과 설정 방법을 화면 페이지(1~4번) 및 기능별로 완벽하게 정리하였습니다. 처음 이용하시는 분은 본 매뉴얼을 순서대로 읽어주시면 개발자 문의 없이 100% 혼자서도 운용이 가능합니다.
최초 접속 및 토스 API Key 연동 (필수 초기 세팅)
시스템을 처음 시작할 때 비밀번호 변경 및 계좌를 연결하는 과정입니다.
STEP 1. 로그인 및 관리자 비밀번호 변경
1. 브라우저에서 서버 접속 주소(http://158.101.145.224:5000)로 접속합니다.
2. 최초 로그인 기본 비밀번호는 admin1234 입니다.
3. 보안을 위해 대시보드 우측 상단의 🔑 API Key 설정 버튼을 누른 후, [비밀번호 변경] 탭에서 나만의 비밀번호로 반드시 변경하세요.
STEP 2. 토스 Open API Key 발급 및 IP 등록 (중요 ★★★)
토스증권 실전 계좌 잔고 조회 및 자동매매 주문을 전송하려면 토스 Open API Key가 필요합니다.
허용 IP 등록 주의사항
토스 개발자 센터에서 API 신청 시 사용하시는 서버의 허용 IP(개인 전용: 168.110.34.210 / 멀티 플랫폼: 158.101.145.224)를 반드시 입력하셔야 정상 작동합니다.
- Client ID (앱 ID): 토스 개발자 센터에서 발급받은 식별 키 입력
- Client Secret (시크릿 키): 보안 인증 키 입력
- 계좌번호 & 계좌 순번: 10자리 계좌번호 및 선택 순번 입력
- [API 저장 및 연결 테스트] 클릭 후 🟢 실계좌 정상 연동됨 메시지 확인
화면 1: 차트 & 매매신호 분석 (1. 차트 & 매매신호 탭)
실시간 주가 캔들 차트, 보조 지표, 딥러닝 매수/매도 타이밍 타점 안내
종목 검색 & 캔들 타임프레임
상단 검색창에 종목명(예: 삼성전자, SK하이닉스) 또는 종목코드(005930)를 입력하여 검색할 수 있습니다.
- 1분봉 / 3분봉 / 5분봉: 단타 & 스캘핑 자동매매 시 정밀 타점 확인용
- 15분봉 / 일봉: 중장기 추세 및 거래량 확인용
핵심 보조 지표 해석법
1. 이동평균선(MA): MA5가 MA20을 상향 돌파 시 골든크로스(매수 신호)
2. RSI(14) 상대강도: 30 이하 과매도(반등 기회), 70 이상 과매수(익절 타점)
3. 볼린저밴드: 상단 밴드 거래량 동반 돌파 시 급등 매수세 확인
AI 종합 매매신호 (BUY / SELL / HOLD) 판정 기준
MA5/20 골든크로스 발생 + RSI 45~60 안전지대 진입 + RVOL 거래량 급증 시 자동 포착
설정된 목표 수익률(+5%) 달성, 손절가(-3%) 이탈, 또는 MA 데드크로스 발생 시 즉시 실행
지표 조건 미충족 상태. 무리한 진입을 방지하고 주가 추이를 실시간 모니터링합니다.
화면 2: 토스계좌 & 자동매매 설정 (2. 자동매매 설정 탭)
모의/실전 스위칭, 매수/손절 세팅, 급등주 감지 검색식 4대 조건 설정
1. 모의투자 (Paper Trading) vs 실전투자 (Live Trading) 전환
토글 스위치를 클릭하면 단 1초만에 [모의투자]와 [실전투자] 모드가 전환됩니다.
- 모의투자: 가상 자금 1,000만원으로 리스크 없이 수수료, 매매 로직을 안심하고 테스트.
- 실전투자: 실제 토스증권 계좌의 주금 잔고로 매수/매도 실시간 주문 전송.
2. 1회 매수금액, 익절가(%), 손절가(%) 설정
포착된 종목에 대해 입력된 금액만큼 자동 수량 계산 매수
평단가 대비 +5% 달성 시 즉시 시장가 자동 익절
평단가 대비 -3% 이탈 시 손실 최소화 자동 손절
3. 실시간 급등주 포착 4대 핵심 변수 세팅
장중 실시간 급등 종목을 자동 검색하는 4가지 감도 조절 파라미터입니다.
평소 대비 거래량 비율. (추천: 3.0배 이상)
최근 3분간 가격 변화 속도. (추천: +1.5% 이상)
매수 체결세 대 매도 체결세 비율. (추천: 150% 이상)
동일 종목 잦은 재매수 방지 시간. (추천: 10분)
화면 3: 매매일지 & 통계 (3. 매매일지 & 통계 탭)
보유 종목 모니터링, AI 추천 Top 5, 24시간 실시간 터미널 로그 콘솔
보유 종목 실시간 현황
현재 보유 중인 주식의 매수평단가, 평가금액, 실시간 평가손익(원) 및 수익률(%)이 실시간 갱신됩니다. 개별 [시장가 즉시 매도] 버튼이 탑재되어 있습니다.
AI 추천 Top 5 종목
딥러닝 알고리즘이 당일 가장 수급이 좋고 차트 패턴이 우수한 5개 종목을 자동 추천합니다. 클릭 한 번으로 감시 종목에 등록할 수 있습니다.
24H 터미널 시스템 로그
자동매매 엔진의 동작 상태, API 전송 로그, 체결 성공/실패 내역이 1초 단위로 로그 창에 기록되어 투명하게 확인하실 수 있습니다.
화면 4: 월별/일별 매매일지 (4. 월별/일별 매매일지 탭)
월 스위처, 일별 순손익 정산, 거래세/수수료 자동 차감 및 투자 메모
월별 선택 스위처 (◀ / ▶)
이전 달(◀) 및 다음 달(▶) 버튼을 통해 과거 매매 기록을 손쉽게 조회할 수 있습니다. 당월 총 매매 횟수, 승률(%), 누적 수익금이 상단에 요약 표시됩니다.
수수료 & 주식 세금 자동 정산
매매 정산 시 증권사 수수료(0.0015%)와 국내 주식 매도 거래세(0.195%)가 자동으로 차감되어 '실제 내 통장에 들어오는 순수익'을 정확히 정산합니다.
일별 매매 메모 작성 및 저장
특정 날짜의 매매 카드를 클릭하고 투자 복기 메모(예: "미국 증시 급등으로 반도체주 중심 매수", "장 시작 후 급등주 포착 성공")를 입력한 뒤 저장하면 나만의 투자 일지로 남길 수 있습니다.
부록 1: 데스크톱 & 모바일 PWA 앱 설치 가이드
웹 브라우저 없이 스마트폰 바탕화면 및 PC 앱으로 편리하게 구동
PC 데스크톱 (Chrome / Edge)
주소창 우측의 [앱 설치] 아이콘을 클릭하거나, 대시보드 상단의 📱 앱 설치 버튼을 누르면 독립된 PC 프로그램으로 설치됩니다.
스마트폰 (안드로이드 / 아이폰)
모바일 브라우저 메뉴( 또는 공유 버튼)에서 '홈 화면에 추가'를 선택하면 스마트폰 앱처럼 바탕화면 아이콘이 바로 생성됩니다.
부록 2: TTS 음성 알림 & 텔레그램 봇 알림 설정
매수/매도 체결 시 브라우저 한국어 음성 브리핑 및 스마트폰 텔레그램 메시지 발송
브라우저 TTS 실시간 음성 알림
매수 또는 매도 체결 시 "삼성전자 10주 매수 체결되었습니다", "목표가 달성 5% 익절 완료"와 같이 한국어 음성으로 실시간 알려주므로 차트를 계속 보지 않아도 상황을 파악할 수 있습니다.
텔레그램(Telegram) 봇 메세지 연동
[설정] 메뉴에서 텔레그램 Bot Token 및 Chat ID를 등록하면 매매 체결 내역, 일일 실현 손익 보고서가 핸드폰 텔레그램으로 자동 전송됩니다.
자주 묻는 질문 & 트러블슈팅 (FAQ Top 10)
개발자 전화 전에 꼭 확인해야 할 대표적인 질문과 문제 해결책입니다.
Q1 자동매매 버튼을 ON으로 켰는데 주문이 안 나가요. 원인이 무엇인가요?
A. 세 가지를 확인하셔야 합니다:
1) 상단 계좌 연동 상태가 🟢 실계좌 연동됨 인지 확인
2) 토스 API 신청 시 허용 IP에 158.101.145.224가 올바르게 등록되어 있는지 확인
3) 현재 시간이 정규 주식 시장 운영 시간(09:00 ~ 15:30)인지 확인하세요.
Q2 모의투자와 실전투자의 차이점은 무엇인가요?
A. 모의투자는 시뮬레이션 가상 1,000만원 잔고로 주가 시세를 받아 매매를 연습하는 모드입니다. 실전투자는 사용자의 실제 토스증권 계좌 잔고를 사용하여 실제 주식 매매가 일어납니다.
Q3 웹 브라우저 창이나 컴퓨터를 꺼도 자동매매가 구동되나요?
A. 네! 본 자동매매 프로그램은 클라우드 전용 서버(158.101.145.224)에서 24시간 백그라운드로 작동하므로, PC를 끄거나 모바일 화면을 닫아도 설정된 매수/매도 규칙대로 자동 집행됩니다.
Q4 급등주 포착 종목이 너무 많이/적게 검색됩니다. 어떻게 조정하나요?
A. 화면 2(자동매매 설정 탭)에서 RVOL 비율(기본 3.0 -> 5.0 높이면 더 보수적 검색), 3분 주가 상승률(기본 +1.5% -> +2.5%) 수치를 수정하여 종목 감도를 조절할 수 있습니다.
Q5 비밀번호를 분실했습니다. 어떻게 재설정하나요?
A. 비밀번호를 잊으신 경우 서버 관리자에게 문의하시면 초기 기본 비밀번호(admin1234)로 리셋 처리해 드립니다.
Q6 수수료 및 주식 거래세는 매매일지에 어떻게 정산되나요?
A. 화면 4(매매일지)에서는 단순 차익만 계산하는 것이 아니라, 국내 주식 매도 시 발생하는 거래세 0.195%와 증권사 거래 수수료 0.0015%를 자동으로 공제한 실제 순수익을 집계합니다.
Q7 매수 주문이 분할해서 들어가나요?
A. 설정된 1회 매수금액 한도(예: 50만원) 내에서 종목 포착 시 단번에 지정가/시장가 매수가 실행되며, 계좌 예수금 총액 범위 내에서 안전하게 운용됩니다.
Q8 손절과 익절은 100% 보장되어 즉시 체결되나요?
A. 도달 시 즉시 '시장가(Market Order)' 매도 주문을 전송하여 수량 체결을 최우선으로 처리하므로 미체결 위험을 최소화합니다.
Q9 시스템에서 에러 로그가 발생하면 어디서 확인하나요?
A. 화면 3(매매일지 & 통계 탭) 하단의 [24H 터미널 로그 콘솔]에 실시간 발생 에러 및 API 통신 상태가 출력됩니다. 문제가 있을 경우 해당 화면을 캡처해 문의주세요.
Q10 스마트폰 아이폰/갤럭시에서도 동일하게 사용할 수 있나요?
A. 네, 100% 반응형 웹 디자인으로 제작되어 모바일 화면 크기에 맞게 자동으로 차트 및 매매 설정 화면이 최적화됩니다.