2. 설치 및 계좌 등록
2.1 프로그램 설치
- 설치 파일
OwlTraderLight-Setup.exe를 실행합니다. .NET Desktop Runtime 10(x64)이 없으면 자동으로 감지하여 함께 설치합니다. - 사용권 계약(License) 에 동의하면 설치가 진행됩니다.
- 기본 설치 경로는
%ProgramFiles%\SageLine\OwlTraderLight이며, 시작 메뉴와 바탕화면에 바로가기가 생성됩니다.
2.2 계좌 등록 (AppKey / SecretKey)

라이트 버전은 별도의 아이디·비밀번호 로그인이 아니라 계좌별 API 키 등록 방식으로 인증합니다. 계좌현황 패널의 API 키 설정에서 등록합니다.
계좌 AppKey 설정 창은 계좌 목록(좌) · 계좌 정보(중앙) · 주문 폭주 방지 하드 리밋(우) 3열로 구성됩니다.
| 입력 항목 | 내용 |
|---|---|
| 모의투자 계좌 여부 | 모의투자 환경에서 거래할 경우 체크합니다. 연결 테스트가 접속할 서버(실서버/모의서버)를 결정하므로 가장 먼저 선택합니다. |
| 계좌번호 | 8자리 계좌번호 |
| 계좌명 | 구분하기 쉬운 이름 |
| AppKey / SecretKey | 키움에서 발급받은 REST API 키 |
- 연결 테스트 버튼으로 키를 실시간 검증할 수 있으며, 저장 시 다시 한 번 검증합니다.
- 설치 후 7일 이내에는 창 상단에 모의투자 권장 안내가 표시되고, 실전투자 계좌를 저장할 때 확인 창이 한 번 더 뜹니다.
⚠️ 프로그램을 켜 둔 상태에서 계좌를 추가하거나 키를 바꿨다면 다시 시작해야 합니다. 그 계좌는 실시간 정보를 받지 못해, 주문은 나가지만 체결 결과가 화면에 반영되지 않고 손절·익절도 동작하지 않습니다. 저장할 때 재시작이 필요하다고 안내하며, 해당 계좌의 전략은 다시 시작하기 전까지 실행되지 않습니다. (중지는 언제든 가능합니다.)
📌 참고: 예전에 있던 기본 수동매수 전략 항목은 없어졌습니다. 외부에서 매수한 종목을 어느 전략으로 관리할지는 종목을 자동매매에 넣는 그 자리에서 고르거나(4.3.1), [설정 → 외부 매수 자동 편입] 에서 계좌별로 지정합니다(4.3.2).
계좌 삭제
모의투자 앱키는 사용기한이 있어 만료되면 새 계좌로 갈아타야 합니다. 삭제하려는 계좌를 쓰는 전략이 가동 중이면, 삭제 확인 창에서 어떤 전략이 중지되는지 알려 주고 승인하면 중지까지 함께 처리합니다.
- 전략을 중지해도 보유 포지션은 그대로 남고 자동 감시만 멈춥니다.
- 하나라도 중지하지 못하면 계좌를 삭제하지 않습니다.
- 삭제된 계좌를 쓰던 전략은 목록에 남지만 계좌가 "(삭제된 계좌)" 로 표시되고 가동 스위치가 잠깁니다. 같은 계좌번호로 다시 등록하면 원래대로 이어져 다시 가동할 수 있습니다.
2.3 주문 폭주 방지 하드 리밋 (계좌별)
자동매매 오작동으로 인한 무한 매수·매도를 막는 최종 안전장치입니다. 상한값은 계좌마다 다르게 지정하며, 계좌 AppKey 설정 창 오른쪽 패널에서 편집합니다.
| 항목 | 내용 |
|---|---|
| 일일 매수 한도 (회) | 계좌 전체 기준, 하루 매수 주문 횟수 상한 |
| 일일 매도 한도 (회) | 하루 매도 주문 횟수 상한. 청산이 막히지 않도록 여유 있게 설정하십시오. |
| 종목별 일일 매수 한도 (회) | 동일 종목에 대한 하루 매수 주문 횟수 상한 |
| 1회 주문 최대 금액 (만원) | 주문 1건(수량 × 가격)의 최대 금액 |
| 일일 매수 금액 한도 (만원) | 하루 누적 매수 주문 금액의 총 상한 |
| 잔고 최대 종목수 제한 (종목) | 계좌 잔고가 이 종목 수에 도달하면 자동매매의 신규 진입만 거절합니다. (기본 100종목) |
값 0은 무제한입니다.
금액은 만원 단위로 입력합니다
1회 주문 최대 금액과 일일 매수 금액 한도는 만원 단위로 입력합니다. 예를 들어 1,000 은 1,000만원입니다. 입력란 오른쪽에 환산 금액(= 10,000,000원)이 항상 표시됩니다.
💡 왜 만원 단위인가: 천만·억 단위를 원으로 입력하면 0의 개수를 세다 자릿수를 한 자리 틀리기 쉽고, 그 실수가 곧 주문 상한 10배 차이가 되기 때문입니다. 저장된 값과 실제 차단 기준은 종전과 같습니다. 화면에서 받는 단위만 바뀌었고, 쓰시던 설정은 자동으로 환산되어 표시됩니다.
잔고 최대 종목수 제한
보유 종목 수 상한은 예전에 전략마다 두었으나, 계좌 단위로 옮겨졌습니다. 위험은 계좌 단위로 생기는데 상한을 전략마다 두면 계좌 전체가 몇 종목을 들고 있는지는 아무도 보지 않게 되기 때문입니다.
| 항목 | 동작 |
|---|---|
| 세는 기준 | 계좌 잔고 전체. 이 프로그램이 산 종목뿐 아니라 HTS 등 밖에서 산 종목도 함께 셉니다. |
| 막히는 것 | 자동매매의 신규 종목 진입만 거절됩니다. |
| 막히지 않는 것 | 보유 종목의 추가 매수(물타기·불타기), 매도, 직접 내는 수동 매수 |
| 경고 | 잔고 종목 수가 상한의 80% 를 넘으면 계좌현황에 경고 줄이 나타납니다. |
⚠️ 주의: 기존 계좌도 100종목으로 설정된 상태로 올라옵니다. 종전 전략별 상한(기본 10종목)보다 훨씬 느슨하므로, 종전과 같이 운용하려면 계좌 설정에서 값을 낮춰 주십시오.
하드 리밋 활성화, 반복 주문 한도, 이상 시세 가드는 계좌 공통 설정이므로 시스템 설정(9.1)에서 관리합니다.
