14. 부가 정보 및 문제 해결
이 장에서는 프로그램 정보 확인, 후원하기 안내, 그리고 사용 중 자주 겪는 문제의 해결 방법을 정리합니다.
14.1 프로그램 정보
상단 메뉴에서 [도움말 → 프로그램 정보] 를 선택하면 프로그램명, 설명, 현재 버전을 확인할 수 있습니다.
| 항목 | 내용 |
|---|---|
| 프로그램명 | 부엉이 주식자동매매 프로그램 |
| 설명 | 키움증권 조건검색식을 활용한 자동매매 지원 프로그램입니다. (최신 키움증권 REST API 기반) |
| 버전 | 현재 설치된 프로그램의 버전이 자동으로 표시됩니다. (이 문서 기준 2.5.5) |
📌 참고: 버전은 메인 창 제목 표시줄(예: 부엉이 트레이더 v2.5.5)에서도 확인할 수 있습니다. 이 문서는 v2.5.5 를 기준으로 작성되었습니다(1.1).
💡 팁: 오류 문의나 업데이트 확인 시 이 화면의 버전 정보를 함께 알려 주시면 빠른 지원에 도움이 됩니다.
14.2 후원하기
상단 메뉴에서 [도움말 → 후원하기] 를 선택하면 후원 안내 창이 열립니다. 프로그램 개발과 운영에 도움을 주고 싶은 사용자를 위한 안내입니다.
14.3 자주 묻는 질문 (FAQ)
키움 REST API KEY 등록
Q. 키가 저장되지 않아요. 키 등록 시 다음 조건을 확인하십시오.
- 최소 1개 이상의 유효한 키 가 입력되어 있어야 저장됩니다.
- 한 계좌에서 계좌번호·App Key·Secret Key 중 하나라도 입력하면 나머지 항목도 모두 입력해야 합니다.
- 계좌번호는 중복될 수 없습니다.
Q. 등록한 키가 올바른지 미리 확인할 수 있나요? 키 등록 화면의 [연결 테스트] 버튼을 누르면 해당 계좌의 키로 키움 서버 연결을 확인하고, 성공·실패 결과를 알려 줍니다.
Q. 키를 변경했는데 반영되지 않아요. 키(자격증명) 변경 내용은 프로그램을 다시 시작한 후 반영됩니다. 저장 후 프로그램을 재시작하십시오.
자동 매매 시작
Q. 자동 매매를 시작하려면 무엇이 준비되어야 하나요? 유효한 키움 REST API KEY 등록이 완료되어 있어야 합니다. 키가 하나도 등록되어 있지 않으면 정상적으로 매매를 시작할 수 없습니다.
Q. 지정한 시간에 프로그램이 자동으로 시작되지 않아요. [설정 → 자동시작 스케줄러] 에서 [자동 실행 스케줄 사용] 이 켜져 있고 요일·시간이 저장되어 있는지 확인하십시오. 스케줄 저장에는 관리자 권한이 필요 없습니다(v2.3.5). 다만 예전 버전에서 관리자 권한으로 등록한 스케줄이 남아 있으면 저장 시 안내가 뜨니, [예] 를 눌러 관리자 권한으로 다시 실행한 뒤 한 번 저장하십시오. (자세한 내용은 10장 참고)
Q. 애프터마켓 시간에 프로그램이 저절로 꺼져요.
자동 시작 스케줄러의 종료 시간이 20:00 이전으로 저장되어 있기 때문입니다. 업데이트해도 예전에 저장한 종료 시각은 바뀌지 않으니 20:10 으로 직접 바꾸어 저장하십시오. (10.3, 7.10 참고)
AI 매수의견 판정
Q. 업데이트했더니 AI 기능이 생겼는데, 제 매매전략이 바뀌나요? 바뀌지 않습니다. AI 매수의견 판정은 기본값이 꺼짐이며, 켜기 전까지는 API 호출도 발생하지 않습니다. 자세한 내용은 6장을 참고하십시오.
Q. 매매작업에 "AI 기각" 배지가 붙은 채 쌓입니다. 기각된 작업은 자동으로 정리되지 않고 보유 종목수 제한을 계속 차지합니다. 목록 아래 [일괄 선택 ▾] → [AI 기각 작업] 으로 한 번에 고른 뒤 완료 또는 삭제하십시오. (6.9 참고)
Q. AI 사용료는 누가 부담하나요? 사용자 본인의 OpenAI 또는 Google 계정에서 결제됩니다. 비용 상한을 두려면 [설정 → AI 매수의견 판정 설정] 의 일일 호출 한도를 지정하십시오. (6.5 참고)
