사용자 설명서를 불러오는 중입니다
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
잠시만 기다려 주세요. 대용량 문서를 최적화하고 있습니다.
부엉이 트레이더는 키움증권 REST API를 통해 주문 실행, 계좌 조회, 실시간 시세 수신 등 모든 핵심 기능을 수행합니다. 이를 위해 키움증권 REST API 포털에서 발급받은 App Key와 Secret Key를 프로그램에 등록해야 합니다.
⚠️ 주의: App Key와 Secret Key가 하나도 등록되지 않으면 프로그램의 매매 관련 기능을 사용할 수 없습니다.
메뉴 [설정 → 키움증권 REST API KEY 등록] 을 클릭하면 등록 화면이 열립니다.
이 화면은 마스터-디테일 구조로, 좌우 두 영역으로 나뉩니다.
| 영역 | 내용 |
|---|---|
| 좌측 계좌 목록 | 등록된 계좌를 카드 형태로 나열합니다. 각 카드에는 별칭, 계좌번호(미입력 시 계좌번호 미입력으로 표시), 모의/실전 구분 뱃지가 보입니다. 최대 10개 계좌까지 등록할 수 있습니다. |
| 우측 상세 편집 | 좌측에서 선택한 계좌의 상세 정보를 입력·수정하는 영역입니다. |
| 버튼 | 동작 |
|---|---|
| [+ 계좌 추가] | 새 계좌 항목을 목록에 추가합니다. 계좌가 10개 미만일 때만 사용할 수 있습니다. |
| [삭제] | 선택한 계좌 항목을 목록에서 제거합니다. |
| [초기화] | 해당 계좌 항목에 입력한 값을 비웁니다. |
좌측 목록에서 계좌를 선택한 뒤 우측에서 아래 항목을 입력합니다.
| 입력 항목 | 설명 | 예시 |
|---|---|---|
| 계좌번호 | 키움증권 국내 주식 계좌번호 (하이픈 없이 숫자만) | 1234567890 |
| App Key | 키움 포털에서 발급받은 공개 식별자 | PSxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Secret Key | 키움 포털에서 발급받은 비공개 인증키 | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| 별칭 | 계좌를 알아보기 쉽게 붙이는 이름 | 주력 계좌 |
| 서버 구분 | ● 모의투자 또는 ● 실서버 중 선택 | ● 모의투자 |
⚠️ 주의: ● 실서버로 등록한 계좌에서 자동매매를 시작하면 실제 돈으로 주문이 실행됩니다. 처음 사용하시는 분은 반드시 ● 모의투자 계좌로 먼저 충분히 검증하십시오.
⚠️ 주의: Secret Key는 절대 타인에게 공개하지 마십시오. 유출 시 타인이 귀하의 계좌로 주문을 실행할 수 있습니다. 유출이 의심되면 키움 REST API 포털에서 즉시 재발급하십시오.
📌 참고: 계좌번호·App Key·Secret Key 중 하나라도 입력하면 나머지 항목도 함께 입력해야 합니다. 또한 서로 다른 계좌에 같은 계좌번호를 중복 입력할 수 없습니다.
상세 편집 영역의 [연결 테스트] 버튼을 누르면, 입력한 App Key와 Secret Key로 키움 서버에 실제 접속을 시도하여 키가 유효한지 즉시 확인합니다. 결과는 성공/실패 메시지와 뱃지로 표시됩니다.
💡 팁: 저장 전에 [연결 테스트] 로 키가 올바른지 미리 확인해 두면, 저장 단계에서의 오류를 줄일 수 있습니다.
[저장] 을 누르면 입력값을 검사한 뒤 유효한 계좌만 저장합니다. 최소 1개 이상의 유효한 키가 있어야 저장됩니다. 이때 새로 입력하거나 수정한 키만 키움 서버로 다시 검증하며, 변경하지 않은 키(별칭만 바꾼 경우 포함)는 재검증을 생략합니다.
자격 증명(App Key·Secret Key)은 Windows 자격 증명 관리자(Credential Manager) 에 안전하게 저장됩니다. 별도 파일로 평문 보관하지 않으므로 보안에 안전하며, PC를 재부팅해도 유지됩니다.
⚠️ 주의: 계좌·키 변경 내용은 프로그램을 재시작한 후에 반영됩니다. 저장 후 안내에 따라 프로그램을 다시 시작하십시오.
의도치 않은 과도한 주문을 막기 위해, 매매 리스크 한도를 계좌(App Key)별로 설정할 수 있습니다. 각 한도는 4.1의 상세 편집 영역에서 해당 계좌를 선택한 상태로 함께 입력하며, 계좌마다 서로 다른 값을 지정할 수 있습니다.
| 리스크 항목 | 설명 | 기본값 |
|---|---|---|
| 일일 총 매수 금액 제한 | 해당 계좌에서 하루 동안 매수할 수 있는 총 금액 상한(원) | 100,000,000 (1억 원) |
| 일일 동일 종목 매매작업 생성 제한 | 하루 동안 같은 종목에 대해 새로 만들 수 있는 매매작업 수 | 5 회 |
| 동일 매수주문 연속 제한 | 같은 매수주문을 연속으로 넣을 수 있는 최대 횟수 | 5 회 |
📌 참고: 세 항목 모두 계좌 단위로 저장됩니다. 여러 계좌를 운용하는 경우, 계좌마다 자금 규모와 전략에 맞게 개별적으로 조정하십시오.
이 한도들은 [저장] 하는 즉시 매매제한 현황에 반영됩니다. 현재 남은 한도와 사용량은 매매제한 현황 화면에서 확인할 수 있습니다(6장 참조).
💡 팁: 리스크 한도는 예기치 못한 반복 주문이나 시스템 오작동으로 인한 손실을 줄여 주는 안전장치입니다. 실서버 운용 전에 계좌별로 적절한 값을 설정해 두시길 권장합니다.