사용자 설명서를 불러오는 중입니다
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
매매전략을 만들었다면 이제 실제로 실행하고, 어떻게 매매가 진행되는지 지켜볼 차례입니다. 이 장에서는 전략을 켜고 끄는 방법, 진행 중인 매매작업을 실시간으로 살펴보는 방법, 그리고 주문·수익률·매매제한을 조회하는 여러 화면을 차례로 안내합니다.
자동매매는 매매전략 단위로 켜고 끕니다. 메인 화면 좌측의 [자동매매 실행 스위치] 패널(3.4에서 소개)에서 전략별 토글 스위치를 눌러 즉시 ON/OFF 할 수 있으며, 편집기를 열 필요가 없습니다.
전략 스위치를 ON으로 전환하면 프로그램이 곧바로 매매를 시작하지 않고, 먼저 아래 세 가지를 순서대로 검사합니다. 하나라도 통과하지 못하면 스위치는 자동으로 OFF로 원복되고 안내 메시지가 표시됩니다.
| 순서 | 검증 항목 | 통과하지 못하면 |
|---|---|---|
| 1 | 실시간 주식 체결 등록 한도 — 실시간 체결 데이터를 받을 수 있는 종목 수 한도를 넘지 않는지 확인 | "실시간 주식 체결 데이터 서비스에 등록할 수 있는 종목코드의 최대 갯수를 초과했습니다…" 메시지 후 원복 |
| 2 | 조건검색식 등록 한도 — 실시간 조건검색식 등록 개수 한도를 넘지 않는지 확인 | "조건검색 서비스에 등록할 수 있는 종목코드의 최대 갯수를 초과했습니다…" 메시지 후 원복 |
| 3 | 포착 조건검색식 충돌 — 이 전략의 포착 조건검색식이 이미 실행 중인 다른 전략에서 편입 조건검색식으로 쓰이고 있지 않은지 확인 | "포착 조건검색식 : '…' 가 이미 실행중인 자동매매전략에서 편입 조건검색식으로 사용되고 있습니다…" 메시지 후 원복 |
세 검증을 모두 통과하면 전략이 실행 상태로 저장되고, 실시간 체결 데이터와 편입 조건검색식이 등록되면서 자동매매 감시가 시작됩니다.
📌 참고: 위 1·2번의 한도는 키움 REST API의 계좌별 한도를 따릅니다. 프로그램이 사용할 수 있는 상한(실시간 체결 종목 수, 실시간 조건검색식 개수)은 화면 하단 등록 현황 바와 [매매제한 현황] 창(6.7)에서 실시간으로 확인할 수 있습니다. 현재 사용량이 한도에 가까울수록 새 전략을 켜기 어려워지므로, 한도가 넘칠 때는 사용하지 않는 전략을 먼저 중지하십시오.
💡 팁: 스위치 목록에는 사용중이면서 오류가 없는 전략만, 그리고 현재 선택한 계좌에 연결된 전략만 표시됩니다. 켜려던 전략이 보이지 않는다면 계좌 선택, 사용 여부, 오류 상태를 먼저 확인하십시오. 또한 등록된 실제 계좌가 아니면 해당 전략은 오류 상태로 전환되며 "…계좌번호가 존재하지 않습니다." 메시지가 표시됩니다.
이미 실행 중인 전략을 장중에 OFF로 전환하면 다음 확인 경고가 표시됩니다.
"장중에 실행을 중지하면 처리되지 못한 매매 데이터가 발생할 수 있습니다. 이로인해 예기치 못한 오류가 발생할 수 있습니다. 계속 진행하시겠습니까 ?"
⚠️ 주의: 갑작스러운 장중 중지는 미체결 주문이나 잔고 불일치를 유발할 수 있습니다. 가급적 보유 종목과 미체결 주문이 없는 상태에서, 또는 장 마감 후에 중지하시기를 권장합니다.
전략을 실행하면 조건에 포착된 종목마다 **매매작업(Job)**이 생성됩니다. 이 매매작업들이 어떻게 진행되는지는 메인 화면 우측에 상시 표시되는 자동매매 현황 대시보드에서 실시간으로 확인합니다. 이 대시보드가 v2.0.0의 주된 모니터링 수단입니다.
화면은 크게 두 부분으로 나뉩니다. 좌측은 진행 중인 매매작업 목록과 필터·액션 버튼, 우측은 선택한 작업의 명세 / 주문 / 체결을 위에서 아래로 3단으로 보여주는 드릴다운 영역입니다.
좌측 상단 헤더에는 진행 중 작업 수를 나타내는 카운트 칩, [금일 완료작업 표시] 체크박스, 그리고 [자동 새로고침] 토글이 있습니다. 자동 새로고침을 켜면 목록이 5초 주기로 자동 갱신됩니다.
바로 아래 필터 패널에서 전략명과 계좌번호를 골라 원하는 작업만 추려 볼 수 있고, [새로고침] 버튼으로 즉시 다시 불러올 수 있습니다.
목록(표)에는 다음 컬럼이 표시됩니다.
| 컬럼 | 설명 |
|---|---|
| (체크박스) | 작업 선택. 헤더의 체크박스로 전체 선택 |
| 계좌번호 | 작업이 속한 계좌 |
| 종목코드 | 매매 대상 종목 코드 |
| 종목명 | 종목명. 매도가 중지된 작업에는 매도중지 빨간 배지가 붙음 |
| 매매전략 | 작업을 생성한 전략 이름 |
| 현재가 | 실시간 현재가. 상승 ▲ / 하락 ▼ 부호와 색상 표시 |
| 전략상태 | 명세별 진행 상태를 색 원형 배지로 표시(기본 숨김) |
| 생성일시 | 작업이 생성된 일시 |
💡 팁: 행 색상으로 상태를 빠르게 구분할 수 있습니다. 오류 작업은 빨간 글씨, 완료 작업은 파란색 계열, 미사용 작업은 회색으로 흐리게 표시됩니다.
목록에서 작업을 선택한 뒤 하단 버튼이나 우클릭 메뉴로 아래 동작을 실행합니다.
| 액션 | 동작 |
|---|---|
| 사용 | 선택한 작업을 사용 상태로 전환(매매 재개) |
| 사용중지 | 선택한 작업을 사용 중지(매매 중단) |
| 매도중지 | 선택한 작업의 매도중지 상태를 토글. 중지 시 매도주문이 실행되지 않음 |
| 최초매수 미체결 | 최초매수가 아직 체결되지 않은 작업을 일괄 선택 |
| 추가매수 | 작업 1개만 선택했을 때 사용. 금액 입력 창이 뜨고, 입력한 금액만큼 시장가로 추가 매수 |
| 삭제 ⚠️ | 선택한 작업을 삭제 |
| 일괄매도 ⚠️ | 선택한 작업의 보유수량을 즉시 매도 |
| 에러 초기화 | 작업의 오류 상태를 해제 |
⚠️ 주의: 삭제와 일괄매도는 되돌릴 수 없는 파괴적 동작입니다. 특히 일괄매도는 선택한 모든 작업의 보유 물량을 시장가로 즉시 처분하므로, 실행 전에 선택된 작업과 종목을 반드시 다시 확인하십시오.
좌측에서 작업을 선택하면 우측 3단에 그 작업의 세부 내역이 연동되어 나타납니다.
우측 상단 — 매매작업 상세(명세) 선택한 작업에 적용된 주문 전략 명세(최초매수·추가매수·매도 등 단계별 설정)가 나열됩니다. 준비·실행·주문구분·거래구분·주문금액과 함께 준비 조건·실행 조건의 통과/대기 여부, 사용여부, 완료여부, 사용중지이유, 오류 및 오류 메시지가 표시됩니다. 헤더 우측의 범례로 행 배경색의 의미(준비통과=주황, 실행통과=초록, 완료=파랑, 오류=빨강, 미사용=회색)를 확인할 수 있습니다.
명세 행에서 우클릭하면 다음을 실행할 수 있습니다.
우측 중단 — 주문 선택한 작업에서 발생한 주문 목록입니다. 종목코드·종목명·주문구분·거래구분·생성일·주문시간·주문수량·주문가격·체결수량·미체결수량·주문번호·처리상태를 표시하며, 취소된 주문은 회색으로 나타납니다. 우클릭으로 주문을 삭제할 수 있습니다.
우측 하단 — 체결 선택한 작업의 실제 체결 내역입니다. 종목코드·종목명·주문구분·체결수량·체결가격·체결시간·체결번호를 표시합니다. 하나의 주문이 여러 건으로 나뉘어 체결될 수 있습니다.
📌 참고: 좌측 목록 아래에는 접이식 선택한 매매작업 상세 정보 영역이 있어, 펼치면 전략명·사용여부·완료여부·오류여부·주문금액·생성일시·사용중지사유·오류메시지를 한눈에 볼 수 있습니다.
메인 대시보드에서 행을 더블클릭하면 더 자세한 별도 상세창이 열립니다. 더블클릭 위치에 따라 두 종류의 창이 있습니다.
⚠️ 주의: 이 더블클릭 상세창들은 메인 임베드 대시보드(6.2)에서만 열립니다. 뒤에서 설명하는 별도 [자동매매 현황] 창(6.4)에는 더블클릭 상세창이 없습니다.
진행 중 매매작업 목록(좌측)에서 작업 행을 더블클릭하면 포지션·평가 중심의 상세창이 열립니다. 계좌 잔고를 기준으로 보유 현황과 손익을 한 화면에 정리해 보여주며, 현재가는 실시간으로 반영됩니다.
상단 포지션/평가 박스에는 다음 항목이 표시됩니다.
| 항목 | 설명 |
|---|---|
| 보유수량 | 현재 보유 중인 수량 |
| 현재가 | 실시간 현재가 |
| 매입단가 | 평균 매입 단가 |
| 매입금액 | 매수에 들어간 총 금액 |
| 평가금액 | 현재가 × 보유수량 |
| 손익률 | 손익 비율(%), 부호에 따라 색상 표시 |
| 평가손익 | 평가금액 − 매입금액, 부호에 따라 색상 표시 |
그 아래 상세 필드 박스에는 전략명·사용여부·완료여부·오류여부·주문금액·생성일시·사용중지사유·오류메시지가 표시됩니다.
매매작업 상세(명세) 목록(우측 상단)에서 명세 행을 더블클릭하면, 넓은 명세 표를 읽기 쉽게 2×2 카드 4개로 정리한 상세창이 열립니다.
| 카드 | 담긴 내용 |
|---|---|
| 기본 (좌상) | 주문구분 · 거래구분 · 실행주기 · 주문금액 |
| 상태 (우상) | 사용여부 · 완료여부 · 오류 · 오류 메시지 · 사용중지이유 · 생성일시 |
| 준비 조건 (좌하) | 유형 · 조건식 · 조합 · 사용자정의 · 통과 여부(통과/대기) |
| 실행 조건 (우하) | 유형 · 조건식 · 조합 · 사용자정의 · 통과 여부(통과/대기) |
💡 팁: 준비 조건과 실행 조건이 모두 통과 상태여야 해당 주문이 실제로 발송됩니다. 주문이 나가지 않는다면 이 두 카드의 통과 여부를 먼저 확인하십시오.
메인 대시보드 외에, 자동매매 전체 계층을 한 창에서 넓게 보고 싶을 때는 별도 [자동매매 현황] 창을 사용합니다. 상단 메뉴 [자동매매 → 자동매매 현황] 을 클릭하면 열립니다.
화면은 좌에서 우로 5개 영역이 나란히 배치되며, 왼쪽 항목을 선택하면 오른쪽이 연동되는 드릴다운 방식입니다.
| 영역 | 내용 |
|---|---|
| ① 매매전략 | 등록된 전략 목록(계좌번호·전략명). 하단에 기본 주문 금액·매수시간 A/B·매도시간 A/B·사용 여부·실행 여부·기타 설명 등 상세 표시 |
| ② 작업중 매매작업 | 선택 전략의 작업 목록(계좌번호·종목코드·종목명·생성일시). [금일 완료작업 표시] 체크박스 제공, 우클릭으로 삭제. 하단에 작업 상세 표시 |
| ③ 매매작업 상세(명세) | 선택 작업의 명세 목록(준비·실행·주문구분·거래구분·주문금액·준비 조건·실행 조건·사용여부·사용중지이유·오류·오류 메세지·생성일시) |
| ④ 주문 현황 | 선택 명세의 주문 목록(종목·주문구분·거래구분·주문시간·주문/체결/미체결수량·주문가격·주문번호·처리상태) |
| ⑤ 체결 현황 | 선택 주문의 체결 내역(종목·주문구분·체결수량·체결가격·체결시간·체결번호) |
우측 상단 [새로고침] 버튼으로 전체 데이터를 다시 불러오며, 각 영역 경계는 드래그하여 크기를 조절할 수 있습니다.
📌 참고: 이 창은 전체 계층을 넓게 훑어보기에 좋지만, 앞서 설명한 더블클릭 상세창(6.3)은 열리지 않습니다. 포지션·평가나 명세 2×2 카드를 보려면 메인 대시보드를 이용하십시오.
과거의 주문과 체결 내역을 전략·기간별로 조회하려면 상단 메뉴 [자동매매 → 자동매매 주문 내역] 을 클릭합니다.
조회 결과에는 다음과 같은 항목이 표시됩니다(일부).
| 컬럼 | 설명 |
|---|---|
| 그룹 | 같은 매매작업(사이클)을 묶는 ID |
| 생성일시 / 주문일자 | 주문 발생·저장 일시 |
| 전략명 · 계좌번호 | 주문이 속한 전략과 계좌 |
| 주문구분 · 상세구분 | 매수/매도 및 세부 구분 |
| 종목코드 · 종목명 | 매매 종목 |
| 실행조건식 | 주문을 트리거한 실행 조건식 표시명 |
| 주문가격 · 주문수량 | 주문 시 가격과 수량 |
| 체결수량 · 체결평균가 · 체결금액 | 실제 체결 결과 |
| 주문번호 · 원주문번호 | 키움 API 주문번호 |
| 전송결과 · 키움결과 | 주문 전송 성공 여부와 키움 응답 메시지 |
| 주문이유 | 주문이 발생한 이유 |
조회된 결과는 목록에서 우클릭 → [Excel 내보내기] 로 엑셀 파일로 저장할 수 있습니다.
매매작업 단위로 수익률을 요약·집계해서 보려면 상단 메뉴 [자동매매 → 자동매매 수익률 조회] 를 클릭합니다. 창 제목은 자동매매 매매작업별 수익률 조회입니다.
전략을 선택하고 기간(1일 · 2일 · 1주일 · 1개월 · 1년 또는 직접 지정)을 정한 뒤 [조회] 를 누르면, 상태바에 조회된 작업 수가 표시됩니다.
화면 상단에는 조회된 전체 작업의 합계가 한 줄로 요약됩니다.
| 지표 | 설명 |
|---|---|
| 매입금액 합계 | 매수에 들어간 총 금액 |
| 매도금액 합계 | 매도로 회수한 총 금액 |
| 실현손익 합계 | 매도금액 − 매입금액 |
| 수익률 | 실현손익 기준 평균 수익률 |
| 실현손익(순) 합계 | 수수료·세금을 반영한 실현손익 |
| 수익률(순) | 실현손익(순) 기준 평균 수익률 |
📌 참고: 지표 이름에 붙는 "순" 은 수수료와 세금을 반영한 뒤의 값이라는 뜻입니다. 실제 손에 남는 금액에 가까운 것은 "순" 지표입니다.
합계 아래에는 매매작업별 요약 표가 있습니다(작업ID·전략명·종목명·매입금액·매도금액·실현손익·수익률·실현손익(순)·수익률(순)·첫 주문·마지막 주문). 작업을 선택하면 하단에 그 작업의 상세 주문 내역(주문일시·구분·체결수량·매입가·매도가·결과·메시지)이 표시됩니다.
작업별 요약 표는 우클릭 → [Excel 내보내기] 로 저장할 수 있습니다.
자동매매는 키움 REST API와 프로그램 자체의 여러 제한 안에서 동작합니다. 각 계좌가 현재 어느 한도를 얼마나 쓰고 있는지 게이지로 실시간 확인하려면, 상단 메뉴 우측의 [매매제한 현황] 을 클릭해 별도 창을 엽니다.
창에는 계좌별 카드가 배치되며, 각 카드에 다음 6종 제한 항목이 게이지로 표시됩니다. 사용량이 한도에 가까워지면 게이지 색이 붉게 변합니다.
| 제한 항목 | 의미 |
|---|---|
| 총 매수금액 제한 | 사용한 매수금액 / 최대 매수금액 한도(원) |
| 실시간 주식 체결 데이터 요청 제한 | 구독 중인 종목 수 / 최대(REST API 제한). 구독 종목 수는 매매작업 개수(중복 종목 제외) 기준. [종목보기] 버튼으로 요청 종목 목록(코드·종목명)을 볼 수 있음 |
| 조건검색식 요청 제한 | 실시간 조건검색식 개수 / 최대(REST API 제한) |
| 일일 동일 종목 매매작업 생성 제한 | 하루에 같은 종목으로 만들 수 있는 매매작업 최대 횟수. 초과한 종목은 코드·횟수로 표시되며(초과 없으면 "제한 초과 종목 없음"), 자정에 초기화 |
| 연속 동일 매수주문 제한 | 같은 종목에 대한 연속 동일 매수주문 최대 횟수. 다른 주문이 발생하면 초기화 |
| 보유 종목수 제한 (전략별) | 전략별 보유 종목 수 / 최대. 한도에 도달하면 해당 전략의 신규 매수가 제한됨 |
각 항목 옆의 ? 도움말을 누르면 그 제한이 무엇을 뜻하는지 요약 설명을 볼 수 있습니다. 초과된 종목은 강조 색으로 표시됩니다.
💡 팁: 6.1에서 전략을 켤 때 검증하는 실시간 체결 등록 한도와 조건검색식 등록 한도가 바로 이 창의 2·3번 항목입니다. 전략이 켜지지 않거나 새 매매작업이 만들어지지 않을 때, 이 창에서 어떤 한도가 가득 찼는지 먼저 확인하면 원인을 빠르게 찾을 수 있습니다.