홈 신청 설치가이드
INSTALL GUIDE

ALPHA BOT 설치 가이드

운영자가 설치 준비 상태로 안내한 뒤, 아래 순서대로 환경을 구성합니다.

이 페이지는 안내용이며, 여기서 계좌·API·봇이 자동 연결되지 않습니다.

📋 베타 준비 단계
실제 자동매매 실행 전 반드시 DRY_RUN(모의) 테스트를 완료하세요.
1️⃣ 한국투자증권 Open API
준비물
  1. KIS Developers 포털에서 앱 등록 (App Key / App Secret 발급)
  2. 계좌번호·HTS ID 확인 (모의투자 계좌 권장)
  3. 서버 환경변수 또는 설정 파일에 Key/Secret 저장 (코드·채팅에 노출 금지)
  4. 토큰 발급·갱신 스크립트가 정상 동작하는지 확인

운영자가 안내한 경로에 API 키를 설정한 뒤, 잔고 조회·시세 조회 API가 응답하는지 먼저 확인합니다. 주문 API는 DRY_RUN 테스트 이후에만 활성화합니다.

2️⃣ 텔레그램 알림
설정 절차
  1. Telegram에서 @BotFather 로 봇 생성 → Bot Token 발급
  2. 본인 계정과 봇 대화 시작 (/start)
  3. Chat ID 확인 (getUpdates 또는 운영자 제공 스크립트)
  4. 환경변수 TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID 설정
  5. 테스트 메시지 1건 전송으로 수신 확인

카카오톡은 상담·안내용, 실시간 매매 알림은 텔레그램부터 지원 예정입니다.

3️⃣ 원격 접속 (서버)
접속·보안 체크
  • SSH 키 기반 접속 사용 (비밀번호 로그인 비권장)
  • 방화벽: 필요한 포트만 개방 (예: 22, 8601은 운영 정책에 따름)
  • 설치·로그 확인: ~/alpha_bot_site / trading_bot 경로는 운영자 안내 따름
  • API Key·토큰 파일 권한 600 이하로 제한
4️⃣ DRY_RUN 테스트 절차
모의 실행 체크리스트
  1. 설정에서 DRY_RUN=true (또는 동등 옵션) 확인
  2. 봇 기동 → 로그에 DRY_RUN 주문 시뮬레이션 메시지 출력 확인
  3. 매수·매도 신호 발생 시 실제 주문 API 미호출 확인
  4. 텔레그램 알림(또는 로그)으로 신호·판단 내역 수신 확인
  5. 1~2 거래일 이상 관찰 후 운영자와 결과 공유
  6. 운영자 승인 후에만 DRY_RUN 해제 → 실거래 전환
⚠️ 주의
DRY_RUN 해제 전 실계좌 주문이 나가지 않도록 설정을 반드시 재확인하세요.
📚 설치 문서 센터

고객 설치 전·후 운영자가 사용하는 문서입니다. (안내용 · 자동 연결 없음)

✅ 설치 전 체크리스트 📋 설치 완료 보고서 예시
🚀 상담 신청하기
bot.aicoinbot.site · 베타 준비 · 자동매매 미실행