반응형
✅ 1단계 개요: 왜 영웅문4 OpenAPI + Python 인가요?
키움증권 영웅문4 OpenAPI는
대한민국 개인 투자자들이 가장 많이 사용하는 자동매매 플랫폼입니다.
이를 Python과 연동하면 아래와 같은 자동화가 가능합니다:
- 실시간 주가 조회
- 조건 검색 자동매매
- 시세 수집 & 백테스트
- 주식 자동매수/매도
- 디스코드/노션/카카오 알림
✅ 지금부터 단계별로 따라하면 누구나 Python으로 자동매매 시스템을 만들 수 있어요!
🛠️ STEP 1. 키움증권 계좌와 API 설치 준비
🔹 준비물
| 준비항목 | 설명 |
| ✅ 키움증권 계좌 | 키움증권 바로가기 |
| ✅ 영웅문4 설치 | 키움 홈페이지 → 다운로드 바로가기 |
| ✅ OpenAPI 설치 | Kiwoom OpenAPI+를 설치해야 함 (HTS 연동용 DLL 포함) 다운로드 바로가기 |
| ✅ Windows 운영체제 | Windows 필수 (COM 기반 API) |
| ✅ Python 3.7 ~ 3.11 | 권장: 3.10 이하 (32bit 권장) |
📦 STEP 2. Python 개발 환경 준비
🔹 Python 설치
- https://www.python.org/downloads/windows/ 에서 3.10.x (32bit) 설치
설치 시 반드시:
- ✅ Add Python to PATH 체크
- ✅ pip 설치 포함 확인
🔹 가상환경 생성 & 패키지 설치
bash
python -m venv kiwoom-env
kiwoom-env\Scripts\activate
pip install pywin32 pandas
🔗 STEP 3. COM 기반 OpenAPI 연동하기
🔹 핵심: win32com.client 모듈로 OpenAPI 객체 호출
python
import win32com.client
# 키움 API 연결
kiwoom = win32com.client.Dispatch("KHOPENAPI.KHOpenAPICtrl.1")
🔐 STEP 4. 로그인 & 상태 확인
python
# 로그인 창 호출
kiwoom.CommConnect()
# 상태 확인 (0:미연결, 1:연결됨)
print("연결 상태:", kiwoom.GetConnectState())🔍 STEP 5. 실시간 시세 조회 (기본 기능)
python
# 주가 요청 (삼성전자)
ret = kiwoom.SetInputValue("종목코드", "005930") # 삼성전자
kiwoom.CommRqData("opt10001_req", "opt10001", 0, "0101")- opt10001 = 주식기본정보 요청
- SetInputValue로 조건 설정
- CommRqData로 요청 보내기
다음 단계에서는 이벤트 처리와 데이터 수신 처리를 배워요!
반응형