파이썬 자동매매 개발, 키움증권 API, 기초 API 익히기

안녕하세요, 투자자 여러분! 오늘은 파이썬을 이용하여 자동매매를 개발하는 방법에 대해 알아보겠습니다. 특히, 한국에서 널리 사용되는 키움증권 API를 활용하여 자동매매 시스템을 구축하는 기초적인 내용을 중점적으로 설명하겠습니다.

1. 자동매매란?

자동매매는 컴퓨터 프로그램을 이용하여 미리 설정된 투자 전략에 따라 자동으로 매매를 수행하는 것을 의미합니다. 이를 통해 인간의 감정을 배제하고, 시장의 변동성에 빠르게 대응할 수 있습니다. 자동매매 시스템을 활용하면 반복적인 매매 작업을 자동화하여 시간과 노력을 절약할 수 있습니다.

2. 키움증권 API 소개

키움증권 API는 키움증권에서 제공하는 증권 거래를 위한 다양한 기능을 사용할 수 있는 인터페이스입니다. 이를 통해 주식의 시세정보, 주문, 체결정보 등을 프로그램적으로 관리할 수 있으며, 기본적인 매매 기능부터 고급 전략까지 다양한 자동매매 알고리즘을 설계할 수 있습니다.

2.1 API 설치 및 환경 설정

API를 사용하기 위해서는 먼저 키움증권의 Open API+를 설치해야 합니다. 아래의 단계로 설치를 진행해 보세요.

키움증권 홈페이지에 접속하여 Open API+를 다운로드합니다.
설치 과정에서 필요한 환경 설정을 진행합니다.
설치 완료 후, 키움증권의 로그인을 통해 API를 사용할 준비가 완료됩니다.

2.2 설치 후 기본 환경 설정

파이썬 환경에서 키움증권 API를 사용하기 위해 필요한 패키지를 설치합니다. 이를 위해 주로 사용하는 패키지는 PyQt5와 pythoncom입니다. 다음 명령어로 설치할 수 있습니다:

pip install PyQt5 pythoncom

3. 키움증권 API 사용하기

그럼 본격적으로 키움증권 API를 사용하여 데이터를 가져오고 주문을 해보겠습니다.

3.1 API 클래스 구현

키움증권 API를 활용하기 위해 클래스를 구현해 보겠습니다. 기본적인 로그인 및 시세 데이터를 가져오는 기능을 포함하도록 하겠습니다.

import sys
import time
import pythoncom
from PyQt5.QtWidgets import QApplication
from PyQt5.QAxContainer import QAxWidget

class KiwoomAPI:
    def __init__(self):
        self.app = QApplication(sys.argv)
        self.api = QAxWidget("KHOPENAPI.KHOpenAPICtrl.1")
        self.api.OnEventConnect.connect(self.connected)
        self.login()

    def connected(self, errCode):
        if errCode == 0:
            print("로그인 성공")
        else:
            print("로그인 실패", errCode)

    def login(self):
        self.api.dynamicCall("CommConnect()")
        self.app.exec_()

    def get_price(self, code):
        self.api.dynamicCall("SetInputValue(QString, QString)", "종목코드", code)
        self.api.dynamicCall("CommRqData(QString, QString, int, QString)", "주식기본정보", "opt10001", 0, "0101")
        time.sleep(1)  # 데이터 수신 대기
        return self.api.dynamicCall("GetCommData(QString, QString, int, QString)", "주식기본정보", "opt10001", 0, "현재가")

api = KiwoomAPI()
price = api.get_price("005930")  # 삼성전자
print("삼성전자 현재가:", price)

위 코드에서는 키움증권 API로 로그인하고, 특정 종목(삼성전자)의 현재가를 가져오는 기본적인 기능을 구현하였습니다. detail level로는 데이터 요청 후 반드시 대기 시간을 두어야 하는 점이 있습니다.

3.2 주식 주문하기

주식을 주문하는 방법도 알아보겠습니다. 다음 코드를 추가하여 매수 주문 기능을 구현해 보겠습니다.

class KiwoomAPI:
    # ... 이전 코드 생략 ...

    def buy_stock(self, code, qty):
        self.api.dynamicCall("SetInputValue(QString, QString)", "종목코드", code)
        self.api.dynamicCall("SetInputValue(QString, QString)", "주문수량", qty)
        self.api.dynamicCall("SetInputValue(QString, QString)", "가격", self.get_price(code))
        self.api.dynamicCall("SetInputValue(QString, QString)", "거래구분", "1") # 1: 매수, 2: 매도
        self.api.dynamicCall("CommRqData(QString, QString, int, QString)", "주식주문", "opt10003", 0, "0101")
        time.sleep(1)
        print("주문 완료")

# 예제 사용
api.buy_stock("005930", 1)  # 삼성전자 1주 매수

4. 자동매매 시스템 구축하기

이제 기본적인 API 사용에 대한 이해를 바탕으로 간단한 자동매매 전략을 작성해보겠습니다. 예를 들어, 특정 조건을 만족할 때 자동으로 매수하는 방식으로 구현할 수 있습니다.

4.1 간단한 이동평균 전략

가장 간단한 자동매매 전략 중 하나는 이동평균선을 이용하는 것입니다. 단기 이동평균선이 장기 이동평균선을 상향 돌파할 때 매수하고, 하향 돌파할 때 매도하는 방식입니다.

import pandas as pd

def get_historical_data(code, count):
    # 과거 데이터 요청
    # 이 부분은 키움 API에서 제공하는 다른 호출을 통해 데이터를 받아와야 함.
    return pd.DataFrame()  # 데이터프레임 형식으로 반환

def trading_strategy():
    historical_data = get_historical_data("005930", 100)
    historical_data['MA5'] = historical_data['종가'].rolling(window=5).mean()
    historical_data['MA20'] = historical_data['종가'].rolling(window=20).mean()

    if historical_data['MA5'].iloc[-2] < historical_data['MA20'].iloc[-2] and historical_data['MA5'].iloc[-1] > historical_data['MA20'].iloc[-1]:
        print("매수 신호 발생")
        api.buy_stock("005930", 1)
    elif historical_data['MA5'].iloc[-2] > historical_data['MA20'].iloc[-2] and historical_data['MA5'].iloc[-1] < historical_data['MA20'].iloc[-1]:
        print("매도 신호 발생")
        # api.sell_stock("005930", 1)  # 매도 로직은 추후 추가 가능

trading_strategy()

5. 주의사항 및 결론

자동매매를 구현할 때는 주의해야 할 점이 많습니다. 우선 다음 사항을 염두에 두시기 바랍니다.

실제 돈을 투자하기 전에 충분한 백테스트를 통해 전략의 유효성을 검증해야 합니다.
API의 호출 한계를 초과하지 않도록 주의하고, 필요 시 예외처리를 구현해야 합니다.
시장에서의 변동성을 고려하여 리스크 관리 방안을 마련해야 합니다.

이번 강좌에서는 파이썬을 이용한 자동매매 시스템 구축의 기초를 다뤄보았습니다. 기초적인 API 사용 예제와 간단한 전략 구현을 통해 기본적인 흐름을 이해할 수 있었기를 바랍니다. 앞으로 더 복잡한 시스템과 전략을 개발해 나가는 데 있어 이 강좌가 도움이 되길 바랍니다.