COSMOTEC v5 데스크톱 봇

① API 키 등록 가이드

v5 봇은 가입자 본인의 거래소 API 키를 사용하여 매매를 실행합니다. API 키는 DPAPI + HMAC 으로 로컬 PC 에서만 복호화되도록 암호화 저장됩니다 (서버 전송 X).

키움증권 (국내 주식)

1. 키움 OpenAPI+ 신청: 키움증권 → 트레이딩채널 → OpenAPI
2. 모의투자 또는 실전 계좌 선택 후 신청 완료
3. v5 앱 → [설정] 탭 → 키움 섹션 → 계좌번호 입력 + 모의/실전 선택
4. OpenAPI+ 모듈 로그인 (키움 본사 인증창) → 자동 연결 확인

KIS (한국투자증권 — 미국 주식)

1. KIS 개발자센터 (apiportal.koreainvestment.com) 접속 → 회원가입
2. API 신청 → 실전투자 / 모의투자 선택 → APP_KEY + APP_SECRET 발급
3. v5 앱 → [설정] 탭 → KIS-US 섹션 → APP_KEY / APP_SECRET / 계좌번호 입력
4. [연결 테스트] 클릭 → ✅ 통과 확인

암호화폐 거래소 (Binance · Bybit · Upbit · Bithumb)

1. 각 거래소 → API 관리 → 신규 API 키 발급
2. 출금 권한 절대 OFF, 매매 + 잔고 조회 권한만 ON
3. IP 화이트리스트는 본인 고정 IP 만 (선택)
4. v5 앱 → [설정] 탭 → 거래소별 섹션 → API_KEY / SECRET 입력 → [연결 테스트]

↑ 목차로

② 스캐너 사용법

v5 의 매매 흐름은 두 종류 — 종목 매매 와 조건식 매매.

1) 종목 매매 (시총 상위 화이트리스트)

코스피 + 코스닥 시총 상위 50+50 종목 (총 100) 을 1분봉 단위로 폴링하며 지표 신호 발생 시 매매.

1. [종목 매매] 탭 → [전략 인스턴스 생성] 클릭
2. 전략명 · 지표 (Cosmotec / Yoon V2 / YSW V3) · 매매 방향 (LONG / SHORT) 선택
3. 1회 매수 수량 + 최대 동시 보유 + TP/SL/TS 설정
4. [저장] → [활성화] → 봇이 자동으로 100 종목 폴링 시작

2) 조건식 매매 (키움 조건검색식 연동)

HTS 에 등록한 키움 조건검색식 (예: "거래량 급증 + 상한가 근접") 을 실시간 모니터링.

1. 키움 영웅문 → 조건검색 → 본인 조건식 생성 + 서버 저장
2. v5 [조건식 매매] 탭 → [조건식 목록 새로고침] → 본인 조건식 출현 확인
3. 조건식 선택 → 매매 방향 + 지표 + TP/SL/TS 설정 → [활성화]
4. 조건식 진입 종목 즉시 (실시간) → 지표 ON 인 경우 평가 → 매수 트리거

지표 종류 (3종)

• Cosmotec (COTRADING2_V3) · LRC1 변화율(shift) 기반. 단기 추세 전환 포착.
• Yoon V2 (SuperTrend + VWMA) · 추세 추종 + 거래량 가중. 안정적 추세 진입.
• YSW V3 (True Reversal Slope) · LRC1 lowest/highest 반등률 기반. 바닥/천장 반전 포착.

※ 지표 파라미터 (LRC 기간 · 임계값 · cooldown 등) 는 각 카드에서 개별 설정 가능. 기본값 권장.

↑ 목차로

③ 차트 사용법

v5 차트는 TradingView Lightweight Charts 기반 — 캔들 + 지표 라인 + 매수/매도 마커를 시각화.

차트 진입 방법

1. 모니터 탭 → 포지션 행 클릭 → 해당 종목 차트 자동 표시
2. [종목 분석] 버튼 → 종목 코드 입력 → 4탭 모달 (차트/뉴스/공시/재무)
3. [조건식 매매] 탭 → 종목 행 클릭 → 차트 + 지표 평가 결과 표시

차트 컨트롤

• 타임프레임 · 1m / 3m / 5m / 15m / 30m / 1h / 4h / 1d (드롭다운)
• 지표 선택 · 차트 상단 드롭다운으로 Cosmotec / Yoon V2 / YSW V3 즉시 전환
• 마우스 드래그 · 좌우 = 시간 이동, 휠 = 확대/축소
• 크로스헤어 · 마우스 위치의 가격 + 시간 표시
• 자동 새로고침 · 1초 폴링 (실시간 캔들 업데이트)

표시 요소

• 캔들 · 양봉 녹색 / 음봉 빨강
• LRC 라인 · LRC1 (단기) · LRC200 / LRC400 / LRC600 (장기 추세선)
• 매수 마커 · ▲ 녹색 (BUY 신호) · 실 매수 시점
• 매도 마커 · ▼ 빨강 (SELL 신호) · 익절 / 손절 / 청산
• 지표 시그널 · 캔들 위 ● 도트 (지표 조건 충족 봉)

차트 + 매매 연계

차트에서 본 신호가 실제 매매와 일치하는지 검증하려면:

1. 모니터 탭에서 매수 체결 발생
2. 해당 행 클릭 → 차트 자동 진입
3. 매수 시점에 ▲ 마커 + ● 지표 도트가 일치하는지 확인
4. 불일치 시 = 지표 파라미터 재조정 또는 cooldown 조정 신호

↑ 목차로

④ 자동 매매 설정 (TP / SL / TS)

익절 (TP — Take Profit)

• TP % · 진입가 대비 % (예: 2.0 = +2% 도달 시 전량 청산)
• 부분 익절 · 1차 TP 50% / 2차 TP 50% (각각 % 별도 설정)
• TP 비활성 · 0 입력 시 TP 작동 안 함 (TS 또는 SL 만 사용)

손절 (SL — Stop Loss)

• SL % · 진입가 대비 % (예: -1.5 = -1.5% 도달 시 즉시 청산)
• SL 가드 · SL = 0 인 경우 안전장치로 자동 -3% 적용 (회원님 요청 사양)

트레일링 스탑 (TS — Trailing Stop)

• TS 활성화 · 최고가 대비 일정 % 하락 시 청산 (수익 극대화)
• TS Trigger % · 진입가 대비 +X% 도달 후 TS 활성화 (조기 손실 방지)
• TS Step % · 최고가 대비 -Y% 하락 시 청산

매매 파라미터 (UI 설정)

• 1회 매수 수량 · 종목당 1회 진입 시 매수 수량 (주식 = 주, 코인 = 계약 수)
• 최대 동시 보유 · 봇이 동시에 보유 가능한 종목 수 (자금 관리)
• 재매수 cooldown · 청산 후 동일 종목 재진입 차단 시간 (기본 5분)
• SHORT 청산 매도만 · 키움 국내주식은 공매도 불가 → SHORT 신호 발생 시 보유 종목 청산만

↑ 목차로

⑤ 모니터 탭 (포지션 관리)

현재 보유 중인 포지션 + 미체결 주문 + 실시간 P&L 을 통합 모니터링.

포지션 그리드

• 종목 · 코드 + 종목명 (클릭 시 차트 자동 진입)
• 방향 · LONG / SHORT
• 진입가 · 현재가 · 수익률 · 실시간 갱신 (5초 폴링)
• TP / SL / TS · 현재 설정값 표시
• [수동 청산] · 즉시 시장가 청산 (확인 다이얼로그)

주문 히스토리

• 당일 체결 내역 (시간 · 종목 · 방향 · 수량 · 가격 · P&L)
• CSV 다운로드 → 외부 저널 또는 세무 자료로 활용

봇 상태 표시

• 상단 도트 · 거래소별 연결 상태 (🟢 정상 / 🔴 오프라인)
• 잔고 칩 · KRW + USD 통합 잔고 + DAILY PNL
• 업데이트 칩 · 신버전 출시 시 자동 표시 → 클릭 시 1-click 업데이트

↑ 목차로

⑥ 자동 업데이트

v5 봇은 서버에서 manifest.json 을 폴링하여 신버전 출시를 자동 감지합니다.

1. 봇 시작 시 manifest.json 폴링 (24h 마다)
2. 신버전 발견 → 상단 [● 업데이트 사용 가능] 칩 표시
3. 칩 클릭 → 업데이트 다이얼로그 → [지금 업데이트]
4. Setup.exe 다운로드 → 자동 실행 (RestartReplace) → 봇 자동 재시작

↑ 목차로

⑦ 트러블슈팅

"로그인 실패" 메시지

• cosmotec.xyz 가입 이메일/비밀번호 정확히 입력 (대소문자 구분)
• 구독 만료 시 → [구독 갱신] 후 재로그인
• 기기 한도 초과 시 → 웹 → [내 기기 관리] 에서 기존 기기 해지

키움 OpenAPI+ 연결 안 됨

• 영웅문에서 직접 로그인되는지 먼저 확인
• 키움 모듈 32비트 / v5 봇 32비트 빌드 사용 중인지 확인 (release 빌드 = 32비트)
• OpenAPI+ 사용 신청 + 인증서 등록 완료 확인

KIS 토큰 오류 (401 Unauthorized)

• APP_KEY / APP_SECRET 정확히 복붙 (앞뒤 공백 X)
• 실전/모의 계좌 일치 확인 (모의 키로 실전 호출 X)
• 봇 재시작 → 토큰 자동 재발급

차트 안 나옴 / 데이터 0개

• 인터넷 연결 확인
• 해당 종목 거래정지 여부 확인
• 봇 재시작 (캐시 초기화)

봇이 매매 안 함

• 전략 인스턴스가 활성화 상태인지 확인 ([전략] 탭)
• 지표 ON / 매매 방향 / 1회 매수 수량 정상 설정 확인
• 잔고 부족 / API 키 만료 확인 ([설정] 탭)
• 로그 파일 확인 — %LOCALAPPDATA%\COSMOTEC v5\logs\

↑ 목차로

⑧ 자주 묻는 질문 (FAQ)

↑ 목차로