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

107
한국투자증권(API)/examples_llm/overseas_stock/volume_power/chk_volume_power.py Normal file
View File

@@ -0,0 +1,107 @@
"""
Created on 20250601
"""
import sys
import logging
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
from volume_power import volume_power
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [해외주식] 시세분석 > 해외주식 매수체결강도상위[해외주식-040]
##############################################################################################
# 컬럼 매핑 정의
COLUMN_MAPPING = {
'zdiv': '소수점자리수',
'stat': '거래상태',
'nrec': 'RecordCount',
'rsym': '실시간조회심볼',
'excd': '거래소코드',
'symb': '종목코드',
'knam': '종목명',
'name': '종목명',
'last': '현재가',
'sign': '기호',
'diff': '대비',
'rate': '등락율',
'tvol': '거래량',
'pask': '매도호가',
'pbid': '매수호가',
'tpow': '당일체결강도',
'powx': '체결강도',
'enam': '영문종목명',
'e_ordyn': '매매가능',
'tamt': '거래대금',
'bivl': '매도체결량',
'asvl': '매수체결량',
'strn': '체결강도'
}
# 숫자형 컬럼 정의
NUMERIC_COLUMNS = []
def main():
"""
해외주식 매수체결강도상위 조회 테스트 함수
이 함수는 해외주식 매수체결강도상위 API를 호출하여 결과를 출력합니다.
테스트 데이터로 홍콩거래소(HKS)를 사용합니다.
Returns:
None
"""
# pandas 출력 옵션 설정
pd.set_option('display.max_columns', None) # 모든 컬럼 표시
pd.set_option('display.width', None) # 출력 너비 제한 해제
pd.set_option('display.max_rows', None) # 모든 행 표시
# 인증 토큰 발급
ka.auth()
# API 호출
logging.info("API 호출")
try:
result1, result2 = volume_power(excd="HKS", nday="0", vol_rang="0")
except ValueError as e:
logging.error("에러 발생: %s" % str(e))
return
# output1 처리
logging.info("사용 가능한 컬럼 (output1): %s", result1.columns.tolist())
# 한글 컬럼명으로 변환
result1 = result1.rename(columns=COLUMN_MAPPING)
# 숫자형 컬럼 소수점 둘째자리까지 표시
for col in NUMERIC_COLUMNS:
if col in result1.columns:
result1[col] = pd.to_numeric(result1[col], errors='coerce').round(2)
logging.info("결과(output1):")
print(result1)
# output2 처리
logging.info("사용 가능한 컬럼 (output2): %s", result2.columns.tolist())
# 한글 컬럼명으로 변환
result2 = result2.rename(columns=COLUMN_MAPPING)
# 숫자형 컬럼 소수점 둘째자리까지 표시
for col in NUMERIC_COLUMNS:
if col in result2.columns:
result2[col] = pd.to_numeric(result2[col], errors='coerce').round(2)
logging.info("결과(output2):")
print(result2)
if __name__ == "__main__":
main()

121
한국투자증권(API)/examples_llm/overseas_stock/volume_power/volume_power.py Normal file
View File

@@ -0,0 +1,121 @@
"""
Created on 20250601
"""
import sys
import time
from typing import Optional, Tuple
import logging
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [해외주식] 시세분석 > 해외주식 매수체결강도상위[해외주식-040]
##############################################################################################
# 상수 정의
API_URL = "/uapi/overseas-stock/v1/ranking/volume-power"
def volume_power(
excd: str, # [필수] 거래소명 (ex. NYS:뉴욕, NAS:나스닥, AMS:아멕스, HKS:홍콩, SHS:상해, SZS:심천, HSX:호치민, HNX:하노이, TSE:도쿄)
nday: str, # [필수] N일자값 (ex. 0:당일, 1:2일, 2:3일, 3:5일, 4:10일, 5:20일전, 6:30일, 7:60일, 8:120일, 9:1년)
vol_rang: str, # [필수] 거래량조건 (ex. 0:전체, 1:1백주이상, 2:1천주이상, 3:1만주이상, 4:10만주이상, 5:100만주이상, 6:1000만주이상)
auth: str = "", # 사용자권한정보
keyb: str = "", # NEXT KEY BUFF
tr_cont: str = "", # 연속거래여부
dataframe1: Optional[pd.DataFrame] = None, # output1 누적 데이터프레임
dataframe2: Optional[pd.DataFrame] = None, # output2 누적 데이터프레임
depth: int = 0, # 내부 재귀깊이 (자동관리)
max_depth: int = 10 # 최대 재귀 횟수 제한
) -> Tuple[pd.DataFrame, pd.DataFrame]:
"""
[해외주식] 시세분석 > 해외주식 매수체결강도상위[해외주식-040]
해외주식 매수 체결강도 상위 종목을 조회합니다.
Args:
excd (str): [필수] 거래소명 (ex. NYS:뉴욕, NAS:나스닥, AMS:아멕스, HKS:홍콩, SHS:상해, SZS:심천, HSX:호치민, HNX:하노이, TSE:도쿄)
nday (str): [필수] N일자값 (ex. 0:당일, 1:2일, 2:3일, 3:5일, 4:10일, 5:20일전, 6:30일, 7:60일, 8:120일, 9:1년)
vol_rang (str): [필수] 거래량조건 (ex. 0:전체, 1:1백주이상, 2:1천주이상, 3:1만주이상, 4:10만주이상, 5:100만주이상, 6:1000만주이상)
auth (str): 사용자권한정보
keyb (str): NEXT KEY BUFF
tr_cont (str): 연속거래여부
dataframe1 (Optional[pd.DataFrame]): output1 누적 데이터프레임
dataframe2 (Optional[pd.DataFrame]): output2 누적 데이터프레임
depth (int): 내부 재귀깊이 (자동관리)
max_depth (int): 최대 재귀 횟수 제한
Returns:
Tuple[pd.DataFrame, pd.DataFrame]: (output1 데이터, output2 데이터)
Example:
>>> df1, df2 = volume_power(excd="HKS", nday="0", vol_rang="0")
>>> print(df1)
>>> print(df2)
"""
if excd == "":
raise ValueError("excd is required (e.g. 'HKS')")
if nday == "":
raise ValueError("nday is required (e.g. '0')")
if vol_rang == "":
raise ValueError("vol_rang is required (e.g. '0')")
if depth > max_depth:
logging.warning("Max recursive depth reached.")
if dataframe1 is None:
dataframe1 = pd.DataFrame()
if dataframe2 is None:
dataframe2 = pd.DataFrame()
return dataframe1, dataframe2
tr_id = "HHDFS76280000"
params = {
"EXCD": excd,
"NDAY": nday,
"VOL_RANG": vol_rang,
"AUTH": auth,
"KEYB": keyb
}
res = ka._url_fetch(API_URL, tr_id, tr_cont, params)
if res.isOK():
# output1 처리 (object)
current_data1 = pd.DataFrame([res.getBody().output1])
if dataframe1 is not None:
dataframe1 = pd.concat([dataframe1, current_data1], ignore_index=True)
else:
dataframe1 = current_data1
# output2 처리 (array)
current_data2 = pd.DataFrame(res.getBody().output2)
if dataframe2 is not None:
dataframe2 = pd.concat([dataframe2, current_data2], ignore_index=True)
else:
dataframe2 = current_data2
tr_cont = res.getHeader().tr_cont
if tr_cont in ["M", "F"]: # 다음 페이지 존재
logging.info("Call Next page...")
ka.smart_sleep() # 시스템 안정적 운영을 위한 지연
return volume_power(
excd, nday, vol_rang, auth, keyb, "N", dataframe1, dataframe2, depth + 1, max_depth
)
else:
logging.info("Data fetch complete.")
return dataframe1, dataframe2
else:
res.printError(url=API_URL)
return pd.DataFrame(), pd.DataFrame()