잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
부엉이 ATS의 설치부터 고급 전략 설정까지 모든 과정을 상세히 안내합니다. 처음 사용하시는 경우 설치 및 초기 설정 섹션부터 시작해 주세요.
이 문서는 **부엉이 주식자동매매 프로그램 (부엉이 ATS)**의 공식 사용자 설명서입니다. 초보 사용자부터 숙련된 사용자까지 프로그램의 모든 기능을 올바르게 활용할 수 있도록 가이드합니다.
설명서는 사용자의 원활한 프로그램 운용을 위해 다음 내용을 중심으로 구성되어 있습니다
이 문서가 다루는 내용
이 문서는 다음 내용을 중심으로 구성되어 있습니다.
구분 | 내용 |
설치 및 초기 설정 | 프로그램 설치 방법과 처음 사용하기 위한 필수 설정 |
화면(UI) 조작 방법 | 각 화면의 구성 요소와 조작 순서 |
기능 활용 방법 | 자동 매매 전략 설정, AI 뉴스 분석, 스케줄러 등 주요 기능 사용법 |
결과물 확인 방법 | 매매 체결 결과, 수익률, 계좌 잔고, 로그 등 확인 방법 |
오류 해결 및 FAQ | 자주 발생하는 문제와 해결 방법 |
이 문서는 아래 버전을 기준으로 작성되었습니다.
항목 | 내용 |
프로그램명 | 부엉이 주식자동매매 프로그램 (부엉이 ATS ) |
문서 적용 버전 | V1.0 |
운영체제 | Windows 10 이상 (64비트) |
필수 연동 서비스 | 키움증권 REST API |
⚠️ 주의: 이후 버전에서는 화면 구성이나 기능이 일부 변경될 수 있습니다.
사용 중인 프로그램 버전과 이 문서의 적용 버전이 다를 경우, 메뉴 [도움말 → 프로그램 정보] 에서 현재 버전을 확인하신 후 해당 버전의 최신 문서를 참고하시기 바랍니다.
이 문서에서 사용하는 표기 방식은 다음과 같습니다.
표기 | 의미 |
[버튼명] | 화면에서 클릭하는 버튼을 나타냅니다. 예: [조회], [저장] |
[메뉴명 → 항목] | 메뉴 이동 경로를 나타냅니다. 예: [설정 → 일반 설정] |
고정폭 텍스트 | 설정 파일의 항목명, 입력값 예시를 나타냅니다. 예: Microsoft.CodeAnalysis.Workspaces.MSBuild.BuildHost.runtimeconfig.json |
⚠️ 주의 | 잘못 조작하면 오류가 발생하거나 의도치 않은 주문이 실행될 수 있는 항목입니다. |
💡 팁 | 기능을 더 편리하게 활용할 수 있는 추가 정보입니다. |
📌 참고 | 이해를 돕기 위한 보충 설명입니다. |
이 문서와 함께 참고할 수 있는 자료는 다음과 같습니다.
버전 | 개정일 | 주요 변경 내용 |
V1.0 | 2026년 – | 최초 작성 |
**부엉이 ATS(Automated Trading System)**는 키움증권 REST API를 기반으로 종목 선정부터 매수·매도 주문 실행까지 전 과정을 자동화하는 Windows 전용 주식 자동매매 프로그램입니다. 복잡한 코딩 지식 없이도 사용자가 설정한 전략과 규칙에 따라 프로그램이 실시간으로 시장을 감시하고 대응하도록 설계되었습니다.
기술적 장벽 완화: 일반적인 API 연동에 필요한 복잡한 코딩 지식 없이, 조건과 규칙 설정만으로 자동매매가 가능하도록 구현되었습니다.
이름의 유래: 밤낮없이 시장을 감시하며 기회를 포착하는 부엉이의 특성에서 착안하여 명명되었습니다.
부엉이 ATS를 사용하기 위해서는 아래의 요건이 반드시 충족되어야 합니다.
항목 | 내용 |
지원 증권사 | 키움증권 (키움 REST API 전용) |
계좌 유형 | 실계좌 및 모의투자 계좌 모두 지원 |
API 키 | 키움증권 Rest API 앱키(App Key) 및 시크릿키(Secret Key) 필요 |
운영체제 | Windows 10 이상 (64비트) |
지원 시장 | 코스피, 코스닥, ETF, ETN |
⚠️ 주의: 이 프로그램은 키움증권 계좌와 API 키가 없으면 사용할 수 없습니다.
API 키 발급은 키움증권 Rest API 포털에서 신청하시기 바랍니다.
매매 전략의 핵심은 "어떤 종목을 언제 사고팔 것인가" 를 사전에 규칙으로 정의하는 것입니다.
종목 선정 방식: 키움증권 HTS 조건검색식 활용 또는 사용자가 직접 종목을 지정할 수 있습니다.
단순히 종목을 고르는 것을 넘어, 언제 사고 팔 것인지 세밀하게 조건을 설정할 수 있습니다.
자동매매의 가장 큰 위험인 과도한 손실을 방지하기 위한 다양한 안전장치가 내장되어 있습니다.
리스크 관리 항목 | 설명 |
일일 최대 매수 금액 제한 | 하루 동안 매수에 사용할 수 있는 최대 금액 설정 |
동일 종목 일일 최대 매수 횟수 | 같은 종목을 하루에 최대 몇 번까지 살 수 있는지 제한 |
연속 동일 매수 주문 제한 | 같은 조건의 매수 주문이 연속으로 실행되는 것을 방지 |
보유 종목 수 제한 | 동시에 보유할 수 있는 종목 수 상한선 설정 |
당일 동일 종목 재매수 제한 | 당일 이미 거래한 종목의 재매수를 차단 |
거래 제외 종목 기준 | 특정 조건의 종목(예: 관리종목, 거래 정지)을 거래 대상에서 자동 제외 |
지정 시간 일괄 매도 | 장 마감 전 지정된 시각에 보유 종목 전체 자동 매도 |
주문 유형: 지정가, 시장가 및 시간외 단일가 주문을 모두 지원합니다.
요일 및 시간대별로 매매 시작/종료를 예약할 수 있으며, 전략별로 독립된 실행 시간대(A/B 구간) 설정이 가능합니다.
⑥ 멀티 앱키 운용
하나의 프로그램에서 여러 개의 키움 앱키를 동시에 등록하고 운용할 수 있습니다.
각 앱키별로 독립적인 매매 전략을 실행할 수 있어 계좌 분리 운용이 가능합니다.
프로그램 동작 흐름 (한눈에 보기)

이 프로그램이 적합한 사용자
✅ 키움증권 조건검색식을 이미 활용하고 있는 사용자
✅ 자동매매를 시작하고 싶지만 코딩 없이 설정만으로 운용하고 싶은 사용자
✅ 여러 개의 매매 전략을 동시에 실행하고 결과를 모니터링하고 싶은 사용자
✅ AI 뉴스 분석을 매매 전략에 접목하고 싶은 사용자
이 프로그램이 적합하지 않은 사용자
❌ 키움증권 계좌가 없거나 API 키를 발급받지 않은 사용자
❌ 복잡한 초기 설정 없이 바로 사용하고 싶은 사용자
❌ 삼성증권, 미래에셋 등 타 증권사 계좌 사용자
⚠️ 투자 위험 고지
부엉이 ATS 은 매매 실행을 자동화하는 도구이며, 수익을 보장하지 않습니다.
설정한 매매 전략과 시장 상황에 따라 손실이 발생할 수 있습니다.
모든 투자 결과에 대한 책임은 사용자 본인에게 있습니다.
실계좌 사용 전 반드시 모의투자 계좌로 충분히 테스트하시기 바랍니다.
부엉이 ATS는 실시간 시장 감시부터 복잡한 매매 전략 실행까지, 주식 투자의 전 과정을 사용자 중심의 직관적인 인터페이스로 자동화합니다.
① 대시보드 — 메인 화면에서 한 번에 확인
프로그램을 시작하면 메인 화면에서 아래 정보를 실시간으로 확인할 수 있습니다.
대시보드 패널 | 표시 정보 | 참고 챕터 |
계좌 상태 | 예수금, 출금 가능 금액, 연결 계좌 정보 | |
자동 매매 스위치 | 전략별 ON/OFF 상태, 즉시 전환 버튼 | |
주식 잔고 | 보유 종목 목록, 종목별 평가 손익 | |
오늘 매매 현황 | 당일 매수·매도 체결 내역 요약 | |
미체결 주문 | 아직 체결되지 않은 주문 목록 | |
체결 주문 | 당일 체결 완료된 주문 목록 | |
조건검색식 포착 종목 | 실시간 조건검색식에 포착된 종목 목록 | |
업종 지수 | 코스피·코스닥 업종별 지수 실시간 현황 | |
시스템 정보 | API 연결 상태, CPU·메모리 사용량 | |
로그 | 실시간 프로그램 동작 로그 |
② 자동 매매 — 핵심 기능
매매 전략 만들기 (3가지 편집기)
편집기 유형 | 특징 | 추천 사용자 |
조건검색식 자동매매 | 키움 HTS에서 만든 조건검색식을 그대로 활용 | 키움 조건검색식 사용 경험자 |
사용자 정의 자동매매 | 실시간 순위·호가창·AI 뉴스 등 다양한 조건 조합 | 세밀한 전략 설정을 원하는 사용자 |
맞춤조건 자동매매 | 종목·조건을 직접 지정하여 단순하게 설정 | 별도 제작 사용자 |
전략 구성 요소
설정 항목 | 내용 |
종목 선정 방식 | 조건검색식 / 직접 지정 |
주문 전략 | 최초 매수 조건, 추가 매수 조건, 매도 조건 |
조건 표현식 | 현재가·체결 강도·수익률 등 수식으로 조건 설정 |
금액 표현식 | 주문 금액을 수식으로 설정 (예: 보유 현금의 20%) |
매매 시간 설정 | 전략별 매수·매도 허용 시간대 A·B 구간 설정 |
일괄 매도 | 지정 시각에 보유 종목 전량 자동 매도 |
거래 제외 기준 | 관리 종목·거래 정지 등 제외 조건 설정 |
리스크 관리 설정
제한 항목 | 설명 |
일일 최대 매수 금액 | 하루 동안 매수에 쓸 수 있는 금액 상한선 |
동일 종목 일일 매수 횟수 | 같은 종목 하루 최대 매수 가능 횟수 |
연속 동일 매수 제한 | 동일 조건 매수 주문이 연속으로 쌓이는 것 방지 |
보유 종목 수 제한 | 동시 보유 가능한 최대 종목 수 |
당일 재매수 차단 | 오늘 이미 거래한 종목의 재매수 방지 |
자동 매매 모니터링
화면 | 확인 가능 내용 |
자동 매매 현황 | 전략 → 작업 → 명세 → 주문 → 체결 5단계 계층 구조로 상세 현황 확인 |
자동 매매 스위치 대시보드 | 전략별 ON/OFF 전환 및 실시간 상태 확인 |
자동 매매 이력 | 날짜별 과거 매매 내역 및 결과 조회 |
수익률 순위 | 전략별 수익률 비교 |
오늘 매매 현황 | 당일 자동매매 체결 결과 요약 |
③ 종목 및 계좌 조회
종목 조회
기능 | 확인 가능 내용 |
종목 목록 조회 | 코스피·코스닥·ETF·ETN 전체 종목 검색 |
종목 현재가 실시간 조회 | 현재가, 호가창, 실시간 체결 내역 |
종목 기본 정보 조회 | 상장일, 자본금, 액면가, 대주주 등 |
종목 요약 정보 조회 | 52주 최고·최저, PER, 시가총액 등 |
시간외 단일가 조회 | 장 마감 후 단일가 거래 정보 조회 |
차트 데이터 조회
기능 | 지원 단위 |
분봉 차트 | 1분 / 3분 / 5분 / 10분 / 15분 / 30분 / 45분 / 60분 |
일봉 차트 | 일 단위 OHLC(시가·고가·저가·종가) 데이터 |
업종 차트 | 업종별 일봉 차트 데이터 |
업종 지수 | 코스피·코스닥 업종 지수 실시간 현황 |
계좌 조회
기능 | 확인 가능 내용 | |
예수금 상세 현황 | 예수금, 출금 가능 금액, 담보 대출 현황 | |
계좌 평가 잔고 | 종목별 보유 수량, 평균 단가, 평가 손익 | |
계좌 평가 현황 | 계좌 전체 총 평가금액, 총 손익률 | |
④ 스케줄러
기능 | 내용 |
자동 시작·종료 | 지정 시각에 자동매매 자동 시작 및 종료 |
요일별 설정 | 월~일 요일별로 실행 여부 개별 설정 |
전략별 시간대 | 전략마다 매수·매도 허용 시간대를 A·B 2구간으로 설정 |
⑤ 설정 관리
설정 항목 | 내용 |
키움 API 키 관리 | 여러 개의 앱키·시크릿키 등록 및 계좌 연결 관리 |
Gemini AI 키 설정 | AI 뉴스 분석용 Google Gemini API 키 등록 |
일반 설정 | 로그 파일 자동 업로드 등 기타 옵션 설정 |
테마 설정 | 밝은 테마 / 어두운 테마 전환 |
⑥ 로그 및 시스템 정보
기능 | 내용 |
실시간 로그 대시보드 | 프로그램 동작 로그 실시간 확인 |
로그 매니저 | 날짜별 과거 로그 파일 조회 및 검색 |
로그 파일 업로드 | 문의·오류 신고 시 로그 파일 자동 업로드 |
시스템 정보 대시보드 | CPU·메모리 사용량, API 서버 연결 상태 확인 |
API 사용 제한 현황 | 키움 REST API 호출 횟수 한도 실시간 모니터링 |
프로그램 정보 | 현재 설치된 버전 확인 |
이 항목은 부엉이 ATS 의 전체 화면 구성을 미리 파악하고
각 영역이 어떤 역할을 하는지 이해하는 데 도움을 줍니다.
메인 화면 전체 레이아웃
프로그램 실행 후 보이는 메인 창의 전체 구성은 다음과 같습니다.

각 영역 상세 설명
❶ 메뉴 바
화면 최상단에 위치하며, 프로그램의 모든 기능에 접근하는 진입점입니다.
메뉴 | 하위 항목 |
종목정보 | 전체 종목정보, 주식기본정보, 주식현재정보, 주식정보요약, 시간외단일가 |
계좌정보 | 예수금 상세 현황, 계좌평가잔고내역, 계좌평가현황 |
조건검색식 | 키움 조건검색식, 키움 조건검색식(실시간) |
자동매매 | 간편 매매, 자동매매 만들기 (3가지 방식), 시스템조건식 만들기, 주문금액 계산식 만들기, 자동매매 현황, 자동매매 주문 내역 |
차트 데이터 | 분봉 차트 데이터, 일봉 차트 데이터, 업종 일봉 차트 데이터 |
설정 | 로그인, 키움 REST API KEY 등록, GEMINI API KEY 등록, 자동시작 스케줄러 |
도움말 | 프로그램 정보, Log 관리, 후원하기 |
테마 | Light Theme, Dark Theme, Primary 색상 변경(Blue/Green/Orange) |
💡 팁: 대부분의 조회 기능은 별도 창으로 열립니다. 이미 열려 있는 창을 다시 메뉴에서 선택하면 기존 창이 자동으로 앞으로 이동합니다.
❷ 계좌 현황 패널
메인 화면 왼쪽 상단에 고정된 패널입니다.
연결된 키움 계좌의 현재 자산 상태를 한눈에 확인할 수 있습니다.

표시 항목 | 설명 |
계좌번호 | 현재 선택된 계좌 (▼ 클릭으로 계좌 전환 가능) |
예수금 | 계좌 내 현금 잔액 |
총 평가금액 | 현금 + 보유 종목 평가금액 합계 |
총 손익 | 보유 종목 전체 평가 손익 |
❸ 자동매매 스위치 패널
등록된 매매 전략 목록과 각 전략의 실행 상태를 보여줍니다.
버튼 한 번으로 전략을 즉시 시작하거나 중지할 수 있습니다.

상태 표시 | 의미 |
● 실행 (녹색) | 현재 이 전략이 활성화되어 매매 신호를 감시 중 |
○ 정지 (회색) | 현재 이 전략이 비활성화된 상태 |
⚠️ 주의: [시작] 버튼을 누르는 순간 해당 전략이 즉시 활성화됩니다.
실계좌에서 사용 시 실제 주문이 자동 실행될 수 있으므로 주의하십시오.
❹ 일반 설정 패널
앱키별 리스크 관리 설정값을 메인 화면에서 바로 확인하고 수정할 수 있습니다.

❺ API 사용 제한 현황 패널
키움 REST API의 실시간 사용량을 표시합니다.
한도를 초과하면 자동매매가 지연될 수 있어 수시로 확인이 필요합니다.

항목 | 한도 설명 |
실시간 체결 등록 종목수 | 동시에 실시간 시세를 수신할 수 있는 최대 종목 수 |
실시간 조건검색식 요청 | 동시에 실행 가능한 실시간 조건검색식 수 |
❻ 하단 탭 패널
메인 화면 하단의 핵심 정보 탭입니다.
탭 헤더의 숫자 배지(🔴)는 현재 데이터 건수를 실시간으로 표시합니다.

탭 이름 | 표시 내용 | 실시간 갱신 |
잔고 | 현재 보유 중인 종목 목록, 수량, 평균 단가, 평가 손익률 | ✅ |
당일매매 | 오늘 자동매매로 체결된 매수·매도 내역 요약 | ✅ |
체결 | 오늘 체결된 모든 주문 (자동·수동 포함) | ✅ |
미체결 | 아직 체결되지 않고 대기 중인 주문 목록 | ✅ |
조건검색식 | 실시간 조건검색식에 포착된 종목 목록 | ✅ |
로그 | 프로그램 동작 로그 실시간 출력 | ✅ |
시스템 정보 | API 연결 상태, 실시간 데이터 수신 지연 현황 | ✅ |
탭 ① 잔고

탭 ② 당일매매

탭 ③ 체결 / ④ 미체결


탭 ⑤ 조건검색식

탭 ⑥ 로그

❼ 업종 지수 바
메인 창 하단 근처에 위치하며, 주요 업종 지수를 실시간으로 스크롤하여 표시합니다.

❽ 상태 표시줄
창 맨 아래에 위치하며, 현재 프로그램의 동작 상태 메시지를 표시합니다.

표시 요소 | 설명 |
신호 표시기 | 실시간 자동매매 신호 발생 여부를 시각적으로 표시 |
후원하기 버튼 | 개발자 후원 계좌 정보 팝업 표시 |
별도 창으로 열리는 화면 목록
메뉴에서 선택 시 메인 창과 별도로 독립 창이 열리는 화면입니다.
여러 창을 동시에 열어 나란히 배치하여 사용할 수 있습니다.
메뉴 경로 | 열리는 창 |
종목정보 → 주식현재정보 | 실시간 현재가 + 호가창 |
종목정보 → 주식기본정보 | 종목 기본 정보 |
종목정보 → 시간외단일가 | 시간외 단일가 조회 |
계좌정보 → 예수금 상세 현황 | 예수금 상세 조회 |
계좌정보 → 계좌평가잔고내역 | 계좌 평가 잔고 조회 |
계좌정보 → 계좌평가현황 | 계좌 평가 현황 조회 |
조건검색식 → 키움 조건검색식 | 조건검색식 목록 조회 |
자동매매 → 자동매매 만들기 | 매매 전략 편집기 |
자동매매 → 자동매매 현황 | 5단계 계층 현황 모니터 |
자동매매 → 자동매매 주문 내역 | 매매 이력 조회 |
차트 데이터 → 분봉/일봉 | 차트 데이터 조회 |
도움말 → Log 관리 | 로그 파일 조회 |
📌 참고: 이미 열려 있는 창을 메뉴에서 다시 선택하면 새 창이 생성되지 않고 기존 창이 화면 앞으로 활성화됩니다.
테마 변경
[테마] 메뉴에서 밝은 화면과 어두운 화면 중 원하는 테마를 선택할 수 있습니다.
테마 | 특징 |
Light Theme | 흰색 배경의 밝은 테마 (낮 사용 권장) |
Dark Theme | 어두운 배경의 다크 테마 (장시간 사용·야간 권장) |
Primary Blue | 강조색을 파란색 계열로 변경 |
Primary Green | 강조색을 초록색 계열로 변경 |
Primary Orange | 강조색을 주황색 계열로 변경 |
부엉이 ATS 을 정상적으로 사용하기 위해 필요한 하드웨어, 소프트웨어, 네트워크 환경을 안내합니다.
설치 전에 아래 요구 사항을 반드시 확인하시기 바랍니다.
항목 | 최소 사양 | 권장 사양 |
CPU | 2코어 이상 (1.6 GHz) | 4코어 이상 (2.5 GHz 이상) |
RAM (메모리) | 4 GB | 8 GB 이상 |
저장 공간 | 1 GB 이상 여유 공간 | 5 GB 이상 여유 공간 |
화면 해상도 | 1280 × 768 이상 | 1920 × 1080 (Full HD) 이상 |
네트워크 | 유선 또는 Wi-Fi 인터넷 연결 | 유선 인터넷 (안정적인 연결 권장) |
⚠️ 주의: 자동매매 중 프로그램이 비정상 종료되면 미체결 주문이 남을 수 있습니다.
안정적인 PC 사양과 네트워크 환경에서 사용하시기 바랍니다.
💡 팁: 실시간 시세 수신, 다수 전략 동시 실행, AI 뉴스 분석 등 여러 기능을 동시에 사용하면
메모리 사용량이 증가합니다. 8 GB 이상의 RAM을 권장합니다.
항목 | 내용 |
지원 OS | Windows 10 / Windows 11 |
아키텍처 | 64비트 (x64) 권장 |
언어 | 한국어 Windows 환경 권장 |
📌 참고: 부엉이 ATS 의 프로그램은 .NET 10 (Windows) 기반으로 작성되었습니다.
① .NET 런타임
부엉이 ATS 은 Microsoft .NET 10 기반으로 개발되었습니다.
인스톨러 실행 시 자동으로 설치 여부를 확인하지만, 사전에 설치되어 있으면 더 빠르게 시작할 수 있습니다.
💡 팁: .NET 런타임은 아래 Microsoft 공식 사이트에서 무료로 다운로드할 수 있습니다.
https://dotnet.microsoft.com/download
② 키움증권 관련 필수 요건
항목 | 요건 | 설명 |
키움증권 계좌 | 필수 | 국내 주식 위탁 거래 계좌 (실계좌 또는 모의투자) |
키움 REST API 앱키 발급 | 필수 | 키움 Rest API 포털에서 앱키(App Key) 및 시크릿키(Secret Key) 발급 |
모의투자 계좌 (권장) | 권장 | 실계좌 사용 전 테스트 목적으로 사용 |
저장 공간 사용 현황
저장 위치 | 용도 | 예상 크기 |
프로그램 설치 폴더 | 실행 파일 및 리소스 | 약 200 ~ 400 MB |
내 문서\SageLine\SageStockPilot\ | 설정 파일 (appsettings.json) | 수 KB |
내 문서\SageLine\SageStockPilot\logs\ | 로그 파일 (일자별, 최대 20개 보관) | 파일당 최대 1 GB |
내 문서\SageLine\SageStockPilot\ | SQLite DB 파일 (전략, 주문, 이력 등) | 수 MB ~ 수십 MB |
💡 팁: 로그 파일은 하루 1개씩 생성되며, 최대 20일치가 보관됩니다.
디스크 여유 공간이 부족해지면 오래된 로그 파일을 수동으로 삭제하시기 바랍니다.
로그 파일 위치: 내 문서 > SageLine > 부엉이 ATS > logs
지원 여부 요약표
환경 | 지원 여부 | 비고 |
Windows 11 (64비트) | ✅ 완전 지원 | 권장 환경 |
Windows 10 (64비트) | ✅ 완전 지원 | 권장 환경 |
⚠️ 투자 안정성 주의:
자동매매 프로그램 특성상 PC가 절전 모드, 화면 보호기, 또는 자동 재시작되면 실행 중인 전략이 중단됩니다.
자동매매 실행 중에는 아래 설정을 확인하세요.
설치 전 체크리스트
번호 | 확인 항목 | 비고 |
☐ | Windows 10 이상 운영체제인지 확인 | 64비트 권장 |
☐ | 키움 앱키(App Key) 및 시크릿키(Secret Key) 발급 여부 확인 | Rest API 포털에서 발급 |
☐ | 기존에 설치된 이전 버전이 있다면 프로그램 종료 후 진행 | 실행 중 재설치 시 오류 가능 |
☐ | Windows 백신·보안 프로그램 실시간 검사 일시 중지 | 설치 파일 오탐 방지 |
네이버까페 자료실에서 부엉이ATS 프로그램 설치 파일 다운로드 및 설치
https://cafe.naver.com/f-e/cafes/31344003/menus/11?t=1773202258583
※ 설치방법은 게시물을 참조하시 바랍니다.

처음 실행 시 자동 생성 파일
메인 화면이 처음 실행될 때 아래 파일들이 내 문서 폴더에 자동으로 생성됩니다.
삭제하거나 수정할 필요는 없으며, 편의 기능으로 활용할 수 있습니다.
파일명 | 위치 | 설명 |
Start부엉이 ATS .bat | 내 문서\SageLine\ | 프로그램 실행 배치 파일 |
Start부엉이 ATS .vbs | 내 문서\SageLine\ | 관리자 권한으로 실행하는 스크립트 |
Exit부엉이 ATS .bat | 내 문서\SageLine\ | 프로그램 강제 종료 배치 파일 |
💡 팁: 매일 자동매매를 사용한다면 Start부엉이 ATS .vbs 파일의 바로 가기를
Windows 시작 프로그램 폴더에 등록하면 PC 부팅 시 자동으로 실행됩니다.
중요한 자동 동작 안내
프로그램에는 아래 두 가지 자동 동작이 내장되어 있습니다.
반드시 숙지하시기 바랍니다.
① 오전 6시 — 종료 예고 알림
프로그램 자동 종료 (실행 중인 자동매매 전략 포함)
⚠️ 주의: 매일 오전 6시 5분에 프로그램이 자동 종료됩니다.
이는 키움증권 서버 점검 시간과 새벽 시간대의 불안정한 데이터 수신을 방지하기 위한 설계입니다.
자동매매가 계속 필요하다면 Start부엉이 ATS .vbs를 Windows 작업 스케줄러에 등록하여 오전 7시 30분 이후 자동 재시작하도록 설정하는 것을 권장합니다.
② 오전 6시 ~ 7시 30분 — 조기 실행 경고
키 미등록 상태에서 최초 실행 시 — API 키 등록 창
등록된 키움 API 키가 없거나 키가 유효하지 않으면 메인 화면 대신
키움 REST API KEY 등록 창이 자동으로 표시됩니다.

⚠️ 주의: 이 창에서 [취소] 를 클릭하면 프로그램이 자동으로 종료됩니다.
API 키를 발급받은 후 다시 실행하십시오.
이 설정이 필요한 이유
부엉이 ATS 은 키움증권 REST API를 통해 주문 실행, 계좌 조회, 실시간 시세 수신 등 모든 핵심 기능을 수행합니다.
이를 위해서는 키움증권 Rest API 포털에서 발급받은 앱키(App Key) 와 시크릿키(Secret Key) 를 프로그램에 등록해야 합니다.
⚠️ 주의: 앱키와 시크릿키가 등록되지 않으면 프로그램의 모든 기능을 사용할 수 없습니다.
STEP 1 — 키움 Rest API 앱키 발급
까페 자료실의 키움증권_REST_API_사용신청_설명서_20260302.pptx 문서 참조
발급 시 확인 사항
항목 | 설명 |
서버 구분 | 실서버 계좌용 또는 모의투자 계좌용 구분 발급 |
계좌번호 | 앱키와 연결할 거래 계좌번호 확인 |
App Key | 공개 식별자 (32자 내외 문자열) |
Secret Key | 비공개 인증키 (64자 내외 문자열, 절대 타인에게 공개 금지) |
⚠️ Secret Key는 절대로 타인에게 공개하지 마십시오.
유출 시 타인이 귀하의 계좌로 주문을 실행할 수 있습니다.
유출이 의심되면 키움 Rest API 포털에서 즉시 앱키를 재발급하십시오.
STEP 2 — 키움 REST API KEY 등록 창 열기
두 가지 방법으로 등록 창을 열 수 있습니다.
방법 | 설명 |
방법 1. 자동 표시 | 앱키 미등록 상태에서 프로그램 시작 시 자동으로 등록 창이 열림 |
방법 2. 메뉴에서 열기 | 메인 화면 메뉴 [설정 → 키움증권 REST API KEY 등록] 클릭 |
메인 화면 메뉴바
│
└── [설정]
└── [키움증권 REST API KEY 등록] ← 클릭
STEP 3 — 키움 REST API KEY 등록 창 화면 구성

입력 항목 | 설명 | 예시 |
계좌번호 | 키움증권 국내 주식 계좌번호 | 1234567890 |
서버 구분 | 연결할 서버 선택 | ● 실서버 또는 ● 모의투자 |
App Key | 키움 포털에서 발급받은 앱키 | PSxxxxxxxxxxxxxxxxxxxxxxxxxxx |
Secret Key | 키움 포털에서 발급받은 시크릿키 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
📌 참고: 기본값은 모의투자 서버로 설정되어 있습니다.
실제 거래 계좌를 사용하려면 반드시 ● 실서버 로 변경하십시오.
STEP 4 — 계좌 및 키 입력
입력 방법
① 계좌번호 입력
계좌번호란 클릭 → 키움증권 계좌번호 입력 (하이픈(-) 없이 숫자만)
예: 1234567890
② 서버 구분 선택
● 실서버 ← 실제 거래 (실제 돈이 거래됨) ⚠️
● 모의투자 ← 테스트용 (가상 자금으로 연습)
③ App Key 입력
키움 Rest API 포털에서 발급받은 App Key 붙여넣기
④ Secret Key 입력
키움 Rest API 포털에서 발급받은 Secret Key 붙여넣기
⚠️ 처음 사용자는 반드시 모의투자 계좌로 먼저 테스트하십시오.
실서버 등록 후 자동매매를 시작하면 실제 돈으로 주문이 실행됩니다.
여러 계좌 등록 (멀티 앱키)
목록의 빈 행에 추가 계좌 정보를 입력하면 여러 개의 계좌/앱키를 동시에 등록할 수 있습니다.
💡 팁: 여러 앱키를 등록하면 API 호출 한도를 분산시킬 수 있습니다.
각 앱키별로 독립적인 매매 전략을 할당하여 운용할 수 있습니다.
STEP 5 — 유효성 검사 및 저장
[저장] 버튼을 클릭하면 아래 절차가 자동으로 진행됩니다.
① 입력값 유효성 검사
② 키움 API 서버에 실제 접속하여 키 유효성 확인
③ Windows 자격 증명 관리자에 암호화 저장
④ 저장 완료 메시지 표시
⑤ 창 자동 닫힘
STEP 6 — 프로그램 재시작
등록이 완료되면 반드시 프로그램을 재시작해야 변경 내용이 적용됩니다.
저장 위치 및 보안
항목 | 내용 |
저장 위치 | Windows 자격 증명 관리자 (Credential Manager) |
저장 키 이름 | SageLine .SageStockPilot.{계좌번호} |
저장 방식 | App Key는 사용자 이름, Secret Key는 비밀번호로 암호화 저장 |
확인 방법 | Windows 제어판 → 자격 증명 관리자 → Windows 자격 증명 |
💡 팁: 앱키는 PC 재부팅 후에도 유지됩니다.
Windows 자격 증명 관리자에 저장되므로 별도 파일로 평문 보관하지 않아 보안에 안전합니다.
오류 메시지 및 해결 방법
오류 메시지 | 원인 | 해결 방법 |
App Key, Secret Key를 입력해주세요. | 입력 항목 누락 | 3개 항목 모두 입력 후 재시도 |
계좌번호가 중복되었습니다. | 같은 계좌를 두 번 입력 | 중복된 행 삭제 후 재시도 |
App Key, Secret Key가 유효하지 않습니다. | 잘못된 키 입력 또는 키 만료 | 키움 포털에서 키 재확인 또는 재발급 |
키움 API 서버에 연결할 수 없습니다. | 인터넷 연결 문제 또는 키움 서버 점검 | 인터넷 연결 확인 후 재시도 |
유효한 App Key, Secret Key를 입력해주세요. | 유효한 키가 하나도 없음 | 올바른 계좌와 키 입력 후 재시도 |
등록 완료 후 확인 방법
프로그램 재시작 후 메인 화면 계좌 현황 패널에서 계좌가 정상 연결되었는지 확인합니다.

계좌 현황 패널에 실제 잔고 데이터가 표시되면 앱키 등록이 완료된 것입니다.
📌 참고: 모의투자 계좌는 잔고가 가상 금액으로 표시됩니다.
처음에는 키움증권에서 지정한 모의투자 초기 자금이 표시됩니다.
※ 회원가입은 하지 않아도 됩니다.
상단 메뉴의 [로그인] 버튼을 클릭하면 로그인 화면이 나타납니다.
화면 구성

구성 요소 | 설명 |
고객 ID | SageLine 회원 가입 시 등록한 아이디를 입력합니다. |
비밀번호 | SageLine 계정 비밀번호를 입력합니다. |
비밀번호 저장 | 체크 시 다음 실행부터 비밀번호를 자동 입력합니다. |
자동 로그인 | 체크 시 다음 실행부터 로그인 창 없이 자동으로 인증합니다. (3.2절 참조) |
로그인 | 입력된 정보로 SageLine 서버에 인증을 요청합니다. |
닫기 | 로그인 창을 닫습니다. 로그인하지 않아도 일부 기능은 사용 가능합니다. |
회원가입 | 기본 브라우저를 열어 SageLine 회원가입 페이지(www.sageline.co.kr)로 이동합니다. |
비번찾기 | 비밀번호 재설정 페이지로 이동합니다. |
홈페이지 | SageLine 공식 홈페이지(www.sageline.co.kr)로 이동합니다. |
네이버카페 | SageLine 공식 네이버 카페로 이동합니다. |
⚠️ 투자 책임 고지 로그인 화면 하단에 표시된 안내문과 같이, 본 프로그램은 투자 판단 지원 도구이며 사용자의 투자 결정 및 손실에 대한 책임은 사용자 본인에게 있습니다.
부엉이 ATS에는 두 가지 독립적인 자동 로그인 기능이 있습니다.
① 부엉이 ATS 자동 로그인 (IsAutoLogin)
SageLine 서버 인증(프로그램 라이선스 확인)을 자동으로 처리합니다.
설정 방법
부엉이 ATS 의 메인 화면은 4개의 영역으로 구성됩니다.

① 메뉴바
화면 최상단에 위치하며, 프로그램의 모든 기능에 접근할 수 있는 메인 메뉴입니다.
메뉴 | 주요 기능 |
종목정보 | 전체 종목정보, 주식기본정보, 주식현재정보, 주식정보요약, 시간외단일가 조회 |
계좌정보 | 예수금 상세 현황, 계좌평가잔고내역, 계좌평가현황 조회 |
조건검색식 | 키움 조건검색식 목록 조회, 실시간 조건검색식 포착 종목 확인 |
자동매매 | 자동매매 전략 생성 (단일종목·조건검색식·사용자 정의), 시스템조건식 만들기, 주문금액 계산식 만들기, 자동매매 현황·이력 조회, 간편 매매 |
차트 데이터 | 분봉·일봉·업종 일봉 차트 데이터 조회 |
설정 | 로그인, 키움 API 키 등록, Gemini API 키 등록, 자동시작 스케줄러 설정 |
도움말 | 프로그램 정보, 로그 관리, 후원하기 |
테마 | Light/Dark 테마 전환 및 포인트 컬러 변경 |
② 대시보드 패널 (상단 4구역)
메뉴바 아래에 가로로 나란히 배치된 4개의 상시 표시 패널입니다. 프로그램을 사용하는 동안 항상 화면에 고정되어 있어 핵심 정보를 한눈에 확인할 수 있습니다.
계좌현황 (좌측 첫 번째)
등록된 계좌 목록과 선택한 계좌의 실시간 평가 현황을 표시합니다.
표시 항목 | 설명 |
계좌번호 목록 | 등록된 키움 계좌 목록 (클릭으로 계좌 전환 가능) |
총매입금액 | 현재 보유 종목들의 총 매입 원가 합계 |
총평가금액 | 현재가 기준 보유 종목들의 총 평가금액 |
총수익률 | 전체 보유 종목 평균 수익률 (%) |
총평가손익금액 | 총 매입금액 대비 평가 손익 |
예수금 | 계좌 내 주문 가능한 현금 잔액 |
새로고침 버튼 (↺) | 계좌 정보를 키움 서버에서 다시 조회합니다 |
자동매매 실행 스위치 (두 번째)
등록된 자동매매 전략 목록과 각 전략의 실행 ON/OFF 스위치를 표시합니다.
표시 항목 | 설명 |
전략 이름 | 등록된 자동매매 전략의 이름 |
토글 스위치 | 해당 전략의 자동매매 실행 여부 제어 (■ OFF / ● ON) |
일반설정 (세 번째)
거래 안전 한도를 설정하는 패널입니다. 계좌(앱키)별로 적용됩니다.
설정 항목 | 설명 |
일일 총 매수 금액 제한 | 하루 동안 자동매매가 매수할 수 있는 최대 금액 (원) |
일일 동일 종목 매수 횟수 제한 | 계좌별로 하루 동안 동일한 종목에 대해 매수 주문을 넣을 수 있는 최대 횟수를 제한합니다. |
동일 매수주문 연속 제한 | 완전히 동일한 조건(종목코드, 매수매도구분, 거래구분, 가격, 수량)의 주문이 연속으로 반복될 때 제한합니다. |
저장 버튼 | 변경된 설정을 usersettings.json에 저장 |
키움 Rest API 제한 현황 (네 번째)
키움증권 REST API의 현재 사용 제한 현황을 표시합니다.
표시 항목 | 설명 |
실시간 주식 체결 데이터 요청 제한(종목수) | 계좌별로 실시간 주식 체결 정보를 받을 수 있는 최대 종목 수를 제한합니다. |
실시간 조건검색식 요청 제한 | 현재 활성화된 실시간 조건검색식 수 및 제한값 |
API 제한 상세 내용은 15장 키움 API 사용 제한 관리를 참고하세요.
③ 탭 패널 (하단 중앙)
대시보드 패널 아래에 위치하며, 실시간 거래 현황 및 시스템 정보를 탭으로 구분하여 표시합니다. 각 탭 이름 옆의 숫자 뱃지는 해당 탭에 표시된 항목 수를 나타냅니다.
탭 이름 | 표시 내용 |
잔고 | 현재 보유 중인 주식 종목 목록과 평가 손익 현황 |
당일매매 | 오늘 발생한 매수·매도 체결 내역 요약 |
체결 | 실시간으로 체결된 주문 목록 |
미체결 | 아직 체결되지 않고 대기 중인 주문 목록 |
조건검색식 | 현재 실시간 조건검색식에 포착된 종목 목록 |
로그 | 프로그램 동작 실시간 로그 출력 |
시스템 정보 | CPU·메모리 사용량, 서버 연결 상태, 버전 정보 등 |
업종지수 바
탭 패널과 상태바 사이에 위치하며, 주요 시장 지수를 실시간으로 표시합니다.
항목 | 설명 |
KOSPI | 한국거래소 코스피 지수 및 등락 정보 |
KOSDAK | 코스닥 지수 및 등락 정보 |
④ 상태바
화면 최하단에 위치하며, 프로그램 동작 상태를 실시간으로 표시합니다.
좌측 — 상태 메시지
현재 프로그램이 수행 중인 작업이나 최근 처리 결과를 텍스트로 표시합니다.
우측 — 신호 표시 영역
[👤 아이디] ● ● ● ● [후원하기]
신호 | 설명 | 색상 변화 |
① TR 요청 신호 | 키움 API TR(데이터 요청) 발생 시 점등 | 회색 → 초록 → 서서히 회색 (1초) |
② 서버 Ping 신호 | 키움 서버로부터 Ping 응답 수신 시 점등 | 회색 → 초록 → 서서히 회색 (5초) |
③ 실시간 데이터 수신 신호 | WebSocket을 통해 실시간 데이터 수신 시 점등 | 회색 → 초록 → 빠르게 회색 (0.3초) |
④ 연결 상태 신호 | 키움 서버와의 WebSocket 상시 연결 상태 표시 | 연결됨: 초록 / 끊김: 회색 또는 빨강 |
후원하기 버튼
클릭 시 후원 계좌 정보(카카오뱅크)가 팝업으로 표시됩니다. 도움말 메뉴에서도 동일하게 접근할 수 있습니다.
메인 화면 최상단에 위치한 메뉴바에서 프로그램의 모든 기능 화면을 열 수 있습니다.
📌 종목정보
주식 종목의 기본 정보와 현재가 시세를 조회하는 기능들이 모여 있습니다.
메뉴 항목 | 설명 | 관련 장 |
전체 종목정보 | 상장된 전체 종목의 코드·이름 목록 조회 | |
주식기본정보 | 종목별 상장일, 자본금, 액면가 등 기본 정보 조회 | |
주식현재정보 | 선택 종목의 실시간 현재가 및 호가 조회 | |
주식정보요약 | 종목의 핵심 지표를 요약하여 조회 | |
시간외단일가 | 장 종료 후 시간외 단일가 시세 조회 |
📌 계좌정보
키움증권 계좌의 잔고, 평가 손익, 예수금 현황을 상세 조회하는 기능들이 모여 있습니다.
메뉴 항목 | 설명 | 관련 장 |
예수금 상세 현황 | 출금 가능 금액, 주문 가능 금액 등 예수금 세부 현황 | |
계좌평가잔고내역 | 보유 종목별 평가금액 및 손익 목록 | |
계좌평가현황 | 종목별 평가 손익 현황 요약 |
📌 조건검색식
키움증권 HTS에 등록된 조건검색식을 불러와 실시간으로 포착 종목을 확인하는 기능입니다.
⚠️ 메뉴 항목이 빨간색으로 표시된 것은 키움 API 사용 횟수 제한에 민감한 기능임을 나타냅니다.
메뉴 항목 | 설명 | 관련 장 |
키움 조건검색식 | 키움 HTS에 저장된 조건검색식 목록을 불러와 조회 | |
키움 조건검색식 (실시간) | 조건검색식에 실시간으로 편입/이탈되는 종목을 모니터링 |
📌 자동매매
자동매매 전략을 설계하고 실행하는 프로그램의 핵심 기능들이 집약되어 있습니다.
메뉴 항목 | 설명 | 관련 장 |
간편 매매 | 간단한 수동 매수·매도 주문 실행 화면 | |
자동매매 만들기 (단일종목) | 특정 종목 하나를 대상으로 자동매매 전략 생성 | |
자동매매 만들기 (키움 조건검색식) | 키움 조건검색식에 편입되는 종목을 자동 선정하는 전략 생성 | |
자동매매 만들기 (사용자 정의) | 사용자가 직접 종목 목록을 지정하는 전략 생성 | |
시스템조건식 만들기 | 매수·매도 발동 조건을 수식으로 정의하는 편집기 | |
주문금액 계산식 만들기 | 주문 금액을 수식으로 계산하는 편집기 | |
자동매매 현황 | 현재 실행 중인 전략의 보유 종목과 손익 현황 | |
자동매매 주문 내역 | 자동매매로 처리된 과거 주문 이력 조회 |
📌 차트 데이터
종목과 업종의 과거 가격 데이터를 조회합니다.
메뉴 항목 | 설명 | 관련 장 |
분봉 차트 데이터 | 1~60분 단위 분봉 가격 데이터 조회 | |
일봉 차트 데이터 | 일별 시가·고가·저가·종가 데이터 조회 | |
업종 일봉 차트 데이터 | 업종 코드별 일봉 데이터 조회 |
💡 틱·주봉·월봉 차트는 현재 준비 중인 기능으로 추후 업데이트될 예정입니다.
📌 설정
프로그램 운영에 필요한 계정 및 API 키 등록과 자동화 스케줄을 설정합니다.
메뉴 항목 | 설명 | 관련 장 |
키움증권 REST API KEY 등록 | 키움 Rest API 앱키·시크릿키·계좌번호 등록 및 관리 | |
GEMINI API KEY 등록 | Google Gemini AI 뉴스 분석 기능용 API 키 등록 | |
자동시작 스케줄러 | 자동매매 시작·종료 시간 및 요일 설정 |
📌 도움말
프로그램 정보 확인과 지원 관련 기능입니다.
메뉴 항목 | 설명 |
프로그램 정보 | 현재 설치된 부엉이 ATS 의 버전 정보와 라이선스 안내 표시 |
Log 관리 | 날짜별 과거 로그 파일 조회 및 서버 업로드 기능 |
후원하기 | SageLine 후원 계좌 정보(카카오뱅크) 팝업 표시 |
📌 테마
프로그램 전체 화면의 색상 테마를 변경합니다. 설정은 즉시 적용됩니다.
메뉴 항목 | 설명 |
Light Theme | 흰 배경의 밝은 테마로 전환 |
Dark Theme | 어두운 배경의 다크 테마로 전환 |
(구분선) | |
Primary : Blue | 포인트 컬러를 파란색으로 변경 |
Primary : Green | 포인트 컬러를 초록색으로 변경 |
Primary : Orange | 포인트 컬러를 주황색으로 변경 |
💡 야간 장시간 모니터링 시에는 Dark Theme를 사용하면 눈의 피로를 줄일 수 있습니다. 테마 변경 상세 방법은 4.4절을 참고하세요.
메인 화면 하단 탭 패널에는 총 7개의 탭이 있으며, 각 탭 이름 옆의 숫자 뱃지(🔢) 는 현재 해당 탭에 표시된 항목의 총 건수를 나타냅니다. 숫자가 변하면 새로운 데이터가 수신된 것입니다.
🗂️ 잔고 탭
현재 보유 중인 주식 종목 목록을 실시간으로 표시합니다.
컬럼명 | 설명 |
종목코드 | 보유 종목의 6자리 고유 코드 |
종목명 | 보유 종목 이름 |
보유수량 | 현재 보유 중인 주식 수 |
현재가 | 실시간 현재 주가 (원) |
매입단가 | 매수 시 평균 단가 (원) |
매입금액 | 보유수량 × 매입단가 (원) |
평가금액 | 보유수량 × 현재가 (원) |
손익률 | (현재가 - 매입단가) / 매입단가 × 100 (%) |
평가손익 | 평가금액 - 매입금액 (원) |
🗂️ 당일매매 탭
오늘 하루 동안 발생한 매수·매도 거래를 종목별로 집계하여 표시합니다.
컬럼명 | 설명 |
종목코드 | 거래된 종목 코드 |
종목명 | 거래된 종목 이름 |
매수수량 | 당일 매수 체결 수량 |
매수평균가 | 당일 매수 평균 체결가 (원) |
매도수량 | 당일 매도 체결 수량 |
매도평균가 | 당일 매도 평균 체결가 (원) |
손익률 | 매도평균가 기준 수익률 (%) |
손익금액 | 당일 해당 종목의 실현 손익 (원) |
🗂️ 체결 탭
당일 체결된 주문 내역을 건별로 실시간 표시합니다. 자동매매와 수동 주문 모두 포함됩니다.
컬럼명 | 설명 |
주문번호 | 키움증권이 부여한 고유 주문 번호 |
종목코드 | 주문 종목 코드 |
종목명 | 주문 종목 이름 |
주문구분 | 매수 / 매도 구분 |
주문가격 | 요청한 주문 가격 (원) |
주문수량 | 요청한 주문 수량 |
체결가 | 실제 체결된 가격 (원) |
체결량 | 실제 체결된 수량 |
미체결수량 | 아직 체결되지 않은 잔여 수량 |
당일매매수수료 | 해당 거래에서 발생한 매매 수수료 (원) |
당일매매세금 | 해당 거래에서 발생한 매매 세금 (원) |
매매구분 | 자동매매 / 수동 등 거래 종류 |
주문시간 | 주문이 접수된 시각 |
🗂️ 미체결 탭
주문을 냈으나 아직 체결되지 않고 대기 중인 주문 목록을 실시간으로 표시합니다.
컬럼명 | 설명 |
주문번호 | 키움증권이 부여한 고유 주문 번호 |
종목코드 | 주문 종목 코드 |
종목명 | 주문 종목 이름 |
주문구분 | 매수 / 매도 구분 |
주문가격 | 요청한 주문 가격 (원) |
주문수량 | 요청한 전체 주문 수량 |
체결가 | 부분 체결된 경우 체결 가격 (원) |
체결량 | 부분 체결된 수량 |
미체결수량 | 아직 체결되지 않은 잔여 수량 |
당일매매수수료 | 부분 체결분에 대한 수수료 (원) |
당일매매세금 | 부분 체결분에 대한 세금 (원) |
매매구분 | 자동매매 / 수동 등 거래 종류 |
주문시간 | 주문이 접수된 시각 |
💡 지정가 주문 시 원하는 가격에 매수·매도가 이루어지지 않으면 이 탭에 미체결 상태로 남습니다. 주문 취소는 10.4 주문 취소 방법을 참고하세요.
🗂️ 조건검색식 탭
현재 활성화된 실시간 조건검색식에 편입되거나 이탈한 종목 이력을 실시간으로 표시합니다. 화면은 좌측 목록과 우측 세부내역 두 영역으로 구성되며, 가운데 구분선을 드래그하여 비율을 조절할 수 있습니다.
좌측 — 포착 종목 목록
컬럼명 | 설명 |
일련번호 | 포착 순서 번호 |
조건검색식 이름 | 해당 종목을 포착한 조건검색식 이름 |
종목코드 | 포착된 종목 코드 |
종목명 | 포착된 종목 이름 |
매수/매도 | 편입(매수 신호) 또는 이탈(매도 신호) 구분 |
검색일시 | 조건검색식에 처음 포착된 시각 (HH:mm:ss) |
편입횟수 | 해당 종목이 조건검색식에 편입된 누적 횟수 |
이탈횟수 | 해당 종목이 조건검색식에서 이탈한 누적 횟수 |
우측 — 세부내역
좌측 목록에서 종목을 선택하면 해당 종목의 편입·이탈 세부 기록이 우측에 표시됩니다.
컬럼명 | 설명 |
검색종류 | 실시간 조건 신호의 유형 |
매도/매수 | 편입 또는 이탈 구분 |
생성일 | 해당 이벤트가 발생한 시각 (HH:mm:ss) |
🗂️ 로그 탭
프로그램의 동작 로그를 실시간으로 출력합니다.
🗂️ 시스템 정보 탭
프로그램의 내부 성능 지표를 실시간으로 표시합니다.
실시간 주식 체결 데이터 지연 정보 (최근 100만 건 기준)
WebSocket으로 수신된 실시간 체결 데이터의 처리 지연 시간 분포를 구간별로 표시합니다.
지연 구간 | 의미 |
0 ~ 1,000ms | 정상적인 실시간 처리 범위 |
1,000 ~ 2,000ms | 약간의 지연 발생 — 네트워크 또는 시스템 부하 확인 권장 |
2,000 ~ 5,000ms | 처리 지연 심화 — 자동매매 타이밍에 영향을 줄 수 있음 |
5,000ms 이상 | 심각한 지연 — 네트워크 상태 및 PC 리소스 점검 필요 |
💡 지연 건수가 많거나 5,000ms 이상 구간이 증가하는 경우 17장 시스템 정보 확인을 참고하여 원인을 점검하세요.
상태 표시 영역은 메인 화면 최하단 상태바에 위치하며, 좌측과 우측 두 부분으로 나뉩니다.
[상태 메시지] [👤 아이디] ① ② ③ ④ [후원하기]
좌측 — 상태 메시지
프로그램이 현재 수행 중인 작업 또는 가장 최근의 처리 결과를 텍스트로 표시합니다.
표시 예시 | 의미 |
Ready | 프로그램이 정상 대기 중 (초기 상태) |
로그인 중... | SageLine 서버 인증 처리 중 |
키움 API 연결 중... | 키움 REST API 토큰 발급 요청 중 |
주문 처리 중... | 매수 또는 매도 주문 전송 중 |
오류 메시지 텍스트 | 오류 발생 시 내용 요약 표시 |
우측 — 신호 표시 영역 상세 안내
우측에는 로그인한 계정 정보와 4개의 신호등 원형 아이콘(●) 이 순서대로 표시됩니다.
👤 아이디 표시
[👤] 홍길동
① TR 요청 신호등
● ← TR 요청 신호
키움증권 REST API에 데이터 조회 요청(TR) 이 발생할 때마다 점등됩니다.
상태 | 색상 | 설명 |
대기 | ⚫ 회색 (DimGray) | TR 요청 없음 |
점등 | 🟢 초록 (Lime) | TR 요청 발생 |
소등 | ⚫ 서서히 회색으로 복귀 (1초) | 요청 완료 후 자동 복귀 |
② 키움 서버 Ping 수신 신호등
● ← Ping 수신 신호
키움 서버가 보내는 WebSocket Ping 메시지를 수신할 때 점등됩니다. WebSocket 연결이 살아있음을 확인하는 심박 신호입니다.
상태 | 색상 | 설명 |
대기 | ⚫ 회색 | Ping 수신 없음 |
점등 | 🟢 초록 | Ping 수신 |
소등 | ⚫ 서서히 회색으로 복귀 (5초) | 자동 복귀 |
③ 실시간 데이터 수신 신호등
● ← 실시간 데이터 수신 신호
WebSocket을 통해 실시간 시세·체결 데이터가 수신될 때마다 점등됩니다.
상태 | 색상 | 설명 |
대기 | ⚫ 회색 | 실시간 데이터 없음 |
점등 | 🟢 초록 | 데이터 수신 |
소등 | ⚫ 매우 빠르게 회색 복귀 (0.3초) | 자동 복귀 |
④ 통신 연결 상태 신호등
● ← 연결 상태 신호 (펄스 애니메이션)
키움 서버와의 WebSocket 상시 연결 상태를 나타냅니다. 1.5초 주기로 색상이 천천히 펄스(점멸)되어 현재 연결 상태를 직관적으로 알 수 있습니다.
연결 상태 | 색상 | 설명 | 조치 방법 |
전체 연결 (AllConnections) | 🟢 초록 (Lime) | 키움 서버 WebSocket 정상 연결 | — (정상 상태) |
일부 연결 (PartialConnections) | 🟠 주황 (Orange) | 여러 연결 채널 중 일부만 연결됨 | 네트워크 상태 점검 |
연결 없음 (NotConnections) | 🔴 빨강 (Red) | WebSocket 연결 전혀 없음 | 아래 조치 방법 참고 |
④ 신호등이 빨간색일 때 점검 순서:
신호등 전체 요약
[👤 아이디] ① ② ③ ④
TR Ping 실시간 연결
요청 수신 데이터 상태
신호 | 점등 조건 | 점등 지속 시간 | 건강한 상태 |
① TR 요청 | 데이터 조회 API 호출 시 | 1초 후 소등 | 조회 시마다 깜빡임 |
② Ping 수신 | 서버 Ping 수신 시 | 5초 후 소등 | 주기적으로 깜빡임 |
③ 실시간 수신 | WebSocket 데이터 수신 시 | 0.3초 후 소등 | 빠르게 빈번히 깜빡임 |
④ 연결 상태 | 항상 표시 (펄스 반복) | 상시 펄스 | 🟢 초록 펄스 |
부엉이 ATS 은 Material Design 기반의 테마 엔진을 사용하며, 메뉴바의 [테마] 메뉴에서 화면 전체의 색상을 즉시 변경할 수 있습니다.
배경 테마 전환
배경색과 전체 색조를 변경합니다.
메뉴 항목 | 결과 | 추천 사용 환경 |
Light Theme | 흰색 배경, 어두운 텍스트의 밝은 화면 | 낮 시간, 밝은 환경 |
Dark Theme | 어두운 배경, 밝은 텍스트의 다크 화면 | 야간 모니터링, 어두운 환경 |
변경 방법:
포인트 컬러 변경
메뉴, 버튼, 탭 등 강조 색상(포인트 컬러)을 변경합니다. 배경 테마(Light/Dark)와 독립적으로 적용됩니다.
메뉴 항목 | 색상 | RGB 값 |
Primary : Blue | 🔵 인디고 블루 | RGB(58, 80, 178) |
Primary : Green | 🟢 초록 | RGB(0, 128, 0) |
Primary : Orange | 🟠 진한 주황 | DarkOrange |
변경 방법:
테마 조합 예시
조합 | 분위기 |
Light Theme + Blue | 기본 설정, 깔끔하고 전문적인 느낌 |
Dark Theme + Blue | 야간 모니터링에 적합, 눈의 피로 최소화 |
Dark Theme + Green | 주식 거래 특유의 트레이딩 화면 분위기 |
Light Theme + Orange | 따뜻하고 활동적인 느낌 |
⚠️ 주의: 현재 선택한 테마 설정은 프로그램 재시작 시 초기화됩니다. 매번 원하는 테마를 다시 선택하거나, 향후 업데이트를 통해 설정 저장 기능이 추가될 예정입니다.
자동 매매 전략은 사용자가 사전에 정의한 규칙에 따라 종목 선정 → 매수 → 매도의 전 과정을 프로그램이 스스로 수행하도록 하는 '투자 알고리즘 묶음'입니다. 전략을 한 번 설정해 두면, 장중에 사용자가 PC 앞에 없어도 프로그램이 실시간으로 시장을 감시하며 조건 충족 시 즉시 주문을 실행합니다.

부엉이 ATS 의 자동 매매는 매매 전략(TradeStrategy) 과 그 하위의 주문 전략(OrderStrategy) 으로 나뉘어 있습니다.
매매 전략 (TradeStrategy) ← "무엇을 어떤 계좌로 거래하는가?"
├── 주문 전략 1 (OrderStrategy) ← "매수: 어떤 조건에서 얼마나 살 것인가?"
├── 주문 전략 2 (OrderStrategy) ← "매도: 어떤 조건에서 얼마나 팔 것인가?"
└── 거래 제외 조건 ← "어떤 종목은 거래하지 않을 것인가?"
매매 전략은 거래의 전체 틀을 정의합니다.
설정 항목 | 설명 |
전략 이름 | 전략을 구분하는 이름 |
연결 계좌 | 이 전략이 주문을 전송할 증권 계좌 |
종목 선정 방식 | 어떻게 거래 대상 종목을 고를 것인지 (아래 별도 설명) |
보유 종목 수 제한 | 이 전략이 동시에 보유할 수 있는 최대 종목 수 |
당일 동일 종목 재매수 제한 | 오늘 이미 매도한 종목을 다시 매수하지 않도록 제한 |
자동 거래 시간대 | 자동 매수·매도가 실행될 허용 시간 구간 (A/B 2개 구간 설정 가능) |
지정 일시 자동 완료 | 설정한 시각이 되면 전략 실행을 자동으로 종료 |
지정 일시 일괄 매도 | 설정한 시각이 되면 보유 종목을 일괄 매도 |
주문 전략은 하나의 매수 또는 매도 규칙을 나타냅니다. 하나의 매매 전략 안에 여러 개의 주문 전략을 추가할 수 있으며, 각각 독립적으로 동작합니다.
설정 항목 | 설명 |
준비 조건 | 주문을 '대기' 상태로 만들기 위한 선행 조건 (키움 조건검색식 또는 조건 표현식) |
실행 조건 | 준비 조건이 충족된 이후 실제 주문을 전송하기 위한 최종 조건 |
매수/매도 구분 | 이 주문 전략이 매수인지 매도인지 |
주문 유형 | 시장가, 지정가 등 주문 방식 |
호가 기준 틱 조정 | 현재가 기준으로 ±N 틱 떨어진 가격에 지정가 주문 전송 |
주문 금액 표현식 | 이 주문에 사용할 금액을 수식으로 정의 (고정 금액, 비율, 잔고 연동 등) |
실행 주기 | 조건 충족 시 1회만 실행할지, 반복 실행할지 |
매매 전략이 어떤 종목을 감시하고 거래할지를 결정하는 방식입니다.
방식 | 설명 |
키움 조건검색식 | 키움증권 HTS에서 작성한 조건검색식을 기반으로 종목을 자동 선정합니다. 조건에 '포착'되거나 '편입'된 종목을 거래 대상으로 삼습니다. |
단일 종목 | 사용자가 직접 특정 종목 코드를 지정합니다. 해당 종목만 감시하고 거래합니다. |
사용자 정의 | 별도 제작 |
조건 표현식이란?
주문 전략의 준비/실행 조건에는 조건 표현식을 사용할 수 있습니다. 조건 표현식은 현재가, 등락률, 거래량, 이동평균 등 다양한 시세 데이터를 수식으로 조합하여 사용자 고유의 매매 기준을 정밀하게 표현하는 기능입니다.
예) A: 현재가 > 전일종가 * 1.03 → "전일 종가 대비 3% 이상 상승했을 때"
조건 표현식은 별도의 조건 표현식 편집기에서 작성하고 저장하며, 여러 전략에 재사용할 수 있습니다.
[전략 시작]
↓
종목 선정 방식에 따라 감시 대상 종목 결정
↓
실시간 시세 수신 (체결가, 호가 등)
↓
주문 전략의 준비 조건 충족 여부 확인
↓ (충족 시)
주문 전략의 실행 조건 충족 여부 확인
↓ (충족 시)
거래 제외 조건 검사 (해당 종목이 제외 대상인지 확인)
↓ (제외 아닌 경우)
보유 수 제한, 재매수 제한, 일일 한도 검사
↓ (통과 시)
주문 금액 계산 → 주문 전송 (매수 또는 매도)
↓
체결 결과 수신 및 포지션 업데이트
↓
지정 시각이 되면 일괄 매도 또는 전략 자동 완료
여러 전략 동시 운영
부엉이 ATS 은 복수의 매매 전략을 동시에 실행할 수 있습니다. 각 전략은 서로 다른 계좌, 다른 종목, 다른 시간대로 독립적으로 구성하고 실행할 수 있습니다.
예를 들어 아래와 같이 구성하는 것도 가능합니다:
각 전략의 ON/OFF는 자동 매매 스위치 대시보드에서 개별적으로 제어할 수 있습니다.
메인 메뉴에서 [자동매매] → [자동매매 편집기] 를 클릭하면 자동매매 편집기 창이 열립니다. 창의 왼쪽 패널에 현재 등록된 모든 매매 전략 목록이 표시됩니다.

매매 전략 목록은 등록된 전략을 한 행씩 나열하며, 각 행에는 다음 정보가 표시됩니다.
항목 | 설명 |
전략 이름 | 사용자가 부여한 매매 전략의 명칭 |
계좌번호 | 해당 전략이 연동된 거래 계좌 |
종목 선정 방식 | 키움조건검색식 / 단일종목 / 사용자정의 중 하나 |
사용 여부 | 사용중 / 사용중지 |
실행 여부 | 실행중 / 실행중지 |
상태 | 정상 / 오류 |
각 전략 행의 상태 열에는 현재 전략의 이상 여부가 표시됩니다.
⚠️ 주의: 오류 상태의 전략은 자동매매가 동작하지 않습니다. 원인을 파악하려면 해당 전략을 선택한 뒤 내용을 확인하고 오류를 수정한 후 저장하십시오.
사용 여부 및 실행 여부 열을 통해 각 전략이 현재 동작 중인지 확인할 수 있습니다.
⚠️ 주의: 실행중 상태인 전략을 수정하면 예상치 못한 오류나 누락 거래가 발생할 수 있습니다. 전략 수정 전 반드시 해당 전략의 실행을 중지한 후 수정하는 것을 권장합니다.
목록에서 전략 항목을 클릭하면 오른쪽 패널에 해당 전략의 상세 설정 내용이 표시됩니다.
확인할 수 있는 정보:
전략 목록 위에서 마우스 우클릭하면 컨텍스트 메뉴가 나타납니다.
메뉴 항목 | 설명 |
새로 만들기 | 빈 매매 전략을 새로 생성합니다. 기본 이름 "새 자동매매"로 생성되며 목록 맨 아래에 추가됩니다. |
삭제 | 현재 선택된 전략을 삭제합니다. 진행 중인 주문이 있는 경우 확인 메시지가 표시됩니다. |
가져오기 | 외부 JSON 파일에서 매매 전략을 불러옵니다. 가져오기 전 계좌를 선택해야 합니다. |
내보내기 | 선택된 전략을 JSON 파일로 저장합니다. 다른 PC나 계정에 전략을 공유할 때 사용합니다. |
⚠️ 삭제 시 주의: 전략에 종속된 매매 이력(주문, 체결 내역)이 존재하는 경우 함께 삭제됩니다. 삭제 전 반드시 확인 메시지를 읽어보십시오.
⚠️ 가져오기 시 주의: 외부에서 가져오는 전략에 키움 조건검색식이 포함된 경우, 해당 조건검색식 이름이 내 영웅문 HTS에 동일하게 등록되어 있어야 합니다.
목록 오른쪽 하단의 ▲ / ▼ 버튼을 사용하여 전략의 실행 우선 순서를 변경할 수 있습니다.
변경된 순서는 즉시 데이터베이스에 저장되며, 다음에 화면을 열어도 유지됩니다.
💡 가장 위에 있는 전략이 선택 상태일 때는 ▲ 버튼이 비활성화됩니다. 목록 맨 아래 전략은 ▼ 버튼이 비활성화됩니다.
항목 | 제한 |
최대 전략 수 | 전략 유형별 최대 30개까지 생성 가능합니다. 30개 초과 시 생성 오류 메시지가 표시됩니다. |
계좌 유효성 | 전략에 연결된 계좌번호가 현재 등록된 앱키에 존재하지 않으면, 해당 전략은 오류 상태(빨간색) 로 표시되고 자동 실행이 중지됩니다. |
.8
목록에서 전략 이름이 빨간색으로 표시되면 다음을 확인하십시오.
화면 위치
자동매매 만들기 창에서 왼쪽 전략 목록의 항목을 선택하면, 오른쪽 패널 상단에 전략의 기본 설정 영역이 표시됩니다. 이 영역은 크게 ① 이름, ② 기본 설정, ③ 자동 실행 시간대 세 부분으로 구성됩니다.

① 전략 이름 설정
항목 | 설명 |
이름 | 이 전략을 식별하는 고유한 이름을 입력합니다. |
💡 전략 목적이 명확히 드러나는 이름을 사용하면 여러 전략을 관리할 때 편리합니다. 예) 갭 상승 편입 매매, 오전 단기 모멘텀, AI 특징주 오후
② 기본 설정
계좌번호
항목 | 설명 |
계좌번호 | 이 전략의 주문이 전송될 증권 계좌를 드롭다운 목록에서 선택합니다. |
⚠️ 계좌 변경 시 주의: 이미 진행 중인 주문이나 매매 이력이 있는 전략의 계좌번호를 변경하면 예상치 못한 문제가 발생할 수 있습니다. 변경 시 경고 메시지를 반드시 확인하십시오.
최초 매수 방법 (키움 조건검색식 전략 전용)
선택값 | 설명 |
포착 | 키움 HTS에서 조건검색식을 직접 조회하는 시점에 해당 종목을 매수 대상으로 등록합니다. |
편입 | 실시간 조건검색식 모니터링 중 종목이 조건에 새로 편입되는 순간을 감지하여 매수 대상으로 등록합니다. |
💡 일반적으로 편입은 조건에 방금 부합한 종목을 즉시 포착하므로 단기 매매에 적합합니다. 포착은 설정된 시간에 조건을 만족하는 모든 종목을 한 번에 조회합니다.
항목 | 설명 |
기본 매수 금액 | 주문 전략에서 금액 표현식이 참조하는 기준 금액(원)입니다. |
⚠️ 이 금액이 곧 1회 주문 금액이 되는 것은 아닙니다. 실제 주문 금액은 주문 전략에 설정된 금액 표현식의 계산 결과에 따라 결정되며, 이 기본 매수 금액은 표현식 내에서 변수로 활용될 수 있습니다. (→ 5.3.5 주문 금액 설정 참고)
전략이 자동으로 매매를 실행할 수 있는 허용 시간 구간을 설정합니다. 각 항목은 체크박스로 활성화/비활성화를 제어하며, 비활성화된 항목은 시간 제한 없이 동작합니다.
전략 전체의 자동 매수·매도가 실행될 수 있는 시간대를 설정합니다.
항목 | 설명 |
자동 실행 시간 (A) | 1차 허용 시간 구간. 체크박스로 활성화 후 시작 ~ 종료 시간을 입력합니다. |
자동 실행 시간 (B) | 2차 허용 시간 구간. A 구간 외 추가 시간대가 필요할 때 사용합니다. |
예) 오전 9:0010:30 / 오후 14:0015:00 두 시간대만 거래하고 싶은 경우 A와 B를 각각 설정합니다.
자동 매수 실행 시간 (A/B)
매수 주문만 허용할 시간 구간을 별도로 지정합니다.
항목 | 설명 |
자동 매수 실행 시간 (A) | 1차 매수 허용 시간 구간 |
자동 매수 실행 시간 (B) | 2차 매수 허용 시간 구간 |
💡 자동 실행 시간과 자동 매수 실행 시간이 모두 설정된 경우, 매수 주문은 두 조건을 모두 만족하는 시간대에만 실행됩니다.
자동 매도 실행 시간 (A/B)
매도 주문만 허용할 시간 구간을 별도로 지정합니다.
항목 | 설명 |
자동 매도 실행 시간 (A) | 1차 매도 허용 시간 구간 |
자동 매도 실행 시간 (B) | 2차 매도 허용 시간 구간 |
설정한 일시가 되면 전략의 실행을 자동으로 종료합니다.
항목 | 설명 |
활성화 체크박스 | 체크 시 자동 완료 기능이 활성화됩니다. |
완료 일자 기준 | 드롭다운에서 선택: 당일 / 익일 / 2일 후 / 3일 후 / 4일 후 / 5일 후 |
완료 시간 | 완료 처리가 실행될 시각을 입력합니다. |
예) "익일 15:30" 설정 → 매매 작업이 생성된 다음 날 오후 3시 30분에 전략 실행이 자동으로 종료됩니다.
설정한 일시에 이 전략이 보유한 모든 종목을 일괄 매도합니다.
항목 | 설명 |
활성화 체크박스 | 체크 시 일괄 매도 기능이 활성화됩니다. |
일괄 매도 일자 | 매매 작업 생성 시점 기준으로 N일 후에 실행합니다. (직접 숫자 입력) |
일괄 매도 시간 | 일괄 매도 주문을 전송할 시각을 입력합니다. |
주문유형 | 지정가 또는 시장가 중 선택합니다. |
틱 조정 | 지정가 선택 시, 현재가 기준으로 ±N 틱 조정된 가격으로 주문합니다. (예: -5틱) |
⚠️ 일괄 매도와 자동 완료 함께 사용 시: 일괄 매도 시각보다 자동 완료 시각이 빠르면 매도 전에 전략이 종료될 수 있습니다. 두 시각의 순서를 반드시 확인하십시오.
저장 방법
모든 설정 입력이 완료되면 화면 우측 하단의 [저장] 버튼을 클릭합니다.
💡 저장하지 않고 창을 닫으면 변경 내용이 사라집니다. 수정 후 반드시 저장 버튼을 클릭하십시오.
자동 매매 전략이 어떤 종목을 대상으로 매매를 실행할지를 결정하는 핵심 설정입니다. 부엉이 ATS 는 2가지 종목 선정 방식을 제공하며, 각 방식은 독립된 전략 편집 창으로 구분됩니다.
종목 선정 방식 | 진입 메뉴 | 특징 |
키움 조건검색식 기반 | 자동매매 만들기 (키움 조건검색식) | HTS 조건검색식에 부합하는 종목을 자동 포착·편입 |
사용자 지정 종목 | 자동매매 만들기 (단일종목) | 사용자가 직접 특정 종목 1개를 지정 |
개요
키움증권 HTS(영웅문)에서 사용자가 직접 작성·저장한 키움 조건검색식을 사용하여 매매 대상 종목을 자동으로 선정합니다. 조건검색식에 해당하는 종목이 감지되는 순간 전략이 반응하여 주문 조건 평가를 시작합니다.
포착과 편입의 차이
이 방식에서는 조건검색식을 종목에 적용하는 시점을 포착과 편입 중 하나로 선택합니다.
구분 | 설명 | 적합한 상황 |
포착 (Search) | 설정된 주기로 조건검색식을 직접 조회하여, 조건에 부합하는 종목 전체를 한 번에 가져옵니다. | 일정 시간마다 조건을 만족하는 종목 목록 전체를 스캔할 때 |
편입 (Inclusion) | 실시간 모니터링 중 새로운 종목이 조건검색식에 진입(I) 하는 순간을 즉시 포착합니다. | 조건에 방금 부합한 신규 진입 종목만 대상으로 할 때 (단기 매매에 권장) |
💡 편입 방식은 조건검색식 이탈 신호는 처리하지 않으며, 새로 편입되는 종목만 추적합니다.
동작 흐름 (편입 방식 기준)
키움 API → 실시간 조건검색식 편입 신호 수신
↓
전략에 설정된 조건검색식 이름과 수신된 신호 비교
↓ (일치 시)
해당 종목에 대한 매매 전략 작업(Job) 자동 생성
↓
주문 전략의 준비 조건 / 실행 조건 평가 시작
↓
조건 충족 시 매수/매도 주문 전송
사용 전 필수 확인 사항
개요
사용자가 거래할 종목을 직접 1개 지정하는 방식입니다. 해당 종목만 지속적으로 감시하며, 주문 전략의 조건이 충족될 때 매수·매도 주문을 전송합니다.
종목 선택 방법
⚠️ 단일 종목 방식에서는 보유 종목 수 제한과 동일 종목 재매수 제한 옵션이 이 1개 종목에 대해서만 적용됩니다.
💡 단일 종목 방식은 특정 종목에 집중하여 세밀한 조건을 걸어두고 싶을 때 적합합니다. 예) 항상 삼성전자만 거래하는 전용 전략을 만들 때.
매수 조건 설정은 주문 전략 편집기에서 이루어집니다. 하나의 주문 전략은 준비 조건과 실행 조건 두 단계로 구성되며, 두 조건이 순서대로 충족될 때 매수 주문이 전송됩니다.
[준비 조건 충족] → [실행 조건 충족] → 매수 주문 전송
전략 목록 화면 오른쪽의 매매 전략 상세 영역에서:
클릭하면 "주문전략상세 편집" 창이 열립니다.

① 매수/매도 구분
창 상단 좌측에서 이 주문 전략이 매수인지 매도인지를 선택합니다.
선택값 | 설명 |
최초매수 | 이 종목에 대해 처음으로 실행하는 매수 주문입니다. 보유 수량이 0인 상태에서만 실행됩니다. |
매수 | 이미 최초매수가 체결된 이후 추가로 매수하는 주문입니다. 최초 매수가 체결되지 않은 상태에서는 실행되지 않습니다. |
매도 | 보유 종목을 매도하는 주문입니다. (→ 11.3.4 참고) |
💡 매수 전략 구성 예시: 최초매수 1개 + 추가매수(매수) 1개를 함께 설정하면, 최초 진입 후 조건 충족 시 물타기/분할 매수가 가능합니다.
② 주문유형 및 틱 조정
항목 | 선택값 | 설명 |
주문유형 | 시장가 | 현재 시장 가격으로 즉시 체결을 시도합니다. NXT는 프리마켓, 애프터마켓에서 시장가 주문이 안되므로, 되도록 현재가를 사용하시기 바랍니다. |
현재가 | 현재가 기준 ±N 틱 조정된 가격으로 지정가 주문을 전송합니다. 틱 조정 콤보박스가 함께 표시됩니다. | |
시간외단일가 | 시간외 단일가 주문으로 전송합니다. 틱 조정 콤보박스가 함께 표시됩니다. | |
틱 조정 | +50틱 ~ -50틱 | 현재가에서 지정한 틱 수만큼 위/아래 가격으로 주문합니다. 0틱이면 현재가 그대로 지정가 주문합니다. |
③ 실행주기
조건이 충족될 때 이 주문 전략을 몇 번 실행할지를 결정합니다.
선택값 | 설명 |
1회 (Single) | 조건이 충족되면 1번만 주문을 전송합니다. |
매일 (Daily) | 매 거래일마다 조건이 충족되면 반복적으로 주문을 전송합니다. |
④ 준비 조건 설정
준비 조건은 매수 주문을 전송하기 전에 먼저 충족되어야 하는 선행 조건입니다. 우측 상단의 [사용] 토글로 활성화/비활성화할 수 있습니다.
조건 타입 선택
타입 | 설명 |
시스템조건식 | 사용자가 직접 작성한 수식 조건을 사용합니다. (조건 표현식 편집기에서 작성) |
키움 조건검색식 | 키움 HTS의 조건검색식이 신호를 발생시키는 시점을 준비 조건으로 사용합니다. |
사용자 정의 | 별도 제작 전략 |
[시스템조건식] 선택 시
항목 | 설명 |
그룹명 | 시스템조건식을 그룹 단위로 필터링합니다. |
준비조건 | 미리 저장된 시스템조건식 목록에서 선택합니다. |
시스템조건식 상세 | 선택된 시스템조건식의 각 줄(Unit)이 표로 표시됩니다. (ID, 좌항, 비교, 우항) |
시스템조건식 조합 | 각 Unit의 AND/OR 논리 조합 방식이 표시됩니다. (예: A AND B OR C) |
사용자 정의 옵션 | 추가적으로 체결강도, 호가 조건 등 내장 조건을 체크하여 보조 조건으로 추가할 수 있습니다. |
[키움 조건검색식] 선택 시
항목 | 설명 |
준비조건 | HTS에 등록된 조건검색식 목록에서 선택합니다. |
편입 | 종목이 조건에 신규 편입되는 순간을 준비 조건 충족으로 처리합니다. |
포착 | 지정한 시각에 조건을 만족하는 종목을 조회하여 준비 조건 충족으로 처리합니다. 시각 선택기가 추가로 표시됩니다. |
⑤ 실행 조건 설정
실행 조건은 준비 조건이 충족된 이후에 실제 매수 주문을 전송하기 위한 최종 확인 조건입니다. 준비 조건과 동일한 구조(시스템조건식 / 키움 조건검색식 / 사용자 정의)로 설정합니다.
💡 준비 조건과 실행 조건을 서로 다른 조건검색식으로 구성하는 것도 가능합니다. 예) 준비: A 조건검색식 편입 → 실행: B 조건검색식 편입
💡 [사용] 토글을 비활성화하면 준비 또는 실행 조건을 건너뛰고 나머지 조건만으로 주문이 실행됩니다.
[시스템조건식 만들기 (준비, 실행)] 버튼을 클릭하면 "시스템조건식 만들기" 창이 열립니다. 이 편집기에서 준비·실행 조건에서 사용할 시스템조건식을 직접 작성하고 저장합니다.
편집기 화면 구성
비교연산자 종류
연산자 | 의미 |
< | 좌항이 우항보다 작다 |
<= | 좌항이 우항보다 작거나 같다 |
== | 좌항과 우항이 같다 |
>= | 좌항이 우항보다 크거나 같다 |
> | 좌항이 우항보다 크다 |
!= | 좌항과 우항이 다르다 |
피연산자는 탭별로 분류되어 있으며, 항목 옆의 [L] 버튼은 좌항에, [R] 버튼은 우항에 자동 입력됩니다.
📌 실시간 주식 정보 탭
피연산자 | 설명 |
현재가 | 당일 현재 체결가 |
시가 | 당일 시가 |
고가 | 당일 고가 |
저가 | 당일 저가 |
누적거래량 | 당일 누적 거래량 |
누적거래대금 | 당일 누적 거래대금 (단위: 백만원) |
등락률 | 전일 대비 등락률 (단위: %) |
전일거래량대비 | 당일거래량 ÷ 전일거래량 × 100 (단위: %) |
거래회전율 | 거래회전율 (단위: %) |
누적매도체결량 | 당일 누적 매도 체결량 |
누적매수체결량 | 당일 누적 매수 체결량 |
누적매수비율 | 당일 누적 매수 비율 (단위: %) |
순간거래대금 | 순간 거래대금 |
체결강도 | 현재 체결강도 — SOR 기준 (단위: %) |
코스피지수 | 실시간 코스피 지수 |
코스닥지수 | 실시간 코스닥 지수 |
📌 차트 데이터 탭
피연산자 | 설명 |
3분봉시가 | 최근 3분봉 시가 |
3분봉저가 | 최근 3분봉 저가 |
3분봉고가 | 최근 3분봉 고가 |
3분봉거래대금 | 최근 3분봉 거래대금 |
30분봉거래대금 | 최근 30분봉 거래대금 |
익일5일이평선 | 익일 5일 이동평균선 |
코스피지수5MA | 코스피지수 5일 이동평균선 |
코스닥지수5MA | 코스닥지수 5일 이동평균선 |
📌 준비조건 만족 후 탭
준비 조건이 충족된 이후의 가격 변화 정보를 실행 조건에서 활용할 때 사용합니다.
피연산자 | 설명 |
준비후고가 | 준비 조건 충족 이후 가장 높았던 가격 |
준비후저가 | 준비 조건 충족 이후 가장 낮았던 가격 |
준비완료가 | 준비 조건이 충족된 시점의 가격 |
준비완료체결강도 | 준비 조건이 충족된 시점의 체결강도 |
시스템조건식 조합 방법
여러 개의 조건 Unit을 추가한 경우, 각 Unit 간의 논리 관계를 **조합(Combination)**으로 표현합니다.
표현식 예시 | 의미 |
A | Unit A 하나만 충족하면 됩니다. |
A AND B | Unit A와 B 모두 충족해야 합니다. |
A OR B | Unit A 또는 B 중 하나만 충족하면 됩니다. |
(A AND B) OR C | (A와 B 모두 충족) 또는 C가 충족되면 됩니다. |
💡 [다른 시스템조건식 가져오기] 버튼을 사용하면 기존에 저장된 다른 시스템조건식의 Unit을 현재 편집 중인 시스템조건식에 복사해 올 수 있습니다.
예시 1) 현재가가 시가보다 높고, 체결강도가 150 이상일 때 준비 조건 충족
ID | 좌항 | 비교 | 우항 |
A | 현재가 | > | 시가 |
B | 체결강도 | >= | 150 |
→ 조합: A AND B
예시 2) 준비 후 현재가가 준비 완료가 대비 0.5% 하락하면 실행 조건 충족 (손절 매도 조건으로 사용 시)
ID | 좌항 | 비교 | 우항 |
A | 현재가 | <= | 준비완료가 * 0.995 |
→ 조합: A
⑦ 저장 및 적용
⚠️ [확인] 버튼 없이 창을 닫으면 변경된 주문 전략 설정이 저장되지 않습니다. 이후 매매 전략 편집기의 [저장] 버튼을 클릭해야 최종적으로 반영됩니다.
매도 조건 설정은 5.3.3 매수 조건 설정과 동일한 주문 전략 편집기에서 이루어집니다. 편집기 구조(준비 조건 / 실행 조건 / 조건 표현식 편집기)는 매수와 동일하며, 매수/매도 구분을 "매도"로 설정하는 것이 핵심 차이입니다.
매도 주문 전략 생성 방법
💡 하나의 매매 전략에 매수 주문 전략과 매도 주문 전략을 함께 설정해야 자동으로 매수 후 매도까지 이루어집니다. 매도 주문 전략이 없으면 매수한 종목을 자동으로 매도하지 않습니다.
매도 조건과 매수 조건의 주요 차이점
항목 | 매수 | 매도 |
매수/매도 구분 | 최초매수 / 매수 | 매도 |
조건에 활용 가능한 피연산자 | 현재가, 시가 등 시세 데이터 중심 | 최초매수가, 평균매수가, 보유수량 등 보유 포지션 데이터 추가 사용 가능 |
중복 실행 방지 | — | 당일 이미 매도 주문이 존재하면 재실행 차단 |
주문 수량 기준 | 주문 금액 계산식 결과 ÷ 현재가 | 매도 가능 수량 (보유 수량 기준) |
시장가 처리 | 시장가 그대로 전송 | 내부적으로 지정가(하한가)로 변환하여 전송 |
매도 전용 피연산자
매도 시스템조건식에서는 매수 조건에서 사용하는 모든 피연산자에 더해, 아래의 보유 포지션 관련 피연산자를 사용할 수 있습니다.
📌 보유 포지션 탭
피연산자 | 설명 | 활용 예 |
최초매수가 | 이 종목에 최초로 매수 체결된 가격 | 최초 매수가 기준 익절/손절 조건 |
평균매수가 | 분할 매수를 포함한 평균 매수 단가 | 전체 포지션 손익 기준 조건 |
최초매수일 | 최초 매수 체결이 발생한 날짜 (숫자) | 보유 일수 계산 |
현재일 | 오늘 날짜 (숫자) | 최초매수일과 차이로 보유 일수 계산 |
비영업일일수 | 최초 매수일 이후 주말·공휴일 수 | 영업일 기준 보유 일수 계산 |
최초매수체결강도 | 최초 매수 체결 시점의 체결강도 | 매수 시점 대비 강도 변화 추적 |
최초매수후최고체결강도 | 최초 매수 이후 가장 높았던 체결강도 | 모멘텀 고점 이탈 감지 |
최초매수후최소체결강도 | 최초 매수 이후 가장 낮았던 체결강도 | 모멘텀 약화 감지 |
보유수량 | 현재 보유 중인 수량 | 수량 조건 또는 금액 표현식 연동 |
특정가 | 호가창 매매 전략에서 기준가로 사용되는 가격 | 호가창 전략 전용 |
예시 1) 고정 익절 / 손절 매도
목적 | 시스템조건식 설정 |
수익 3% 익절 | 실행: 현재가 >= 최초매수가 * 1.03 |
손실 3% 손절 | 실행: 현재가 <= 최초매수가 * 0.97 |
→ 두 조건을 OR로 결합하거나, 각각 별도 주문 전략(매도)으로 추가합니다.
예시 2) 평균 매수가 기준 손익 매도 (분할 매수 시 활용)
목적 | 시스템조건식 설정 |
평균단가 대비 5% 수익 | 실행: 현재가 >= 평균매수가 * 1.05 |
평균단가 대비 3% 손실 | 실행: 현재가 <= 평균매수가 * 0.97 |
예시 3) 고점 추적 매도 (트레일링 스탑)
준비 조건 충족 이후의 고가를 기준으로 하락 폭이 일정 수준을 넘으면 매도합니다.
단계 | 설정 |
준비 조건 | 실행: 현재가 >= 최초매수가 * 1.02 → 준비 조건 통과 |
실행 조건 | 실행: 현재가 <= 준비후고가 * 0.97 → 고점 대비 -3% 하락 시 매도 |
예시 4) 보유 일수 기준 강제 매도
목적 | 시스템조건식 설정 |
N 영업일 이상 보유 시 매도 | 실행: (현재일 - 최초매수일) - 비영업일일수 >= 3 |
예시 5) 체결강도 약화 매도 (모멘텀 소실 감지)
목적 | 시스템조건식 설정 |
강도 140 미만으로 약화 + 현재가 평균 단가 이상 | 실행 Unit A: 체결강도 < 140, Unit B: 현재가 >= 평균매수가 → 조합: A AND B |
매도 조건 동작 시 내부 처리 규칙
규칙 | 내용 |
당일 중복 매도 방지 | 동일 주문 전략에서 당일 이미 매도 주문을 전송한 경우 추가 매도 주문을 전송하지 않습니다. |
매도 가능 수량 0 차단 | 현재 매도 가능 수량이 0이면 조건을 만족해도 주문을 전송하지 않습니다. |
시장가 → 지정가 변환 | 주문유형을 시장가로 설정해도, 내부적으로는 지정가(하한가)로 변환하여 전송합니다. 이는 키움 API의 안전한 전처리 방식입니다. |
일괄 매도와의 관계
5.3.1 전략 이름 및 계좌 설정에서 지정 일시 일괄 매도를 활성화한 경우, 해당 시각이 되면 매도 주문 전략의 조건 충족 여부와 관계없이 보유 종목 전체를 일괄 매도합니다.
비교 항목 | 시스템조건식 기반 매도 | 지정 일시 일괄 매도 |
실행 기준 | 조건 충족 시 | 설정된 일시 도달 시 |
대상 | 조건을 만족하는 경우만 | 보유 전 종목 무조건 |
설정 위치 | 주문 전략 편집기 | 전략 기본 설정 (5.3.1) |
⚠️ 일괄 매도와 시스템조건식 매도가 동시에 활성화된 경우, 시스템조건식 매도가 먼저 체결될 수 있습니다. 일괄 매도 시각 이전에 이미 시스템조건식으로 매도되면 일괄 매도는 보유 수량이 없어 실행되지 않습니다.
매도 주문 전략 저장 흐름
편집기에서 조건 설정 완료
↓
[확인] 버튼 클릭
↓
매매 전략 상세 목록에 "매도" 행 추가 확인
↓
자동매매 만들기 화면의 [저장] 버튼 클릭
↓
데이터베이스에 최종 저장
↓
자동 매매 실행 시 매도 조건 감시 시작
주문 금액 설정은 자동 매매 시 실제로 얼마어치 주문을 낼지를 수식(계산식)으로 정의하는 기능입니다. 단순히 고정 금액을 입력하는 대신, "기본주문금액 × 2", "기본주문금액 / 보유수량" 과 같이 변수와 연산자를 조합한 표현식을 만들어 유연하게 주문 금액을 제어할 수 있습니다.
정의된 계산식은 금액 표현식 편집기를 통해 생성·수정·삭제하며, 이후 매매 전략의 주문 전략 설정 항목에서 원하는 계산식을 선택하여 전략에 연결합니다.
매매 전략 편집기의 "주문 전략 설정" 탭에서 [주문금액식 만들기] 버튼을 클릭하면 별도 창(주문금액식 만들기)이 열립니다.
편집기 화면 구성

편집기 창은 좌우 두 영역으로 나뉩니다.
영역 | 설명 |
왼쪽 – 계산식 목록 | 저장된 주문 금액 계산식 목록이 표시됩니다. 용도(매수/매도) 및 이름을 확인할 수 있습니다. |
오른쪽 – 계산식 편집 | 선택된 계산식의 상세 내용(용도, 이름, 수식)을 편집합니다. |
계산식 목록 (왼쪽 패널)
계산식 편집 (오른쪽 패널)
① 용도 선택
선택지 | 설명 |
매수 | 매수 주문 시 이 계산식이 사용됩니다. |
매도 | 매도 주문 시 이 계산식이 사용됩니다. |
계산식마다 용도를 별도로 지정할 수 있으므로, 매수용 계산식과 매도용 계산식을 각각 따로 만들어 관리할 수 있습니다.
② 이름 입력
계산식의 이름을 자유롭게 입력합니다. 목록에서 식별할 수 있는 직관적인 이름을 권장합니다. (예: 기본 2배 매수, 추가매수용, 전량 매도)
③ 수식 구성 (계산식 빌더)
수식은 좌변 피연산자 + 연산자 + 우변 숫자 3가지 요소로 구성됩니다.
[ 좌변 피연산자 ] [ 연산자 ] [ 우변 숫자 ]
기본주문금액 * 1
좌변 피연산자 (변수)
드롭다운에서 선택합니다.
변수명 | 설명 |
기본주문금액 | 환경 설정에서 지정한 1회 주문의 기준 금액입니다. |
보유수량 | 현재 해당 종목의 보유 주식 수량입니다. 추가 매수 시 물타기/불타기 금액 계산 등에 활용할 수 있습니다. |
연산자
드롭다운에서 선택합니다.
기호 | 의미 |
+ | 덧셈 |
- | 뺄셈 |
* | 곱셈 |
/ | 나눗셈 |
우변 숫자
직접 숫자를 입력합니다. 소수점 숫자도 입력 가능합니다 (예: 0.5, 2, 1.5).
수식 | 의미 |
기본주문금액 * 1 | 기본 주문 금액 그대로 주문 (기본값) |
기본주문금액 * 2 | 기본 주문 금액의 2배로 주문 |
기본주문금액 / 2 | 기본 주문 금액의 절반으로 주문 |
기본주문금액 * 0.5 | 기본 주문 금액의 50%로 주문 |
보유수량 * 1 | 현재 보유수량을 기준으로 주문 수량 계산 |
참고: 기본주문금액의 기준값은 환경 설정(TradingConfig)의 일일 최대 매수 금액 및 주문 전략 설정과 연동되어 결정됩니다.
저장 및 삭제
편집기에서 계산식을 저장한 후, 주문 전략 설정 화면의 주문금액 표현식 드롭다운에서 원하는 계산식을 선택하면 해당 전략에 적용됩니다. 선택된 계산식의 이름과 수식 내용이 화면에 함께 표시되어 확인할 수 있습니다.
주의사항
개요
주문 전략은 자동 매매에서 실제 주문을 어떻게 실행할지 정의하는 규칙 단위입니다. 하나의 매매 전략에는 여러 개의 주문 전략을 등록할 수 있으며, 각 주문 전략은 "어떤 조건이 되면 / 어떤 유형으로 / 얼마에 / 주문한다" 는 흐름으로 구성됩니다.
주문전략상세 편집 창은 이 흐름의 모든 항목을 설정하는 화면입니다.
화면 열기
매매 전략 편집 화면의 주문 전략 탭에서 전략 항목을 더블 클릭하거나, 추가 버튼으로 새 주문 전략을 생성하면 주문전략상세 편집 창이 열립니다.
화면 구성 요약

① 매수/매도 구분
주문의 성격을 지정합니다.
선택값 | 설명 |
최초매수 | 해당 종목을 처음 매수할 때 실행되는 주문 전략입니다. 보유 수량이 0인 상태에서만 동작합니다. |
매수 | 이미 보유 중인 종목에 대한 추가 매수 주문입니다. |
매도 | 보유 종목을 매도할 때 실행되는 주문 전략입니다. |
💡 최초매수와 매수를 각각 별도의 주문 전략으로 구성하면 분할 매수 전략을 구현할 수 있습니다.
② 주문유형 (거래 구분)
실제 주문을 어떤 방식으로 제출할지 지정합니다.
선택값 | 설명 |
시장가 | 현재 시장의 최우선 호가로 즉시 체결합니다. 빠른 체결이 필요한 경우 사용합니다. |
현재가 | 현재가 기준으로 지정 틱만큼 조정한 가격으로 지정가 주문합니다. 호가 기준 틱 설정이 함께 표시됩니다. |
시간외단일가 | 장 마감 후 시간외 단일가로 주문합니다. 틱 설정이 함께 표시됩니다. |
③ 호가 기준 틱 설정 (TickGap)
주문유형이 현재가 또는 시간외단일가인 경우에만 표시됩니다.
현재가를 기준으로 몇 틱 위/아래 가격으로 지정가 주문할지를 설정합니다.
설정 예시 | 의미 |
+1틱 | 현재가보다 1틱 높은 가격으로 주문 (매수 시 빠른 체결 유도) |
0틱 | 현재가와 동일한 가격으로 주문 |
-1틱 | 현재가보다 1틱 낮은 가격으로 주문 (매수 시 더 낮은 가격 노림) |
+50틱 ~ -50틱 | 최대 ±50틱 범위 내에서 선택 가능 |
💡 매수 주문 시: 틱을 높게 설정할수록 체결 가능성이 높아지지만 불리한 가격으로 체결될 수 있습니다. 💡 매도 주문 시: 틱을 낮게 설정할수록 빠른 매도가 가능하지만 더 낮은 가격에 체결될 수 있습니다.
④ 실행주기
해당 주문 전략을 조건 충족 시 몇 번 실행할지 설정합니다.
선택값 | 설명 |
1회 | 조건 충족 시 1회만 주문을 실행합니다. 이후 동일 신호가 발생해도 재실행하지 않습니다. |
매일 | 매 거래일 조건 충족 시마다 주문을 실행합니다. 반복 매수/매도 전략에 사용합니다. |
⑤ 준비조건

주문 실행 전 사전 확인용 조건입니다.
준비조건이 충족된 경우에만 실행조건 평가로 넘어갑니다.
오른쪽 상단의 사용 토글 버튼으로 준비조건 사용 여부를 활성화/비활성화할 수 있습니다.
준비조건 유형은 세 가지 중 하나를 선택합니다.
시스템조건식
시스템조건식 만들기 (준비, 실행) 버튼에서 미리 만들어 둔 시스템조건식을 적용합니다.
항목 | 설명 |
그룹명 | 시스템조건식이 속한 그룹을 선택합니다. |
준비조건 | 해당 그룹에 속한 시스템조건식 목록에서 하나를 선택합니다. |
시스템조건식 상세 | 선택된 시스템조건식의 세부 내용(좌항 / 비교 / 우항)이 하단에 표시됩니다. |
조합 | 시스템조건식 항목들의 논리 조합 표현식이 하단에 표시됩니다. |
사용자 정의 옵션 | 추가적으로 적용할 사용자 정의 조건 항목 목록이 표시됩니다. 체크박스로 사용 여부를 선택합니다. |
키움 조건검색식
키움증권 HTS에서 저장한 조건검색식을 그대로 활용합니다.
항목 | 설명 |
준비조건 | 키움 조건검색식 목록에서 사용할 검색식을 선택합니다. |
편입 | 해당 종목이 조건검색식 결과에 편입되어 있을 때 조건 충족으로 판단합니다. |
포착 | 특정 시간에 조건검색식을 실행하여 결과에 포함될 때 조건 충족으로 판단합니다. 포착 선택 시 검색 시간 입력란이 함께 표시됩니다. |
사용자 정의
코드로 구현된 커스텀 전략 로직을 준비조건으로 사용합니다. 드롭다운에서 사용 가능한 사용자 정의 전략을 선택합니다.
⑥ 실행조건

주문을 실제로 실행할 조건입니다.
준비조건이 활성화된 경우, 준비조건을 통과한 후 실행조건이 평가됩니다.
설정 방식은 준비조건과 동일하게 시스템조건식 / 키움 조건검색식 / 사용자 정의 세 가지 중 선택합니다.
⚠️ 실행조건은 항상 활성 상태이며, 비활성화 토글이 없습니다.
⑦ 주문금액 계산식

이 주문 전략에서 사용할 주문 금액 계산식을 선택합니다.
항목 | 설명 |
주문금액 계산식 | 드롭다운에서 금액 표현식 편집기에서 미리 만들어 둔 계산식을 선택합니다. |
수식 표시줄 | 선택된 계산식의 실제 수식 내용이 하단에 표시됩니다. 예) 기본주문금액 * 2 |
💡 새로운 계산식을 만들려면 오른쪽 상단의 "주문 금액 계산식 만들기" 버튼을 클릭합니다. (→ 5.3.5 금액 표현식 편집기 참조)
예시: "RSI 과매도 구간 진입 시 현재가+1틱으로 최초매수, 1회 실행"
항목 | 설정값 |
매수/매도 | 최초매수 |
주문유형 | 현재가 |
호가 기준 틱 | +1틱 |
실행주기 | 1회 |
준비조건 | 사용 안 함 (토글 OFF) |
실행조건 | 키움 조건검색식 → RSI_과매도 조건식 선택 |
주문금액 계산식 | 기본주문금액 * 1 |
저장 및 닫기
버튼 | 동작 |
확인 | 설정 내용을 저장하고 편집 창을 닫습니다. |
취소 | 변경 내용을 저장하지 않고 편집 창을 닫습니다. |
거래 제외 종목 기준 설정은 자동 매매 실행 시 특정 속성을 가진 종목은 처음부터 매매 대상에서 제외하는 필터 기능입니다.
예를 들어 조건검색식에 의해 종목이 편입되더라도, 해당 종목이 "투자경고" 상태이거나 "ETF" 종목이거나 특정 업종에 속하는 경우라면 자동으로 걸러내어 주문이 나가지 않도록 차단합니다.
이 설정은 매매 전략 단위로 독립적으로 관리되며, 전략마다 서로 다른 제외 기준을 적용할 수 있습니다.
설정 화면 열기
자동 매매 편집기에서 전략을 선택한 후 [매매 제외 카테고리 수정] 버튼을 클릭하면 "매매 종목 필터" 창이 열립니다.
창 상단에 "매매 종목 필터 (제외 할 카테고리를 선택하세요)" 라는 안내 문구가 표시됩니다.
화면 구성
필터 창은 총 7개의 카테고리 열로 나뉘어 있으며, 각 항목 옆의 체크박스를 체크하면 해당 속성의 종목이 거래에서 제외됩니다.

카테고리별 항목 상세
① 거래소
종목이 상장된 거래소를 기준으로 제외합니다.
항목 | 설명 |
KRX | 한국거래소(유가증권·코스닥·코넥스) 상장 종목 |
NXT | NXT(넥스트레이드) 거래 종목 |
💡 특정 거래소 종목을 완전히 배제하고 싶을 때 사용합니다.
② 감리구분
키움증권에서 제공하는 종목의 감리 상태를 기준으로 제외합니다.
항목 | 설명 |
정상 | 감리 이슈가 없는 일반 종목 |
단기과열 | 단기간 급등으로 과열 지정된 종목 |
투자주의 | 투자 주의 지정 종목 |
투자경고 | 투자 경고 지정 종목 |
투자주의환기종목 | 지속적인 이상 거래로 주의 환기 지정 종목 |
투자위험 | 투자 위험 지정 종목 (상폐 위험 등) |
⚠️ 감리 지정 종목은 거래 제한이나 급격한 가격 변동이 발생할 수 있으므로, 투자경고 · 투자위험 항목을 체크하여 제외하는 것을 권장합니다.
③ 시장구분
종목이 속한 시장을 기준으로 제외합니다.
항목 | 설명 |
코스피 | 유가증권시장(KOSPI) 상장 종목 |
코스닥 | 코스닥(KOSDAQ) 상장 종목 |
ETF | 상장지수펀드(ETF) |
None | 시장 구분 정보가 없는 종목 |
④ 업종
종목의 업종 분류를 기준으로 제외합니다.
아래 업종 중 원하는 항목을 선택하면 해당 업종에 속한 모든 종목이 제외됩니다.
그룹 | 업종 목록 |
제조/산업 | 제약, 화학, 비금속, 금속, 기계/장비, 전기/전자, 섬유/의류, 종이/목재, 기타제조, 제조 |
소비/유통 | 유통, 음식료/담배, 오락/문화, 출판/매체복제 |
서비스/IT | 일반서비스, IT 서비스, 통신 |
금융 | 금융, 보험, 증권 |
기반시설 | 전기/가스, 건설, 운송장비/부품, 운송/창고 |
기타 | 의료/정밀기기, 부동산 |
⑤ 회사크기분류
시가총액 기준 회사 규모를 기준으로 제외합니다.
항목 | 설명 |
소형주 | 시가총액 기준 소형주로 분류된 종목 |
중형주 | 시가총액 기준 중형주로 분류된 종목 |
대형주 | 시가총액 기준 대형주로 분류된 종목 |
⑥ 회사분류
기업 특성에 따른 분류를 기준으로 제외합니다.
항목 | 설명 |
외국기업 | 국내 증시에 상장된 외국 기업 |
중견기업 | 중견기업으로 분류된 종목 |
스팩 | 기업인수목적회사(SPAC) |
우량기업 | 재무 건전성이 높은 우량 기업 |
벤처기업 | 벤처기업으로 등록된 종목 |
신성장기업 | 신성장 기업으로 분류된 종목 |
💡 스팩은 변동성이 크므로, 일반 자동 매매 전략에서는 제외하는 것을 권장합니다.
⑦ 투자유의종목
투자 주의가 필요한 특수 지정 종목을 기준으로 제외합니다.
항목 | 설명 |
해당없음 | 투자유의 지정이 없는 일반 종목 |
단기과열 | 단기 과열로 지정된 종목 |
투자경고 | 투자 경고로 지정된 종목 |
ETF주의 | ETF 관련 주의 지정 종목 |
투자위험 | 투자 위험 지정 종목 |
적용 방법
동작 방식
현재 설정 확인
매매 전략 편집 화면에서 "매매 종목 필터" 버튼 아래에 현재 설정된 제외 기준 목록이 태그 형태로 표시됩니다. 제외 기준이 없는 경우에는 모든 종목이 매매 대상이 됩니다.
목적 | 권장 제외 항목 |
안정적인 매매 | 감리구분: 투자경고, 투자위험 / 회사분류: 스팩 |
코스닥 종목만 매매 | 시장구분: 코스피, ETF |
우량주 위주 매매 | 회사크기분류: 소형주 / 감리구분: 투자주의, 투자경고, 투자위험 |
금융주 제외 | 업종: 금융, 보험, 증권 |
주의 사항
매매 전략에서 발생할 수 있는 과다 종목 보유와 당일 동일 종목 반복 매수를 제어하기 위한 리스크 관리 설정입니다.
이 두 설정은 키움 조건검색식 기반 자동 매매 전략에서 활성화됩니다.
💡 단일 종목 선정 방식의 전략에서는 보유할 종목이 이미 고정되어 있으므로 해당 설정이 적용되지 않습니다.
화면 위치
자동매매 만들기 (키움 조건검색식) 창 → 전략 기본 설정 영역에서 확인할 수 있습니다.
① 보유 종목수 제한 (HoldingCountLimit)

기능 설명
이 전략이 동시에 보유할 수 있는 최대 종목 수를 지정합니다.
조건검색식으로 신호가 포착된 종목이 아무리 많더라도, 보유 종목 수가 이 한도에 도달하면 새로운 최초매수 주문이 차단됩니다.
입력 규칙
항목 | 내용 |
입력 형식 | 정수 (숫자) |
최소값 | 0 (제한 없음) |
최대값 | 90 |
유효성 오류 | 0 미만이거나 90 초과 시 저장 불가 |
동작 방식
신호 발생 → 현재 보유 종목 수 확인
├── 보유 수 < 제한 수 → 최초매수 주문 진행
└── 보유 수 >= 제한 수 → 주문 차단 (로그 기록)
설정 예시
설정값 | 동작 |
0 | 제한 없음. 조건 충족 시 계속 매수합니다. |
5 | 동시에 최대 5개 종목까지만 보유합니다. |
10 | 동시에 최대 10개 종목까지만 보유합니다. |
⚠️ 0으로 설정하면 제한이 없으므로, 조건 신호가 많이 발생할 경우 예상치 못한 대규모 매수가 일어날 수 있습니다. 반드시 적절한 상한값을 입력하는 것을 권장합니다.
② 당일 동일 종목 재매수 제한 (SameStockTradeLimit)
기능 설명
체크박스가 활성화된 경우, 당일 매도한 종목은 같은 날 다시 매수하지 않도록 제한합니다.
이 기능은 당일 손절·익절 후 같은 종목을 반복적으로 재진입하는 것을 방지하기 위한 리스크 관리 옵션입니다.
동작 방식
매수 조건 충족 → 당일 동일 종목 매도 이력 확인
├── 매도 이력 없음 → 매수 주문 진행
└── 매도 이력 있음 → 주문 차단 (재매수 제한)
설정 | 동작 |
체크 해제 (기본값) | 당일 매도 후에도 조건 충족 시 재매수를 허용합니다. |
체크 활성화 | 당일 매도한 종목은 당일 내 재매수를 차단합니다. |
💡 변동성이 높은 장세에서 동일 종목을 반복 매매하는 전략이라면 체크 해제를 유지하고, 손절 후 재진입을 막고 싶은 전략에서는 활성화하는 것을 권장합니다.
글로벌 제한 설정과의 관계
부엉이 ATS 에는 전략별 설정 외에 환경 설정(Config)에서 계좌 단위로 적용되는 글로벌 제한도 별도로 존재합니다.
설정 위치 | 설정 이름 | 적용 범위 |
환경 설정 → 일일 최대 매수 금액 | MaxDailyBuyAmount | 계좌 전체 |
환경 설정 → 동일 종목 최대 매수 횟수 | MaxDailySameStockBuyOrderCount | 계좌 전체 |
전략 설정 → 보유 종목수 제한 | HoldingCountLimit | 전략 단위 |
전략 설정 → 당일 동일 종목 재매수 제한 | SameStockTradeLimit | 전략 단위 |
두 레벨의 제한이 동시에 적용됩니다. 즉, 어느 한 쪽이라도 조건을 충족하지 못하면 주문은 차단됩니다.
💡 글로벌 제한 설정 변경 방법은 → 2.5 환경 설정 파일 안내 를 참고하십시오.
관련 추가 설정
키움 조건검색식 기반 전략에는 보유·재매수 제한 외에도 아래 추가 옵션이 함께 제공됩니다.
지정 일시 자동 완료
작업이 생성된 시점으로부터 지정한 날짜·시간 이후 해당 작업을 자동으로 완료(종료) 처리합니다.
항목 | 설명 |
체크박스 | 자동 완료 기능 활성화 여부 |
기준일 | 당일 / 익일 / 2일 후 ~ 5일 후 선택 |
시간 | 완료 처리할 시각 입력 |
지정 일시 일괄 매도
지정한 날짜·시간에 해당 전략이 보유한 모든 종목을 일괄 매도합니다.
항목 | 설명 |
체크박스 | 일괄 매도 기능 활성화 여부 |
기준 일수 | N일 후 일괄 매도 |
시간 | 일괄 매도 실행 시각 |
주문유형 | 시장가 / 현재가 선택 |
호가 기준 틱 | 현재가 선택 시 ±틱 조정 |
설정 권장 조합
전략 유형 | 보유 종목수 제한 | 당일 동일 종목 재매수 제한 |
다종목 스캘핑 | 5 ~ 10 | 체크 해제 |
단기 스윙 (손절 후 재진입 방지) | 5 ~ 15 | 체크 활성화 |
분산 투자 (포트폴리오) | 10 ~ 30 | 체크 활성화 |
제한 없이 전략 테스트 | 0 | 체크 해제 |
주의 사항
이미 만들어진 매매 전략의 설정을 변경하거나 불필요한 전략을 제거하는 방법을 설명합니다.
자동매매 만들기 화면 왼쪽의 전략 목록에서 수정·삭제할 전략을 선택하여 작업합니다.
화면 구성 (전략 목록 영역)

버튼 | 기능 |
+ | 새 전략 추가 |
- | 선택된 전략 삭제 |
↑ | 선택된 전략을 목록에서 위로 이동 |
↓ | 선택된 전략을 목록에서 아래로 이동 |
저장 | 현재 편집 내용을 저장(신규 등록 또는 수정 반영) |
닫기 | 편집 창 닫기 |
수정 절차
수정 시 유효성 검사 항목
저장 버튼 클릭 시 다음 항목들이 자동으로 검사됩니다. 하나라도 실패하면 저장이 차단됩니다.
검사 항목 | 실패 시 메시지 |
계좌번호 선택 여부 | "선택한 계좌번호가 존재하지 않습니다." |
최초매수 주문 전략 존재 여부 | "최초매수 주문 전략이 존재하지 않습니다." |
최초매수 주문 전략 1개 초과 여부 | "최초매수 주문 전략은 1개만 존재해야 합니다." |
최초매수 실행주기 = 1회 여부 | "최초매수 주문 전략의 실행주기는 반드시 '1회' 이어야 합니다." |
이름, 기본 매수 금액, 보유 종목수 제한 범위 | 각 항목별 오류 메시지 표시 |
키움 조건검색식 존재 여부 (조건검색식 기반 전략만) | "선택한 계정번호에 해당하는 키움 조건검색식이 존재하지 않습니다." |
수정 제약 조건
전략의 현재 상태에 따라 일부 항목은 수정이 제한될 수 있습니다.
① 실행 중인 전략
상태 | 동작 |
전략이 자동 매매 실행 중 (IsRun = true) | 수정 불가 — "실행중인 매매 전략은 수정할 수 없습니다." 오류 표시 |
💡 수정하려면 자동 매매 스위치 화면에서 해당 전략을 먼저 OFF 하십시오.
② 계좌번호 변경
전략 유형 | 조건 | 동작 |
단일 종목 | 진행중인 주문이 있음 | 변경 불가 — "진행중인 주문이 존재하여 계좌번호를 변경할 수 없습니다." |
키움 조건검색식 / 사용자 정의 | 진행중인 매매전략 작업이 있음 | 작업 중지 여부를 사용자에게 확인 후 중지 시 변경 가능 |
③ 기본주문금액 변경
전략 유형 | 조건 | 동작 |
단일 종목 | 진행중인 주문이 있음 | 변경 불가 — "진행중인 주문이 존재하여 기본주문금액을 변경할 수 없습니다." |
키움 조건검색식 / 사용자 정의 | 진행중인 매매전략 작업이 있음 | 계속 진행 여부를 사용자에게 확인 — 확인 시 변경 적용 |
④ 키움 조건검색식 기반 전략의 이미 생성된 작업
키움 조건검색식 기반 전략에 **이미 생성된 매매전략 작업(종목 작업)**이 있는 경우:
⚠️ 이미 생성된 매매전략 작업에는 수정 내용이 반영되지 않습니다.
이후에 새로 생성되는 작업에만 변경 사항이 적용됩니다.
저장 시 아래와 같은 경고가 표시됩니다.
이미 생성된 매매전략작업이 있습니다: [종목명 A, 종목명 B]
키움조건식 기반에서 이미 생성된 매매전략작업은 수정되지 않습니다.
이후에 생성되는 매매전략작업에만 적용됩니다.
삭제 절차
삭제 시 종속 데이터 처리
전략 유형 | 종속 데이터 | 처리 방식 |
키움 조건검색식 | 종속된 매매전략 작업이 있는 경우 | "삭제 시 종속된 모든 매매전략 작업이 삭제됩니다." 경고 후 사용자 확인 |
단일 종목 | 진행중인 주문이 있는 경우 | "이미 진행중인 주문이 존재합니다. 삭제 시 모든 주문내역이 삭제됩니다." 경고 후 사용자 확인 |
모든 유형 | 종속 데이터 없음 | "매매전략을 삭제하시겠습니까?" 확인 후 즉시 삭제 |
⚠️ 삭제된 전략 및 그에 종속된 모든 작업·주문 내역은 복구할 수 없습니다.
삭제 전 반드시 내용을 확인하십시오.
삭제 제약 조건
상태 | 동작 |
전략이 자동 매매 실행 중 (IsRun = true) | 삭제 불가 — 먼저 자동 매매를 중지하십시오. |
전략 목록의 표시 순서(실행 우선순위)를 조정할 수 있습니다.
수정 또는 삭제 과정에서 표시될 수 있는 주요 확인·경고 메시지는 다음과 같습니다.
메시지 | 원인 | 조치 |
"실행중인 매매 전략은 수정할 수 없습니다." | 전략이 실행 중 | 자동 매매 스위치에서 먼저 OFF |
"진행중인 주문이 존재하여 계좌번호를 변경할 수 없습니다." | 단일종목 전략에 미완료 주문 존재 | 주문 처리 완료 후 수정 |
"진행중인 매매전략작업이 존재합니다. 계좌번호를 변경하려면 진행중인 매매전략작업의 사용을 모두 중지해야 합니다." | 키움 조건검색식 전략에 활성 작업 존재 | 확인 후 자동 중지 또는 취소 |
"이미 실행중인 주문이 존재합니다. 예상하지 못한 문제가 발생할 수 있습니다." | 활성 주문 상태에서 전략 수정 시도 | 경고 확인 후 수정 진행 여부 결정 |
"최초매수 주문 전략이 존재하지 않습니다." | 주문 전략에 최초매수가 없음 | 주문 전략 추가 |
"선택한 계정번호에 해당하는 키움 조건검색식이 존재하지 않습니다." | 해당 계좌의 조건검색식 목록에 없음 | 키움 HTS에서 동일 이름 조건검색식 등록 후 재시도 |
가져오기 / 내보내기 기능은 매매 전략을 JSON 파일 형식으로 저장하고 다시 불러올 수 있는 기능입니다.
이 기능을 활용하면 다음과 같은 작업이 가능합니다.
내보내기 / 가져오기 버튼 위치
자동매매 만들기 화면의 전략 목록에서 오른쪽 클릭(컨텍스트 메뉴) 또는 전략 목록 상단 메뉴에서 접근합니다.
메뉴 항목 | 기능 |
가져오기 | 외부 JSON 파일에서 매매 전략을 불러옵니다. |
내보내기 | 선택된 전략을 JSON 파일로 저장합니다. |
내보내기 절차
매매 전략을 '{저장경로\파일명.json}'에 저장되었습니다.
내보내기 파일에 포함되는 정보
내보내기 파일(JSON)에는 전략 재현에 필요한 모든 구성 요소가 함께 포함됩니다.
포함 항목 | 설명 |
전략 기본 정보 | 이름, 계좌번호, 기본 매수 금액, 보유 종목수 제한, 재매수 제한, 자동 실행 시간 등 |
주문 전략 목록 | 매수/매도 구분, 주문유형, 준비·실행 조건 설정, 금액 계산식 연결 정보 등 |
시스템조건식 목록 | 준비조건·실행조건에 사용된 모든 시스템조건식의 상세 내용 |
키움 조건검색식 이름 목록 | 전략에서 사용된 키움 조건검색식의 이름 |
주문금액 계산식 목록 | 전략에 연결된 금액 계산식 내용 |
거래 제외 기준 | 설정된 매매 제외 카테고리 목록 |
⚠️ 현재 진행 중인 매매전략 작업(종목별 주문 이력) 은 내보내기 파일에 포함되지 않습니다.
또한 내보내기 파일에서 전략의 실행 상태는 항상 OFF로 초기화됩니다.
내보내기 파일 예시 구조
{
"tradeStrategyDto": {
"name": "RSI 전략",
"unitTradeAmount": 500000,
"holdingCountLimit": 5,
...
"orderStrategies": [ ... ]
},
"conditionExpressions": [ ... ],
"conditionSearchExpressionNames": [ "RSI_30이하", "거래량급등" ],
"amountExpressions": [ ... ]
}
가져오기 전 사전 조건
⚠️ 반드시 확인하세요:
가져오려는 전략에서 사용된 키움 조건검색식 이름이 내 키움 영웅문 HTS에 동일한 이름으로 등록되어 있어야 합니다.
조건검색식 이름이 없으면 가져오기가 실패합니다.
가져오기 절차
외부에서 가져오려는 매매 전략에 사용된 키움 조건검색식이 내 영웅문에 존재해야합니다. (동일한 이름)
계속하시겠습니까?
가져오기 처리 방식
가져오기 시 내부적으로 다음과 같은 처리가 자동으로 수행됩니다.
항목 | 처리 방식 |
전략 ID | 새로 발급 (원본 ID 무시) |
계좌번호 | 사용자가 선택한 계좌번호로 교체 |
실행 상태 | OFF로 초기화 |
시스템조건식 | 이름·수식·조합이 동일한 항목이 이미 있으면 기존 항목 재사용, 없으면 새로 추가 |
주문금액 계산식 | 이름·수식이 동일한 항목이 이미 있으면 기존 항목 재사용, 없으면 새로 추가 |
키움 조건검색식 | 선택한 계좌번호에 동일 이름의 검색식이 존재해야 함 |
주문 전략 ID | 전체 새로 발급 |
가져오기 오류 및 해결 방법
오류 메시지 | 원인 | 해결 방법 |
"대상 매매전략의 이름과 동일한 매매전략이 이미 존재합니다." | 같은 이름의 전략이 이미 등록되어 있음 | 기존 전략 이름을 변경하거나 삭제 후 재시도 |
"대상 키움 조건검색식이 현재 키움 조건검색식에 없습니다. 키움 조건검색식 이름 : {이름}" | 해당 이름의 검색식이 영웅문에 없음 | 키움 영웅문 HTS에서 동일한 이름으로 조건검색식을 등록한 후 재시도 |
"유효하지 않은 파일 경로입니다." | 선택한 파일이 존재하지 않음 | 파일 경로를 다시 확인 |
"선택한 파일은 JSON 형식이어야 합니다." | .json 확장자가 아닌 파일을 선택함 | AmountExpression.json 파일만 선택 |
"계좌번호를 선택하지 않았습니다." | 계좌 선택 창에서 계좌 선택 없이 닫음 | 계좌번호 선택 후 재시도 |
활용 시나리오
시나리오 1 — 전략 백업
1. 전략 선택 → 내보내기
2. 원하는 경로에 JSON 파일 저장
3. 필요 시 가져오기로 복원
시나리오 2 — 전략 복사 후 변형
1. 원본 전략 내보내기 → 파일 저장
2. 가져오기 → 동일 계좌 선택
→ "동일 이름 전략 존재" 오류 발생
3. 원본 전략 이름 변경 후 재시도
→ 복사된 전략이 추가됨
시나리오 3 — 다른 PC로 이전
[PC A]
1. 전략 내보내기 → USB 또는 클라우드에 저장
[PC B]
1. 조건검색식 목록 동기화 (9.2 참조)
2. 가져오기 → 파일 선택 → 계좌번호 선택
→ 전략이 그대로 복원됨
주의 사항
부엉이 ATS의 자동 매매는 매매 전략 단위로 개별 ON/OFF가 가능합니다. 전략을 실행(ON)하면 프로그램이 실시간 시세 및 조건검색식 결과를 감시하며, 설정된 매수/매도 조건이 충족될 때 자동으로 주문을 발송합니다.
⚠️ 선행 조건: 자동 매매를 시작하기 전에 반드시 아래 항목이 모두 준비되어 있어야 합니다.
전략 스위치를 ON으로 전환하면 내부적으로 다음 순서가 자동 진행됩니다.
[스위치 ON]
↓
① 실시간 종목 체결 등록 한도 확인 (최대 90 종목)
↓
② 실시간 조건검색식 등록 한도 확인 (편입용 최대 9개)
↓
③ 포착 조건검색식 충돌 여부 확인
↓
④ 전략 실행 상태 저장 (IsRun = true)
↓
⑤ 실시간 주식 체결 데이터 등록 갱신
↓
⑥ 편입 조건검색식 실시간 조건검색 등록
↓
[자동 매매 감시 시작]
스위치를 ON으로 전환할 때 프로그램이 자동으로 아래 항목을 검증합니다. 어느 하나라도 실패하면 스위치는 원래 상태(OFF)로 복원됩니다.
검증 항목 | 제한 | 초과 시 조치 |
실시간 체결 종목 수 | 최대 90 종목 | 오류 메시지 표시 후 실행 취소 |
실시간 조건검색식 등록 수 | 편입용 최대 9개 | 오류 메시지 표시 후 실행 취소 |
포착 조건검색식 충돌 | 같은 조건검색식이 이미 실행 중인 다른 전략에서 편입용으로 사용 중인 경우 | 오류 메시지 표시 후 실행 취소 |
등록 계좌번호 유효성 | AppKey에 등록된 실제 계좌여야 함 | 전략을 오류 상태로 전환 |
💡 참고: 실시간 체결 종목 수는 현재 실행 중인 모든 전략의 매매 작업에서 감시 중인 종목의 합계를 기준으로 계산됩니다. 전략 하나가 여러 종목을 감시하고 있는 경우 그 종목 수만큼 차감됩니다.
이미 실행 중인 전략을 장중에 중지(OFF)하면 다음과 같은 경고 메시지가 표시됩니다.
"장중에 실행을 중지하면 처리되지 못한 매매 데이터가 발생할 수 있습니다. 이로 인해 예기치 못한 오류가 발생할 수 있습니다. 계속 진행하시겠습니까?"
⚠️ 권장사항: 장중 중지가 필요한 경우 가급적 보유 종목이 없는 상태에서 수행하십시오.
매일 정해진 시간에 프로그램이 자동으로 시작되도록 Windows 작업 스케줄러에 등록할 수 있습니다.
⚠️ 주의: 스케줄러 등록은 관리자 권한으로 실행해야 합니다. 일반 권한으로 실행한 경우 저장이 거부됩니다.
자동 매매 스위치 대시보드는 메인 화면 하단 탭에 위치합니다. 현재 선택된 계좌에 등록된 매매 전략 목록을 카드 형태로 표시하며, 각 전략을 별도 화면을 열지 않고 즉시 ON/OFF 할 수 있는 빠른 제어 패널입니다.

대시보드에는 조건을 통과한 전략만 표시됩니다. 각 전략 카드에는 다음 정보가 포함됩니다.
구성 요소 | 내용 |
전략 표시 이름 | [계좌번호] 전략명 형식으로 표시 (예: [12345678901] 단기모멘텀전략) |
실행 스위치 | 토글 형태의 ON/OFF 스위치. 파란색(ON) / 회색(OFF) |
💡 표시 조건: 아래 조건을 모두 충족하는 전략만 대시보드에 표시됩니다.
대시보드 목록은 다음 상황에서 자동으로 새로 고침됩니다.
갱신 트리거 | 설명 |
계좌 변경 | 상단 계좌 선택 콤보박스에서 다른 계좌를 선택하면 해당 계좌의 전략 목록으로 즉시 교체됩니다. |
전략 추가/수정/삭제 | 자동매매 편집기에서 전략을 저장하거나 삭제하면 대시보드 목록이 자동으로 갱신됩니다. |
대시보드에 전략이 표시되지 않는 경우 아래 항목을 순서대로 확인하십시오.
자동매매 현황 화면은 실행 중인 전략과 그에 속한 종목 작업, 주문·체결 내역을 실시간으로 계층적으로 확인할 수 있는 모니터링 화면입니다.
화면 열기
메인 화면 상단 메뉴 또는 탭에서 자동매매 현황 을 클릭합니다.
화면 구성
화면은 좌→우로 5개 영역이 분할 배치되며, 왼쪽 항목을 선택하면 오른쪽 영역이 연계되어 드릴다운 방식으로 조회됩니다.

① 전략 목록 (왼쪽 패널)
등록된 모든 매매 전략이 표시됩니다.
컬럼 | 설명 |
계좌번호 | 전략에 연결된 거래 계좌번호 |
전략명 | 매매 전략 이름 |
전략을 선택하면 하단 전략 상세 정보 영역에 다음 정보가 표시됩니다.
항목 | 설명 |
기본 매수 금액 | 설정된 기본 매수 금액 |
자동매매 매수시간A | 매수 실행 시간대 A |
자동매매 매수시간B | 매수 실행 시간대 B |
자동매매 매도시간A | 매도 실행 시간대 A |
자동매매 매도시간B | 매도 실행 시간대 B |
사용 여부 | 사용 중 / 사용 중지 |
실행 여부 | 실행 중 / 실행 중지 |
기타 설명 | 전략 메모 |
② 작업중 전략 (종목 목록, 두 번째 패널)
왼쪽에서 선택한 전략에 속하는 종목별 작업 목록이 표시됩니다. 키움 조건검색식 기반 전략에서는 조건에 포착된 각 종목이 하나의 작업으로 생성됩니다.
컬럼 | 설명 |
계좌번호 | 해당 작업의 계좌번호 |
종목코드 | 매매 대상 종목 코드 |
종목명 | 종목명 |
생성일시 | 작업이 시작된 일시 |
💡 오류 상태인 항목은 빨간색 글씨로 표시됩니다.
종목 작업을 선택하면 하단 작업 상세 정보가 표시됩니다.
항목 | 설명 |
기본 매수 금액 | 이 작업에 적용된 매수 금액 |
사용 여부 | 실행 중 / 실행 중지 |
오류 여부 | 정상 / 오류 |
오류 메시지 | 오류 발생 시 상세 메시지 |
기타 설명 | 작업 메모 |
작업 삭제
작업 항목에서 우클릭 → 삭제 를 선택하면 해당 종목 작업을 삭제할 수 있습니다.
③ 전략 명세 (오른쪽 상단)
선택한 종목 작업에 적용된 **주문 전략 명세(실행 단계)**가 표시됩니다. 각 명세는 최초매수·매수·매도 등 주문 전략 하나에 해당합니다.
컬럼 | 설명 |
준비 | 준비 조건 이름 |
실행 | 실행 조건 이름 |
주문구분 | 최초매수 / 매수 / 매도 |
거래구분 | 시장가 / 현재가 / 시간외단일가 등 |
주문금액 | 적용 중인 주문 금액 수식 결과 |
준비 조건 | 통과 / 대기 |
실행 조건 | 통과 / 대기 |
오류 | 정상 / 오류 |
오류 메시지 | 오류 내용 |
생성일시 | 명세 생성 시간 |
💡 준비 조건 = 통과, 실행 조건 = 통과 상태여야 해당 주문이 실제로 발송됩니다.
④ 주문 현황 (오른쪽 중간)
선택한 명세에서 발생한 주문 목록이 실시간으로 표시됩니다.
컬럼 | 설명 |
종목코드 | 주문 종목 코드 |
종목명 | 종목명 |
주문구분 | 매수 / 매도 |
거래구분 | 지정가 / 시장가 등 |
주문시간 | 주문 발송 일시 |
주문수량 | 주문한 수량 |
주문가격 | 주문 가격 |
체결수량 | 체결 완료된 수량 |
미체결수량 | 아직 체결되지 않은 수량 |
주문번호 | 키움 API에서 발급된 주문번호 |
처리상태 | 접수 / 체결 / 확인 |
⑤ 체결 현황 (오른쪽 하단)
선택한 주문의 체결 내역이 표시됩니다. 하나의 주문은 여러 건의 체결로 분할될 수 있습니다.
컬럼 | 설명 |
종목코드 | 체결 종목 코드 |
종목명 | 종목명 |
주문구분 | 매수 / 매도 |
체결수량 | 이번 체결 수량 |
체결가격 | 체결된 가격 |
체결시간 | 체결 발생 시간 |
체결번호 | 키움 API 체결번호 |
새로고침
화면 우측 상단의 새로고침 버튼을 클릭하면 전체 데이터를 다시 불러옵니다. 실시간 이벤트로 자동 갱신되지만, 일시적 누락이 의심될 경우 수동으로 새로고침합니다.

전략 단위 중지
장중에 실행을 중지하면 처리되지 못한 매매 데이터가 발생할 수 있습니다.
이로인해 예기치 못한 오류가 발생할 수 있습니다.
계속 진행하시겠습니까?
선택 | 동작 |
예 | 즉시 자동 매매 중지, 스위치 OFF 처리 |
아니오 | 취소, 스위치 ON 상태 유지 |
안전한 중지 권장 순서
자동 매매 실행 시간대가 끝나기를 기다린다
미체결 주문이 없는지 주문 현황 화면에서 확인한다
미체결 주문이 있다면 키움 HTS에서 수동으로 취소/정정한다
스위치를 OFF한다
⚠️ 갑작스러운 중지는 미체결 주문·잔고 불일치를 유발할 수 있습니다. 가급적 장 마감 후에 중지하십시오.
자동매매 주문 내역 화면에서 과거 매매 결과를 날짜 범위와 전략별로 조회할 수 있으며, CSV 파일로 내보낼 수 있습니다.
화면 열기
메인 화면 상단 메뉴에서 자동매매 주문 내역 을 클릭합니다.
조회 조건 설정

전략 선택
선택 | 조회 범위 |
전체 | 모든 전략의 거래 내역 조회 |
특정 전략명 | 선택한 전략의 거래 내역만 조회 |
날짜 범위 빠른 선택 버튼
버튼 | 기간 설정 |
전일 | 이전 영업일 ~ 오늘 |
당일 | 오늘 ~ 오늘 |
당주 | 이번 주 월요일 ~ 오늘 |
당월 | 이번 달 1일 ~ 오늘 |
당해 | 올해 1월 1일 ~ 오늘 |
날짜 직접 입력
DatePicker를 통해 시작일 ~ 종료일을 직접 선택합니다.
과거 매매 결과 확인 방법
조회 결과 컬럼 설명
컬럼 | 설명 |
그룹 | 동일 종목 매매 묶음 ID (같은 그룹 = 같은 매매 사이클) |
주문일자 | 주문이 발생한 일시 |
전략명 | 해당 주문이 속한 매매 전략 이름 |
계좌번호 | 주문 계좌번호 |
주문구분 | 매수 / 매도 |
거래소 | KRX / NXT |
종목코드 | 매매 종목 코드 |
종목명 | 종목명 |
실행조건식 표시명 | 주문을 트리거한 조건식 이름 |
체결수량 | 실제 체결된 수량 |
매입평균가 | 매수 체결 평균 가격 |
매도평균가 | 매도 체결 평균 가격 |
실현손익 | 매도금액 - 매입금액 (수수료·세금 제외) |
수익률 | 실현손익 / 매입금액 × 100 (%) |
수수료 | 매입금액 × 0.015% (추정치) |
세금 | 매도금액 × 0.15% (추정치) |
실현손익2 | 실현손익 - (수수료 + 세금) |
수익률2 | 실현손익2 / 매입금액 × 100 (%) |
매입금액 | 매수 체결 총 금액 |
매도금액 | 매도 체결 총 금액 |
체결시간 | 마지막 체결 시간 |
전송결과 | 주문 전송 성공/실패 여부 |
키움결과 | 키움 API 콜백 메시지 |
설명 | 주문 발생 이유 |
생성일시 | 주문 DB 저장 일시 |
⚠️ 수익률 = 0 으로 표시되는 경우: 매수 체결수량과 매도 체결수량이 다른 경우 (일부만 매도된 경우) 수익률은 계산되지 않고 0으로 표시됩니다.
CSV 내보내기
조회된 결과를 CSV 파일로 저장할 수 있습니다.
💡 CSV 파일은 UTF-8 (BOM 포함) 형식으로 저장되어 한국어가 깨지지 않습니다. 엑셀에서 바로 열어 활용 가능합니다.
스케줄러는 부엉이 ATS 을 지정한 요일과 시간에 자동으로 시작하고 종료하도록 Windows 작업 스케줄러에 등록하는 기능입니다. 매일 수동으로 프로그램을 켜고 끌 필요 없이, 주식 시장 개장 시간에 맞춰 프로그램이 자동 실행되도록 예약할 수 있습니다.
스케줄러 화면 열기
메인 메뉴에서 [스케줄러] 항목을 클릭하면 "프로그램 실행 스케줄" 창이 열립니다.

화면 구성
구성 요소 | 설명 |
자동시작 활성화 토글 | 스케줄 기능을 전체적으로 ON/OFF 합니다 |
시작 시간 | 프로그램을 자동으로 실행할 시각을 설정합니다 |
종료 시간 | 프로그램을 자동으로 종료할 시각을 설정합니다 |
요일 선택 | 스케줄을 적용할 요일(월~일)을 개별 선택합니다 |
저장 버튼 | 설정을 저장하고 Windows 작업 스케줄러에 등록합니다 |
닫기 버튼 | 창을 닫습니다 |
⚠️ 사용 가능 시간 제한: 자동시작은 07:30 ~ 23:00 범위 내에서만 설정하도록 권장합니다. 이는 키움 Rest API의 사용 가능 시간을 고려한 제한입니다.
⚠️ 자동 종료 알림: 프로그램은 매일 06:00에 "06:05에 자동 종료된다"는 알림을 표시하며, 06:05에 자동으로 종료됩니다. 이는 야간 장 종료 이후 다음 날 스케줄 실행을 위한 안전 종료 기능입니다.
스케줄 기능을 처음 설정하거나 시작 시간을 변경할 때 아래 단계를 따릅니다.
사전 조건
⚠️ 반드시 관리자 권한으로 실행해야 합니다. 일반 권한으로 실행 중인 경우 저장 시 "관리자 권한으로 실행해주세요." 메시지가 표시되며 저장되지 않습니다.
관리자 권한 실행 방법: *내 문서\SageLine* 폴더 내의 Start부엉이 ATS .vbs 파일을 실행하면 UAC(사용자 계정 컨트롤) 프롬프트가 나타나며 관리자 권한으로 프로그램이 시작됩니다.
설정 단계
① 자동시작 활성화
② 시작 시간 입력
③ 요일 선택
④ 저장
자동 종료 스케줄은 자동 시작 스케줄과 동일한 화면에서 함께 설정됩니다. 별도의 화면이 없으며, 시작 시간과 종료 시간을 한 번에 저장합니다.
설정 단계
① 종료 시간 입력
② 요일 및 저장
📌 참고: 종료 스케줄은 Exit부엉이 ATS .bat를 통해 실행 중인 부엉이 ATS 프로세스를 강제 종료합니다. 진행 중인 자동 매매가 있더라도 설정한 시각에 프로그램이 종료되므로, 모든 자동 매매 전략이 완료되는 시각 이후로 종료 시간을 설정하는 것을 권장합니다.
자동 종료 시간 설정 권장 예시
매매 유형 | 권장 종료 시간 |
정규 시장 매매만 사용 | 15:40 ~ 16:00 |
시간 외 단일가까지 사용 | 18:10 ~ 18:30 |
야간 선물 등 포함 | 23:00 이전 |
현재 설정 확인
스케줄러 창을 열면 이전에 저장된 설정값이 자동으로 불러와집니다.
이를 통해 현재 어떤 스케줄이 등록되어 있는지 한눈에 확인할 수 있습니다.
스케줄 수정 방법
스케줄 비활성화 방법
스케줄을 완전히 해제하려면 다음 단계를 따릅니다.
Windows 작업 스케줄러에서 직접 확인하는 방법
등록된 스케줄을 Windows 작업 스케줄러에서 직접 확인하거나 관리할 수 있습니다.
📌 참고: Windows 작업 스케줄러에서 직접 항목을 수정하거나 삭제하는 것은 권장하지 않습니다. 항상 부엉이 ATS 스케줄러 화면을 통해 관리하시기 바랍니다.
자주 발생하는 문제
증상 | 원인 및 해결 방법 |
저장 시 "관리자 권한으로 실행해주세요." 메시지 | 프로그램을 일반 권한으로 실행 중입니다. 내 문서\SageLine\Start부엉이 ATS .vbs로 재실행 후 다시 시도하세요 |
설정한 시간에 프로그램이 실행되지 않음 | 자동시작 활성화 토글이 OFF인지 확인, Windows 작업 스케줄러에서 해당 항목이 등록되어 있는지 확인하세요 |
저장 버튼이 비활성화됨 | 시작 시간, 종료 시간, 요일 중 하나 이상이 설정되지 않은 상태입니다. 모두 입력 후 다시 시도하세요 |
로그 대시보드는 부엉이 ATS 이 동작하면서 발생하는 모든 내부 이벤트와 상태 메시지를 실시간으로 표시하는 화면입니다. 주문 접수, 체결, 오류 발생, API 호출 내역 등 프로그램의 모든 동작이 이 화면에 기록되므로, 자동 매매 중 이상 징후를 즉시 파악할 수 있습니다.
화면 위치
메인 화면의 특정 탭 또는 패널에서 [로그] 항목을 선택하면 로그 대시보드 영역이 표시됩니다.
화면 구성

구성 요소 | 설명 |
로그 출력창 | 실시간으로 발생하는 로그 메시지를 표시하는 스크롤 가능한 텍스트 영역 |
자동 스크롤 | 새 메시지가 추가되면 자동으로 최신 메시지로 스크롤 이동 |
로그 메시지 형식
모든 로그 메시지는 아래 형식으로 출력됩니다.
[yyyy-MM-dd HH:mm:ss.fff] 메시지 내용
예시:
[2025-06-10 09:01:33.412] 자동 매매 전략 '전략1' 시작
[2025-06-10 09:01:34.108] [매수 주문] 종목: 005930 삼성전자, 수량: 1, 가격: 78500
[2025-06-10 09:01:34.891] [체결] 005930 삼성전자 1주 @ 78500원 체결 완료
📌 참고: 로그 대시보드는 현재 실행 중인 세션의 메시지만 표시합니다. 과거 날짜의 로그는 [로그 매니저] 에서 확인할 수 있습니다. (→ 8.3 참고)
로그 자동 출력
로그 대시보드는 별도의 조작 없이 자동으로 업데이트됩니다. 프로그램 동작 중 발생하는 모든 이벤트는 1초마다 화면에 반영됩니다.
자동 스크롤 제어
동작 | 결과 |
스크롤을 내리지 않고 맨 위 유지 | 자동 스크롤 활성화 — 새 로그가 올 때마다 자동으로 맨 위로 이동 |
스크롤을 아래로 내려 과거 로그 확인 중 | 자동 스크롤 비활성화 — 현재 보고 있는 위치가 고정됨 |
다시 맨 위로 스크롤 | 자동 스크롤 재활성화 |
📌 팁: 자동 매매가 진행 중일 때 특정 시점의 로그를 확인하려면 스크롤을 내려 해당 시점을 찾으면 됩니다. 자동 스크롤이 일시 중지되므로 로그가 흘러가지 않고 편하게 읽을 수 있습니다.
로그 읽는 방법
로그는 여러 유형의 메시지를 포함합니다.
로그 유형 | 예시 내용 |
일반 정보 (INFO) | 전략 시작/종료, 로그인 성공, 잔고 조회 완료 |
경고 (WARN) | API 호출 지연, 재시도 발생, 설정 누락 |
오류 (ERROR) | 주문 실패, 연결 끊김, 예외 발생 |
매매 이벤트 | 매수/매도 주문 접수, 체결, 취소 |
로그 매니저는 디스크에 저장된 로그 파일 목록을 관리하는 별도 창입니다. 특정 날짜의 로그를 열어 확인하거나 파일을 삭제할 수 있습니다.
로그 매니저 열기
메인 메뉴에서 [로그 매니저] 항목을 선택하면 "로그 파일 관리" 창이 열립니다.

로그 파일 저장 위치
로그 파일은 아래 경로에 자동 저장됩니다.
내 문서\SageLine\SageStockPilot\logs\
화면 구성
구성 요소 | 설명 |
당일 로그파일 자동 전송 토글 | 당일 로그 파일을 30분마다 자동으로 서버에 전송하는 기능 ON/OFF |
파일 목록 테이블 | 로그 파일의 이름, 크기, 최종 수정일을 표시 |
메모장으로 열기 버튼 | 선택한 로그 파일을 Windows 메모장으로 엽니다 |
삭제 버튼 | 선택한 로그 파일을 삭제합니다 |
서버로 전송 버튼 | 선택한 로그 파일을 지원팀 서버로 업로드합니다 |
파일 목록 컬럼 설명
컬럼 | 설명 |
파일명 | 로그 파일 이름 (날짜 기준으로 자동 생성) |
크기 (KB) | 파일 크기 (KB 단위, 소수점 1자리 표시) |
수정일 | 파일이 마지막으로 기록된 날짜와 시간 |
과거 로그 조회 방법
📌 참고: 메모장으로 열기는 파일을 1개만 선택했을 때 활성화됩니다. 여러 파일을 동시에 열려면 각각 선택하여 열어야 합니다.
로그 파일 삭제 방법
⚠️ 주의: 삭제된 로그 파일은 복구할 수 없습니다. 문의나 오류 분석이 필요한 경우 삭제 전에 미리 서버로 전송해 두는 것을 권장합니다.
프로그램 오작동이나 오류 발생 시 지원팀에 로그 파일을 전송하면 빠른 원인 분석이 가능합니다.
수동 업로드 방법
자동 업로드 설정
로그 매니저 상단의 [당일 로그파일 자동 전송] 토글을 ON으로 설정하면, 프로그램 실행 중 30분마다 당일 로그 파일이 자동으로 서버에 전송됩니다.
설정 | 동작 |
ON | 30분 간격으로 당일 최신 로그 파일을 자동 전송 |
OFF | 자동 전송 비활성화. 수동으로만 전송 가능 |
업로드 제한 및 주의사항
항목 | 내용 |
최대 파일 크기 | 파일당 최대 2GB |
전송 중 주의 | 전송 중 프로그램을 강제 종료하면 업로드가 실패할 수 있습니다 |
오류 발생 시 | 서버 연결 상태를 확인 후 재시도하거나, 파일 경로(내 문서\SageLine\SageStockPilot\logs\)에서 직접 파일을 이메일로 전송하세요 |