1. 시작하기 전에

1.1 이 문서에 대하여

이 문서는 **부엉이 주식자동매매 프로그램 (부엉이 ATS)**의 공식 사용자 설명서입니다. 초보 사용자부터 숙련된 사용자까지 프로그램의 모든 기능을 올바르게 활용할 수 있도록 가이드합니다.

이 문서가 다루는 내용

설명서는 사용자의 원활한 프로그램 운용을 위해 다음 내용을 중심으로 구성되어 있습니다

이 문서가 다루는 내용

이 문서는 다음 내용을 중심으로 구성되어 있습니다.

적용 버전

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

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

표기 약속

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

관련 문서 및 참고 자료

이 문서와 함께 참고할 수 있는 자료는 다음과 같습니다.

• 키움증권 Rest API 공식 문서 : https://apiportal.koreainvestment.com
  (키움 REST API 앱키 발급, TR 코드 상세 사양 참고)
• Google Gemini API 공식 문서 : https://ai.google.dev
  (AI 뉴스 분석 기능 사용 시 API 키 발급 참고)

문서 개정 이력

1.2 부엉이 ATS 란?

**부엉이 ATS(Automated Trading System)**는 키움증권 REST API를 기반으로 종목 선정부터 매수·매도 주문 실행까지 전 과정을 자동화하는 Windows 전용 주식 자동매매 프로그램입니다. 복잡한 코딩 지식 없이도 사용자가 설정한 전략과 규칙에 따라 프로그램이 실시간으로 시장을 감시하고 대응하도록 설계되었습니다.

프로그램 탄생 배경

 기술적 장벽 완화: 일반적인 API 연동에 필요한 복잡한 코딩 지식 없이, 조건과 규칙 설정만으로 자동매매가 가능하도록 구현되었습니다.

 이름의 유래: 밤낮없이 시장을 감시하며 기회를 포착하는 부엉이의 특성에서 착안하여 명명되었습니다.

지원 증권사 및 필수 조건

부엉이 ATS를 사용하기 위해서는 아래의 요건이 반드시 충족되어야 합니다.

⚠️ 주의: 이 프로그램은 키움증권 계좌와 API 키가 없으면 사용할 수 없습니다.
API 키 발급은 키움증권 Rest API 포털에서 신청하시기 바랍니다.

핵심 기능 요약

① 자동 매매 전략

매매 전략의 핵심은 "어떤 종목을 언제 사고팔 것인가" 를 사전에 규칙으로 정의하는 것입니다.
종목 선정 방식: 키움증권 HTS 조건검색식 활용 또는 사용자가 직접 종목을 지정할 수 있습니다.

② 유연한 매수·매도 조건 설정

단순히 종목을 고르는 것을 넘어, 언제 사고 팔 것인지 세밀하게 조건을 설정할 수 있습니다.

• 준비 조건 : 매수 대기 상태 진입을 위한 선행 조건 (예: 조건검색식 포착 신호 수신)
• 실행 조건 : 실제 주문 실행 시점을 결정하는 조건 (예: 체결 강도 기준, 현재가 조건)
• 매도 조건 : 목표 수익률 도달, 손절 기준, 지정 시간 일괄 매도 등
• 금액 표현식 : 주문 금액을 수식으로 설정 (예: 보유 현금의 N%, 고정 금액 등)

③ 리스크 관리 기능

자동매매의 가장 큰 위험인 과도한 손실을 방지하기 위한 다양한 안전장치가 내장되어 있습니다.

④ 다양한 주문 유형 지원

주문 유형: 지정가, 시장가 및 시간외 단일가 주문을 모두 지원합니다.

⑤ 자동 실행 스케줄러

요일 및 시간대별로 매매 시작/종료를 예약할 수 있으며, 전략별로 독립된 실행 시간대(A/B 구간) 설정이 가능합니다.

⑥ 멀티 앱키 운용

하나의 프로그램에서 여러 개의 키움 앱키를 동시에 등록하고 운용할 수 있습니다.
각 앱키별로 독립적인 매매 전략을 실행할 수 있어 계좌 분리 운용이 가능합니다.

프로그램 동작 흐름 (한눈에 보기)

이 프로그램이 적합한 사용자

✅ 키움증권 조건검색식을 이미 활용하고 있는 사용자
✅ 자동매매를 시작하고 싶지만 코딩 없이 설정만으로 운용하고 싶은 사용자
✅ 여러 개의 매매 전략을 동시에 실행하고 결과를 모니터링하고 싶은 사용자
✅ AI 뉴스 분석을 매매 전략에 접목하고 싶은 사용자

이 프로그램이 적합하지 않은 사용자

❌ 키움증권 계좌가 없거나 API 키를 발급받지 않은 사용자
❌ 복잡한 초기 설정 없이 바로 사용하고 싶은 사용자
❌ 삼성증권, 미래에셋 등 타 증권사 계좌 사용자

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

1.3 주요 기능 한눈에 보기

부엉이 ATS는 실시간 시장 감시부터 복잡한 매매 전략 실행까지, 주식 투자의 전 과정을 사용자 중심의 직관적인 인터페이스로 자동화합니다.

① 대시보드 — 메인 화면에서 한 번에 확인

프로그램을 시작하면 메인 화면에서 아래 정보를 실시간으로 확인할 수 있습니다.

② 자동 매매 — 핵심 기능

매매 전략 만들기 (3가지 편집기)

전략 구성 요소

리스크 관리 설정

자동 매매 모니터링

③ 종목 및 계좌 조회

종목 조회

차트 데이터 조회

계좌 조회

④ 스케줄러

⑤ 설정 관리

⑥ 로그 및 시스템 정보

1.4 화면 구성 미리보기

이 항목은 부엉이 ATS 의 전체 화면 구성을 미리 파악하고
각 영역이 어떤 역할을 하는지 이해하는 데 도움을 줍니다.

메인 화면 전체 레이아웃

프로그램 실행 후 보이는 메인 창의 전체 구성은 다음과 같습니다.

각 영역 상세 설명

❶ 메뉴 바

화면 최상단에 위치하며, 프로그램의 모든 기능에 접근하는 진입점입니다.

💡 팁: 대부분의 조회 기능은 별도 창으로 열립니다. 이미 열려 있는 창을 다시 메뉴에서 선택하면 기존 창이 자동으로 앞으로 이동합니다.

❷ 계좌 현황 패널

메인 화면 왼쪽 상단에 고정된 패널입니다.
연결된 키움 계좌의 현재 자산 상태를 한눈에 확인할 수 있습니다.

❸ 자동매매 스위치 패널

등록된 매매 전략 목록과 각 전략의 실행 상태를 보여줍니다.
버튼 한 번으로 전략을 즉시 시작하거나 중지할 수 있습니다.

⚠️ 주의: [시작] 버튼을 누르는 순간 해당 전략이 즉시 활성화됩니다.
실계좌에서 사용 시 실제 주문이 자동 실행될 수 있으므로 주의하십시오.

❹ 일반 설정 패널

앱키별 리스크 관리 설정값을 메인 화면에서 바로 확인하고 수정할 수 있습니다.

❺ API 사용 제한 현황 패널

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

❻ 하단 탭 패널

메인 화면 하단의 핵심 정보 탭입니다.
탭 헤더의 숫자 배지(🔴)는 현재 데이터 건수를 실시간으로 표시합니다.

탭 ① 잔고

탭 ② 당일매매

탭 ③ 체결 / ④ 미체결

탭 ⑤ 조건검색식

탭 ⑥ 로그

❼ 업종 지수 바

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

❽ 상태 표시줄

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

별도 창으로 열리는 화면 목록

메뉴에서 선택 시 메인 창과 별도로 독립 창이 열리는 화면입니다.
여러 창을 동시에 열어 나란히 배치하여 사용할 수 있습니다.

📌 참고: 이미 열려 있는 창을 메뉴에서 다시 선택하면 새 창이 생성되지 않고 기존 창이 화면 앞으로 활성화됩니다.

테마 변경

[테마] 메뉴에서 밝은 화면과 어두운 화면 중 원하는 테마를 선택할 수 있습니다.

2. 설치 및 초기 설정

2.1 시스템 요구 사항

부엉이 ATS 을 정상적으로 사용하기 위해 필요한 하드웨어, 소프트웨어, 네트워크 환경을 안내합니다.
설치 전에 아래 요구 사항을 반드시 확인하시기 바랍니다.

하드웨어 요구 사항

⚠️ 주의: 자동매매 중 프로그램이 비정상 종료되면 미체결 주문이 남을 수 있습니다.
안정적인 PC 사양과 네트워크 환경에서 사용하시기 바랍니다.

💡 팁: 실시간 시세 수신, 다수 전략 동시 실행, AI 뉴스 분석 등 여러 기능을 동시에 사용하면
메모리 사용량이 증가합니다. 8 GB 이상의 RAM을 권장합니다.

운영체제 요구 사항

📌 참고: 부엉이 ATS 의 프로그램은 .NET 10 (Windows) 기반으로 작성되었습니다.

필수 소프트웨어

① .NET 런타임

부엉이 ATS 은 Microsoft .NET 10 기반으로 개발되었습니다.
인스톨러 실행 시 자동으로 설치 여부를 확인하지만, 사전에 설치되어 있으면 더 빠르게 시작할 수 있습니다.

💡 팁: .NET 런타임은 아래 Microsoft 공식 사이트에서 무료로 다운로드할 수 있습니다.
https://dotnet.microsoft.com/download

② 키움증권 관련 필수 요건

저장 공간 사용 현황

💡 팁: 로그 파일은 하루 1개씩 생성되며, 최대 20일치가 보관됩니다.
디스크 여유 공간이 부족해지면 오래된 로그 파일을 수동으로 삭제하시기 바랍니다.
로그 파일 위치: 내 문서 > SageLine > 부엉이 ATS > logs

지원 여부 요약표

⚠️ 투자 안정성 주의:
자동매매 프로그램 특성상 PC가 절전 모드, 화면 보호기, 또는 자동 재시작되면 실행 중인 전략이 중단됩니다.
자동매매 실행 중에는 아래 설정을 확인하세요.

• Windows 절전 모드 → 해제
• 화면 보호기 → 해제
• Windows 자동 업데이트 강제 재시작 → 활성 시간 설정으로 재시작 방지

2.2 프로그램 설치

설치 전 체크리스트

네이버까페 자료실에서 부엉이ATS 프로그램 설치 파일 다운로드 및 설치

https://cafe.naver.com/f-e/cafes/31344003/menus/11?t=1773202258583

※ 설치방법은 게시물을 참조하시 바랍니다.

처음 실행 시 자동 생성 파일

메인 화면이 처음 실행될 때 아래 파일들이 내 문서 폴더에 자동으로 생성됩니다.
삭제하거나 수정할 필요는 없으며, 편의 기능으로 활용할 수 있습니다.

💡 팁: 매일 자동매매를 사용한다면 Start부엉이 ATS .vbs 파일의 바로 가기를
Windows 시작 프로그램 폴더에 등록하면 PC 부팅 시 자동으로 실행됩니다.

중요한 자동 동작 안내

프로그램에는 아래 두 가지 자동 동작이 내장되어 있습니다.
반드시 숙지하시기 바랍니다.

① 오전 6시 — 종료 예고 알림

프로그램 자동 종료 (실행 중인 자동매매 전략 포함)

⚠️ 주의: 매일 오전 6시 5분에 프로그램이 자동 종료됩니다.
이는 키움증권 서버 점검 시간과 새벽 시간대의 불안정한 데이터 수신을 방지하기 위한 설계입니다.
자동매매가 계속 필요하다면 Start부엉이 ATS .vbs를 Windows 작업 스케줄러에 등록하여 오전 7시 30분 이후 자동 재시작하도록 설정하는 것을 권장합니다.
② 오전 6시 ~ 7시 30분 — 조기 실행 경고

키 미등록 상태에서 최초 실행 시 — API 키 등록 창

등록된 키움 API 키가 없거나 키가 유효하지 않으면 메인 화면 대신
키움 REST API KEY 등록 창이 자동으로 표시됩니다.

⚠️ 주의: 이 창에서 [취소] 를 클릭하면 프로그램이 자동으로 종료됩니다.
API 키를 발급받은 후 다시 실행하십시오.

2.3 필수 초기 설정

2.3.1 키움 API 앱키 등록

이 설정이 필요한 이유

부엉이 ATS 은 키움증권 REST API를 통해 주문 실행, 계좌 조회, 실시간 시세 수신 등 모든 핵심 기능을 수행합니다.
이를 위해서는 키움증권 Rest API 포털에서 발급받은 앱키(App Key) 와 시크릿키(Secret Key) 를 프로그램에 등록해야 합니다.

⚠️ 주의: 앱키와 시크릿키가 등록되지 않으면 프로그램의 모든 기능을 사용할 수 없습니다.

STEP 1 — 키움 Rest API 앱키 발급

까페 자료실의 키움증권_REST_API_사용신청_설명서_20260302.pptx 문서 참조

발급 시 확인 사항

⚠️ Secret Key는 절대로 타인에게 공개하지 마십시오.
유출 시 타인이 귀하의 계좌로 주문을 실행할 수 있습니다.
유출이 의심되면 키움 Rest API 포털에서 즉시 앱키를 재발급하십시오.

STEP 2 — 키움 REST API KEY 등록 창 열기

두 가지 방법으로 등록 창을 열 수 있습니다.

메인 화면 메뉴바

│

└── [설정]

└── [키움증권 REST API KEY 등록] ← 클릭

STEP 3 — 키움 REST API KEY 등록 창 화면 구성

📌 참고: 기본값은 모의투자 서버로 설정되어 있습니다.
실제 거래 계좌를 사용하려면 반드시 ● 실서버 로 변경하십시오.

STEP 4 — 계좌 및 키 입력

입력 방법

① 계좌번호 입력

계좌번호란 클릭 → 키움증권 계좌번호 입력 (하이픈(-) 없이 숫자만)

예: 1234567890

② 서버 구분 선택

● 실서버 ← 실제 거래 (실제 돈이 거래됨) ⚠️

● 모의투자 ← 테스트용 (가상 자금으로 연습)

③ App Key 입력

키움 Rest API 포털에서 발급받은 App Key 붙여넣기

④ Secret Key 입력

키움 Rest API 포털에서 발급받은 Secret Key 붙여넣기

⚠️ 처음 사용자는 반드시 모의투자 계좌로 먼저 테스트하십시오.
실서버 등록 후 자동매매를 시작하면 실제 돈으로 주문이 실행됩니다.

여러 계좌 등록 (멀티 앱키)

목록의 빈 행에 추가 계좌 정보를 입력하면 여러 개의 계좌/앱키를 동시에 등록할 수 있습니다.

💡 팁: 여러 앱키를 등록하면 API 호출 한도를 분산시킬 수 있습니다.
각 앱키별로 독립적인 매매 전략을 할당하여 운용할 수 있습니다.

STEP 5 — 유효성 검사 및 저장

[저장] 버튼을 클릭하면 아래 절차가 자동으로 진행됩니다.

① 입력값 유효성 검사

② 키움 API 서버에 실제 접속하여 키 유효성 확인

③ Windows 자격 증명 관리자에 암호화 저장

④ 저장 완료 메시지 표시

⑤ 창 자동 닫힘

STEP 6 — 프로그램 재시작

등록이 완료되면 반드시 프로그램을 재시작해야 변경 내용이 적용됩니다.

저장 위치 및 보안

💡 팁: 앱키는 PC 재부팅 후에도 유지됩니다.
Windows 자격 증명 관리자에 저장되므로 별도 파일로 평문 보관하지 않아 보안에 안전합니다.

오류 메시지 및 해결 방법

등록 완료 후 확인 방법

프로그램 재시작 후 메인 화면 계좌 현황 패널에서 계좌가 정상 연결되었는지 확인합니다.

계좌 현황 패널에 실제 잔고 데이터가 표시되면 앱키 등록이 완료된 것입니다.

📌 참고: 모의투자 계좌는 잔고가 가상 금액으로 표시됩니다.
처음에는 키움증권에서 지정한 모의투자 초기 자금이 표시됩니다.

3. 로그인

※ 회원가입은 하지 않아도 됩니다.

3.1 로그인 화면 안내

상단 메뉴의 [로그인] 버튼을 클릭하면 로그인 화면이 나타납니다.

화면 구성

⚠️ 투자 책임 고지 로그인 화면 하단에 표시된 안내문과 같이, 본 프로그램은 투자 판단 지원 도구이며 사용자의 투자 결정 및 손실에 대한 책임은 사용자 본인에게 있습니다.

3.2 자동 로그인 설정 방법

부엉이 ATS에는 두 가지 독립적인 자동 로그인 기능이 있습니다.

① 부엉이 ATS 자동 로그인 (IsAutoLogin)

SageLine 서버 인증(프로그램 라이선스 확인)을 자동으로 처리합니다.

설정 방법

1. 로그인 화면 우측 폼에서 "자동 로그인" 체크박스를 활성화합니다.
2. 정상적으로 로그인이 완료되면 해당 설정이 usersettings.json에 저장됩니다.

4. 메인 화면 안내

4.1 메인 화면 전체 구성

부엉이 ATS 의 메인 화면은 4개의 영역으로 구성됩니다.

① 메뉴바

화면 최상단에 위치하며, 프로그램의 모든 기능에 접근할 수 있는 메인 메뉴입니다.

② 대시보드 패널 (상단 4구역)

메뉴바 아래에 가로로 나란히 배치된 4개의 상시 표시 패널입니다. 프로그램을 사용하는 동안 항상 화면에 고정되어 있어 핵심 정보를 한눈에 확인할 수 있습니다.

계좌현황 (좌측 첫 번째)

등록된 계좌 목록과 선택한 계좌의 실시간 평가 현황을 표시합니다.

자동매매 실행 스위치 (두 번째)

등록된 자동매매 전략 목록과 각 전략의 실행 ON/OFF 스위치를 표시합니다.

• 스위치를 ON으로 전환하면 해당 전략이 즉시 자동매매를 시작합니다.
• 여러 전략을 동시에 활성화할 수 있습니다.
• 등록된 전략이 없으면 목록이 비어 있습니다. [자동매매] 메뉴에서 전략을 먼저 생성하세요.

일반설정 (세 번째)

거래 안전 한도를 설정하는 패널입니다. 계좌(앱키)별로 적용됩니다.

키움 Rest API 제한 현황 (네 번째)

키움증권 REST API의 현재 사용 제한 현황을 표시합니다.

API 제한 상세 내용은 15장 키움 API 사용 제한 관리를 참고하세요.

③ 탭 패널 (하단 중앙)

대시보드 패널 아래에 위치하며, 실시간 거래 현황 및 시스템 정보를 탭으로 구분하여 표시합니다. 각 탭 이름 옆의 숫자 뱃지는 해당 탭에 표시된 항목 수를 나타냅니다.

업종지수 바

탭 패널과 상태바 사이에 위치하며, 주요 시장 지수를 실시간으로 표시합니다.

④ 상태바

화면 최하단에 위치하며, 프로그램 동작 상태를 실시간으로 표시합니다.

좌측 — 상태 메시지

현재 프로그램이 수행 중인 작업이나 최근 처리 결과를 텍스트로 표시합니다.

우측 — 신호 표시 영역

[👤 아이디] ● ● ● ● [후원하기]

• 신호등에 마우스를 올리면 툴팁으로 해당 신호의 누적 횟수를 확인할 수 있습니다.
• ④ 연결 상태 신호가 회색이면 실시간 데이터가 수신되지 않는 상태입니다. 키움 서버 연결을 확인하세요.

후원하기 버튼

클릭 시 후원 계좌 정보(카카오뱅크)가 팝업으로 표시됩니다. 도움말 메뉴에서도 동일하게 접근할 수 있습니다.

4.2 메뉴 및 탭 설명

4.2.1 메뉴바 상세 설명

메인 화면 최상단에 위치한 메뉴바에서 프로그램의 모든 기능 화면을 열 수 있습니다.

📌 종목정보

주식 종목의 기본 정보와 현재가 시세를 조회하는 기능들이 모여 있습니다.

📌 계좌정보

키움증권 계좌의 잔고, 평가 손익, 예수금 현황을 상세 조회하는 기능들이 모여 있습니다.

📌 조건검색식

키움증권 HTS에 등록된 조건검색식을 불러와 실시간으로 포착 종목을 확인하는 기능입니다.

⚠️ 메뉴 항목이 빨간색으로 표시된 것은 키움 API 사용 횟수 제한에 민감한 기능임을 나타냅니다.

📌 자동매매

자동매매 전략을 설계하고 실행하는 프로그램의 핵심 기능들이 집약되어 있습니다.

📌 차트 데이터

종목과 업종의 과거 가격 데이터를 조회합니다.

💡 틱·주봉·월봉 차트는 현재 준비 중인 기능으로 추후 업데이트될 예정입니다.

📌 설정

프로그램 운영에 필요한 계정 및 API 키 등록과 자동화 스케줄을 설정합니다.

📌 도움말

프로그램 정보 확인과 지원 관련 기능입니다.

📌 테마

프로그램 전체 화면의 색상 테마를 변경합니다. 설정은 즉시 적용됩니다.

💡 야간 장시간 모니터링 시에는 Dark Theme를 사용하면 눈의 피로를 줄일 수 있습니다. 테마 변경 상세 방법은 4.4절을 참고하세요.

4.2.2 탭 패널 상세 설명

메인 화면 하단 탭 패널에는 총 7개의 탭이 있으며, 각 탭 이름 옆의 숫자 뱃지(🔢) 는 현재 해당 탭에 표시된 항목의 총 건수를 나타냅니다. 숫자가 변하면 새로운 데이터가 수신된 것입니다.

🗂️ 잔고 탭

현재 보유 중인 주식 종목 목록을 실시간으로 표시합니다.

• 우측 상단의 ↺ 새로고침 버튼을 누르면 키움 서버에서 잔고를 다시 조회합니다.
• 보유 종목이 없으면 목록이 비어 있습니다.

🗂️ 당일매매 탭

오늘 하루 동안 발생한 매수·매도 거래를 종목별로 집계하여 표시합니다.

• 매수만 하고 매도하지 않은 종목도 표시됩니다.
• 당일 장 종료 후 다음 날 초기화됩니다.

🗂️ 체결 탭

당일 체결된 주문 내역을 건별로 실시간 표시합니다. 자동매매와 수동 주문 모두 포함됩니다.

🗂️ 미체결 탭

주문을 냈으나 아직 체결되지 않고 대기 중인 주문 목록을 실시간으로 표시합니다.

💡 지정가 주문 시 원하는 가격에 매수·매도가 이루어지지 않으면 이 탭에 미체결 상태로 남습니다. 주문 취소는 10.4 주문 취소 방법을 참고하세요.

🗂️ 조건검색식 탭

현재 활성화된 실시간 조건검색식에 편입되거나 이탈한 종목 이력을 실시간으로 표시합니다. 화면은 좌측 목록과 우측 세부내역 두 영역으로 구성되며, 가운데 구분선을 드래그하여 비율을 조절할 수 있습니다.

좌측 — 포착 종목 목록

우측 — 세부내역

좌측 목록에서 종목을 선택하면 해당 종목의 편입·이탈 세부 기록이 우측에 표시됩니다.

🗂️ 로그 탭

프로그램의 동작 로그를 실시간으로 출력합니다.

• API 요청·응답, 주문 실행, 오류 발생 등의 내역이 시간 순서로 누적됩니다.
• 로그 내용을 마우스로 선택하여 복사할 수 있습니다.
• 스크롤을 올려 이전 로그를 확인할 수 있습니다.
• 과거 날짜의 로그 파일은 [도움말] → [Log 관리] 에서 조회하세요.

🗂️ 시스템 정보 탭

프로그램의 내부 성능 지표를 실시간으로 표시합니다.

실시간 주식 체결 데이터 지연 정보 (최근 100만 건 기준)

WebSocket으로 수신된 실시간 체결 데이터의 처리 지연 시간 분포를 구간별로 표시합니다.

💡 지연 건수가 많거나 5,000ms 이상 구간이 증가하는 경우 17장 시스템 정보 확인을 참고하여 원인을 점검하세요.

4.3 상태 표시 영역 읽는 방법 (연결 상태, 로그인 상태)

상태 표시 영역은 메인 화면 최하단 상태바에 위치하며, 좌측과 우측 두 부분으로 나뉩니다.

[상태 메시지] [👤 아이디] ① ② ③ ④ [후원하기]

좌측 — 상태 메시지

프로그램이 현재 수행 중인 작업 또는 가장 최근의 처리 결과를 텍스트로 표시합니다.

우측 — 신호 표시 영역 상세 안내

우측에는 로그인한 계정 정보와 4개의 신호등 원형 아이콘(●) 이 순서대로 표시됩니다.

👤 아이디 표시

[👤] 홍길동

• 현재 SageLine 서비스에 로그인된 계정의 사용자 ID를 표시합니다.
• 로그인하지 않은 상태이면 Guest로 표시됩니다.
• 아이디 변경은 [설정] → [로그인] 을 통해 다시 로그인하면 갱신됩니다.

① TR 요청 신호등

● ← TR 요청 신호

키움증권 REST API에 데이터 조회 요청(TR) 이 발생할 때마다 점등됩니다.

• 마우스를 올리면 툴팁으로 "TR 요청 N건" (누적 횟수)이 표시됩니다.
• 장 중 조회 기능 사용 시 활발하게 깜빡입니다.
• 이 신호가 전혀 점등되지 않으면 API 요청 자체가 발생하지 않는 상태입니다.

② 키움 서버 Ping 수신 신호등

● ← Ping 수신 신호

키움 서버가 보내는 WebSocket Ping 메시지를 수신할 때 점등됩니다. WebSocket 연결이 살아있음을 확인하는 심박 신호입니다.

• 마우스를 올리면 툴팁으로 "키움 서버 Ping 수신 N건" 이 표시됩니다.
• 키움 서버와 연결된 정상 상태에서는 일정 주기로 자동 점등됩니다.
• Ping이 수 분 이상 점등되지 않으면 연결이 단절된 상태일 수 있습니다. ④ 연결 상태 신호등도 함께 확인하세요.

③ 실시간 데이터 수신 신호등

● ← 실시간 데이터 수신 신호

WebSocket을 통해 실시간 시세·체결 데이터가 수신될 때마다 점등됩니다.

• 마우스를 올리면 툴팁으로 "실시간 데이터 수신 N건" 이 표시됩니다.
• 자동매매 실행 중, 또는 실시간 조건검색식이 활성화된 상태에서 빠르게 깜빡입니다.
• 장 중에 이 신호가 전혀 점등되지 않으면 실시간 시세 수신이 중단된 상태입니다.

④ 통신 연결 상태 신호등

● ← 연결 상태 신호 (펄스 애니메이션)

키움 서버와의 WebSocket 상시 연결 상태를 나타냅니다. 1.5초 주기로 색상이 천천히 펄스(점멸)되어 현재 연결 상태를 직관적으로 알 수 있습니다.

④ 신호등이 빨간색일 때 점검 순서:

1. 인터넷 연결이 정상인지 확인합니다.
2. [설정] → [키움증권 REST API KEY 등록] 에서 앱키와 시크릿키가 올바르게 등록되어 있는지 확인합니다.
3. 키움증권 서버 점검 시간이 아닌지 확인합니다.
4. 프로그램을 완전히 종료 후 재시작합니다.

신호등 전체 요약

[👤 아이디] ① ② ③ ④

TR Ping 실시간 연결

요청 수신 데이터 상태

4.4 테마 변경 방법

부엉이 ATS 은 Material Design 기반의 테마 엔진을 사용하며, 메뉴바의 [테마] 메뉴에서 화면 전체의 색상을 즉시 변경할 수 있습니다.

배경 테마 전환

배경색과 전체 색조를 변경합니다.

변경 방법:

1. 메뉴바에서 [테마] 를 클릭합니다.
2. [Light Theme] 또는 [Dark Theme] 를 클릭합니다.
3. 클릭 즉시 전체 화면 테마가 전환됩니다.

포인트 컬러 변경

메뉴, 버튼, 탭 등 강조 색상(포인트 컬러)을 변경합니다. 배경 테마(Light/Dark)와 독립적으로 적용됩니다.

변경 방법:

1. 메뉴바에서 [테마] 를 클릭합니다.
2. [Primary : Blue], [Primary : Green], [Primary : Orange] 중 원하는 항목을 클릭합니다.
3. 메뉴바, 탭, 버튼 등의 강조 색상이 즉시 변경됩니다.

테마 조합 예시

⚠️ 주의: 현재 선택한 테마 설정은 프로그램 재시작 시 초기화됩니다. 매번 원하는 테마를 다시 선택하거나, 향후 업데이트를 통해 설정 저장 기능이 추가될 예정입니다.

5. 자동 매매 전략 설정

5.1 자동 매매 전략이란?

1. 개요

자동 매매 전략은 사용자가 사전에 정의한 규칙에 따라 종목 선정 → 매수 → 매도의 전 과정을 프로그램이 스스로 수행하도록 하는 '투자 알고리즘 묶음'입니다. 전략을 한 번 설정해 두면, 장중에 사용자가 PC 앞에 없어도 프로그램이 실시간으로 시장을 감시하며 조건 충족 시 즉시 주문을 실행합니다.

2. 전략의 2계층 구조

부엉이 ATS 의 자동 매매는 매매 전략(TradeStrategy) 과 그 하위의 주문 전략(OrderStrategy) 으로 나뉘어 있습니다.

매매 전략 (TradeStrategy) ← "무엇을 어떤 계좌로 거래하는가?"

├── 주문 전략 1 (OrderStrategy) ← "매수: 어떤 조건에서 얼마나 살 것인가?"

├── 주문 전략 2 (OrderStrategy) ← "매도: 어떤 조건에서 얼마나 팔 것인가?"

└── 거래 제외 조건 ← "어떤 종목은 거래하지 않을 것인가?"

3. 주요 설정 항목 가이드

① 매매 전략 (상위 단계: 운영 환경 설정)

매매 전략은 거래의 전체 틀을 정의합니다.

② 주문 전략 (하위 단계: 실행 규칙 설정)

주문 전략은 하나의 매수 또는 매도 규칙을 나타냅니다. 하나의 매매 전략 안에 여러 개의 주문 전략을 추가할 수 있으며, 각각 독립적으로 동작합니다.

4. 종목 선정 방식 (3가지)

매매 전략이 어떤 종목을 감시하고 거래할지를 결정하는 방식입니다.

조건 표현식이란?

주문 전략의 준비/실행 조건에는 조건 표현식을 사용할 수 있습니다. 조건 표현식은 현재가, 등락률, 거래량, 이동평균 등 다양한 시세 데이터를 수식으로 조합하여 사용자 고유의 매매 기준을 정밀하게 표현하는 기능입니다.

예) A: 현재가 > 전일종가 * 1.03 → "전일 종가 대비 3% 이상 상승했을 때"

조건 표현식은 별도의 조건 표현식 편집기에서 작성하고 저장하며, 여러 전략에 재사용할 수 있습니다.

5. 한눈에 보는 전략 실행 흐름

[전략 시작]

↓

종목 선정 방식에 따라 감시 대상 종목 결정

↓

실시간 시세 수신 (체결가, 호가 등)

↓

주문 전략의 준비 조건 충족 여부 확인

↓ (충족 시)

주문 전략의 실행 조건 충족 여부 확인

↓ (충족 시)

거래 제외 조건 검사 (해당 종목이 제외 대상인지 확인)

↓ (제외 아닌 경우)

보유 수 제한, 재매수 제한, 일일 한도 검사

↓ (통과 시)

주문 금액 계산 → 주문 전송 (매수 또는 매도)

↓

체결 결과 수신 및 포지션 업데이트

↓

지정 시각이 되면 일괄 매도 또는 전략 자동 완료

여러 전략 동시 운영

부엉이 ATS 은 복수의 매매 전략을 동시에 실행할 수 있습니다. 각 전략은 서로 다른 계좌, 다른 종목, 다른 시간대로 독립적으로 구성하고 실행할 수 있습니다.

예를 들어 아래와 같이 구성하는 것도 가능합니다:

• 전략 A: 오전 9시~10시, 조건검색식 기반, 계좌 1번
• 전략 B: 오후 2시~3시, AI 특징주 기반, 계좌 2번
• 전략 C: 종일, 단일 종목(삼성전자), 계좌 1번

각 전략의 ON/OFF는 자동 매매 스위치 대시보드에서 개별적으로 제어할 수 있습니다.

5.2 매매 전략 목록 확인 방법

5.2.1 매매 전략 목록 화면 열기

메인 메뉴에서 [자동매매] → [자동매매 편집기] 를 클릭하면 자동매매 편집기 창이 열립니다. 창의 왼쪽 패널에 현재 등록된 모든 매매 전략 목록이 표시됩니다.

5.2.2 목록 구성 요소

매매 전략 목록은 등록된 전략을 한 행씩 나열하며, 각 행에는 다음 정보가 표시됩니다.

5.2.3 전략 상태 표시 (정상 / 오류)

각 전략 행의 상태 열에는 현재 전략의 이상 여부가 표시됩니다.

• 정상: 전략 구성에 문제가 없으며 실행 가능한 상태입니다.
• 오류 (🔴 빨간색 강조): 전략 구성에 오류가 감지된 상태입니다. 오류가 있는 전략은 자동매매 스위치 대시보드에 표시되지 않으며, 실행되지 않습니다.

⚠️ 주의: 오류 상태의 전략은 자동매매가 동작하지 않습니다. 원인을 파악하려면 해당 전략을 선택한 뒤 내용을 확인하고 오류를 수정한 후 저장하십시오.

5.2.4 실행 중인 전략 구별

사용 여부 및 실행 여부 열을 통해 각 전략이 현재 동작 중인지 확인할 수 있습니다.

• 사용중 + 실행중: 전략이 활성화되어 자동매매가 진행 중입니다.
• 사용중 + 실행중지: 전략은 등록되어 있으나 현재 실행되고 있지 않습니다.
• 사용중지: 해당 전략이 비활성화된 상태로, 자동매매 스위치 대시보드에 표시되지 않습니다.

⚠️ 주의: 실행중 상태인 전략을 수정하면 예상치 못한 오류나 누락 거래가 발생할 수 있습니다. 전략 수정 전 반드시 해당 전략의 실행을 중지한 후 수정하는 것을 권장합니다.

5.2.5 전략 상세 정보 확인

목록에서 전략 항목을 클릭하면 오른쪽 패널에 해당 전략의 상세 설정 내용이 표시됩니다.

확인할 수 있는 정보:

• 전략 이름 / 연결 계좌 / 종목 선정 방식
• 기본 주문 금액 / 보유 종목 수 제한
• 자동 거래 시간대 설정 (A/B 구간)
• 매수·매도 시간 제한 설정
• 하위 주문 전략 목록 (오른쪽 패널에 별도 표시)

5.2.6 목록에서 가능한 작업

전략 목록 위에서 마우스 우클릭하면 컨텍스트 메뉴가 나타납니다.

⚠️ 삭제 시 주의: 전략에 종속된 매매 이력(주문, 체결 내역)이 존재하는 경우 함께 삭제됩니다. 삭제 전 반드시 확인 메시지를 읽어보십시오.

⚠️ 가져오기 시 주의: 외부에서 가져오는 전략에 키움 조건검색식이 포함된 경우, 해당 조건검색식 이름이 내 영웅문 HTS에 동일하게 등록되어 있어야 합니다.

5.2.7 전략 순서 변경

목록 오른쪽 하단의 ▲ / ▼ 버튼을 사용하여 전략의 실행 우선 순서를 변경할 수 있습니다.

• ▲ (위로 이동): 선택된 전략을 목록에서 한 칸 위로 이동합니다.
• ▼ (아래로 이동): 선택된 전략을 목록에서 한 칸 아래로 이동합니다.

변경된 순서는 즉시 데이터베이스에 저장되며, 다음에 화면을 열어도 유지됩니다.

💡 가장 위에 있는 전략이 선택 상태일 때는 ▲ 버튼이 비활성화됩니다. 목록 맨 아래 전략은 ▼ 버튼이 비활성화됩니다.

제한 사항

.8

5.2.8 오류 상태 전략 처리 방법

목록에서 전략 이름이 빨간색으로 표시되면 다음을 확인하십시오.

1. 해당 전략을 클릭하여 연결된 계좌번호가 올바른지 확인합니다.

5.3 새 매매 전략 만들기

5.3.1 전략 이름 및 계좌 설정

화면 위치

자동매매 만들기 창에서 왼쪽 전략 목록의 항목을 선택하면, 오른쪽 패널 상단에 전략의 기본 설정 영역이 표시됩니다. 이 영역은 크게 ① 이름, ② 기본 설정, ③ 자동 실행 시간대 세 부분으로 구성됩니다.

① 전략 이름 설정

• 새 전략을 생성하면 기본 이름 "새 자동매매" 로 자동 설정됩니다.
• 이름이 겹치는 경우 "새 자동매매 (1)", "새 자동매매 (2)" 형식으로 번호가 붙습니다.
• 이름은 반드시 입력해야 합니다. 비어 있으면 저장이 되지 않으며 입력창 아래에 경고 문구가 표시됩니다.
• 이름은 언제든지 수정할 수 있으며, 수정 후 저장 버튼을 클릭해야 반영됩니다.

💡 전략 목적이 명확히 드러나는 이름을 사용하면 여러 전략을 관리할 때 편리합니다. 예) 갭 상승 편입 매매, 오전 단기 모멘텀, AI 특징주 오후

② 기본 설정

계좌번호

• 목록에는 2.3.1 키움 API 앱키 등록 에서 등록된 계좌만 표시됩니다.
• 등록된 계좌가 없으면 목록이 비어 있으며, 먼저 앱키를 등록해야 합니다.
• 하나의 전략에는 하나의 계좌만 연결할 수 있습니다.
• 서로 다른 전략에 동일한 계좌를 중복 연결하는 것은 허용됩니다.

⚠️ 계좌 변경 시 주의: 이미 진행 중인 주문이나 매매 이력이 있는 전략의 계좌번호를 변경하면 예상치 못한 문제가 발생할 수 있습니다. 변경 시 경고 메시지를 반드시 확인하십시오.

최초 매수 방법 (키움 조건검색식 전략 전용)

💡 일반적으로 편입은 조건에 방금 부합한 종목을 즉시 포착하므로 단기 매매에 적합합니다. 포착은 설정된 시간에 조건을 만족하는 모든 종목을 한 번에 조회합니다.

기본 매수 금액

• 숫자만 입력하며, 천 단위 구분 기호(,)가 자동으로 표시됩니다.
• 입력 가능 범위: 0원 이상 ~ 10,000,000원 이하
• 범위를 벗어나면 입력창 아래에 경고 문구가 표시되며 저장이 차단됩니다.
• 새 전략의 기본값은 100,000원입니다.

⚠️ 이 금액이 곧 1회 주문 금액이 되는 것은 아닙니다. 실제 주문 금액은 주문 전략에 설정된 금액 표현식의 계산 결과에 따라 결정되며, 이 기본 매수 금액은 표현식 내에서 변수로 활용될 수 있습니다. (→ 5.3.5 주문 금액 설정 참고)

③ 자동 실행 시간대 설정

전략이 자동으로 매매를 실행할 수 있는 허용 시간 구간을 설정합니다. 각 항목은 체크박스로 활성화/비활성화를 제어하며, 비활성화된 항목은 시간 제한 없이 동작합니다.

자동 실행 시간 (A/B)

전략 전체의 자동 매수·매도가 실행될 수 있는 시간대를 설정합니다.

예) 오전 9:0010:30 / 오후 14:0015:00 두 시간대만 거래하고 싶은 경우 A와 B를 각각 설정합니다.

자동 매수 실행 시간 (A/B)

매수 주문만 허용할 시간 구간을 별도로 지정합니다.

💡 자동 실행 시간과 자동 매수 실행 시간이 모두 설정된 경우, 매수 주문은 두 조건을 모두 만족하는 시간대에만 실행됩니다.

자동 매도 실행 시간 (A/B)

매도 주문만 허용할 시간 구간을 별도로 지정합니다.

④ 지정 일시 자동 완료

설정한 일시가 되면 전략의 실행을 자동으로 종료합니다.

예) "익일 15:30" 설정 → 매매 작업이 생성된 다음 날 오후 3시 30분에 전략 실행이 자동으로 종료됩니다.

⑤ 지정 일시 일괄 매도

설정한 일시에 이 전략이 보유한 모든 종목을 일괄 매도합니다.

⚠️ 일괄 매도와 자동 완료 함께 사용 시: 일괄 매도 시각보다 자동 완료 시각이 빠르면 매도 전에 전략이 종료될 수 있습니다. 두 시각의 순서를 반드시 확인하십시오.

저장 방법

모든 설정 입력이 완료되면 화면 우측 하단의 [저장] 버튼을 클릭합니다.

• 신규 전략: 새 전략이 데이터베이스에 등록됩니다.
• 기존 전략 수정: 이미 진행 중인 주문이 있을 경우 추가 확인 메시지가 표시됩니다.
• 저장 성공 시 "저장이 완료 되었습니다." 메시지가 표시됩니다.

💡 저장하지 않고 창을 닫으면 변경 내용이 사라집니다. 수정 후 반드시 저장 버튼을 클릭하십시오.

5.3.2 종목 선정 방식 선택

자동 매매 전략이 어떤 종목을 대상으로 매매를 실행할지를 결정하는 핵심 설정입니다. 부엉이 ATS 는 2가지 종목 선정 방식을 제공하며, 각 방식은 독립된 전략 편집 창으로 구분됩니다.

① 조건검색식 기반 자동 선정

개요

키움증권 HTS(영웅문)에서 사용자가 직접 작성·저장한 키움 조건검색식을 사용하여 매매 대상 종목을 자동으로 선정합니다. 조건검색식에 해당하는 종목이 감지되는 순간 전략이 반응하여 주문 조건 평가를 시작합니다.

포착과 편입의 차이

이 방식에서는 조건검색식을 종목에 적용하는 시점을 포착과 편입 중 하나로 선택합니다.

💡 편입 방식은 조건검색식 이탈 신호는 처리하지 않으며, 새로 편입되는 종목만 추적합니다.

동작 흐름 (편입 방식 기준)

키움 API → 실시간 조건검색식 편입 신호 수신

↓

전략에 설정된 조건검색식 이름과 수신된 신호 비교

↓ (일치 시)

해당 종목에 대한 매매 전략 작업(Job) 자동 생성

↓

주문 전략의 준비 조건 / 실행 조건 평가 시작

↓

조건 충족 시 매수/매도 주문 전송

사용 전 필수 확인 사항

• 키움증권 HTS(영웅문)에서 해당 조건검색식이 등록되어 있어야 합니다.
• 전략에 설정한 조건검색식 이름과 HTS에 저장된 이름이 정확히 일치해야 합니다.
• KRX 종목은 오전 9:00 ~ 오후 3:30 사이의 데이터만 처리됩니다.

② 사용자 지정 종목

개요

사용자가 거래할 종목을 직접 1개 지정하는 방식입니다. 해당 종목만 지속적으로 감시하며, 주문 전략의 조건이 충족될 때 매수·매도 주문을 전송합니다.

종목 선택 방법

1. 전략 설정 화면에서 종목 항목 옆의 🔍 (돋보기) 버튼을 클릭합니다.
2. 종목 선택 창이 열립니다.
3. 검색창에 종목코드 또는 종목명 일부를 입력하면 목록이 실시간으로 필터링됩니다.
4. 목록에서 원하는 종목을 선택한 후 확인 버튼을 클릭합니다.
5. 전략 화면에 선택된 종목코드와 종목명이 표시됩니다.

⚠️ 단일 종목 방식에서는 보유 종목 수 제한과 동일 종목 재매수 제한 옵션이 이 1개 종목에 대해서만 적용됩니다.

💡 단일 종목 방식은 특정 종목에 집중하여 세밀한 조건을 걸어두고 싶을 때 적합합니다. 예) 항상 삼성전자만 거래하는 전용 전략을 만들 때.

5.3.3 매수 조건 설정 (조건 표현식 편집기)

개요

매수 조건 설정은 주문 전략 편집기에서 이루어집니다. 하나의 주문 전략은 준비 조건과 실행 조건 두 단계로 구성되며, 두 조건이 순서대로 충족될 때 매수 주문이 전송됩니다.

[준비 조건 충족] → [실행 조건 충족] → 매수 주문 전송

주문 전략 편집기 열기

전략 목록 화면 오른쪽의 매매 전략 상세 영역에서:

• [+] 버튼: 새 주문 전략 생성
• [✏ 연필] 버튼: 선택된 주문 전략 수정

클릭하면 "주문전략상세 편집" 창이 열립니다.

편집기 화면 구성

① 매수/매도 구분

창 상단 좌측에서 이 주문 전략이 매수인지 매도인지를 선택합니다.

💡 매수 전략 구성 예시: 최초매수 1개 + 추가매수(매수) 1개를 함께 설정하면, 최초 진입 후 조건 충족 시 물타기/분할 매수가 가능합니다.

② 주문유형 및 틱 조정

③ 실행주기

조건이 충족될 때 이 주문 전략을 몇 번 실행할지를 결정합니다.

④ 준비 조건 설정

준비 조건은 매수 주문을 전송하기 전에 먼저 충족되어야 하는 선행 조건입니다. 우측 상단의 [사용] 토글로 활성화/비활성화할 수 있습니다.

조건 타입 선택

[시스템조건식] 선택 시

[키움 조건검색식] 선택 시

⑤ 실행 조건 설정

실행 조건은 준비 조건이 충족된 이후에 실제 매수 주문을 전송하기 위한 최종 확인 조건입니다. 준비 조건과 동일한 구조(시스템조건식 / 키움 조건검색식 / 사용자 정의)로 설정합니다.

💡 준비 조건과 실행 조건을 서로 다른 조건검색식으로 구성하는 것도 가능합니다. 예) 준비: A 조건검색식 편입 → 실행: B 조건검색식 편입

💡 [사용] 토글을 비활성화하면 준비 또는 실행 조건을 건너뛰고 나머지 조건만으로 주문이 실행됩니다.

⑥ 시스템조건식 편집기

[시스템조건식 만들기 (준비, 실행)] 버튼을 클릭하면 "시스템조건식 만들기" 창이 열립니다. 이 편집기에서 준비·실행 조건에서 사용할 시스템조건식을 직접 작성하고 저장합니다.

편집기 화면 구성

시스템조건식 작성 방법

1. [+] 버튼으로 새 시스템조건식을 생성합니다.
2. 그룹명을 입력하거나 기존 그룹을 선택합니다. (새 그룹명을 직접 입력하면 새 그룹이 생성됩니다)
3. 이름을 입력합니다.
4. 시스템조건식 Unit 목록에서 [+] 버튼을 클릭하여 조건 행을 추가합니다.
5. 좌항, 비교연산자, 우항을 입력합니다.

비교연산자 종류

사용 가능한 피연산자 목록

피연산자는 탭별로 분류되어 있으며, 항목 옆의 [L] 버튼은 좌항에, [R] 버튼은 우항에 자동 입력됩니다.

📌 실시간 주식 정보 탭

📌 차트 데이터 탭

📌 준비조건 만족 후 탭

준비 조건이 충족된 이후의 가격 변화 정보를 실행 조건에서 활용할 때 사용합니다.

시스템조건식 조합 방법

여러 개의 조건 Unit을 추가한 경우, 각 Unit 간의 논리 관계를 **조합(Combination)**으로 표현합니다.

💡 [다른 시스템조건식 가져오기] 버튼을 사용하면 기존에 저장된 다른 시스템조건식의 Unit을 현재 편집 중인 시스템조건식에 복사해 올 수 있습니다.

시스템조건식 작성 예시

예시 1) 현재가가 시가보다 높고, 체결강도가 150 이상일 때 준비 조건 충족

→ 조합: A AND B

예시 2) 준비 후 현재가가 준비 완료가 대비 0.5% 하락하면 실행 조건 충족 (손절 매도 조건으로 사용 시)

→ 조합: A

⑦ 저장 및 적용

1. 시스템조건식 편집이 완료되면 [저장] 버튼을 클릭합니다.
2. 저장된 시스템조건식은 주문 전략 편집기의 준비조건/실행조건 드롭다운 목록에 즉시 반영됩니다.
3. 원하는 시스템조건식을 선택한 후 [확인] 버튼을 클릭하면 주문 전략에 조건이 저장됩니다.

⚠️ [확인] 버튼 없이 창을 닫으면 변경된 주문 전략 설정이 저장되지 않습니다. 이후 매매 전략 편집기의 [저장] 버튼을 클릭해야 최종적으로 반영됩니다.

5.3.4 매도 조건 설정

개요

매도 조건 설정은 5.3.3 매수 조건 설정과 동일한 주문 전략 편집기에서 이루어집니다. 편집기 구조(준비 조건 / 실행 조건 / 조건 표현식 편집기)는 매수와 동일하며, 매수/매도 구분을 "매도"로 설정하는 것이 핵심 차이입니다.

매도 주문 전략 생성 방법

1. 매매 전략 상세 영역에서 [+] 버튼을 클릭하여 새 주문 전략을 추가합니다.
2. 매수/매도 드롭다운에서 "매도" 를 선택합니다.
3. 준비 조건, 실행 조건, 주문 금액 계산식을 설정합니다.
4. [확인] 버튼을 클릭합니다.

💡 하나의 매매 전략에 매수 주문 전략과 매도 주문 전략을 함께 설정해야 자동으로 매수 후 매도까지 이루어집니다. 매도 주문 전략이 없으면 매수한 종목을 자동으로 매도하지 않습니다.

매도 조건과 매수 조건의 주요 차이점

매도 전용 피연산자

매도 시스템조건식에서는 매수 조건에서 사용하는 모든 피연산자에 더해, 아래의 보유 포지션 관련 피연산자를 사용할 수 있습니다.

📌 보유 포지션 탭

매도 전략 유형별 구성 예시

예시 1) 고정 익절 / 손절 매도

→ 두 조건을 OR로 결합하거나, 각각 별도 주문 전략(매도)으로 추가합니다.

예시 2) 평균 매수가 기준 손익 매도 (분할 매수 시 활용)

예시 3) 고점 추적 매도 (트레일링 스탑)

준비 조건 충족 이후의 고가를 기준으로 하락 폭이 일정 수준을 넘으면 매도합니다.

예시 4) 보유 일수 기준 강제 매도

예시 5) 체결강도 약화 매도 (모멘텀 소실 감지)

매도 조건 동작 시 내부 처리 규칙

일괄 매도와의 관계

5.3.1 전략 이름 및 계좌 설정에서 지정 일시 일괄 매도를 활성화한 경우, 해당 시각이 되면 매도 주문 전략의 조건 충족 여부와 관계없이 보유 종목 전체를 일괄 매도합니다.

⚠️ 일괄 매도와 시스템조건식 매도가 동시에 활성화된 경우, 시스템조건식 매도가 먼저 체결될 수 있습니다. 일괄 매도 시각 이전에 이미 시스템조건식으로 매도되면 일괄 매도는 보유 수량이 없어 실행되지 않습니다.

매도 주문 전략 저장 흐름

편집기에서 조건 설정 완료

↓

[확인] 버튼 클릭

↓

매매 전략 상세 목록에 "매도" 행 추가 확인

↓

자동매매 만들기 화면의 [저장] 버튼 클릭

↓

데이터베이스에 최종 저장

↓

자동 매매 실행 시 매도 조건 감시 시작

5.3.5 주문 금액 설정 (금액 표현식 편집기)

개요

주문 금액 설정은 자동 매매 시 실제로 얼마어치 주문을 낼지를 수식(계산식)으로 정의하는 기능입니다. 단순히 고정 금액을 입력하는 대신, "기본주문금액 × 2", "기본주문금액 / 보유수량" 과 같이 변수와 연산자를 조합한 표현식을 만들어 유연하게 주문 금액을 제어할 수 있습니다.

정의된 계산식은 금액 표현식 편집기를 통해 생성·수정·삭제하며, 이후 매매 전략의 주문 전략 설정 항목에서 원하는 계산식을 선택하여 전략에 연결합니다.

금액 표현식 편집기 열기

매매 전략 편집기의 "주문 전략 설정" 탭에서 [주문금액식 만들기] 버튼을 클릭하면 별도 창(주문금액식 만들기)이 열립니다.

편집기 화면 구성

편집기 창은 좌우 두 영역으로 나뉩니다.

계산식 목록 (왼쪽 패널)

• DataGrid 목록: 저장된 계산식이 용도와 이름 열로 표시됩니다.
  • 목록에서 항목을 클릭하면 오른쪽 편집 영역에 해당 계산식이 로드됩니다.
• [+] 버튼: 새 계산식을 추가합니다. "새 주문 금액 계산식" 이라는 이름으로 항목이 생성되며, 이름이 중복되면 자동으로 번호가 붙습니다 (예: 새 주문 금액 계산식 (1)).
• [−] 버튼: 선택된 계산식을 삭제합니다. 단, 기본 계산식(IsRequired) 으로 지정된 항목은 삭제할 수 없습니다.
• [계산식을 이름으로 사용] 체크박스: 체크 시 저장할 때 수식 문자열 자체가 이름으로 자동 설정됩니다 (예: 수식이 기본주문금액 * 2이면 이름도 기본주문금액 * 2로 저장).

계산식 편집 (오른쪽 패널)

① 용도 선택

계산식마다 용도를 별도로 지정할 수 있으므로, 매수용 계산식과 매도용 계산식을 각각 따로 만들어 관리할 수 있습니다.

② 이름 입력

계산식의 이름을 자유롭게 입력합니다. 목록에서 식별할 수 있는 직관적인 이름을 권장합니다. (예: 기본 2배 매수, 추가매수용, 전량 매도)

③ 수식 구성 (계산식 빌더)

수식은 좌변 피연산자 + 연산자 + 우변 숫자 3가지 요소로 구성됩니다.

[ 좌변 피연산자 ] [ 연산자 ] [ 우변 숫자 ]

기본주문금액 * 1

좌변 피연산자 (변수)

드롭다운에서 선택합니다.

연산자

드롭다운에서 선택합니다.

우변 숫자

직접 숫자를 입력합니다. 소수점 숫자도 입력 가능합니다 (예: 0.5, 2, 1.5).

수식 예시

참고: 기본주문금액의 기준값은 환경 설정(TradingConfig)의 일일 최대 매수 금액 및 주문 전략 설정과 연동되어 결정됩니다.

저장 및 삭제

• [저장] 버튼: 현재 편집 중인 계산식을 저장합니다.
  • 새로 만든 항목은 DB에 추가(ADD)됩니다.
  • 기존 항목은 수정(UPDATE)됩니다.
  • 저장 전 확인 메시지가 표시됩니다.
• [닫기] 버튼: 편집기 창을 닫습니다. 저장하지 않은 변경사항은 반영되지 않습니다.
• 삭제 시 기본 주문 금액 계산식으로 지정된 항목(IsRequired = true)은 삭제 불가하며, 오류 메시지가 표시됩니다.

매매 전략에 계산식 연결하기

편집기에서 계산식을 저장한 후, 주문 전략 설정 화면의 주문금액 표현식 드롭다운에서 원하는 계산식을 선택하면 해당 전략에 적용됩니다. 선택된 계산식의 이름과 수식 내용이 화면에 함께 표시되어 확인할 수 있습니다.

주의사항

• 계산 결과가 0 이하가 되지 않도록 수식을 설계하십시오.
• 수식에 사용할 수 있는 변수는 현재 기본주문금액, 보유수량 두 가지이며, 대소문자 및 띄어쓰기에 주의하십시오.
• 연산은 단일 이항 연산(변수 연산자 숫자)만 지원합니다. 복잡한 괄호식이나 다중 연산은 지원하지 않습니다.

5.3.6 주문 전략 설정 (주문전략상세 편집)

개요

주문 전략은 자동 매매에서 실제 주문을 어떻게 실행할지 정의하는 규칙 단위입니다. 하나의 매매 전략에는 여러 개의 주문 전략을 등록할 수 있으며, 각 주문 전략은 "어떤 조건이 되면 / 어떤 유형으로 / 얼마에 / 주문한다" 는 흐름으로 구성됩니다.

주문전략상세 편집 창은 이 흐름의 모든 항목을 설정하는 화면입니다.

화면 열기

매매 전략 편집 화면의 주문 전략 탭에서 전략 항목을 더블 클릭하거나, 추가 버튼으로 새 주문 전략을 생성하면 주문전략상세 편집 창이 열립니다.

화면 구성 요약

① 매수/매도 구분

주문의 성격을 지정합니다.

💡 최초매수와 매수를 각각 별도의 주문 전략으로 구성하면 분할 매수 전략을 구현할 수 있습니다.

② 주문유형 (거래 구분)

실제 주문을 어떤 방식으로 제출할지 지정합니다.

③ 호가 기준 틱 설정 (TickGap)

주문유형이 현재가 또는 시간외단일가인 경우에만 표시됩니다.

현재가를 기준으로 몇 틱 위/아래 가격으로 지정가 주문할지를 설정합니다.

💡 매수 주문 시: 틱을 높게 설정할수록 체결 가능성이 높아지지만 불리한 가격으로 체결될 수 있습니다. 💡 매도 주문 시: 틱을 낮게 설정할수록 빠른 매도가 가능하지만 더 낮은 가격에 체결될 수 있습니다.

④ 실행주기

해당 주문 전략을 조건 충족 시 몇 번 실행할지 설정합니다.

⑤ 준비조건

주문 실행 전 사전 확인용 조건입니다.
준비조건이 충족된 경우에만 실행조건 평가로 넘어갑니다.
오른쪽 상단의 사용 토글 버튼으로 준비조건 사용 여부를 활성화/비활성화할 수 있습니다.

준비조건 유형은 세 가지 중 하나를 선택합니다.

시스템조건식

시스템조건식 만들기 (준비, 실행) 버튼에서 미리 만들어 둔 시스템조건식을 적용합니다.

키움 조건검색식

키움증권 HTS에서 저장한 조건검색식을 그대로 활용합니다.

사용자 정의

코드로 구현된 커스텀 전략 로직을 준비조건으로 사용합니다. 드롭다운에서 사용 가능한 사용자 정의 전략을 선택합니다.

⑥ 실행조건

주문을 실제로 실행할 조건입니다.
준비조건이 활성화된 경우, 준비조건을 통과한 후 실행조건이 평가됩니다.
설정 방식은 준비조건과 동일하게 시스템조건식 / 키움 조건검색식 / 사용자 정의 세 가지 중 선택합니다.

⚠️ 실행조건은 항상 활성 상태이며, 비활성화 토글이 없습니다.

⑦ 주문금액 계산식

이 주문 전략에서 사용할 주문 금액 계산식을 선택합니다.

💡 새로운 계산식을 만들려면 오른쪽 상단의 "주문 금액 계산식 만들기" 버튼을 클릭합니다. (→ 5.3.5 금액 표현식 편집기 참조)

설정 흐름 예시

예시: "RSI 과매도 구간 진입 시 현재가+1틱으로 최초매수, 1회 실행"

저장 및 닫기

주의 사항

• 준비조건과 실행조건을 모두 키움 조건검색식으로 설정하는 경우, 해당 검색식이 키움 HTS에 등록되어 있어야 합니다.
  목록이 비어 있는 경우 → 9.2 조건검색식 목록 불러오기를 먼저 수행하십시오.
• 실행주기를 매일로 설정한 경우, 동일 종목에 대해 매일 반복 주문이 발생할 수 있으므로 동일 종목 최대 매수 횟수 설정(→ 2.5 환경 설정 참조)과 함께 사용하는 것을 권장합니다.
• **주문유형 현재가**는 실제로는 지정가 주문이며, 틱 설정으로 호가 단위 조정이 가능합니다.

5.3.7 거래 제외 종목 기준 설정

개요

거래 제외 종목 기준 설정은 자동 매매 실행 시 특정 속성을 가진 종목은 처음부터 매매 대상에서 제외하는 필터 기능입니다.

예를 들어 조건검색식에 의해 종목이 편입되더라도, 해당 종목이 "투자경고" 상태이거나 "ETF" 종목이거나 특정 업종에 속하는 경우라면 자동으로 걸러내어 주문이 나가지 않도록 차단합니다.

이 설정은 매매 전략 단위로 독립적으로 관리되며, 전략마다 서로 다른 제외 기준을 적용할 수 있습니다.

설정 화면 열기

자동 매매 편집기에서 전략을 선택한 후 [매매 제외 카테고리 수정] 버튼을 클릭하면 "매매 종목 필터" 창이 열립니다.

창 상단에 "매매 종목 필터 (제외 할 카테고리를 선택하세요)" 라는 안내 문구가 표시됩니다.

화면 구성

필터 창은 총 7개의 카테고리 열로 나뉘어 있으며, 각 항목 옆의 체크박스를 체크하면 해당 속성의 종목이 거래에서 제외됩니다.

카테고리별 항목 상세

① 거래소

종목이 상장된 거래소를 기준으로 제외합니다.

💡 특정 거래소 종목을 완전히 배제하고 싶을 때 사용합니다.

② 감리구분

키움증권에서 제공하는 종목의 감리 상태를 기준으로 제외합니다.

⚠️ 감리 지정 종목은 거래 제한이나 급격한 가격 변동이 발생할 수 있으므로, 투자경고 · 투자위험 항목을 체크하여 제외하는 것을 권장합니다.

③ 시장구분

종목이 속한 시장을 기준으로 제외합니다.

④ 업종

종목의 업종 분류를 기준으로 제외합니다.

아래 업종 중 원하는 항목을 선택하면 해당 업종에 속한 모든 종목이 제외됩니다.

⑤ 회사크기분류

시가총액 기준 회사 규모를 기준으로 제외합니다.

⑥ 회사분류

기업 특성에 따른 분류를 기준으로 제외합니다.

💡 스팩은 변동성이 크므로, 일반 자동 매매 전략에서는 제외하는 것을 권장합니다.

⑦ 투자유의종목

투자 주의가 필요한 특수 지정 종목을 기준으로 제외합니다.

적용 방법

• 각 카테고리에서 제외할 항목의 체크박스를 선택합니다.
  • 복수 카테고리, 복수 항목을 동시에 선택할 수 있습니다.
• "적용" 버튼을 클릭합니다.
  • 선택한 내용이 해당 매매 전략의 거래 제외 기준으로 저장됩니다.
• "취소" 버튼을 클릭하면 변경 사항 없이 창이 닫힙니다.

동작 방식

• 설정된 제외 기준은 자동 매매 실행 중 종목이 신호를 수신했을 때 실시간으로 적용됩니다.
• 제외 기준에 해당하는 종목에 대해서는 주문 전략의 준비조건 / 실행조건 평가 자체가 건너뜁니다.
• 복수의 카테고리를 선택한 경우, 하나라도 해당되면 해당 종목은 제외됩니다. (OR 조건)

현재 설정 확인

매매 전략 편집 화면에서 "매매 종목 필터" 버튼 아래에 현재 설정된 제외 기준 목록이 태그 형태로 표시됩니다. 제외 기준이 없는 경우에는 모든 종목이 매매 대상이 됩니다.

권장 설정 예시

주의 사항

• 제외 기준은 전략 단위로 저장됩니다. 다른 전략에는 영향을 주지 않습니다.
• 종목의 업종·감리 상태 등은 키움증권에서 제공하는 종목 기본 정보를 기준으로 판단합니다. 데이터 갱신 주기에 따라 최신 상태와 차이가 있을 수 있습니다.
• 제외 기준을 너무 넓게 설정하면 매매 대상 종목이 지나치게 줄어들 수 있습니다.

5.3.8 보유 수 제한 및 재매수 제한 설정

개요

매매 전략에서 발생할 수 있는 과다 종목 보유와 당일 동일 종목 반복 매수를 제어하기 위한 리스크 관리 설정입니다.
이 두 설정은 키움 조건검색식 기반 자동 매매 전략에서 활성화됩니다.

💡 단일 종목 선정 방식의 전략에서는 보유할 종목이 이미 고정되어 있으므로 해당 설정이 적용되지 않습니다.

화면 위치

자동매매 만들기 (키움 조건검색식) 창 → 전략 기본 설정 영역에서 확인할 수 있습니다.

① 보유 종목수 제한 (HoldingCountLimit)

기능 설명

이 전략이 동시에 보유할 수 있는 최대 종목 수를 지정합니다.
조건검색식으로 신호가 포착된 종목이 아무리 많더라도, 보유 종목 수가 이 한도에 도달하면 새로운 최초매수 주문이 차단됩니다.

입력 규칙

동작 방식

신호 발생 → 현재 보유 종목 수 확인

├── 보유 수 < 제한 수 → 최초매수 주문 진행

└── 보유 수 >= 제한 수 → 주문 차단 (로그 기록)

• 보유 수 계산 기준은 해당 전략이 현재 보유 중인 종목 수입니다.
• 다른 전략의 보유 종목과는 무관하게 전략 단위로 카운트됩니다.
• 보유 종목이 매도되면 카운트가 줄어들고, 이후 다시 매수가 가능해집니다.

설정 예시

⚠️ 0으로 설정하면 제한이 없으므로, 조건 신호가 많이 발생할 경우 예상치 못한 대규모 매수가 일어날 수 있습니다. 반드시 적절한 상한값을 입력하는 것을 권장합니다.

② 당일 동일 종목 재매수 제한 (SameStockTradeLimit)

기능 설명

체크박스가 활성화된 경우, 당일 매도한 종목은 같은 날 다시 매수하지 않도록 제한합니다.

이 기능은 당일 손절·익절 후 같은 종목을 반복적으로 재진입하는 것을 방지하기 위한 리스크 관리 옵션입니다.

동작 방식

매수 조건 충족 → 당일 동일 종목 매도 이력 확인

├── 매도 이력 없음 → 매수 주문 진행

└── 매도 이력 있음 → 주문 차단 (재매수 제한)

• 매도 이력 기준: 당일(오늘) 자정 00:00 이후 해당 전략에서 발생한 매도 체결
• 다음 날이 되면 제한이 자동으로 초기화됩니다.

💡 변동성이 높은 장세에서 동일 종목을 반복 매매하는 전략이라면 체크 해제를 유지하고, 손절 후 재진입을 막고 싶은 전략에서는 활성화하는 것을 권장합니다.

글로벌 제한 설정과의 관계

부엉이 ATS 에는 전략별 설정 외에 환경 설정(Config)에서 계좌 단위로 적용되는 글로벌 제한도 별도로 존재합니다.

두 레벨의 제한이 동시에 적용됩니다. 즉, 어느 한 쪽이라도 조건을 충족하지 못하면 주문은 차단됩니다.

💡 글로벌 제한 설정 변경 방법은 → 2.5 환경 설정 파일 안내 를 참고하십시오.

관련 추가 설정

키움 조건검색식 기반 전략에는 보유·재매수 제한 외에도 아래 추가 옵션이 함께 제공됩니다.

지정 일시 자동 완료

작업이 생성된 시점으로부터 지정한 날짜·시간 이후 해당 작업을 자동으로 완료(종료) 처리합니다.

지정 일시 일괄 매도

지정한 날짜·시간에 해당 전략이 보유한 모든 종목을 일괄 매도합니다.

설정 권장 조합

주의 사항

• 보유 종목수 제한 입력값은 0 이상 90 이하이어야 합니다. 범위를 벗어나면 저장 시 오류가 표시됩니다.
• 당일 동일 종목 재매수 제한은 매도 체결 이력을 기준으로 동작하므로, 미체결 매도 주문이 있는 상태에서는 바로 적용되지 않을 수 있습니다.
• 두 설정 모두 전략이 실행 중지 상태일 때 수정할 수 있습니다. 실행 중인 전략은 수정이 불가합니다.

5.4 매매 전략 수정 및 삭제

개요

이미 만들어진 매매 전략의 설정을 변경하거나 불필요한 전략을 제거하는 방법을 설명합니다.
자동매매 만들기 화면 왼쪽의 전략 목록에서 수정·삭제할 전략을 선택하여 작업합니다.

화면 구성 (전략 목록 영역)

5.4.1 매매 전략 수정

수정 절차

• 왼쪽 전략 목록에서 수정할 전략을 클릭하여 선택합니다.
• 오른쪽 편집 영역에서 변경할 항목을 수정합니다.
  • 이름, 계좌번호, 기본 매수 금액, 보유 종목수 제한 등 기본 설정
  • 자동 실행 시간대 설정
  • 매매 제외 카테고리
  • 주문 전략 상세 (추가 / 수정 / 삭제)
• 하단의 저장 버튼을 클릭합니다.
• 확인 대화창에서 예를 클릭하면 수정이 완료됩니다.

수정 시 유효성 검사 항목

저장 버튼 클릭 시 다음 항목들이 자동으로 검사됩니다. 하나라도 실패하면 저장이 차단됩니다.

수정 제약 조건

전략의 현재 상태에 따라 일부 항목은 수정이 제한될 수 있습니다.

① 실행 중인 전략

💡 수정하려면 자동 매매 스위치 화면에서 해당 전략을 먼저 OFF 하십시오.

② 계좌번호 변경

③ 기본주문금액 변경

④ 키움 조건검색식 기반 전략의 이미 생성된 작업

키움 조건검색식 기반 전략에 **이미 생성된 매매전략 작업(종목 작업)**이 있는 경우:

⚠️ 이미 생성된 매매전략 작업에는 수정 내용이 반영되지 않습니다.
이후에 새로 생성되는 작업에만 변경 사항이 적용됩니다.

저장 시 아래와 같은 경고가 표시됩니다.

이미 생성된 매매전략작업이 있습니다: [종목명 A, 종목명 B]

키움조건식 기반에서 이미 생성된 매매전략작업은 수정되지 않습니다.

이후에 생성되는 매매전략작업에만 적용됩니다.

5.4.2 매매 전략 삭제

삭제 절차

1. 왼쪽 전략 목록에서 삭제할 전략을 클릭하여 선택합니다.
2. 목록 우측 상단의 - 버튼을 클릭합니다.
   (또는 목록에서 오른쪽 클릭 → 삭제 메뉴 선택)
3. 확인 대화창에서 예를 클릭하면 삭제됩니다.

삭제 시 종속 데이터 처리

⚠️ 삭제된 전략 및 그에 종속된 모든 작업·주문 내역은 복구할 수 없습니다.
삭제 전 반드시 내용을 확인하십시오.

삭제 제약 조건

5.4.3 전략 순서 변경

전략 목록의 표시 순서(실행 우선순위)를 조정할 수 있습니다.

1. 순서를 변경할 전략을 목록에서 선택합니다.
2. ↑ (위로 이동) 또는 ↓ (아래로 이동) 버튼을 클릭합니다.
3. 순서는 변경 즉시 데이터베이스에 자동 저장됩니다. (별도 저장 버튼 불필요)

5.4.4 수정 시 주의 메시지 정리

수정 또는 삭제 과정에서 표시될 수 있는 주요 확인·경고 메시지는 다음과 같습니다.

5.5 전략 가져오기 / 내보내기

개요

가져오기 / 내보내기 기능은 매매 전략을 JSON 파일 형식으로 저장하고 다시 불러올 수 있는 기능입니다.

이 기능을 활용하면 다음과 같은 작업이 가능합니다.

• 잘 동작하는 전략을 백업하여 보관
• 다른 PC로 전략을 이전
• 동일 전략을 복사하여 변형 전략 생성
• 전략 공유

내보내기 / 가져오기 버튼 위치

자동매매 만들기 화면의 전략 목록에서 오른쪽 클릭(컨텍스트 메뉴) 또는 전략 목록 상단 메뉴에서 접근합니다.

5.5.1 전략 내보내기 (Export)

내보내기 절차

1. 왼쪽 전략 목록에서 내보낼 전략을 선택합니다.
2. 목록에서 오른쪽 클릭 → 내보내기 를 선택합니다.
3. 파일 저장 대화창이 열립니다.
   • 기본 파일 이름: {전략 이름}.json
   • 파일 형식: JSON 파일 (*.json)
4. 저장할 경로와 파일 이름을 선택한 후 저장 버튼을 클릭합니다.
5. 성공 시 안내 메시지가 표시됩니다.

매매 전략을 '{저장경로\파일명.json}'에 저장되었습니다.

내보내기 파일에 포함되는 정보

내보내기 파일(JSON)에는 전략 재현에 필요한 모든 구성 요소가 함께 포함됩니다.

⚠️ 현재 진행 중인 매매전략 작업(종목별 주문 이력) 은 내보내기 파일에 포함되지 않습니다.
또한 내보내기 파일에서 전략의 실행 상태는 항상 OFF로 초기화됩니다.

내보내기 파일 예시 구조

{

"tradeStrategyDto": {

"name": "RSI 전략",

"unitTradeAmount": 500000,

"holdingCountLimit": 5,

...

"orderStrategies": [ ... ]

},

"conditionExpressions": [ ... ],

"conditionSearchExpressionNames": [ "RSI_30이하", "거래량급등" ],

"amountExpressions": [ ... ]

}

5.5.2 전략 가져오기 (Import)

가져오기 전 사전 조건

⚠️ 반드시 확인하세요:
가져오려는 전략에서 사용된 키움 조건검색식 이름이 내 키움 영웅문 HTS에 동일한 이름으로 등록되어 있어야 합니다.
조건검색식 이름이 없으면 가져오기가 실패합니다.

가져오기 절차

1. 오른쪽 클릭 → 가져오기 를 선택합니다.
2. 아래 사전 확인 메시지가 표시됩니다.

외부에서 가져오려는 매매 전략에 사용된 키움 조건검색식이 내 영웅문에 존재해야합니다. (동일한 이름)

계속하시겠습니까?

1. 예를 클릭하여 계속합니다.
2. 파일 열기 대화창이 열립니다.
   • JSON 파일 (*.json) 형식의 파일을 선택합니다.
3. 계좌번호 선택 창이 열립니다.
   • 이 전략을 적용할 계좌번호를 선택합니다.
   • 내보내기 원본과 다른 계좌번호를 선택해도 됩니다.
4. 성공 시 전략이 목록에 추가되고 안내 메시지가 표시됩니다.
   매매 전략을 '{파일경로}'에서 가져왔습니다.

가져오기 처리 방식

가져오기 시 내부적으로 다음과 같은 처리가 자동으로 수행됩니다.

가져오기 오류 및 해결 방법

활용 시나리오

시나리오 1 — 전략 백업

1. 전략 선택 → 내보내기

2. 원하는 경로에 JSON 파일 저장

3. 필요 시 가져오기로 복원

시나리오 2 — 전략 복사 후 변형

1. 원본 전략 내보내기 → 파일 저장

2. 가져오기 → 동일 계좌 선택

→ "동일 이름 전략 존재" 오류 발생

3. 원본 전략 이름 변경 후 재시도

→ 복사된 전략이 추가됨

1. 복사된 전략 수정 후 저장

시나리오 3 — 다른 PC로 이전

[PC A]

1. 전략 내보내기 → USB 또는 클라우드에 저장

[PC B]

1. 조건검색식 목록 동기화 (9.2 참조)

2. 가져오기 → 파일 선택 → 계좌번호 선택

→ 전략이 그대로 복원됨

주의 사항

• 내보낸 파일은 JSON 텍스트 파일이므로 외부에 공유 시 계좌번호 등 민감 정보 노출에 주의하십시오.
• 가져오기 전 해당 전략에서 사용하는 모든 키움 조건검색식 이름을 미리 확인하고, 영웅문 HTS에 동일한 이름으로 등록해 두어야 합니다. (→ 9.2 조건검색식 목록 불러오기 참조)
• 동일 이름의 전략은 가져오기가 불가합니다. 기존 전략 이름 변경 또는 삭제 후 재시도하십시오.
• 가져온 전략의 실행 상태는 항상 OFF이므로, 자동 매매를 시작하려면 별도로 ON 하여야 합니다.

6. 자동 매매 실행 및 모니터링

6.1 자동 매매 시작하기

6.1.1 개요

부엉이 ATS의 자동 매매는 매매 전략 단위로 개별 ON/OFF가 가능합니다. 전략을 실행(ON)하면 프로그램이 실시간 시세 및 조건검색식 결과를 감시하며, 설정된 매수/매도 조건이 충족될 때 자동으로 주문을 발송합니다.

⚠️ 선행 조건: 자동 매매를 시작하기 전에 반드시 아래 항목이 모두 준비되어 있어야 합니다.

• 키움 AppKey가 계좌번호에 정상 등록되어 있을 것
• 매매 전략이 정상 상태일 것 (오류 상태이면 실행 불가)
• 사용 여부가 사용중 으로 설정되어 있을 것

---

6.1.2 실행 흐름

전략 스위치를 ON으로 전환하면 내부적으로 다음 순서가 자동 진행됩니다.

[스위치 ON]

↓

① 실시간 종목 체결 등록 한도 확인 (최대 90 종목)

↓

② 실시간 조건검색식 등록 한도 확인 (편입용 최대 9개)

↓

③ 포착 조건검색식 충돌 여부 확인

↓

④ 전략 실행 상태 저장 (IsRun = true)

↓

⑤ 실시간 주식 체결 데이터 등록 갱신

↓

⑥ 편입 조건검색식 실시간 조건검색 등록

↓

[자동 매매 감시 시작]

6.1.3 실행 전 자동 검증 항목

스위치를 ON으로 전환할 때 프로그램이 자동으로 아래 항목을 검증합니다. 어느 하나라도 실패하면 스위치는 원래 상태(OFF)로 복원됩니다.

💡 참고: 실시간 체결 종목 수는 현재 실행 중인 모든 전략의 매매 작업에서 감시 중인 종목의 합계를 기준으로 계산됩니다. 전략 하나가 여러 종목을 감시하고 있는 경우 그 종목 수만큼 차감됩니다.

6.1.4 장중 실행 중지 시 주의사항

이미 실행 중인 전략을 장중에 중지(OFF)하면 다음과 같은 경고 메시지가 표시됩니다.

"장중에 실행을 중지하면 처리되지 못한 매매 데이터가 발생할 수 있습니다. 이로 인해 예기치 못한 오류가 발생할 수 있습니다. 계속 진행하시겠습니까?"

• [예] 를 선택하면 즉시 전략 실행이 중지됩니다. 이미 접수된 주문은 취소되지 않으며, 이후 체결 이벤트에 대한 후속 처리가 누락될 수 있습니다.
• [아니오] 를 선택하면 스위치는 원래 ON 상태로 복원되며 매매가 계속됩니다.

⚠️ 권장사항: 장중 중지가 필요한 경우 가급적 보유 종목이 없는 상태에서 수행하십시오.

6.1.5 스케줄러를 이용한 자동 시작

매일 정해진 시간에 프로그램이 자동으로 시작되도록 Windows 작업 스케줄러에 등록할 수 있습니다.

1. 메인 메뉴에서 [설정] → [스케줄러] 를 클릭합니다.
2. 자동 시작 사용 체크박스를 활성화합니다.
3. 시작 시간과 종료 시간을 입력합니다.
4. 실행할 요일을 선택합니다 (월~일 개별 선택 가능).
5. [저장] 버튼을 클릭합니다.

⚠️ 주의: 스케줄러 등록은 관리자 권한으로 실행해야 합니다. 일반 권한으로 실행한 경우 저장이 거부됩니다.

6.2 자동 매매 스위치 대시보드

6.2.1 대시보드 위치 및 역할

자동 매매 스위치 대시보드는 메인 화면 하단 탭에 위치합니다. 현재 선택된 계좌에 등록된 매매 전략 목록을 카드 형태로 표시하며, 각 전략을 별도 화면을 열지 않고 즉시 ON/OFF 할 수 있는 빠른 제어 패널입니다.

6.2.2 화면 구성

대시보드에는 조건을 통과한 전략만 표시됩니다. 각 전략 카드에는 다음 정보가 포함됩니다.

💡 표시 조건: 아래 조건을 모두 충족하는 전략만 대시보드에 표시됩니다.

• 사용 여부: 사용중 으로 설정된 전략
• 오류 여부: 정상 상태인 전략 (오류 전략은 제외)
• 계좌 일치: 현재 선택된 계좌에 연동된 전략

6.2.3 전략 ON/OFF 방법

1. 실행하려는 전략 카드의 토글 스위치를 클릭하여 ON(파란색) 상태로 전환합니다.
2. 내부 검증(6.1.3 참조)이 모두 통과되면 스위치가 ON 상태로 확정되고 자동 매매가 시작됩니다.
3. 실행을 중지하려면 동일한 스위치를 다시 클릭하여 OFF(회색)로 전환합니다.

6.2.4 대시보드 자동 갱신 조건

대시보드 목록은 다음 상황에서 자동으로 새로 고침됩니다.

6.2.5 대시보드에서 전략이 보이지 않을 때 확인 사항

대시보드에 전략이 표시되지 않는 경우 아래 항목을 순서대로 확인하십시오.

1. 계좌 선택 확인: 상단 계좌 선택 영역에서 올바른 계좌가 선택되어 있는지 확인합니다.
2. 사용 여부 확인: 자동매매 편집기에서 해당 전략의 사용 여부가 사용중으로 설정되어 있는지 확인합니다.
3. 오류 상태 확인: 자동매매 편집기 목록에서 해당 전략이 🔴 오류 상태가 아닌지 확인합니다. 오류가 있는 경우 전략 내용을 수정하고 저장합니다.
4. AppKey 등록 확인: 메뉴 [설정] → [키움 AppKey 관리] 에서 해당 계좌번호에 AppKey가 정상 등록되어 있는지 확인합니다.

6.3 자동 매매 현황 모니터링

6.3.1 개요

자동매매 현황 화면은 실행 중인 전략과 그에 속한 종목 작업, 주문·체결 내역을 실시간으로 계층적으로 확인할 수 있는 모니터링 화면입니다.

화면 열기

메인 화면 상단 메뉴 또는 탭에서 자동매매 현황 을 클릭합니다.

화면 구성

화면은 좌→우로 5개 영역이 분할 배치되며, 왼쪽 항목을 선택하면 오른쪽 영역이 연계되어 드릴다운 방식으로 조회됩니다.

① 전략 목록 (왼쪽 패널)

등록된 모든 매매 전략이 표시됩니다.

전략을 선택하면 하단 전략 상세 정보 영역에 다음 정보가 표시됩니다.

② 작업중 전략 (종목 목록, 두 번째 패널)

왼쪽에서 선택한 전략에 속하는 종목별 작업 목록이 표시됩니다. 키움 조건검색식 기반 전략에서는 조건에 포착된 각 종목이 하나의 작업으로 생성됩니다.

💡 오류 상태인 항목은 빨간색 글씨로 표시됩니다.

종목 작업을 선택하면 하단 작업 상세 정보가 표시됩니다.

작업 삭제

작업 항목에서 우클릭 → 삭제 를 선택하면 해당 종목 작업을 삭제할 수 있습니다.

③ 전략 명세 (오른쪽 상단)

선택한 종목 작업에 적용된 **주문 전략 명세(실행 단계)**가 표시됩니다. 각 명세는 최초매수·매수·매도 등 주문 전략 하나에 해당합니다.

💡 준비 조건 = 통과, 실행 조건 = 통과 상태여야 해당 주문이 실제로 발송됩니다.

④ 주문 현황 (오른쪽 중간)

선택한 명세에서 발생한 주문 목록이 실시간으로 표시됩니다.

⑤ 체결 현황 (오른쪽 하단)

선택한 주문의 체결 내역이 표시됩니다. 하나의 주문은 여러 건의 체결로 분할될 수 있습니다.

새로고침

화면 우측 상단의 새로고침 버튼을 클릭하면 전체 데이터를 다시 불러옵니다. 실시간 이벤트로 자동 갱신되지만, 일시적 누락이 의심될 경우 수동으로 새로고침합니다.

6.4 자동 매매 중지 방법

전략 단위 중지

1. 메인 화면의 자동매매 실행 스위치 대시보드에서 중지할 전략을 찾습니다.
2. 해당 전략의 토글 스위치를 클릭하여 OFF 합니다.
3. 장중 중지 시 아래 확인 메시지가 표시됩니다.

장중에 실행을 중지하면 처리되지 못한 매매 데이터가 발생할 수 있습니다.

이로인해 예기치 못한 오류가 발생할 수 있습니다.

계속 진행하시겠습니까?

안전한 중지 권장 순서

1. 자동 매매 실행 시간대가 끝나기를 기다린다

2. 미체결 주문이 없는지 주문 현황 화면에서 확인한다

3. 미체결 주문이 있다면 키움 HTS에서 수동으로 취소/정정한다

4. 스위치를 OFF한다

⚠️ 갑작스러운 중지는 미체결 주문·잔고 불일치를 유발할 수 있습니다. 가급적 장 마감 후에 중지하십시오.

6.5 자동 매매 이력 조회

6.5.1 개요

자동매매 주문 내역 화면에서 과거 매매 결과를 날짜 범위와 전략별로 조회할 수 있으며, CSV 파일로 내보낼 수 있습니다.

화면 열기

메인 화면 상단 메뉴에서 자동매매 주문 내역 을 클릭합니다.

조회 조건 설정

전략 선택

날짜 범위 빠른 선택 버튼

날짜 직접 입력

DatePicker를 통해 시작일 ~ 종료일을 직접 선택합니다.

과거 매매 결과 확인 방법

1. 상단에서 전략 선택 및 날짜 범위 를 설정합니다.
2. 조회 버튼을 클릭합니다.
3. 조회 결과가 하단 목록에 표시됩니다. (조회 중에는 로딩 표시가 나타납니다.)

조회 결과 컬럼 설명

⚠️ 수익률 = 0 으로 표시되는 경우: 매수 체결수량과 매도 체결수량이 다른 경우 (일부만 매도된 경우) 수익률은 계산되지 않고 0으로 표시됩니다.

CSV 내보내기

조회된 결과를 CSV 파일로 저장할 수 있습니다.

• 목록에서 우클릭 → Export(CSV) 를 선택합니다.
• 저장 경로와 파일명을 지정합니다.
  • 기본 파일명: 내조건식_거래내역_YYYYMMDD_HHmmss.csv
• 저장 버튼을 클릭합니다.

💡 CSV 파일은 UTF-8 (BOM 포함) 형식으로 저장되어 한국어가 깨지지 않습니다. 엑셀에서 바로 열어 활용 가능합니다.

7. 스케줄러

7.1 스케줄러 화면 안내

스케줄러는 부엉이 ATS 을 지정한 요일과 시간에 자동으로 시작하고 종료하도록 Windows 작업 스케줄러에 등록하는 기능입니다. 매일 수동으로 프로그램을 켜고 끌 필요 없이, 주식 시장 개장 시간에 맞춰 프로그램이 자동 실행되도록 예약할 수 있습니다.

스케줄러 화면 열기

메인 메뉴에서 [스케줄러] 항목을 클릭하면 "프로그램 실행 스케줄" 창이 열립니다.

화면 구성

⚠️ 사용 가능 시간 제한: 자동시작은 07:30 ~ 23:00 범위 내에서만 설정하도록 권장합니다. 이는 키움 Rest API의 사용 가능 시간을 고려한 제한입니다.

⚠️ 자동 종료 알림: 프로그램은 매일 06:00에 "06:05에 자동 종료된다"는 알림을 표시하며, 06:05에 자동으로 종료됩니다. 이는 야간 장 종료 이후 다음 날 스케줄 실행을 위한 안전 종료 기능입니다.

7.2 자동 시작 스케줄 설정 방법

스케줄 기능을 처음 설정하거나 시작 시간을 변경할 때 아래 단계를 따릅니다.

사전 조건

⚠️ 반드시 관리자 권한으로 실행해야 합니다. 일반 권한으로 실행 중인 경우 저장 시 "관리자 권한으로 실행해주세요." 메시지가 표시되며 저장되지 않습니다.

관리자 권한 실행 방법: *내 문서\SageLine* 폴더 내의 Start부엉이 ATS .vbs 파일을 실행하면 UAC(사용자 계정 컨트롤) 프롬프트가 나타나며 관리자 권한으로 프로그램이 시작됩니다.

설정 단계

① 자동시작 활성화

• 화면 상단의 [자동시작 활성화] 토글 스위치를 ON 상태로 설정합니다.
• 토글이 꺼진 상태에서는 아래 설정값을 입력해도 스케줄이 동작하지 않습니다.

② 시작 시간 입력

• [시작 시간] 입력란을 클릭하여 원하는 시각을 입력합니다.
• 예: 주식 시장 개장 준비를 위해 08:50 으로 설정
• 시간 형식은 HH:mm (24시간 형식)을 사용합니다.
• 키움 Rest API 사용 가능 시간을 고려하여 07:30 이후로 설정하는 것을 권장합니다.

③ 요일 선택

• 하단의 요일 체크박스에서 스케줄을 실행할 요일을 선택합니다.
  • 월, 화, 수, 목, 금: 평일 자동 매매 시 선택 (일반적인 설정)
  • 토, 일: 특수 거래일이 있는 경우에만 선택
• 최소 1개 이상의 요일을 선택해야 저장이 가능합니다.

④ 저장

• 우측 하단의 [저장] 버튼을 클릭합니다.
• 저장이 완료되면 "스케줄 저장됨: [시작시간] ~ [종료시간]" 확인 메시지가 표시됩니다.
• 내부적으로 내 문서\SageLine\Start부엉이 ATS .bat 파일을 실행하는 Windows 작업 스케줄러 항목(부엉이 ATS Scheduler Task Start)이 등록됩니다.

7.3 자동 종료 스케줄 설정 방법

자동 종료 스케줄은 자동 시작 스케줄과 동일한 화면에서 함께 설정됩니다. 별도의 화면이 없으며, 시작 시간과 종료 시간을 한 번에 저장합니다.

설정 단계

① 종료 시간 입력

• [종료 시간] 입력란을 클릭하여 원하는 종료 시각을 입력합니다.
• 예: 장 마감 이후 16:00 또는 15:30 으로 설정
• 시간 외 단일가 거래를 포함하려면 18:00 이후로 설정합니다.
• 23:00 이전으로 설정하는 것을 권장합니다.

② 요일 및 저장

• 7.2의 ③~④ 단계와 동일하게 요일을 선택하고 [저장] 버튼을 클릭합니다.
• 저장 시 내 문서\SageLine\Exit부엉이 ATS .bat 파일을 실행하는 Windows 작업 스케줄러 항목(부엉이 ATS Scheduler Task Exit)이 함께 등록됩니다.

📌 참고: 종료 스케줄은 Exit부엉이 ATS .bat를 통해 실행 중인 부엉이 ATS 프로세스를 강제 종료합니다. 진행 중인 자동 매매가 있더라도 설정한 시각에 프로그램이 종료되므로, 모든 자동 매매 전략이 완료되는 시각 이후로 종료 시간을 설정하는 것을 권장합니다.

자동 종료 시간 설정 권장 예시

7.4 설정한 스케줄 확인 및 수정

현재 설정 확인

스케줄러 창을 열면 이전에 저장된 설정값이 자동으로 불러와집니다.

• 자동시작 활성화 토글: 현재 활성화 여부 표시
• 시작 시간 / 종료 시간: 마지막으로 저장한 시각 표시
• 요일 체크박스: 이전에 선택한 요일이 체크된 상태로 표시

이를 통해 현재 어떤 스케줄이 등록되어 있는지 한눈에 확인할 수 있습니다.

스케줄 수정 방법

1. 스케줄러 창을 엽니다.
2. 변경하려는 항목(시작 시간, 종료 시간, 요일)을 수정합니다.
3. [저장] 버튼을 클릭합니다.
4. 저장 시 기존 Windows 작업 스케줄러 항목은 자동으로 삭제 후 재등록되므로 별도의 삭제 작업은 필요하지 않습니다.

스케줄 비활성화 방법

스케줄을 완전히 해제하려면 다음 단계를 따릅니다.

1. 스케줄러 창을 엽니다.
2. [자동시작 활성화] 토글을 OFF 상태로 변경합니다.
3. [저장] 버튼을 클릭합니다.
4. Windows 작업 스케줄러에 등록된 기존 시작/종료 작업(부엉이 ATS Scheduler Task Start, 부엉이 ATS Scheduler Task Exit)이 자동으로 삭제됩니다.

Windows 작업 스케줄러에서 직접 확인하는 방법

등록된 스케줄을 Windows 작업 스케줄러에서 직접 확인하거나 관리할 수 있습니다.

1. Windows 검색창에서 "작업 스케줄러"를 검색하여 실행합니다.
2. 좌측 트리에서 **[작업 스케줄러 라이브러리]**를 클릭합니다.
3. 다음 두 항목을 확인합니다.
   • 부엉이 ATS Scheduler Task Start — 프로그램 자동 시작
   • 부엉이 ATS Scheduler Task Exit — 프로그램 자동 종료

📌 참고: Windows 작업 스케줄러에서 직접 항목을 수정하거나 삭제하는 것은 권장하지 않습니다. 항상 부엉이 ATS 스케줄러 화면을 통해 관리하시기 바랍니다.

자주 발생하는 문제

8. 로그 확인

8.1 로그 대시보드 화면 안내

로그 대시보드는 부엉이 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 참고)

8.2 실시간 로그 보는 방법

로그 자동 출력

로그 대시보드는 별도의 조작 없이 자동으로 업데이트됩니다. 프로그램 동작 중 발생하는 모든 이벤트는 1초마다 화면에 반영됩니다.

• 새 메시지는 목록의 맨 위에 추가되어 가장 최신 내용이 항상 위에 표시됩니다.
• 최신 메시지가 추가될 때마다 자동으로 맨 위로 스크롤됩니다.

자동 스크롤 제어

📌 팁: 자동 매매가 진행 중일 때 특정 시점의 로그를 확인하려면 스크롤을 내려 해당 시점을 찾으면 됩니다. 자동 스크롤이 일시 중지되므로 로그가 흘러가지 않고 편하게 읽을 수 있습니다.

로그 읽는 방법

로그는 여러 유형의 메시지를 포함합니다.

8.3 로그 매니저에서 과거 로그 조회

로그 매니저는 디스크에 저장된 로그 파일 목록을 관리하는 별도 창입니다. 특정 날짜의 로그를 열어 확인하거나 파일을 삭제할 수 있습니다.

로그 매니저 열기

메인 메뉴에서 [로그 매니저] 항목을 선택하면 "로그 파일 관리" 창이 열립니다.

로그 파일 저장 위치

로그 파일은 아래 경로에 자동 저장됩니다.

내 문서\SageLine\SageStockPilot\logs\

화면 구성

파일 목록 컬럼 설명

과거 로그 조회 방법

• 로그 매니저 창을 엽니다.
• 파일 목록에서 확인하고 싶은 날짜의 로그 파일을 클릭하여 선택합니다.
• [메모장으로 열기] 버튼을 클릭합니다.
• Windows 메모장이 실행되며 해당 로그 파일의 전체 내용을 확인할 수 있습니다.
  • 메모장의 Ctrl + F 기능을 사용하면 특정 키워드(오류 메시지, 종목 코드 등)를 빠르게 검색할 수 있습니다.

📌 참고: 메모장으로 열기는 파일을 1개만 선택했을 때 활성화됩니다. 여러 파일을 동시에 열려면 각각 선택하여 열어야 합니다.

로그 파일 삭제 방법

1. 삭제할 파일을 클릭하여 선택합니다. (Ctrl 클릭으로 여러 파일 선택 가능)
2. [삭제] 버튼을 클릭합니다.
3. "선택한 로그 파일을 삭제하시겠습니까?" 확인 메시지가 표시되면 [확인] 을 클릭합니다.
4. 선택한 파일이 영구적으로 삭제됩니다.

⚠️ 주의: 삭제된 로그 파일은 복구할 수 없습니다. 문의나 오류 분석이 필요한 경우 삭제 전에 미리 서버로 전송해 두는 것을 권장합니다.

8.4 로그 파일 업로드 방법 (문의 시 활용)

프로그램 오작동이나 오류 발생 시 지원팀에 로그 파일을 전송하면 빠른 원인 분석이 가능합니다.

수동 업로드 방법

• [로그 매니저] 창을 엽니다.
• 전송할 로그 파일을 목록에서 선택합니다.
  • 문제가 발생한 날짜의 파일을 선택합니다.
  • Ctrl 클릭으로 여러 파일을 동시에 선택할 수 있습니다.
• [서버로 전송] 버튼을 클릭합니다.
• "데이터를 전송 중입니다. 잠시만 기다려주세요." 대기 화면이 표시됩니다.
• 업로드가 완료되면 "선택한 파일 업로드가 완료되었습니다." 메시지가 표시됩니다.

자동 업로드 설정

로그 매니저 상단의 [당일 로그파일 자동 전송] 토글을 ON으로 설정하면, 프로그램 실행 중 30분마다 당일 로그 파일이 자동으로 서버에 전송됩니다.

업로드 제한 및 주의사항