""" 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, format='%(levelname)s - %(message)s') logger = logging.getLogger(__name__) ############################################################################################## # [해외주식] 기본시세 > 해외주식 업종별코드조회[해외주식-049] ############################################################################################## # 상수 정의 API_URL = "/uapi/overseas-price/v1/quotations/industry-price" def industry_price( excd: str, # [필수] 거래소명 auth: str = "", # 사용자권한정보 tr_cont: str = "", # 연속거래여부 dataframe1: Optional[pd.DataFrame] = None, # 누적 데이터프레임1 dataframe2: Optional[pd.DataFrame] = None, # 누적 데이터프레임2 depth: int = 0, # 내부 재귀깊이 (자동관리) max_depth: int = 10 # 최대 재귀 횟수 제한 ) -> Tuple[pd.DataFrame, pd.DataFrame]: """ 해외주식 업종별코드조회 API입니다. Args: excd (str): [필수] 거래소명 (ex. NYS:뉴욕, NAS:나스닥, AMS:아멕스, HKS:홍콩, SHS:상해, SZS:심천, HSX:호치민, HNX:하노이, TSE:도쿄) auth (str): 사용자권한정보 tr_cont (str): 연속거래여부 dataframe1 (Optional[pd.DataFrame]): 누적 데이터프레임1 dataframe2 (Optional[pd.DataFrame]): 누적 데이터프레임2 depth (int): 내부 재귀깊이 (자동관리) max_depth (int): 최대 재귀 횟수 제한 Returns: Tuple[pd.DataFrame, pd.DataFrame]: (output1, output2) 데이터 Example: >>> df1, df2 = industry_price(excd="NAS") >>> print(df1, df2) """ if excd == "": raise ValueError("excd is required (e.g. 'NYS', 'NAS', 'AMS', 'HKS', 'SHS', 'SZS', 'HSX', 'HNX', 'TSE')") 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 = "HHDFS76370100" params = { "EXCD": excd, "AUTH": auth } 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 industry_price( excd, auth, "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()