FAQ

설치 및 실행

Q: HTS를 찾을 수 없다는 에러가 발생합니다.

설정에서 HTS 경로를 정확히 지정했는지 확인하세요.

1. GUI에서 [📁 HTS 경로] 버튼 클릭
2. 메리츠증권 iMeritz XII 실행 파일 경로를 지정
3. 저장 후 다시 시도

Q: 관리자 권한 없이 실행했더니 일부 기능이 작동하지 않습니다.

이 프로그램은 관리자 권한으로 실행해야 합니다.

• 사용자 입력 차단 기능(BlockInput API)은 관리자 권한이 필요합니다
• 실행 방법: 프로그램 아이콘 우클릭 → “관리자 권한으로 실행”
• 비상 시: Ctrl+Alt+Del을 눌러 Task Manager를 열 수 있습니다

Q: 프로그램 버전을 확인하는 방법은?

GUI 하단 상태 바에서 현재 버전을 확인할 수 있습니다. 또는 CLI에서 --version 옵션으로 확인 가능합니다.

Google Sheets 연동

Q: Google Sheets 연결이 안 됩니다.

다음을 순서대로 확인하세요:

1. credentials.json 파일이 config/ 폴더에 있는지 확인
2. Google Cloud Console에서 Sheets API가 활성화되었는지 확인
3. Service Account 이메일(client_email)이 스프레드시트에 편집자로 공유되어 있는지 확인
4. settings.json의 google_sheets.sheet_id가 올바른지 확인

Q: 시트 데이터를 읽지 못합니다.

• 워크시트 이름이 정확한지 확인하세요 (대소문자, 공백 포함)
• Service Account에 해당 스프레드시트 접근 권한이 있는지 확인하세요
• Google Sheets API의 할당량(quota)을 초과하지 않았는지 확인하세요

HTS 자동화

Q: 공동인증서 선택이 제대로 되지 않습니다.

1. 계정 설정에서 ‘공동인증서 순서’가 올바르게 설정되었는지 확인
   • 순서는 0부터 시작합니다 (첫 번째 인증서 = 0)
2. HTS에서 인증서 목록이 표시되는 순서를 직접 확인
3. 인증서가 만료되지 않았는지 확인

Q: 계좌 비밀번호 일괄등록 창이 자동 처리되지 않습니다.

1. 계정 설정에서 ‘계좌 비밀번호’가 올바르게 입력되었는지 확인
2. 로그 파일에서 에러 메시지 확인
3. HTS 업데이트 후 창 구조가 변경되었을 수 있으므로, 문제가 지속되면 GitHub Issues에 보고

Q: 주문이 실행되지 않습니다.

1. HTS에 로그인되어 있는지 확인
2. 해외주식 주문창[6100]이 열려 있는지 확인
3. 종목코드가 올바른지 확인 (영문 대문자 티커)
4. 시장 개장 시간인지 확인 (미국 시장 기준)
5. 잔고 또는 예수금이 충분한지 확인

Q: 자동화 중에 마우스를 움직여서 작업이 실패했습니다.

• 프로그램이 관리자 권한으로 실행 중인지 확인하세요
• 관리자 권한으로 실행하면 자동화 작업 중 사용자 입력이 자동으로 차단됩니다
• 비상 시: Ctrl+Alt+Del을 눌러 Task Manager를 열 수 있습니다

Q: pywinauto가 UI 요소를 찾지 못합니다.

1. HTS 버전이 업데이트되었을 가능성 → UI 요소 재탐색 필요
2. scripts/hts_inspector.py로 현재 요소 확인
3. GitHub Issues에 보고하여 컨트롤 매핑 업데이트 요청

전략 관련

Q: 그리드 전략이 “1티어 가격 하락 감지”로 중지됩니다.

1티어 기준가가 이전보다 낮아지면 안전장치가 발동하여 전략이 중지됩니다.

• 의도적인 변경이라면: GUI에서 전략을 수동으로 다시 시작
• 실수라면: 시트에서 E14 값을 이전 값 이상으로 수정 후 재시작

Q: 그리드 전략에서 catch-up 주문이 많이 발생합니다.

프로그램이 오랜 시간 중지된 후 재시작하면, 잔고 티어와 가격 티어의 차이만큼 catch-up 주문이 발생할 수 있습니다. 이는 정상 동작입니다.

Q: 무한매수법에서 “T≥분할 이상 상태”가 감지됩니다.

분할 횟수(E15)를 초과한 상태입니다. 시트의 주문 영역을 확인하고 수동으로 조치하세요.

Q: 무한매수법에서 예수금 부족 알림이 옵니다.

매수 주문 총액이 외화추정예수금을 초과한 상태입니다.

• 계좌에 추가 입금
• 또는 분할 횟수(E15)나 원금(E13)을 조정

알림

Q: Telegram 알림이 오지 않습니다.

1. 워크시트 E24에 Chat ID가 올바르게 입력되었는지 확인
2. E26에 Bot Token이 올바르게 입력되었는지 확인
3. Bot이 해당 채팅방에 메시지 전송 권한이 있는지 확인
4. Bot Token 형식: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

Q: Discord 알림이 오지 않습니다.

1. E24를 비우고, E26에 Discord Webhook URL을 입력
2. Webhook URL 형식: https://discord.com/api/webhooks/{id}/{token}
3. Webhook이 유효한지 확인 (Discord 서버 설정에서 확인)

Q: 워크시트에 알림 설정이 없는데 알림을 받고 싶습니다.

settings.json의 notification 섹션에 Telegram 또는 Discord 설정을 추가하세요. 워크시트에 설정이 없을 때 fallback으로 사용됩니다.

업데이트

Q: 자동 업데이트가 작동하지 않습니다.

1. settings.json에서 auto_update.enabled가 true인지 확인
2. 인터넷 연결 확인
3. Private 저장소라면 auto_update.github_pat에 유효한 Personal Access Token이 설정되었는지 확인
4. GitHub API 요청 제한(rate limit)에 도달하지 않았는지 확인

Q: 업데이트 후 문제가 발생했습니다.

자동 업데이트 시 이전 버전이 자동으로 백업됩니다.

1. backup/ 폴더에서 이전 버전 확인
2. 수동으로 이전 버전 파일로 복원
3. GitHub Issues에 문제 보고

운영

Q: 미국 공휴일에도 프로그램이 실행됩니다.

strategies.json에서 해당 전략의 run_on_holiday를 false로 설정하세요. 프로그램은 --check-holiday 옵션으로 미국 공휴일을 자동 감지합니다.

Q: 서머타임 전환 시 실행 시간이 맞지 않습니다.

프로그램은 zoneinfo 모듈을 사용하여 서머타임(DST)을 자동으로 감지합니다. 실행 시간을 KST(한국 시간) 기준으로 설정하면 자동으로 조정됩니다.

Q: 로그 파일이 너무 커졌습니다.

settings.json에서 다음 설정을 확인하세요:

• logging.retention_days: 로그 보관 일수 (기본 30일)
• logging.max_file_size: 로그 파일 최대 크기 (기본 10MB)

오래된 로그는 자동으로 삭제되며, 수동으로 logs/ 폴더의 파일을 삭제해도 됩니다.