처음 시작하는 분을 위한
단계별 설치 안내

키움 REST API 키 발급

GridMate 가 키움에 주문·조회를 하려면 App Key / Secret Key 가 필요합니다.

1. 키움증권 OpenAPI(REST) 사용 신청 — 키움 홈페이지/개발자센터에서 해외주식 REST API 사용을 신청합니다.
2. 승인되면 개발자센터에서 App Key 와 Secret Key 를 발급받습니다.
3. 두 값을 복사해 둡니다. (STEP 4 에서 입력)

텔레그램 봇 만들기 (알림용)

매수·매도 체결, 잔고 부족, 위험 경보를 실시간으로 받습니다.

1. 텔레그램에서 @BotFather 를 검색해 대화를 시작합니다.
2. /newbot 입력 → 봇 이름·아이디를 정하면 봇 토큰(예: 8000000000:AA...)을 줍니다.
3. 방금 만든 내 봇과 대화를 시작하고 아무 메시지나 보냅니다.
4. 브라우저에서 https://api.telegram.org/bot<봇토큰>/getUpdates 를 열면 "chat":{"id":숫자} 가 보입니다 — 이 숫자가 Chat ID 입니다.

• 봇 토큰과 Chat ID 를 복사해 둡니다. (STEP 4 에서 입력)

프로그램 다운로드 & 실행

설치 과정이 없습니다. 받은 실행 파일을 더블클릭하면 됩니다.

1. 승인 후 관리자가 보내드린 링크에서 GridMate.exe 를 내려받습니다. (파일이 커서 메일 첨부 대신 공유 링크로 전달됩니다)
2. 받은 파일을 원하는 폴더에 두고 더블클릭해 실행합니다. (Windows 보안 경고가 뜨면 추가 정보 → 실행)
3. 처음 실행하면 인증 창이 뜹니다 — 관리자에게 받은 라이선스 ID / 비밀번호를 입력합니다.

초기 설정 (자동 마법사)

인증 후 설정 창이 뜹니다. 준비한 값을 입력하면 나머지는 자동으로 채워집니다.

1. 키움 App Key / Secret Key — STEP 1 에서 발급받은 값
2. 텔레그램 봇 토큰 / Chat ID — STEP 2 에서 만든 값
3. 대시보드 비밀번호 — 내 계좌 현황 페이지를 열 때 쓸 비밀번호를 직접 정합니다
4. 매매 종목 / 거래소 — 기본값(QLD / NY)이면 그대로 두어도 됩니다
5. 저장하고 시작 을 누르면 완료됩니다.

그리드 시작 & 모니터링

종목의 그리드를 켜면, 이후엔 프로그램이 알아서 사고팝니다.

1. 메인 화면의 그리드 설정 탭에서 종목·투자금·단계(tier) 를 등록합니다.
2. 그리드 활성화 를 누르면 매매가 시작됩니다.
3. 체결이 나면 텔레그램으로 알림이 옵니다.
4. 인증 완료 시 안내되는 내 대시보드 링크에서 tier·보유·누적손익을 실시간으로 봅니다. (대시보드 열람 시 STEP 4 의 대시보드 비밀번호를 입력)

자주 막히는 곳

• 인증이 안 돼요 — ID/비밀번호를 확인하고, 승인 상태인지 관리자에게 문의하세요.
• 주문이 거부돼요 — 키움 REST 사용신청이 승인됐는지, App/Secret Key 가 정확한지 확인하세요.
• 알림이 안 와요 — 봇과 먼저 대화를 시작했는지, Chat ID 가 맞는지 확인하세요.
• 대시보드가 안 열려요 — STEP 4 에서 정한 대시보드 비밀번호가 맞는지 확인하세요.