자주 묻는 질문

키움증권 Open API의 REST API를 사용해 시세 조회·주문·체결 확인을 합니다. HTS에 설치하는 OCX(ActiveX) 방식과 달리, 별도 HTS 창 없이 프로그램이 직접 서버와 통신합니다.

REST API는 기존 키움 Open API(OCX 방식)에 비하여 한 PC에서 여러 키움 계좌를 동시에 운용하기 쉽습니다. 데이터 수신·처리 속도는 OCX보다 다소 느릴 수 있지만, 멀티계좌로 다양한 기법을 동시에 안정적으로 원격 운용할 수 있는 점에 초점을 두고 사용됩니다.

키움증권 Open API 개발자 센터에서 애플리케이션을 등록하고 앱키·시크릿을 발급받습니다. 프로그램 계좌 추가 화면에 입력하면 해당 PC에만 저장됩니다. 발급·IP 등록 절차는 키움증권 안내를 따릅니다.

이미지 보기 — 계좌 추가 — App Key·Secret Key 입력

네. REST API 방식은 등급별 계좌 한도 내에서 여러 키움 계좌를 한 프로그램에 등록·전환할 수 있습니다. 계좌마다 모의·실전 구분과 자동매매 ON/OFF를 따로 관리합니다.

다만 REST API는 계좌·주문·시세 조회에 횟수 제한이 있습니다. 한 PC에서 계좌를 여러 개 동시에 돌리면 조회·주문이 늦어지거나 일시적으로 실패할 수 있습니다. 가능하면 검증된 한두 계좌를 안정적으로 운용하는 것을 권합니다.

OCX 실시간 대비 시세·체결 갱신이 약간 지연될 수 있습니다. 본 프로그램은 폴링 주기·체결 확인·미체결 관리를 REST 특성에 맞게 조정해 운용합니다. 급변 구간에서는 HTS와 체결 시각이 소폭 다를 수 있습니다.

프로그램에서 이용자 인증(algotrade) 후 키움 계좌 로그인을 진행합니다. REST API 토큰이 발급되면 당일 장중 주문·조회가 가능합니다. 토큰 만료 시 재로그인 안내가 표시됩니다.

이미지 보기 — 키움증권 계좌 선택·로그인

계좌가 없으면 계좌 추가에서 모의/실전·계좌번호·App Key를 등록합니다.

이미지 보기 — 계좌 추가 화면

네. 키움 모의투자 계좌와 실거래 계좌를 프로그램에서 구분해 표시합니다. 등급 1·2는 모의투자(데모) 중심이며, 실거래 계좌 연동·주문은 정회원 Pro(등급 3) 이상에서 가능합니다. 정회원(등급 2)부터 원스탁 데모 자동매매가 가능합니다.

모의에서 2주 이상 운용한 뒤 실계좌는 소액으로 연결하는 것을 권합니다. 모의와 실전은 체결 속도·호가·시장가 처리가 다를 수 있어, 모의 결과를 그대로 실전에 대입하면 안 됩니다.

Windows 작업 스케줄러로 프로그램을 미리 실행하고, 파일 → 자동시작을 켜 두면 장 시작 전 algotrade·키움 순으로 로그인을 시도합니다. PC가 켜져 있고 네트워크·키움 서버가 정상이어야 합니다.

이미지 보기 — 파일 메뉴 — 자동시작 체크

이미지 보기 — 자동시작 체크 시 안내 (평일 08:30 실행·장후 종료)

당일 REST API 토큰이 만료되거나 키움 서버 점검 시 주문·조회가 중단될 수 있습니다. 프로그램에서 키움 재로그인을 시도하고, 앱키·시크릿·IP 등록 상태를 확인해 주세요.

종목마스터 미완료 · 종목마스터실패:토큰발급실패:인증 같은 문구가 보이면, 종목마스터 문제가 아니라 키움 REST API 토큰 발급 단계에서 인증이 거절된 것입니다.

1. App Key · Secret Key 재입력 — 복사·붙여넣기 후 앞뒤 공백이 없는지 확인
2. 모의/실전 구분 확인 — 모의 계좌는 모의 전용 키, 실전 계좌는 실전 키를 사용 (혼용 불가)
3. 키움 Open API 신청 · 승인 상태 확인 — 신청 직후 또는 미승인 상태면 토큰 발급이 거절될 수 있음
4. 등록 IP 확인 — 현재 PC의 공인 IP가 키움 개발자 센터의 APP KEY 관리에 등록되어 있는지 확인
5. 프로그램 완전 종료 후 재실행 — 토큰 재발급 상태를 초기화한 뒤 다시 로그인

가장 흔한 원인은 키 입력 오타, 모의/실전 키 혼용, IP 미등록입니다. 반복 실패 시 키움 Open API 고객센터를 확인합니다.

키움증권 계좌 로그인 화면에서 계좌 추가 / 수정 / 삭제를 사용합니다. 별칭·모의/실전·계좌번호·App Key·Secret Key를 입력해 저장합니다. 삭제 전 해당 계좌의 자동매매·미체결을 모두 정리하는 것을 권장합니다. 등급별 계좌 수 한도를 초과하면 추가할 수 없습니다.

이미지 보기 — 계좌 선택·추가·수정·삭제

이미지 보기 — 계좌 추가 입력 항목