GoogleAIBuilder/KisStock0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

initial commit

Browse Source
This commit is contained in:
tindevil
2026-02-04 00:16:34 +09:00
commit ae11528dd9
867 changed files with 209640 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

54
한국투자증권(API)/examples_user/etfetn/etfetn_examples.py Normal file
View File

@@ -0,0 +1,54 @@
import sys
import logging
import pandas as pd
sys.path.extend(['..', '.'])
import kis_auth as ka
from etfetn_functions import *
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
# 인증
ka.auth()
trenv = ka.getTREnv()
##############################################################################################
# [국내주식] 기본시세 > ETF 구성종목시세[국내주식-073]
##############################################################################################
result1, result2 = inquire_component_stock_price(fid_cond_mrkt_div_code="J", fid_input_iscd="069500", fid_cond_scr_div_code="11216")
print(result1)
print(result2)
##############################################################################################
# [국내주식] 기본시세 > ETF/ETN 현재가[v1_국내주식-068]
##############################################################################################
result = inquire_price(fid_cond_mrkt_div_code="J", fid_input_iscd="005930")
print(result)
##############################################################################################
# [국내주식] 기본시세 > NAV 비교추이(일)[v1_국내주식-071]
##############################################################################################
result = nav_comparison_daily_trend(fid_cond_mrkt_div_code="J", fid_input_iscd="069500", fid_input_date_1="20240101", fid_input_date_2="20240220")
print(result)
##############################################################################################
# [국내주식] 기본시세 > NAV 비교추이(분)[v1_국내주식-070]
##############################################################################################
result = nav_comparison_time_trend(fid_cond_mrkt_div_code="E", fid_input_iscd="069500", fid_hour_cls_code="60")
print(result)
##############################################################################################
# [국내주식] 기본시세 > NAV 비교추이(종목)[v1_국내주식-069]
##############################################################################################
result1, result2 = nav_comparison_trend(fid_cond_mrkt_div_code="J", fid_input_iscd="069500")
print(result1)
print(result2)

34
한국투자증권(API)/examples_user/etfetn/etfetn_examples_ws.py Normal file
View File

@@ -0,0 +1,34 @@
import sys
import logging
import pandas as pd
sys.path.extend(['..', '.'])
import kis_auth as ka
from etfetn_functions_ws import *
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
# 인증
ka.auth()
ka.auth_ws()
trenv = ka.getTREnv()
# 웹소켓 선언
kws = ka.KISWebSocket(api_url="/tryitout")
##############################################################################################
# [국내주식] 실시간시세 > 국내ETF NAV추이[실시간-051]
##############################################################################################
kws.subscribe(request=etf_nav_trend, data=["069500"])
# 시작
def on_result(ws, tr_id, result, data_info):
print(result)
kws.start(on_result=on_result)

317
한국투자증권(API)/examples_user/etfetn/etfetn_functions.py Normal file
View File

@@ -0,0 +1,317 @@
import logging
import time
import sys
from typing import Optional, Tuple
import pandas as pd
sys.path.extend(['..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
##############################################################################################
# [국내주식] 기본시세 > ETF 구성종목시세[국내주식-073]
##############################################################################################
def inquire_component_stock_price(
fid_cond_mrkt_div_code: str,
fid_input_iscd: str,
fid_cond_scr_div_code: str
) -> Tuple[pd.DataFrame, pd.DataFrame]:
"""
ETF 구성종목시세 API입니다.
한국투자 HTS(eFriend Plus) > [0245] ETF/ETN 구성종목시세 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
Args:
fid_cond_mrkt_div_code (str): [필수] 조건시장분류코드 (ex. J: 주식/ETF/ETN)
fid_input_iscd (str): [필수] 입력종목코드 (ex. 123456)
fid_cond_scr_div_code (str): [필수] 조건화면분류코드 (ex. 11216)
Returns:
Tuple[pd.DataFrame, pd.DataFrame]: (output1 데이터프레임, output2 데이터프레임)
Raises:
ValueError: 필수 파라미터가 누락된 경우
Examples:
>>> df1, df2 = inquire_component_stock_price("J", "069500", "11216")
>>> print(df1) # ETF 기본 정보
>>> print(df2) # ETF 구성종목 상세정보
"""
# 필수 파라미터 검증
if fid_cond_mrkt_div_code == "":
raise ValueError("fid_cond_mrkt_div_code is required (e.g. 'J: 주식/ETF/ETN')")
if fid_input_iscd == "":
raise ValueError("fid_input_iscd is required (e.g. '123456')")
if fid_cond_scr_div_code == "":
raise ValueError("fid_cond_scr_div_code is required (e.g. '11216')")
# API 호출 설정
tr_id = "FHKST121600C0"
# 파라미터 설정
api_url = "/uapi/etfetn/v1/quotations/inquire-component-stock-price"
params = {
"FID_COND_MRKT_DIV_CODE": fid_cond_mrkt_div_code,
"FID_INPUT_ISCD": fid_input_iscd,
"FID_COND_SCR_DIV_CODE": fid_cond_scr_div_code
}
# API 호출
res = ka._url_fetch(api_url, tr_id, "", params)
if res.isOK():
# output1 (object) -> DataFrame 변환
output1_data = res.getBody().output1
df1 = pd.DataFrame([output1_data]) if output1_data else pd.DataFrame()
# output2 (array) -> DataFrame 변환
output2_data = res.getBody().output2
df2 = pd.DataFrame(output2_data) if output2_data else pd.DataFrame()
return df1, df2
else:
res.printError(url=api_url)
return pd.DataFrame(), pd.DataFrame()
##############################################################################################
# [국내주식] 기본시세 > ETF/ETN 현재가[v1_국내주식-068]
##############################################################################################
def inquire_price(
fid_cond_mrkt_div_code: str, # 조건 시장 분류 코드
fid_input_iscd: str, # 입력 종목코드
) -> pd.DataFrame:
"""
ETF/ETN 현재가 API입니다.
한국투자 HTS(eFriend Plus) > [0240] ETF/ETN 현재가 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
Args:
fid_cond_mrkt_div_code (str): [필수] 조건 시장 분류 코드 (ex. J:KRX, NX:NXT, UN:통합)
fid_input_iscd (str): [필수] 입력 종목코드 (ex. 123456)
Returns:
pd.DataFrame: ETF/ETN 현재가 데이터
Example:
>>> df = inquire_price("J", "123456")
>>> print(df)
"""
if fid_cond_mrkt_div_code == "":
raise ValueError("fid_cond_mrkt_div_code is required (e.g. 'J:KRX, NX:NXT, UN:통합')")
if fid_input_iscd == "":
raise ValueError("fid_input_iscd is required (e.g. '123456')")
tr_id = "FHPST02400000" # ETF/ETN 현재가
api_url = "/uapi/etfetn/v1/quotations/inquire-price"
params = {
"FID_COND_MRKT_DIV_CODE": fid_cond_mrkt_div_code, # 조건 시장 분류 코드
"FID_INPUT_ISCD": fid_input_iscd, # 입력 종목코드
}
res = ka._url_fetch(api_url, tr_id, "", params)
if res.isOK():
current_data = pd.DataFrame(res.getBody().output, index=[0])
return current_data
else:
res.printError(url=api_url)
return pd.DataFrame()
##############################################################################################
# [국내주식] 기본시세 > NAV 비교추이(일)[v1_국내주식-071]
##############################################################################################
def nav_comparison_daily_trend(
fid_cond_mrkt_div_code: str, # 조건시장분류코드
fid_input_iscd: str, # 입력종목코드
fid_input_date_1: str, # 조회시작일자
fid_input_date_2: str # 조회종료일자
) -> pd.DataFrame:
"""
NAV 비교추이(일) API입니다.
한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면 "일별" 비교추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능합니다.
Args:
fid_cond_mrkt_div_code (str): [필수] 조건시장분류코드 (ex. J:주식)
fid_input_iscd (str): [필수] 입력종목코드 (ex. 123456)
fid_input_date_1 (str): [필수] 조회시작일자 (ex. 20240101)
fid_input_date_2 (str): [필수] 조회종료일자 (ex. 20240220)
Returns:
pd.DataFrame: NAV 비교추이(일) 데이터
Example:
>>> df = nav_comparison_daily_trend("J", "069500", "20240101", "20240220")
>>> print(df)
"""
# 필수 파라미터 검증
if fid_cond_mrkt_div_code == "":
raise ValueError("fid_cond_mrkt_div_code is required (e.g. 'J:주식')")
if fid_input_iscd == "":
raise ValueError("fid_input_iscd is required (e.g. '123456')")
if fid_input_date_1 == "":
raise ValueError("fid_input_date_1 is required (e.g. '20240101')")
if fid_input_date_2 == "":
raise ValueError("fid_input_date_2 is required (e.g. '20240220')")
tr_id = "FHPST02440200" # NAV 비교추이(일)
api_url = "/uapi/etfetn/v1/quotations/nav-comparison-daily-trend"
params = {
"FID_COND_MRKT_DIV_CODE": fid_cond_mrkt_div_code, # 조건시장분류코드
"FID_INPUT_ISCD": fid_input_iscd, # 입력종목코드
"FID_INPUT_DATE_1": fid_input_date_1, # 조회시작일자
"FID_INPUT_DATE_2": fid_input_date_2 # 조회종료일자
}
res = ka._url_fetch(api_url, tr_id, "", params)
if res.isOK():
current_data = pd.DataFrame(res.getBody().output)
logging.info("Data fetch complete.")
return current_data
else:
res.printError(url=api_url)
return pd.DataFrame()
##############################################################################################
# [국내주식] 기본시세 > NAV 비교추이(분)[v1_국내주식-070]
##############################################################################################
def nav_comparison_time_trend(
fid_cond_mrkt_div_code: str, # [필수] 조건시장분류코드 (ex. E)
fid_input_iscd: str, # [필수] 입력종목코드 (ex. 123456)
fid_hour_cls_code: str # [필수] 시간구분코드 (ex. 60:1분,180:3분,...,7200:120분)
) -> pd.DataFrame:
"""
NAV 비교추이(분) API입니다.
한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면 "분별" 비교추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
실전계좌의 경우, 한 번의 호출에 최근 30건까지 확인 가능합니다.
Args:
fid_cond_mrkt_div_code (str): [필수] 조건시장분류코드 (ex. E)
fid_input_iscd (str): [필수] 입력종목코드 (ex. 123456)
fid_hour_cls_code (str): [필수] 시간구분코드 (ex. 60:1분,180:3분,...,7200:120분)
Returns:
pd.DataFrame: NAV 비교추이(분) 데이터
Example:
>>> df = nav_comparison_time_trend("E", "069500", "60")
>>> print(df)
"""
# 필수 파라미터 검증
if fid_cond_mrkt_div_code == "" or fid_cond_mrkt_div_code is None:
raise ValueError("fid_cond_mrkt_div_code is required (e.g. 'E')")
if fid_input_iscd == "" or fid_input_iscd is None:
raise ValueError("fid_input_iscd is required (e.g. '123456')")
if fid_hour_cls_code == "" or fid_hour_cls_code is None:
raise ValueError("fid_hour_cls_code is required (e.g. '60:1분,180:3분,...,7200:120분')")
tr_id = "FHPST02440100"
api_url = "/uapi/etfetn/v1/quotations/nav-comparison-time-trend"
params = {
"FID_COND_MRKT_DIV_CODE": fid_cond_mrkt_div_code,
"FID_INPUT_ISCD": fid_input_iscd,
"FID_HOUR_CLS_CODE": fid_hour_cls_code
}
res = ka._url_fetch(api_url, tr_id, "", params)
if res.isOK():
# output (array) -> pd.DataFrame
current_data = pd.DataFrame(res.getBody().output)
return current_data
else:
res.printError(url=api_url)
return pd.DataFrame()
##############################################################################################
# [국내주식] 기본시세 > NAV 비교추이(종목)[v1_국내주식-069]
##############################################################################################
def nav_comparison_trend(
fid_cond_mrkt_div_code: str, # [필수] 조건 시장 분류 코드 (ex. J)
fid_input_iscd: str, # [필수] 입력 종목코드
) -> Tuple[pd.DataFrame, pd.DataFrame]:
"""
NAV 비교추이(종목) API입니다.
한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
Args:
fid_cond_mrkt_div_code (str): [필수] 조건 시장 분류 코드 (ex. J)
fid_input_iscd (str): [필수] 입력 종목코드
Returns:
Tuple[pd.DataFrame, pd.DataFrame]: output1, output2 데이터프레임
Example:
>>> output1, output2 = nav_comparison_trend("J", "069500")
>>> print(output1)
>>> print(output2)
"""
if fid_cond_mrkt_div_code == "":
raise ValueError("fid_cond_mrkt_div_code is required (e.g. 'J')")
if fid_input_iscd == "":
raise ValueError("fid_input_iscd is required")
tr_id = "FHPST02440000" # NAV 비교추이(종목)
api_url = "/uapi/etfetn/v1/quotations/nav-comparison-trend"
params = {
"FID_COND_MRKT_DIV_CODE": fid_cond_mrkt_div_code, # 조건 시장 분류 코드
"FID_INPUT_ISCD": fid_input_iscd, # 입력 종목코드
}
res = ka._url_fetch(api_url, tr_id, "", params)
if res.isOK():
output1_data = pd.DataFrame(res.getBody().output1, index=[0])
output2_data = pd.DataFrame(res.getBody().output2, index=[0])
logging.info("Data fetch complete.")
return output1_data, output2_data
else:
res.printError(url=api_url)
return pd.DataFrame(), pd.DataFrame()

72
한국투자증권(API)/examples_user/etfetn/etfetn_functions_ws.py Normal file
View File

@@ -0,0 +1,72 @@
import logging
import sys
sys.path.extend(['..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
##############################################################################################
# [국내주식] 실시간시세 > 국내ETF NAV추이[실시간-051]
##############################################################################################
def etf_nav_trend(
tr_type: str,
tr_key: str,
) -> tuple[dict, list[str]]:
"""
국내ETF NAV추이[H0STNAV0] 실시간 데이터 구독 함수
이 함수는 한국투자증권의 웹소켓 API를 통해 실시간으로 국내 ETF의 NAV 추이를 구독합니다.
구독을 시작하거나 해제할 수 있으며, 실시간 데이터를 수신합니다.
Args:
tr_type (str): [필수] 구독 등록("1") 또는 해제("0") 여부를 나타내는 문자열
tr_key (str): [필수] 종목코드 (빈 문자열 불가)
Returns:
message (dict): 수신된 메시지 데이터
columns (list[str]): 수신된 데이터의 컬럼 정보
Raises:
ValueError: tr_key가 빈 문자열인 경우 발생
Example:
>>> msg, columns = etf_nav_trend("1", "005930")
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if not tr_key:
raise ValueError("tr_key is required and cannot be an empty string")
tr_id = "H0STNAV0"
params = {
"tr_key": tr_key,
}
# 데이터 수신
msg = ka.data_fetch(tr_id, tr_type, params)
# 응답 컬럼 정보
columns = [
"rt_cd", # 성공 실패 여부
"msg_cd", # 응답코드
"output1", # 응답상세
"msg1", # 응답메세지
"mksc_shrn_iscd", # 유가증권단축종목코드
"nav", # NAV
"nav_prdy_vrss_sign", # NAV전일대비부호
"nav_prdy_vrss", # NAV전일대비
"nav_prdy_ctrt", # NAV전일대비율
"oprc_nav", # NAV시가
"hprc_nav", # NAV고가
"lprc_nav", # NAV저가
]
return msg, columns