사용자 설명서를 불러오는 중입니다
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
부엉이 트레이더를 실행하면 나타나는 메인 화면의 구성과 각 영역을 읽는 방법을 안내합니다. 프로그램을 처음 사용하신다면 이 장을 먼저 읽고 화면의 전체 구조를 익혀 두시면, 이후 자동매매 설정과 모니터링이 한결 수월해집니다.
부엉이 트레이더의 메인 화면은 크게 4개의 영역으로 구성됩니다.
| 영역 | 위치 | 내용 |
|---|---|---|
| ① 상단 바 | 화면 최상단 | 좌측에 메뉴바, 우측에 업종지수 틱커(KOSPI/KOSDAQ)가 한 줄에 나란히 배치됩니다. |
| ② 좌측 패널 스택 | 본문 왼쪽(폭 고정) | 위에서부터 계좌현황 패널과 자동매매 실행 스위치 패널이 세로로 쌓여 표시되며, 상단 바의 토글 버튼으로 접거나 펼칠 수 있습니다. |
| ③ 자동매매 현황 대시보드 | 본문 오른쪽(넓은 영역) | 진행 중인 매매작업과 선택 작업의 명세·주문·체결을 한 화면에서 모니터링·조작하는 핵심 영역입니다. |
| ④ 하단 접이식 탭 + 상태바 | 본문 아래 ~ 최하단 | 잔고 · 체결 현황 접이식 탭 그룹과, 화면 맨 아래의 상태바(실시간 등록 현황·연결 상태·신호등)로 구성됩니다. |
💡 팁 — 사이드바 접기/펼치기: 상단 바 오른쪽 끝(업종지수 틱커 옆)의 토글 버튼(☰) 을 누르면 좌측의 계좌현황·자동매매 실행 스위치 사이드바를 접거나 펼칠 수 있습니다. 사이드바를 접으면 그만큼 자동매매 현황 대시보드가 더 넓게 표시되어, 진행 중 매매작업과 체결 현황을 여유롭게 볼 수 있습니다.
📌 참고: 부엉이 트레이더는 다크 네이비 테마로 고정되어 있습니다. 화면 색상을 바꾸는 테마 변경 기능은 제공하지 않으며, 별도 설정 없이 항상 어두운 네이비 화면으로 표시됩니다. 야간 장시간 모니터링에도 눈의 피로가 적도록 설계된 화면입니다.
💡 팁: 각 영역의 목록·탭 이름 옆에 붙은 숫자 뱃지는 해당 영역에 표시된 항목 수를 나타냅니다. 숫자가 바뀌면 새로운 데이터가 수신된 것입니다.
화면 최상단 왼쪽의 메뉴바에서 프로그램의 모든 기능 화면을 열 수 있습니다. 메뉴는 왼쪽부터 자동매매 · 종목정보 · 계좌정보 · 조건검색식 · 차트 데이터 · 설정 · 도움말 순으로 배치되며, 오른쪽 끝에는 매매제한 현황과 로그 버튼이 별도로 있습니다.
📌 참고: 맨 앞의 [자동매매] 메뉴는 초록색 로봇 아이콘과 굵은 글씨로 강조되어 있습니다. 이 프로그램의 핵심 기능이 자동매매에 모여 있기 때문입니다.
자동매매 전략을 만들고 실행 현황을 조회하는, 프로그램의 핵심 기능이 모여 있습니다.
| 메뉴 항목 | 설명 |
|---|---|
| 간편 매매 | 간단한 수동 매수·매도 주문 실행 화면 |
| 자동매매 만들기 (단일종목) | 특정 종목 하나를 대상으로 하는 전략 생성 |
| 자동매매 만들기 (키움 조건검색식) | 키움 조건검색식에 편입되는 종목을 자동 선정하는 전략 생성 |
| 자동매매 만들기 (사용자 정의) | 사용자가 직접 종목 목록을 지정하는 전략 생성 |
| 시스템조건식 만들기 | 매수·매도 발동 조건을 수식으로 정의하는 편집기 |
| 주문금액 계산식 만들기 | 주문 금액을 수식으로 계산하는 편집기 |
| 자동매매 현황 | 실행 중인 전략의 매매작업 현황을 별도 창으로 조회 |
| 자동매매 주문 내역 | 자동매매로 처리된 주문 이력을 별도 창으로 조회 |
| 자동매매 수익률 조회 | 자동매매 실현 수익률을 별도 창으로 조회 |
종목의 기본 정보와 시세를 조회하는 기능들입니다.
| 메뉴 항목 | 설명 |
|---|---|
| 전체 종목정보 | 상장된 전체 종목의 코드·이름 목록 조회 |
| 주식기본정보 | 종목별 기본 정보 조회 |
| 주식현재정보 | 선택 종목의 현재가·호가 조회 |
| 주식정보요약 | 종목의 핵심 지표를 요약 조회 |
| 시간외단일가 | 장 종료 후 시간외 단일가 시세 조회 |
| 변동성완화장치발동종목 | 변동성완화장치(VI)가 발동된 종목 조회 |
키움증권 계좌의 잔고·평가 손익·예수금 현황을 상세 조회합니다.
| 메뉴 항목 | 설명 |
|---|---|
| 예수금 상세 현황 | 주문 가능 금액 등 예수금 세부 현황 |
| 계좌평가잔고내역 | 보유 종목별 평가금액 및 손익 목록 |
| 계좌평가현황 | 종목별 평가 손익 현황 요약 |
키움증권 HTS에 등록된 조건검색식을 불러와 포착 종목을 확인합니다.
⚠️ 주의: 이 메뉴의 두 항목은 빨간색으로 표시됩니다. 키움 API 사용 횟수 제한에 민감한 기능임을 알리기 위한 표시입니다.
| 메뉴 항목 | 설명 |
|---|---|
| 키움 조건검색식 | 키움 HTS에 저장된 조건검색식 목록을 불러와 조회 |
| 키움 조건검색식 (실시간) | 조건검색식에 실시간으로 편입/이탈되는 종목을 모니터링 |
종목과 업종의 과거 가격 데이터, 기술적 지표를 조회합니다.
| 메뉴 항목 | 설명 |
|---|---|
| 분봉 차트 데이터 | 분 단위 가격 데이터 조회 |
| 일봉 차트 데이터 | 일별 시가·고가·저가·종가 데이터 조회 |
| 업종 일봉 차트 데이터 | 업종별 일봉 데이터 조회 |
| 기술적 지표 조회 | 피벗·볼린저밴드·일목균형표 조회 |
API 키 등록, 알림, 자동화 등 프로그램 운영에 필요한 설정을 합니다.
| 메뉴 항목 | 설명 |
|---|---|
| 키움증권 REST API KEY 등록 | 키움 앱키·시크릿키·계좌번호 등록 및 관리 |
| Discord WebHook 설정 | 매매 알림을 Discord로 전송하도록 설정 |
| Telegram 알림 설정 | 매매 알림을 Telegram으로 전송하도록 설정 |
| 시스템 환경 설정 | 당일실현손익 탭 표시, 전략상태 컬럼 표시, 계좌 자동 새로고침 등 화면 동작 옵션 제어 |
| 매매조건 처리시간 모니터 | 매매조건 처리 지연 시간을 모니터링 |
| 자동시작 스케줄러 | 자동매매 시작·종료 시간 및 요일 설정 |
📌 참고: **[시스템 환경 설정]**에서 켤 수 있는 화면 옵션들은 이 장 곳곳에서 안내합니다. 상세 설정 방법은 시스템 환경 설정 장을 참고하세요.
프로그램 정보와 지원 관련 기능입니다.
| 메뉴 항목 | 설명 |
|---|---|
| 프로그램 정보 | 설치된 버전 정보와 라이선스 안내 표시 |
| Log 관리 | 과거 로그 파일 조회 및 관리 |
| 후원하기 | 후원 계좌 정보 팝업 표시 |
메뉴바 오른쪽 끝의 두 버튼은 다른 메뉴와 달리 각각 별도의 창을 엽니다.
| 버튼 | 동작 |
|---|---|
| 매매제한 현황 | 계좌별 매매 제한과 키움 API 사용 제한 현황을 별도 창으로 표시합니다. 이미 열려 있으면 기존 창을 다시 활성화합니다. |
| 로그 | 프로그램 동작 로그 화면을 별도 창으로 표시합니다. 이미 열려 있으면 기존 창을 다시 활성화합니다. |
메인 화면 왼쪽 위에 상시 표시되는 패널로, 등록된 계좌 목록과 선택한 계좌의 실시간 평가 요약을 보여 줍니다.
계좌 목록과 전환
패널 왼쪽에는 등록된 키움 계좌 번호 목록이 표시됩니다. 계좌 번호를 클릭하면 해당 계좌로 전환되며, 오른쪽 요약 항목이 선택한 계좌 기준으로 갱신됩니다. (계좌 번호는 일부가 가려진 형태로 표시됩니다.)
요약 항목
선택한 계좌의 현황이 다음 항목으로 표시됩니다.
| 항목 | 설명 |
|---|---|
| 총매입금액 | 보유 종목들의 총 매입 원가 합계 |
| 총평가금액 | 현재가 기준 보유 종목들의 총 평가금액 |
| 총수익률 | 전체 보유 종목의 평균 수익률(%) |
| 총평가손익금액 | 총매입금액 대비 평가 손익 |
| 예수금 | 계좌 내 주문 가능한 현금 잔액 |
헤더 버튼
| 버튼 | 동작 |
|---|---|
| 새로고침 | 계좌 정보를 키움 서버에서 다시 조회합니다. |
| 설정 | 키움증권 REST API KEY 등록 화면을 엽니다. |
계좌현황 패널 바로 아래에 있는 패널로, 등록된 자동매매 전략을 켜고 끄는 곳입니다.
전략 목록과 실행 토글
등록된 전략이 목록으로 표시되며, 각 전략에는 토글 스위치가 있습니다.
| 표시 요소 | 의미 |
|---|---|
| 토글 스위치 | 해당 전략의 자동매매 실행을 켜고(ON) 끕니다(OFF). 켜면 즉시 매매를 시작합니다. |
| 실행 중 점(●) | 전략이 실행 중일 때만 전략 이름 옆에 초록색 점이 나타나 은은하게 명멸합니다. |
| 전략 이름 | 실행 중이면 밝고 굵게, 꺼져 있으면 흐리게 표시되어 상태를 한눈에 구분할 수 있습니다. |
여러 전략을 동시에 켤 수 있습니다. 등록된 전략이 없으면 목록은 비어 있습니다.
자동매매 만들기 (드롭다운)
패널 헤더 오른쪽의 톱니바퀴 버튼을 누르면 전략 만들기 드롭다운이 열립니다.
| 항목 | 설명 |
|---|---|
| 단일종목 | 특정 종목 하나를 대상으로 하는 전략을 만듭니다. |
| 조건검색식 | 키움 조건검색식으로 종목을 자동 선정하는 전략을 만듭니다. |
| 사용자 정의 | 사용자가 종목을 직접 지정하는 전략을 만듭니다. |
💡 팁: 같은 항목을 메뉴바 **[자동매매] → [자동매매 만들기]**에서도 열 수 있습니다.
메인 화면 오른쪽 넓은 영역을 차지하는 핵심 화면으로, 진행 중인 매매작업 목록과 함께 실시간 체결 현황 및 선택한 작업의 상세 정보(명세·주문·체결) 를 한 화면에서 모니터링하고 조작합니다. 좌우 두 영역은 가운데 경계선을 드래그하여 비율을 조절할 수 있습니다.
📌 참고: 여기서는 화면 구성과 각 버튼의 역할만 소개합니다. 매매작업을 실제로 조작하는 상세 절차는 자동매매 운영 장(6장)을 참고하세요.
헤더와 자동 새로고침
헤더에는 "진행 중 매매작업" 제목과 건수 뱃지가 있으며, 금일 완료작업 표시 체크박스로 오늘 완료된 작업을 목록에 함께 볼 수 있습니다. 오른쪽의 자동 새로고침 스위치를 켜면 목록이 5초 주기로 자동 갱신됩니다.
필터
| 필터 | 설명 |
|---|---|
| 전략명 | 특정 전략의 작업만 골라 봅니다. |
| 계좌번호 | 특정 계좌의 작업만 골라 봅니다. |
| 새로고침 | 목록을 즉시 다시 불러옵니다. |
목록 컬럼
| 컬럼 | 설명 |
|---|---|
| [선택 체크박스] | 작업을 선택합니다. 헤더 체크박스로 전체 선택도 가능합니다. |
| 계좌번호 | 작업이 속한 계좌 |
| 종목코드 / 종목명 | 대상 종목 (매도가 중지된 작업은 종목명에 "매도중지" 배지 표시) |
| 매매전략 | 작업을 만든 전략 이름 |
| 현재가 | 실시간 현재가 (▲/▼ 부호·색상) |
| 전략상태 | 각 주문 단계의 진행 상태를 원형 뱃지로 표시(옵션 컬럼, 아래 참고) |
| 생성일시 | 작업이 생성된 시각 |
행 색상으로 상태를 구분합니다. 오류는 빨강, 완료는 파랑 계열, 미사용(꺼 둔 작업)은 회색·반투명으로 표시됩니다.
📌 참고: 전략상태 컬럼은 기본적으로 숨겨져 있습니다. **[설정] → [시스템 환경 설정]**에서 켜면 표시되며, 각 주문 단계를 원형 뱃지로 나타냅니다(회색=대기, 주황=준비조건 통과, 초록=실행조건 통과, 테두리 파랑=매수 계열·빨강=매도). 상세는 시스템 환경 설정 장(12장)을 참고하세요.
액션 버튼
목록 아래(또는 목록에서 우클릭)에서 선택한 작업에 대해 다음 동작을 실행합니다.
| 버튼 | 동작 |
|---|---|
| 사용 | 선택 작업을 사용(실행) 상태로 전환 |
| 사용중지 | 선택 작업을 사용 중지 |
| 매도중지 | 선택 작업의 매도중지 ↔ 재개를 토글합니다. 중지 중에는 해당 작업의 매도 주문이 실행되지 않습니다. |
| 최초매수 미체결 | 최초매수가 아직 체결되지 않은 작업을 일괄 선택 |
| 추가매수 | 선택한 작업에 추가 매수를 실행 (작업 1개만 선택했을 때 사용) |
| 삭제 | 선택 작업을 삭제 (되돌릴 수 없는 동작, 빨강) |
| 일괄매도 | 선택 작업의 보유 수량을 즉시 전량 매도 (되돌릴 수 없는 동작, 빨강) |
⚠️ 주의: 삭제와 일괄매도는 즉시 실행되어 되돌릴 수 없습니다. 선택한 작업이 맞는지 반드시 확인하고 실행하세요. (우클릭 메뉴에는 오류 상태를 초기화하는 에러 초기화도 있습니다.)
상세 정보 패널
목록 아래에는 선택한 작업의 상세 정보를 펼쳐 볼 수 있는 접이식 패널이 있습니다(처음에는 접혀 있음). 전략명, 사용·완료·오류 여부, 주문금액, 생성일시, 사용중지 사유, 오류 메시지 등을 확인할 수 있습니다.
오른쪽 영역은 [실시간 체결 현황] 과 [매매작업 상세] 두 개의 탭으로 구성됩니다. 위쪽 탭을 눌러 전환합니다.
매매가 체결될 때마다 그 내역이 최신순으로 실시간 누적되는 탭입니다. 프로그램을 실행하면 먼저 당일 체결분이 채워지고, 이후 새로 발생하는 체결이 맨 위에 추가됩니다.
| 컬럼 | 설명 |
|---|---|
| 시간 | 체결이 이루어진 시각 |
| 계좌번호 | 체결이 발생한 계좌 |
| 종목코드 / 종목명 | 체결된 종목 |
| 구분 | 매수(빨강) / 매도(파랑) |
| 체결수량 / 체결단가 / 체결금액 | 체결된 수량·단가와 그 합계 금액 |
왼쪽 목록에서 매매작업을 선택하면, 그 작업 기준으로 위에서부터 명세 · 주문 · 체결 세 단이 채워집니다. 각 단의 경계선을 드래그해 높이를 조절할 수 있습니다.
| 단 | 표시 내용 |
|---|---|
| 매매작업 상세(명세) | 선택 작업을 이루는 주문 명세 목록입니다. 준비·실행 단계, 주문·거래 구분, 주문금액, 준비·실행 조건, 사용·완료·오류 상태 등을 표시하며, 행 배경색으로 상태를 구분합니다(준비 통과=주황, 실행 통과=초록, 완료=파랑, 오류=빨강, 미사용=회색). |
| 주문 | 해당 작업에서 발생한 주문 목록입니다. 종목·주문 구분·거래 구분·주문/체결/미체결 수량·주문가격·주문번호·처리상태 등을 표시하며, 취소된 주문은 회색·반투명으로 표시됩니다. |
| 체결 | 실제 체결된 내역입니다. 종목·주문 구분·체결 수량·체결가격·체결시간·체결번호를 표시합니다. |
본문 아래쪽에는 실시간 거래 현황을 탭으로 나눠 보여 주는 잔고 · 체결 현황 영역이 있습니다.
접기 / 펼치기
영역 헤더의 셰브론(∨) 버튼으로 탭 영역을 접거나 펼칠 수 있습니다. 접으면 위쪽 대시보드를 더 넓게 볼 수 있고, 이 상태는 저장되어 다음 실행에도 유지됩니다.
탭 구성
각 탭 이름 옆의 숫자 뱃지는 해당 탭의 항목 수를 나타냅니다.
| 탭 | 표시 내용 |
|---|---|
| 키움잔고 | 키움 계좌의 보유 종목별 평가·손익 현황 (아래 상세) |
| 시스템잔고 | 프로그램이 자동매매로 관리하는 내부 기준 보유 현황 |
| 당일매매 | 오늘 발생한 매수·매도 체결 내역 요약 |
| 당일실현손익 | 오늘 실현된 손익 현황 (옵션 탭, 아래 참고) |
| 체결 | 실시간으로 체결된 주문 목록 |
| 미체결 | 아직 체결되지 않고 대기 중인 주문 목록 |
| 조건검색식 | 실시간 조건검색식에 포착된 종목 목록 |
| 시스템 정보 | 실시간 체결 데이터의 처리 지연 통계 등 시스템 상태 정보 |
📌 참고: 당일실현손익 탭은 기본적으로 숨겨져 있습니다. **[설정] → [시스템 환경 설정]**에서 켜면 표시됩니다.
키움 계좌에 보유 중인 종목별 평가·손익과 자동매매 전략 연계 여부를 함께 보여 줍니다.
| 컬럼 | 설명 |
|---|---|
| 종목코드 / 종목명 | 보유 종목 코드와 이름 (손익에 따라 종목명 글자색 구분) |
| 자동매매 전략 | 해당 종목에 연계된 전략을 파란 뱃지로 표시 |
| 보유수량 | 현재 보유 중인 주식 수 |
| 현재가 | 실시간 현재가 (▲/▼ 부호·색상) |
| 매입단가 / 매입금액 | 매수 평균 단가와 매입 원가 |
| 평가금액 | 현재가 기준 평가금액 |
| 손익률 / 평가손익 | 수익률과 평가 손익 (부호·색상 구분) |
전략 미등록 종목 강조
자동매매 전략이 연결되지 않은 종목은 행 배경이 옅은 앰버(호박)색으로 표시되며, 목록 우측 상단에 "전략 미등록 종목: N" 배지로 개수가 안내됩니다. 이런 종목은 키움 잔고에만 존재해 자동매매 관리 대상이 아니며, 실시간 시세가 바로 반영되지 않을 수 있습니다.
💡 팁: 전략 미등록 종목에서 우클릭하면 자동매매 적용 메뉴로 해당 종목에 전략을 연결할 수 있습니다. (이미 전략이 있는 종목에는 나타나지 않습니다.) 우측 상단의 ? 도움말을 누르면 관련 안내를 볼 수 있습니다.
나머지 탭도 각각의 현황을 실시간으로 표시합니다.
화면 최상단 오른쪽, 메뉴바 옆에는 주요 시장 지수가 실시간으로 표시됩니다.
| 항목 | 설명 |
|---|---|
| KOSPI | 코스피 지수의 현재가와 등락 정보 (등락에 따라 색상 표시) |
| KOSDAQ | 코스닥 지수의 현재가와 등락 정보 (등락에 따라 색상 표시) |
화면 최하단의 상태바는 프로그램의 실시간 연결 상태와 등록 현황을 보여 줍니다. 왼쪽은 실시간 등록 현황, 오른쪽은 연결 상태 텍스트 · 신호등 · 후원하기로 나뉩니다.
계좌가 하나 이상 등록되어 있으면, 상태바 왼쪽에 계좌별 실시간 등록 현황 카드가 표시됩니다.
각 카드는 계좌 라벨과 함께 시세 등록 수와 조건 등록 수를 보여 줍니다.
| 표시 | 의미 |
|---|---|
| 시세 n/90 | 실시간 시세를 받는 종목 수 / 프로그램 상한(90). 매수 가능한 종목이 최대 90개까지임을 뜻합니다. |
| 조건 n/9 | 사용 중인 실시간 조건검색식 수 / 프로그램 상한(9) |
📌 참고: 키움 REST API의 실제 상한은 실시간 시세 100개, 조건검색식 10개이지만, 안정적인 처리를 위해 프로그램에서는 각각 90개·9개로 제한합니다.
색상으로 보는 여유 정도
| 색상 | 상태 |
|---|---|
| 🟢 초록 | 여유 (상한의 80% 미만) |
| 🟠 주황 | 주의 (상한의 80% 이상) |
| 🔴 빨강 | 포화 (상한 도달) |
💡 팁: 등록 현황 라벨 옆의 ? 아이콘을 누르면 요청 종류별 상한과 색상 기준을 설명하는 안내 화면이 열립니다.
연결 상태 텍스트
키움 서버와의 연결 상태를 텍스트와 점으로 표시합니다.
| 표시 | 의미 |
|---|---|
| 🟢 연결됨 | 모든 연결이 정상 |
| 🟠 일부 연결 | 일부 연결만 살아 있음 — 네트워크 상태 점검 권장 |
| 🔴 연결 끊김 | 연결이 없음 — 연결 상태 확인 필요 |
신호등 (4종)
연결 상태 옆에는 사용자 아이디와 함께 4개의 신호등이 순서대로 표시됩니다. 각 신호등에 마우스를 올리면 툴팁으로 누적 횟수를 확인할 수 있습니다.
| 신호등 | 점등 조건 | 색상 변화 |
|---|---|---|
| ① TR 요청 | 키움 API에 데이터 조회 요청이 발생할 때 | 회색 → 초록 → 1초에 걸쳐 서서히 회색 |
| ② 키움 서버 Ping 수신 | 키움 서버의 Ping을 수신할 때 | 초록 → 5초에 걸쳐 회색 |
| ③ 실시간 데이터 수신 | 실시간 시세·체결 데이터를 수신할 때 | 초록 → 0.3초 만에 빠르게 회색 |
| ④ 통신 연결 상태 | 상시 표시 (1.5초 주기 펄스) | 전체 연결=초록 / 일부 연결=주황 / 연결 없음=빨강 |
💡 팁: 장 중인데 ③ 실시간 데이터 수신 신호가 전혀 깜빡이지 않거나 ④ 연결 상태가 빨강이면, 실시간 데이터가 수신되지 않는 상태입니다. 인터넷 연결과 키움 API 등록 상태를 확인하세요.
후원하기
상태바 오른쪽 끝의 후원하기 버튼을 누르면 후원 계좌 정보 팝업이 표시됩니다. 메뉴바 **[도움말] → [후원하기]**와 동일한 기능입니다.