Chapter 1 / 11
1. 시작하기 전에
1.1 이 문서에 대하여
이 문서는 부엉이 트레이더 라이트 (Owl Trader Light) 의 공식 사용자 설명서입니다. 라이트 버전은 키움증권 REST API 기반의 조건검색식 자동매매에 집중한 경량 프로그램입니다.
부엉이 트레이더 프로와 달리 AI 분석·차트·서버 연동을 제외하고, 조건검색식으로 매수하고 손절·익절·트레일링 스탑·분할 매매 등 계좌를 지키는 매도 전략에 집중했습니다.
적용 버전
| 항목 | 내용 |
|---|---|
| 프로그램명 | 부엉이 트레이더 라이트 |
| 문서 적용 버전 | 1.7.4 |
| 운영체제 | Windows 10 이상 (64비트) |
| 필수 연동 | 키움증권 REST API |
⚠️ 주의: 사용 중인 프로그램 버전과 이 문서의 적용 버전이 다르면 화면 구성이나 기능이 다를 수 있습니다.
문서 개정 이력
| 버전 | 주요 변경 내용 |
|---|---|
| 1.7.4 | 지난 체결을 날짜별로 보는 [체결 내역] 창이 생겼습니다. 체결 시각을 초 단위로 보여 주고, 그 체결이 어느 조건검색 신호에서 나왔는지 맞춰 볼 수 있습니다(4.4.1). |
| 1.7.2 · 1.7.3 | 조건검색 신호 모니터가 매수·매도 조건식 탭으로 나뉘었습니다(7.2). 매도 조건을 여러 개 켰을 때의 매도 판정 순서를 화면에서 볼 수 있습니다(6.2.1). 당일 재매수 제한에 "전략이 달라도 제한" 이 생겼습니다(9.1.2). 감시 목록의 모든 열 제목으로 정렬됩니다(4.3). ETF는 애프터마켓까지 미루지 않고 정규장 기준으로 청산합니다. |
| 1.7.0 | ⚠️ KRX 애프터마켓(16:00~20:00) 개장과 시간외 단일가 폐지에 대응했습니다(11.4). 16:00 이후 주문은 KRX·NXT 통합(SOR)으로 나가고, 애프터마켓 시세가 화면과 매매 판단에 반영됩니다. 당일 청산 옵션이 "애프터마켓까지 기다렸다 청산" 으로 바뀌어 대상이 전 종목으로 넓어졌습니다(9.1.2). 익절용 매도 조건식 2번 슬롯(6.2), 조건검색 등록 자리 점유 내역 표시(4.5.2)가 추가되었고, 당일 청산은 산 날 안에만 적용됩니다. |
| 1.6.0 | 앱 밖에서 산 수량을 기존 포지션에 합치기(수동·자동, 4.3.3). 계좌를 삭제할 때 그 계좌의 전략을 함께 중지합니다(2.2). |
| 1.5.9 | HTS 등에서 산 종목을 지정한 전략으로 자동 편입할 수 있습니다(계좌별 선택, 기본 꺼짐, 4.3.2). 조건검색 신호의 지난 기록 조회와 "왜 안 샀는지" 결과 표시(7.2), 편입 종목 거래의 매매 통계 반영(9.2), 해외 지표 VIX 추가(4.5). |
| 1.5.6 | 한 계좌에서 동시에 감시할 수 있는 종목 수가 90개에서 190개로 늘었습니다(11.1). 키움 API 상한이 100개에서 200개로 확대된 데 따른 것으로, 업데이트만 하면 바로 적용됩니다. |
| 1.5.5 | 매수 시간대를 여러 개 지정할 수 있고 대체거래소(NXT) 프리마켓·애프터마켓을 버튼 한 번으로 넣습니다. 시간 입력이 24시간제로 바뀌었습니다(6.1). 당일 청산을 매매 설정별로 정할 수 있고(6.2), 감시 목록에 [청산 예정] 열이 생겼습니다(4.3). ⚠️ 매수 시간대 제한이 최초매수에만 적용되고, 하이브리드 모드가 한 번 켜지며, 매매 통계 집계 기준이 바뀝니다. |
| 1.5.1 | 상단 지수를 직접 고를 수 있게 되었고(국내 8종), 해외 참고 지표 4종이 새로 생겼습니다(4.5). 계좌 하드 리밋의 금액을 만원 단위로 입력합니다(2.3). |
| 1.5.0 | 매매 설정의 "기타 설정" 탭이 [시스템 설정 → 매매]로 이전되어 모든 전략에 공통 적용됩니다(9.1). ⚠️ 공통 값은 기본값(모두 꺼짐)으로 시작하므로 쓰시던 분은 다시 지정해야 합니다. |
| 1.4.1 | 제세금 기본값이 2026년 세율인 0.20% 로 인상되었고, 항목 이름이 "증권거래세율"에서 "제세금률" 로 바뀌었습니다(9.1). |
| 1.4.0 | 최대 보유 종목 수가 전략별에서 계좌별로 이전되었습니다("잔고 최대 종목수 제한", 2.3). 거래소별 수수료율(NXT)과 주문 건별 비용 계산을 반영했습니다(9.1). |
| 1.3.0 | 조건검색이 통합시세(KRX+NXT) 기준으로 전환되었습니다(7장). 외부에서 매수한 종목이 자동매매에 자동 편입되지 않습니다(4.3). 키움 접속 IP 차단 안내(9.7), 당일 청산의 KRX/NXT 분리(9.1)가 추가되었습니다. 모든 화면의 글자가 한 단계 커졌습니다. |
| 1.2.1 | 종목별 자동매매 일시중지(4.3), 계좌현황의 총매입·총평가와 계좌번호 마스킹(4.1), 패널 접기·펼치기(4장)를 추가했습니다. |
| 1.1.0 | 계좌별 하드 리밋과 권리이벤트 자동매매 중지를 반영했습니다. |
1.2 동작 원리
라이트 버전의 자동매매는 다음 흐름으로 동작합니다.
- 키움 HTS(영웅문)에서 미리 만들어 둔 조건검색식이 종목을 포착합니다.
- 포착된 종목을 전략에 연결된 매매 설정 프로필에 따라 매수합니다.
- 보유 종목은 손절·익절·트레일링 스탑·분할 매도 규칙에 따라 자동으로 청산됩니다.
⚠️ 조건검색식은 키움 HTS에서 먼저 생성해야 프로그램의 전략 설정 목록에 나타납니다.
1.3 사용 전 알아둘 점
| 항목 | 내용 |
|---|---|
| 증권사 API | 키움증권 REST API (단일 연동) |
| AppKey 발급 단위 | 계좌번호별로 발급하며, 계좌와 AppKey는 1:1로 대응합니다. |
| 키움 접속 단절 시간 | 월 |
| 초기 모의투자 기간 | 설치 후 7일간은 모의투자 사용을 권장합니다. 강제는 아니며, 이 기간에도 실전투자 계좌를 등록할 수 있습니다(안내 배너와 저장 시 확인 창이 표시됩니다). |