1. 시작하기 전에 | 부엉이 트레이더 프로 설명서

1.1 이 문서에 대하여

이 문서는 부엉이 트레이더 프로 의 공식 사용자 설명서입니다. 처음 사용하는 분부터 숙련된 사용자까지, 프로그램의 기능을 올바르게 이해하고 안전하게 활용할 수 있도록 안내합니다.

이 문서가 다루는 내용

설명서는 사용자가 프로그램을 처음부터 끝까지 무리 없이 운용할 수 있도록 다음 순서로 구성되어 있습니다.

구분	내용
설치 및 초기 설정	프로그램 설치와 처음 사용하기 위한 필수 준비
화면(UI) 조작 방법	각 화면의 구성 요소와 조작 순서
기능 활용 방법	자동매매 전략 설정, 조건검색, 스케줄러 등 주요 기능 사용법
결과 확인 방법	체결 결과, 수익률, 계좌 잔고, 로그 등 확인 방법

표기 약속

이 문서에서 사용하는 표기 방식은 다음과 같습니다.

표기	의미
[버튼명]	화면에서 클릭하는 버튼을 나타냅니다. 예: [저장], [확인]
[상위 → 하위]	메뉴 이동 경로를 나타냅니다. 예: [설정 → 시스템 환경 설정]
`고정폭 텍스트`	입력값 예시나 항목명을 나타냅니다. 예: `현재가`
⚠️ 주의	잘못 조작하면 오류가 발생하거나 의도치 않은 주문이 실행될 수 있는 항목입니다.
💡 팁	기능을 더 편리하게 활용할 수 있는 추가 정보입니다.
📌 참고	이해를 돕기 위한 보충 설명입니다.

적용 버전

이 문서는 아래 버전을 기준으로 작성되었습니다.

항목	내용
프로그램명	부엉이 트레이더 프로
문서 적용 버전	2.5.5
운영체제	Windows 10 이상 (64비트)
필수 연동	키움증권 REST API

⚠️ 주의: 이후 버전에서는 화면 구성이나 기능이 일부 변경될 수 있습니다. 사용 중인 프로그램 버전과 이 문서의 적용 버전이 다를 경우, [도움말 → 프로그램 정보] 에서 현재 버전을 확인한 뒤 해당 버전의 최신 문서를 참고하시기 바랍니다.

문서 개정 이력

버전	주요 변경 내용
2.5.5	KRX 애프터마켓(16:00~20:00) 개장과 시간외단일가 폐지에 맞추어 매매 시간·주문 방식 설명을 정리하고, 시간표와 주의사항을 7.10에 모았습니다. 대시보드 수동 매매·포착 조건검색·KRX 전용 종목 거래가 20:00까지 늘었고, 주문전략에 미체결 매도를 애프터마켓으로 이전 옵션이 생겼습니다(5.7.3). [종목정보 → 시간외단일가] 조회 창이 삭제되어 기존 9.1.6 이 9.1.5 로 당겨졌습니다. ⚠️ 기존 사용자 확인 사항: ① 자동 시작 스케줄러의 종료 시각이 20:00 이전(예: 18:00)이면 20:10 으로 직접 변경하십시오(10.3). ② 주문유형이 `시간외단일가(폐지)` 로 표시되는 전략은 다른 주문유형으로 변경하십시오. 그대로 두면 주문이 실패합니다(5.7.1). ③ 외부신호 수신 기본 포트가 5050 → 15050 으로 바뀌었습니다. 신호를 보내는 프로그램의 주소를 확인하십시오(13.4.2). 이 밖에 AI 판정 이력(6.11)과 매매 통계 / 성과 분석(7.7) 화면 신설, 보조지표 기간·승수 지정과 주봉 기준 지표(5.8), 준비·실행조건 시간 범위 필터(5.7.4), 진입 요일 제한과 "추가매수도 같은 요일만"(5.3), AI 분석용 문서 만들기(5.11), 잔고 전용 종목 일괄 편입(3.6.1), 자동 시작 스케줄 관리자 권한 불필요(10장), AI 프롬프트 가격위치 변수 4종(6.7.2), 수익률 조회의 수수료·기간 기준 정정(7.6), 실시간 연결 끊김 자동 감지(3.8.2), 조건검색 기준 시세(13.7)를 반영했습니다. 동작하지 않던 사용자 정의 방식(특징주·호가창 매매) 설명을 정리하면서 5.6.4 가 5.6.2 로 당겨졌고, 절이 추가된 6장·7장은 뒤쪽 절 번호가 밀렸습니다(6.11 → 6.12, 6.12 → 6.13, 7.7 → 7.8, 7.8 → 7.9).
2.3.0	외부 매매신호로 매도까지 지시할 수 있게 되었습니다(13.4). 신호에 매수·매도 구분과 발동할 주문전략 ID를 함께 보내며, 이전까지 매수 신호 하나가 매도 주문전략까지 평가하던 동작이 바로잡혔습니다. 주문 전략 상세 목록에 ID 컬럼이 추가되고(5.7), `조건반복` 의 하루 반복 횟수를 시스템 설정에서 1~20회로 조정할 수 있습니다(13.5).
2.2.4	실시간 감시 종목 상한을 90 → 190개로 확대했습니다(3.8.1·5.2). 시스템조건식에 코스피지수20MA·코스닥지수20MA 피연산자가 추가되었고(5.8), 지수 값을 받지 못한 동안에는 그 값을 쓰는 조건이 통과하지 않도록 바뀌었습니다.
2.2.2	AI 매수의견 판정의 전역 설정을 정리했습니다(6.5·6.8) — 판정 동시 실행 수는 1 고정, 요청 폐기 시간 기본값 3분, 재시도 2회 신설, 판정 타임아웃 설정 항목 제거. AI 응답을 받지 못한 종목도 `AI 판정 실패` 로 표시됩니다(6.9).
2.2.0	AI 매수의견 판정(6장)을 새로 추가했습니다. 조건검색식에 편입된 종목을 최초매수하기 직전에 AI에게 매수 의견을 물어 매수 여부를 결정하는 기능으로, 기본값은 꺼짐입니다. 이와 함께 진행 중 매매작업 목록의 일괄 선택 드롭다운, AI 기각·AI Shadow 배지, 다건 확인 창 스크롤, 계좌 삭제 확인, 사용자 정의 편집기(5.6) 설명 보강을 반영했습니다. 이 장 추가로 기존 6~13장은 7~14장으로 번호가 밀렸습니다.
2.1.0	제품명을 부엉이 트레이더 프로로 변경했습니다. 디자인 테마 선택, 권리이벤트 감지와 매매작업 자동 사용중지(7.9), 진행 중 매매작업 목록의 잔고 컬럼·설정 창·상태 배경 틴트, 외부신호 수신 포트 설정, 알림 종류별 선택, 매일 실행주기 횟수제한, 수익률 조회의 미청산 종목 현재가 평가를 반영했습니다.
2.0.3	자동 시작 스케줄러 개선을 반영했습니다 — 저장할 때만 관리자 권한이 필요(권한이 필요하면 재실행 안내. v2.3.5부터는 관리자 권한 없이 저장됩니다), 예약 작업은 스크립트 없이 실행 파일을 직접 실행, 종료 시각에 프로그램이 스스로 정상 종료.
2.0.1	자동매매 현황 대시보드 우측에 실시간 체결 현황 탭을 추가하고, 좌측 계좌·스위치 사이드바 접기/펼치기 기능을 반영했습니다.
2.0.0	메인 화면 구성 및 설정 화면 재편에 맞추어 설명서를 전면 재작성했습니다.

1.2 부엉이 트레이더 프로란?

부엉이 트레이더 프로 는 키움증권 REST API를 기반으로, 사용자가 정해 둔 전략과 규칙에 따라 종목 선정부터 매수·매도 주문 실행까지의 과정을 자동으로 처리하는 Windows 전용 주식 자동매매 프로그램입니다. 복잡한 코딩 없이도, 설정한 조건에 맞추어 프로그램이 실시간으로 시장을 감시하고 대응하도록 설계되었습니다.

지원 증권사 및 지원 시장

항목	내용
지원 증권사	키움증권 (키움 REST API 전용)
계좌 유형	실계좌 및 모의투자 계좌 모두 지원
지원 시장	코스피, 코스닥, ETF, ETN

사용을 위한 필수 조건

부엉이 트레이더 프로를 사용하려면 아래 조건이 반드시 충족되어야 합니다.

항목	내용
키움증권 계좌	국내 주식 위탁 거래 계좌 (실계좌 또는 모의투자)
키움 REST API 키	앱키(App Key) 및 시크릿키(Secret Key) 발급 필요

⚠️ 주의: 이 프로그램은 키움증권 계좌와 API 키가 없으면 사용할 수 없습니다. API 키 등록 방법은 4장을 참고하시기 바랍니다.

핵심 기능 요약

① 자동매매 전략 "어떤 종목을 언제 사고팔 것인가"를 미리 규칙으로 정의합니다. 종목은 키움 조건검색식을 활용하거나 직접 지정할 수 있으며, 단일종목·키움 조건검색식·사용자 정의의 세 가지 방식으로 전략을 만들 수 있습니다.

② 유연한 매수·매도 조건 단순히 종목을 고르는 데 그치지 않고, 준비 조건 → 실행 조건 → 매도 조건으로 나누어 언제 사고팔지 세밀하게 설정할 수 있습니다. 주문 금액도 수식(예: 보유 현금의 일정 비율)으로 지정할 수 있습니다.

③ 리스크 관리 과도한 손실을 막기 위한 안전장치가 계좌별로 내장되어 있습니다.

리스크 관리 항목	설명
일일 총 매수 금액 제한	하루 동안 매수에 사용할 수 있는 최대 금액
일일 동일 종목 매매작업 생성 제한	같은 종목에 대해 하루에 만들 수 있는 매매작업 수
동일 매수주문 연속 제한	같은 조건의 매수 주문이 연속으로 실행되는 것을 방지

④ 다양한 주문 유형 지정가·시장가 등 상황에 맞는 주문 유형을 지원합니다.

⑤ 자동 실행 스케줄러 지정한 요일과 시간에 프로그램을 자동으로 시작·종료하도록 예약할 수 있습니다.

⑥ 멀티 계좌 운용 하나의 프로그램에서 여러 개의 키움 계좌(최대 10계좌)를 등록하여, 계좌별로 독립적인 전략과 리스크 한도를 운용할 수 있습니다.

⚠️ 투자 위험 고지: 부엉이 트레이더 프로는 매매 실행을 자동화하는 도구이며 수익을 보장하지 않습니다. 설정한 전략과 시장 상황에 따라 손실이 발생할 수 있으며, 모든 투자 결과에 대한 책임은 사용자 본인에게 있습니다. 실계좌 사용 전에는 반드시 모의투자 계좌로 충분히 검증하시기 바랍니다.

1.3 주요 기능 한눈에 보기

부엉이 트레이더 프로의 주요 기능을 한눈에 정리하면 다음과 같습니다.

구분	주요 기능
자동매매 만들기	단일종목 / 키움 조건검색식 / 사용자 정의 — 세 가지 편집기
전략 구성 요소	최초매수·추가매수·매도 조건, 시스템조건식, 주문금액 계산식
AI 매수의견 판정	조건검색식 편입 종목의 최초매수 직전에 AI(ChatGPT·Gemini)에게 매수 의견 확인, 판정 이력과 사후 성적 조회 (선택 기능, 기본 꺼짐)
리스크 관리	계좌별 일일 총 매수 금액·동일 종목 매매작업 생성·동일 매수주문 연속 제한
실시간 모니터링	자동매매 현황, 진행 중 매매작업, 주문·체결 내역, 수익률 조회, 매매 통계 / 성과 분석
정규장 이후 매매	애프터마켓(16:00~20:00)까지 자동매매·대시보드 수동 매매 지원
잔고·계좌 조회	키움잔고, 시스템잔고, 당일매매, 예수금·계좌평가 현황
종목·차트 조회	전체 종목정보, 주식 기본·현재·요약 정보, 분봉·일봉 차트, 기술적 지표
외부 신호 연동	외부 프로그램이 REST API로 매수·매도 신호 전달 (선택 기능)
알림	Discord WebHook, Telegram 알림 (계좌별 설정 지원)
스케줄러	요일·시간 지정 자동 시작/종료
로그·시스템 정보	실시간 로그, 로그 관리·보관, 실시간 등록 현황, 연결 상태

1.4 화면 구성 미리보기

프로그램을 실행하면 나타나는 메인 화면은 크게 네 개 영역으로 구성됩니다. 각 영역의 자세한 사용법은 뒤의 "메인 화면 안내" 장에서 다룹니다.

영역	위치	역할
상단 바	화면 최상단	좌측 메뉴바 + 우측 업종지수(코스피·코스닥) 표시
좌측 패널	본문 왼쪽	계좌현황 + 자동매매 실행 스위치
자동매매 현황	본문 오른쪽	진행 중 매매작업 목록과 상세·주문·체결 현황
하단 탭 · 상태바	화면 아래	접이식 "잔고 · 체결 현황" 탭 그룹과 실시간 상태 표시

📌 참고: 기본 화면은 다크 네이비 테마입니다. [설정] → [시스템 환경 설정] 에서 밝은 테마로 바꿀 수 있습니다(13장 참고).