한국투자증권 파이썬 패키지 pykis로 주가를 가져오는 파이썬 프로그래밍

가장 빠르게 익히는 방법은 직접 해보는 것입니다. 지난 포스팅에서는 한국투자증권 파이썬 API로 내 계좌에 접속했고, 특정 종목의 주가도 가져왔었습니다. 이번 포스팅에서는 파이썬 패키지 pykis로 똑같은 작업을 수행해 보겠습니다. pykis가 사용하기 훨씬 간편하다는 것을 느끼셨다면 이번 포스팅의 목적을 달성한 것입니다. 최종 결과물은 pykis 패키지로 거래소에 접속해서 LG 에너지솔루션의 시계열 데이터(가격)를 가져오는 파이썬 코드입니다.

글의 순서

한국투자증권 파이썬 패키지 pykis
한국투자증권 파이썬 패키지 pykis 설치
API 객체 인증 후 계좌 정보 확인 방법
LG에너지솔루션 주가 가져오기
한국투자증권 API의 토큰 정책 : pykis 사용할 때 알아두어야 할 사항

한국투자증권 파이썬 패키지 pykis

pykis 패키지는 Open API를 활용하여 주식한국투자증권 파이썬 라이브러리입니다. 이를 이용하면 Web API 방식으로 한국투자증권의 다양한 기능을 사용할 수 있습니다. pykis는 개인 투자자용으로 개발되었으며, Python 3.7 이상 버전에서 사용할 수 있습니다.

한국투자증권 파이썬 패키지 pykis 설치

pip를 사용하여 아래와 같이 설치할 수 있습니다.

pip install pykis

1	pip install pykis

pykis가 정상적으로 설치되었는지 확인하려면 아래의 코드를 실행시켜봅니다. pykis가 정상적으로 설치되었다면 pykis의 버전 정보를 확인할 수 있습니다.

import pykis
print(pykis.__version__)

1 2	import pykis print(pykis.__version__)

pykis는 한국투자증권의 비공식 패키지입니다만, 지속적으로 업데이트 되고 있습니다. 따라서, GitHub에서 최신 버전을 설치하는 아래의 방법도 알아두실 것을 추천합니다.

pip install pykis --upgrade

1	pip install pykis --upgrade

만약 특정 버전으로 업그레이드 하고싶다면 다음과 같이 입력합니다.

pip install pykis==버전번호

1	pip install pykis==버전번호

API 객체 인증 후 계좌 정보 확인 방법

실습코드 01에 API 키 설정 후 API 객체를 생성하고 인증하는 방법을 나타내었습니다. 지난 포스팅의 액세스토큰을 발행해서 접속하는 것보다 훨씬 간단하게 접속할 수 있습니다. 또한 거래가능한 현금을 확인하는 방법도 훨씬 간단합니다.

import pykis
import os

# KIS API 설정
api_key = os.getenv('KIS_APP_KEY')
api_secret = os.getenv('KIS_APP_SECRET')
account_number = os.getenv('KIS_ACCOUNT_NUMBER')    # 계좌번호 앞 8자리
product_code = os.getenv('KIS_PRODUCT_CODE', '01')  # 계좌번호 뒤 2자리 기본값 01

print(pykis.__version__)

key_info = {
    "appkey": api_key,
    "appsecret": api_secret
}

account_info = {
    "account_code": account_number,
    "product_code": product_code  
}

api = pykis.Api(key_info=key_info, account_info=account_info)

cash = api.get_kr_buyable_cash()
print(f"거래 가능 현금: {cash} 원")

import pykis

import os

# KIS API 설정

api_key = os.getenv('KIS_APP_KEY')

api_secret = os.getenv('KIS_APP_SECRET')

account_number = os.getenv('KIS_ACCOUNT_NUMBER') # 계좌번호 앞 8자리

product_code = os.getenv('KIS_PRODUCT_CODE', '01') # 계좌번호 뒤 2자리 기본값 01

print(pykis.__version__)

key_info = {

"appkey": api_key,

"appsecret": api_secret

}

account_info = {

"account_code": account_number,

"product_code": product_code

}

api = pykis.Api(key_info=key_info, account_info=account_info)

cash = api.get_kr_buyable_cash()

print(f"거래 가능 현금: {cash} 원")

0.7.0
거래 가능 현금: 300000 원

1 2	0.7.0 거래 가능 현금: 300000 원

LG에너지솔루션 주가 가져오기

LG에너지솔루션 주가와 같이 특정 종목의 현재가나 과거 데이터를 가져올 수 있습니다.

import pykis
import os

# KIS API 설정
api_key = os.getenv('KIS_APP_KEY')
api_secret = os.getenv('KIS_APP_SECRET')
account_number = os.getenv('KIS_ACCOUNT_NUMBER')    # 계좌번호 앞 8자리
product_code = os.getenv('KIS_PRODUCT_CODE', '01')  # 계좌번호 뒤 2자리 기본값 01

print(pykis.__version__)

key_info = {
    "appkey": api_key,
    "appsecret": api_secret
}

account_info = {
    "account_code": account_number,
    "product_code": product_code  
}

api = pykis.Api(key_info=key_info, account_info=account_info)

# 종목 코드 설정 (예: LG에너지솔루션)
stock_code = '373220'

# 현재가 조회
current_price = api.get_kr_current_price(stock_code)    
print(f"{stock_code} 현재가: {current_price} 원")

import pykis

import os

# KIS API 설정

api_key = os.getenv('KIS_APP_KEY')

api_secret = os.getenv('KIS_APP_SECRET')

account_number = os.getenv('KIS_ACCOUNT_NUMBER') # 계좌번호 앞 8자리

product_code = os.getenv('KIS_PRODUCT_CODE', '01') # 계좌번호 뒤 2자리 기본값 01

print(pykis.__version__)

key_info = {

"appkey": api_key,

"appsecret": api_secret

}

account_info = {

"account_code": account_number,

"product_code": product_code

}

api = pykis.Api(key_info=key_info, account_info=account_info)

# 종목 코드 설정 (예: LG에너지솔루션)

stock_code = '373220'

# 현재가 조회

current_price = api.get_kr_current_price(stock_code)

print(f"{stock_code} 현재가: {current_price} 원")

0.7.0
373220 현재가: 391500 원

1 2	0.7.0 373220 현재가: 391500 원

한국투자증권 API의 토큰 정책 : pykis 사용할 때 알아두어야 할 사항

토큰(Token)은 인증 및 권한 부여를 위해 사용되는 임시 디지털 키입니다. 특히 API 서비스에서, 사용자나 애플리케이션이 서버에 접근할 권한이 있는지 확인하는 데 사용됩니다. 토큰은 특정 기간 동안 유효하며, 보통 특정 API 호출이나 자원에 접근할 때 사용됩니다.

위 실습코드에서 API 객체 인증에 사용하는 pykis.Api 함수는 토큰을 1분에 1회만 발급할 수 있습니다. 이 제한은 한국투자증권 Open API 자체의 정책에 따른 것으로, 1분 이내에 두 번 이상 토큰을 발급하려고 하면 오류가 발생합니다.

만약 아래의 오류가 발생했다면, 이 오류는 1분 이내에 토큰을 다시 발행하려 할 때 생기는 오류입니다. 1분 후에 다시 코드를 실행해 보세요.

RuntimeError: http response: 403, return code: None. msg:

마치며 …

가장 빠르게 익히는 방법은 직접 해보는 것입니다. 이번 포스팅에서는 한국투자증권 API를 간편하게 구현할 수 있는 파이썬 패키지인 pykis로 계정에 접속하는 방법과 특정 종목의 주가를 가져오는 방법을 정리하였습니다.

최종 결과물은 한국투자증권 API로 거래소에 접속해서 LG 에너지솔루션의 시계열 데이터(가격)를 가져오는 실습코드02입니다. API 객체 인증, 계좌 확인, 주가 확인에 필요한 함수 사용법을 연습해 보시기 바랍니다. 다음 포스팅에서는 pykis 활용법을 더 정리해 보겠습니다.

함께 참고하면 좋은 글
▶ 한국투자증권 API로 주가를 가져오는 파이썬 프로그래밍
▶ 파이썬 바이낸스 API로 시계열 데이터를 가져오는 파이썬 프로그래밍
▶ 파이썬으로 금융시장 분석하기 : FDR(FinanceDataReader) 패키지 활용법
▶ yfinance로 주식, 암호화폐, 원자재까지: 파이썬으로 금융 데이터 쉽게 분석하기
▶ 한국투자증권 API 신청 방법
▶ 한국투자증권 파이썬 패키지 pykis로 준비하는 알고리즘 투자
▶ RESTful API : 웹 애플리케이션 개발자를 위한 기초부터 실전까지
▶ 파이썬 데이터 분석을 위한 API 이해, REST API, WebSocket API
▶ 업비트 REST API를 이용한 비트코인 가격 추출 파이썬 프로그래밍

참고자료

한국투자증권 API 파이썬 패키지 pykis