Plan X . PROJECTS/0. 키움 OpenAPI 개발 환경 세팅

*키움증권 자동매매 환경 설정 및 PyCharm 가상환경 설정 가이드

The Greatest Thinking! 2025. 5. 2. 01:06
SMALL

1. 키움증권 자동매매 최적화 환경 설정

1.1. 필수 준비물

  • 키움증권 Open API+: 키움증권 홈페이지에서 다운로드 및 설치. 주식 데이터 조회 및 매매 주문 자동화.
  • 파이썬 (32bit 권장): 키움 Open API+는 32bit 환경에서 안정적. 64bit OS에서도 32bit 파이썬 설치 가능.
  • PyCharm: 코드 디버깅과 프로젝트 관리를 위한 IDE.
  • pykiwoom 패키지: 키움 Open API+를 파이썬에서 쉽게 사용 (pip install pykiwoom).
  • 모의투자 계좌: 실제 매매 전 테스트용 계좌 (키움증권 신청).

1.2. 최적화된 환경 설정

  • 운영체제: Windows 10/11 권장 (맥OS/리눅스는 가상환경 우회 필요).
  • 파이썬 버전: Python 3.6~3.8 (32bit) 권장. 최신 버전은 호환성 문제 가능.
  • 가상환경: 프로젝트별 독립 환경으로 라이브러리 충돌 방지 (virtualenv 또는 Anaconda).
  • 멀티로그인: HTS/MTS와 동시 접속을 위해 키움증권 멀티로그인 신청.
  • KOA Studio: API 요청 테스트 및 디버깅 툴 (선택).

1.3. 환경 설정 순서

  1. 키움증권 Open API+ 설치 및 모의투자 계좌 신청.
  2. 32bit 파이썬 설치 후 pykiwoom 패키지 설치.
  3. PyCharm에서 프로젝트 생성 및 가상환경 설정.
  4. API 연결 테스트 코드 실행.

1.4. 최적화 팁

  • 안정성: API 호출 빈도 조절 (초당 5회 이하).
  • 로그 관리: 매매 기록 및 에러 로그 파일 저장.
  • 백테스팅: 모의투자로 전략 검증.
  • REST API: 2025년 출시된 키움 REST API로 다양한 OS 지원.

2. PyCharm 가상환경과 인터프리터 설정

2.1. 가상환경 개념

  • 정의: 프로젝트별 독립된 파이썬 환경. 라이브러리 충돌 방지.
  • 비유: 각 프로젝트를 위한 "독립된 작업실".
  • 필요성: 프로젝트마다 다른 버전의 라이브러리 사용 시 충돌 방지.

2.2. 인터프리터 개념

  • 정의: 파이썬 코드를 실행하는 프로그램 (python.exe).
  • 비유: 작업실의 "엔진".
  • 중요성: 올바른 인터프리터 지정 없으면 코드 실행 불가.

2.3. PyCharm 설정 방법

  1. 프로젝트 생성: PyCharm에서 New Project로 프로젝트 폴더 지정.
  2. 가상환경 생성: New environment using Virtualenv 선택. 프로젝트 폴더에 venv 생성.
  3. 인터프리터 설정: File > Settings > Project > Python Interpreter에서 가상환경의 python.exe 지정.
  4. 패키지 설치: pykiwoom 등 필요 라이브러리 설치.
  5. 테스트: 간단한 코드 실행으로 환경 확인.

2.4. 예시

  • 상황: 키움 자동매매 프로젝트.
    • 가상환경: C:\KiwoomAutoTrade\venv.
    • 인터프리터: venv\Scripts\python.exe.
    • 설치 패키지: pykiwoom.
  • 효과: 다른 프로젝트와 독립적으로 동작.

3. 성공 사례 기반 파이썬 및 아나콘다 설정

3.1. 사례 1: 

  • 환경:
    • OS: Windows 10 (64bit).
    • 파이썬: 3.7.9 (32bit).
    • 아나콘다: Anaconda3-2020.11.
  • 설치 항목:
    • pykiwoom, pandas, numpy, matplotlib, requests, python-telegram-bot.
  • 명령어:
    conda create -n kiwoom python=3.7 conda activate kiwoom pip install pykiwoom pandas numpy matplotlib requests python-telegram-bot
  • 결과: 안정적인 자동매매 시스템, 일평균 50건 매매.

3.2.  사례 2

  • 환경:
    • OS: Windows 11 (64bit).
    • 파이썬: 3.8.5 (32bit).
    • 아나콘다: Anaconda3-2021.05.
  • 설치 항목:
    • pykiwoom, pandas, numpy, ta-lib, schedule.
  • 명령어:
  • conda create -n trading python=3.8 conda activate trading pip install pykiwoom pandas numpy schedule conda install -c conda-forge ta-lib
  • 결과: 이동평균 전략으로 일 2~3건 매매.
  •  

5. 추가 팁

  • 32bit 파이썬 필수: 키움 API는 32bit 환경 권장.
  • 모의투자 테스트: 실제 매매 전 필수.
  • 로그 관리: PyCharm 디버거와 로그 파일 활용.
  • 최신 동향 (2025년): 키움 REST API로 64bit 지원 가능성, 하지만 Open API+는 32bit 권장.
LIST