사용자 설명서를 불러오는 중입니다
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
이 문서는 부엉이 트레이더(부엉이 주식자동매매 프로그램) 의 공식 사용자 설명서입니다. 처음 사용하는 분부터 숙련된 사용자까지, 프로그램의 기능을 올바르게 이해하고 안전하게 활용할 수 있도록 안내합니다.
설명서는 사용자가 프로그램을 처음부터 끝까지 무리 없이 운용할 수 있도록 다음 순서로 구성되어 있습니다.
| 구분 | 내용 |
|---|---|
| 설치 및 초기 설정 | 프로그램 설치와 처음 사용하기 위한 필수 준비 |
| 화면(UI) 조작 방법 | 각 화면의 구성 요소와 조작 순서 |
| 기능 활용 방법 | 자동매매 전략 설정, 조건검색, 스케줄러 등 주요 기능 사용법 |
| 결과 확인 방법 | 체결 결과, 수익률, 계좌 잔고, 로그 등 확인 방법 |
이 문서에서 사용하는 표기 방식은 다음과 같습니다.
| 표기 | 의미 |
|---|---|
| [버튼명] | 화면에서 클릭하는 버튼을 나타냅니다. 예: [저장], [확인] |
| [상위 → 하위] | 메뉴 이동 경로를 나타냅니다. 예: [설정 → 시스템 환경 설정] |
고정폭 텍스트 | 입력값 예시나 항목명을 나타냅니다. 예: 현재가 |
| ⚠️ 주의 | 잘못 조작하면 오류가 발생하거나 의도치 않은 주문이 실행될 수 있는 항목입니다. |
| 💡 팁 | 기능을 더 편리하게 활용할 수 있는 추가 정보입니다. |
| 📌 참고 | 이해를 돕기 위한 보충 설명입니다. |
이 문서는 아래 버전을 기준으로 작성되었습니다.
| 항목 | 내용 |
|---|---|
| 프로그램명 | 부엉이 트레이더 (부엉이 주식자동매매 프로그램) |
| 문서 적용 버전 | 2.0.3 |
| 운영체제 | Windows 10 이상 (64비트) |
| 필수 연동 | 키움증권 REST API |
⚠️ 주의: 이후 버전에서는 화면 구성이나 기능이 일부 변경될 수 있습니다. 사용 중인 프로그램 버전과 이 문서의 적용 버전이 다를 경우, [도움말 → 프로그램 정보] 에서 현재 버전을 확인한 뒤 해당 버전의 최신 문서를 참고하시기 바랍니다.
| 버전 | 주요 변경 내용 |
|---|---|
| 2.0.3 | 자동 시작 스케줄러 개선을 반영했습니다 — 저장할 때만 관리자 권한이 필요(권한이 필요하면 재실행 안내), 예약 작업은 스크립트 없이 실행 파일을 직접 실행, 종료 시각에 프로그램이 스스로 정상 종료. |
| 2.0.1 | 자동매매 현황 대시보드 우측에 실시간 체결 현황 탭을 추가하고, 좌측 계좌·스위치 사이드바 접기/펼치기 기능을 반영했습니다. |
| 2.0.0 | 메인 화면 구성 및 설정 화면 재편에 맞추어 설명서를 전면 재작성했습니다. |
부엉이 트레이더 는 키움증권 REST API를 기반으로, 사용자가 정해 둔 전략과 규칙에 따라 종목 선정부터 매수·매도 주문 실행까지의 과정을 자동으로 처리하는 Windows 전용 주식 자동매매 프로그램입니다. 복잡한 코딩 없이도, 설정한 조건에 맞추어 프로그램이 실시간으로 시장을 감시하고 대응하도록 설계되었습니다.
| 항목 | 내용 |
|---|---|
| 지원 증권사 | 키움증권 (키움 REST API 전용) |
| 계좌 유형 | 실계좌 및 모의투자 계좌 모두 지원 |
| 지원 시장 | 코스피, 코스닥, ETF, ETN |
부엉이 트레이더를 사용하려면 아래 조건이 반드시 충족되어야 합니다.
| 항목 | 내용 |
|---|---|
| 키움증권 계좌 | 국내 주식 위탁 거래 계좌 (실계좌 또는 모의투자) |
| 키움 REST API 키 | 앱키(App Key) 및 시크릿키(Secret Key) 발급 필요 |
⚠️ 주의: 이 프로그램은 키움증권 계좌와 API 키가 없으면 사용할 수 없습니다. API 키 등록 방법은 4장을 참고하시기 바랍니다.
① 자동매매 전략 "어떤 종목을 언제 사고팔 것인가"를 미리 규칙으로 정의합니다. 종목은 키움 조건검색식을 활용하거나 직접 지정할 수 있으며, 단일종목·키움 조건검색식·사용자 정의의 세 가지 방식으로 전략을 만들 수 있습니다.
② 유연한 매수·매도 조건 단순히 종목을 고르는 데 그치지 않고, 준비 조건 → 실행 조건 → 매도 조건으로 나누어 언제 사고팔지 세밀하게 설정할 수 있습니다. 주문 금액도 수식(예: 보유 현금의 일정 비율)으로 지정할 수 있습니다.
③ 리스크 관리 과도한 손실을 막기 위한 안전장치가 계좌별로 내장되어 있습니다.
| 리스크 관리 항목 | 설명 |
|---|---|
| 일일 총 매수 금액 제한 | 하루 동안 매수에 사용할 수 있는 최대 금액 |
| 일일 동일 종목 매매작업 생성 제한 | 같은 종목에 대해 하루에 만들 수 있는 매매작업 수 |
| 동일 매수주문 연속 제한 | 같은 조건의 매수 주문이 연속으로 실행되는 것을 방지 |
④ 다양한 주문 유형 지정가·시장가 등 상황에 맞는 주문 유형을 지원합니다.
⑤ 자동 실행 스케줄러 지정한 요일과 시간에 프로그램을 자동으로 시작·종료하도록 예약할 수 있습니다.
⑥ 멀티 계좌 운용 하나의 프로그램에서 여러 개의 키움 계좌(최대 10계좌)를 등록하여, 계좌별로 독립적인 전략과 리스크 한도를 운용할 수 있습니다.
⚠️ 투자 위험 고지: 부엉이 트레이더는 매매 실행을 자동화하는 도구이며 수익을 보장하지 않습니다. 설정한 전략과 시장 상황에 따라 손실이 발생할 수 있으며, 모든 투자 결과에 대한 책임은 사용자 본인에게 있습니다. 실계좌 사용 전에는 반드시 모의투자 계좌로 충분히 검증하시기 바랍니다.
부엉이 트레이더의 주요 기능을 한눈에 정리하면 다음과 같습니다.
| 구분 | 주요 기능 |
|---|---|
| 자동매매 만들기 | 단일종목 / 키움 조건검색식 / 사용자 정의 — 세 가지 편집기 |
| 전략 구성 요소 | 최초매수·추가매수·매도 조건, 시스템조건식, 주문금액 계산식 |
| 리스크 관리 | 계좌별 일일 총 매수 금액·동일 종목 매매작업 생성·동일 매수주문 연속 제한 |
| 실시간 모니터링 | 자동매매 현황, 진행 중 매매작업, 주문·체결 내역, 수익률 조회 |
| 잔고·계좌 조회 | 키움잔고, 시스템잔고, 당일매매, 예수금·계좌평가 현황 |
| 종목·차트 조회 | 전체 종목정보, 주식 기본·현재·요약 정보, 분봉·일봉 차트, 기술적 지표 |
| 알림 | Discord WebHook, Telegram 알림 (계좌별 설정 지원) |
| 스케줄러 | 요일·시간 지정 자동 시작/종료 |
| 로그·시스템 정보 | 실시간 로그, 로그 관리·보관, 실시간 등록 현황, 연결 상태 |
프로그램을 실행하면 나타나는 메인 화면은 크게 네 개 영역으로 구성됩니다. 각 영역의 자세한 사용법은 뒤의 "메인 화면 안내" 장에서 다룹니다.
| 영역 | 위치 | 역할 |
|---|---|---|
| 상단 바 | 화면 최상단 | 좌측 메뉴바 + 우측 업종지수(코스피·코스닥) 표시 |
| 좌측 패널 | 본문 왼쪽 | 계좌현황 + 자동매매 실행 스위치 |
| 자동매매 현황 | 본문 오른쪽 | 진행 중 매매작업 목록과 상세·주문·체결 현황 |
| 하단 탭 · 상태바 | 화면 아래 | 접이식 "잔고 · 체결 현황" 탭 그룹과 실시간 상태 표시 |
📌 참고: 부엉이 트레이더는 다크 네이비 테마로 고정되어 있으며, 테마를 변경하는 기능은 없습니다.