🔍 키움증권 Open API 연동 방법(2025 최신 가이드)

반응형

키움증권 Open API는 주식 자동매매 프로그램, 실시간 데이터 수집, DDE 연동 등을 만들기 위한 필수 도구입니다.
이 글에서는 처음 시작하는 분도 쉽게 따라 할 수 있도록 설치부터 엑셀 연동까지 순서대로 설명드립니다.


✅ 키움증권 Open API란?

  • OpenAPI+ (KOAStudio): 키움증권에서 제공하는 주식 자동매매 개발용 인터페이스
  • 주요 기능: 실시간 시세조회, 주문/잔고조회, 자동매매, 엑셀 연동(DDE)
  • 대상: Python, C#, 엑셀 VBA, JavaScript 등 다양한 언어 지원

🧩 설치 순서 요약

단계설명
1단계 키움증권 회원가입 및 영웅문4 설치
2단계 OpenAPI+ 설치 (KOAStudio 포함)
3단계 KOAStudio 실행 확인
4단계 엑셀 연동 설정 (DDE) 또는 코드 테스트 시작

📥 1단계: 키움증권 회원가입 및 영웅문4 설치

  1. 키움증권 홈페이지 접속
  2. 계좌 개설 + 인증서 등록
  3. 영웅문4 다운로드 및 설치

키움증권 로그인 상태 확인

※ 반드시 로그인 상태에서 연동 테스트해야 합니다.


🧑‍💻 2단계: 키움 OpenAPI+ 설치

키움 Open API 다운로드 및 설치 화면

  1. 아래 링크에서 최신 OpenAPI+ 설치파일 다운로드
    🔗 OpenAPI+ 다운로드 바로가기
  2. 설치 완료 후, 다음 폴더 확인:
makefile

C:\OpenAPI\

 

KOAStudioSA 압축 해제된 파일명

  1. KOAStudioSA.exe 실행 가능해야 정상 설치(만약 다른곳에 설치 되었으면 꼭 c:\OpenAPI\ 안으로 이동합니다.)

OpenAPI 디렉토리로 이동함

 

⚙️ 3단계: KOAStudio 실행 및 테스트

  1. C:\OpenAPI\KOAStudioSA.exe 실행
  2. 아래 항목이 정상 로드되어야 함:
    • 실시간 목록 초기화 성공
    • 화면 구성 파일 로드됨
    • 개발 가이드 파일 연결됨

KOAStudio 정상 실행 화면

❗오류 발생 시:

  • 압축 미해제 → 반디집/7zip으로 재해제
  • 일부 파일 누락 → OpenAPI+ 재설치

📊 4단계: 엑셀 실시간 연동 (DDE)

1. 엑셀 설정 변경

  • 파일 > 옵션 > 고급 > 일반 > DDE 사용 허용 체크

2. 아래 수식 입력 예시 (삼성전자 005930)

excel

=DDE("KOA","005930","현재가")
=DDE("KOA","005930","종목명")
=DDE("KOA","005930","거래량")

3. 실시간 시세가 엑셀에 자동으로 표시됨


🧪 Python 연동 시작하려면?

  • Python용 라이브러리: pykiwoom 또는 pywinauto + comtypes
  • 키움 로그인은 32비트 파이썬 + 관리자 권한 실행 필수

👉 별도 코드 예시 및 자동매매 템플릿도 제공 가능


🔒 보안 주의사항

  • 공인인증서, HTS ID/비번 노출 주의
  • 실거래 환경은 별도 테스트 후 적용
  • 비정상 주문 시 주문 제한 가능

🔁 자주 묻는 질문 (FAQ)

질문답변
KOAStudio 실행 에러가 떠요 OpenAPI+ 다시 설치, 압축 완전 해제
#NAME? 오류가 떠요 DDE 설정 안 됐거나 영웅문 로그인 안 됨
여러 종목을 동시에 보려면? 엑셀 시트 복사하거나 VBA 자동화 활용

 

반응형