initial commit

This commit is contained in:
2026-01-31 22:34:57 +09:00
commit f1301de543
875 changed files with 196598 additions and 0 deletions

View File

@@ -0,0 +1,163 @@
# -*- coding: utf-8 -*-
"""
Created on 2025-07-03
"""
import sys
import logging
import pandas as pd
sys.path.extend(['../..', '.']) # kis_auth 파일 경로 추가
import kis_auth as ka
from inquire_asking_price import inquire_asking_price
# 로깅 설정
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
logger = logging.getLogger(__name__)
##############################################################################################
# [해외주식] 기본시세 > 해외주식 현재가 1호가[해외주식-033]
##############################################################################################
COLUMN_MAPPING = {
'rsym': '실시간조회종목코드',
'zdiv': '소수점자리수',
'curr': '통화',
'base': '전일종가',
'open': '시가',
'high': '고가',
'low': '저가',
'last': '현재가',
'dymd': '호가일자',
'dhms': '호가시간',
'bvol': '매수호가총잔량',
'avol': '매도호가총잔량',
'bdvl': '매수호가총잔량대비',
'advl': '매도호가총잔량대비',
'code': '종목코드',
'ropen': '시가율',
'rhigh': '고가율',
'rlow': '저가율',
'rclose': '현재가율',
'pbid1': '매수호가가격1',
'pask1': '매도호가가격1',
'vbid1': '매수호가잔량1',
'vask1': '매도호가잔량1',
'dbid1': '매수호가대비1',
'dask1': '매도호가대비1',
'vstm': 'VCMStart시간',
'vetm': 'VCMEnd시간',
'csbp': 'CAS/VCM기준가',
'cshi': 'CAS/VCMHighprice',
'cslo': 'CAS/VCMLowprice',
'iep': 'IEP',
'iev': 'IEV'
}
NUMERIC_COLUMNS = ['소수점자리수', '시가율', '고가율', '저가율', '현재가율', '매수호가가격1', '매도호가가격1', '매수호가잔량1',
'매도호가잔량1', '매수호가대비1', '매도호가대비1', 'CAS/VCM기준가', 'CAS/VCMHighprice', 'CAS/VCMLowprice', 'IEP', 'IEV']
def main():
"""
[해외주식] 기본시세
해외주식 현재가 1호가[해외주식-033]
해외주식 현재가 1호가 테스트 함수
Parameters:
- auth (str): 사용자권한정보 (공백)
- excd (str): 거래소코드 (NYS : 뉴욕 NAS : 나스닥 AMS : 아멕스 HKS : 홍콩 SHS : 상해 SZS : 심천 HSX : 호치민 HNX : 하노이 TSE : 도쿄 BAY : 뉴욕(주간) BAQ : 나스닥(주간) BAA : 아멕스(주간))
- symb (str): 종목코드 (종목코드 예)TSLA)
Returns:
- DataFrame: 해외주식 현재가 1호가 결과
Example:
>>> df1, df2, df3 = inquire_asking_price(auth="", excd="NAS", symb="TSLA")
"""
try:
# pandas 출력 옵션 설정
pd.set_option('display.max_columns', None) # 모든 컬럼 표시
pd.set_option('display.width', None) # 출력 너비 제한 해제
pd.set_option('display.max_rows', None) # 모든 행 표시
# 토큰 발급
logger.info("토큰 발급 중...")
ka.auth()
logger.info("토큰 발급 완료")
# API 호출
logger.info("API 호출 시작: 해외주식 현재가 1호가")
result1, result2, result3 = inquire_asking_price(
auth="", # 사용자권한정보
excd="NAS", # 거래소코드
symb="TSLA", # 종목코드
)
# 결과 확인
results = [result1, result2, result3]
if all(result is None or result.empty for result in results):
logger.warning("조회된 데이터가 없습니다.")
return
# output1 처리
if result1 is not None and not result1.empty:
logger.info("=== output1 결과 ===")
logger.info("사용 가능한 컬럼 목록:")
logger.info(result1.columns.tolist())
# output1 결과 처리
logger.info("=== output1 조회 ===")
if not result1.empty:
logger.info("사용 가능한 컬럼: %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)
logger.info("조회된 데이터 건수: %d", len(result1))
print("=== output1 ===")
print(result1)
# output2 결과 처리
logger.info("=== output2 조회 ===")
if result2 is not None and not result2.empty:
logger.info("사용 가능한 컬럼: %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)
logger.info("조회된 데이터 건수: %d", len(result2))
print("=== output2 ===")
print(result2)
# output3 결과 처리
logger.info("=== output3 조회 ===")
if result3 is not None and not result3.empty:
logger.info("사용 가능한 컬럼: %s", result3.columns.tolist())
# 통합 컬럼명 한글 변환
result3 = result3.rename(columns=COLUMN_MAPPING)
for col in NUMERIC_COLUMNS:
if col in result3.columns:
result3[col] = pd.to_numeric(result3[col], errors='coerce').round(2)
logger.info("조회된 데이터 건수: %d", len(result3))
print("=== output3 ===")
print(result3)
except Exception as e:
logger.error("에러 발생: %s", str(e))
raise
if __name__ == "__main__":
main()

View File

@@ -0,0 +1,165 @@
# -*- coding: utf-8 -*-
"""
Created on 2025-07-03
"""
import logging
import time
from typing import Optional, Tuple
import sys
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__)
##############################################################################################
# [해외주식] 기본시세 > 해외주식 현재가 1호가[해외주식-033]
##############################################################################################
# 상수 정의
API_URL = "/uapi/overseas-price/v1/quotations/inquire-asking-price"
def inquire_asking_price(
auth: str, # 사용자권한정보
excd: str, # 거래소코드
symb: str, # 종목코드
dataframe1: Optional[pd.DataFrame] = None, # 누적 데이터프레임 (output1)
dataframe2: Optional[pd.DataFrame] = None, # 누적 데이터프레임 (output2)
dataframe3: Optional[pd.DataFrame] = None, # 누적 데이터프레임 (output3)
tr_cont: str = "",
depth: int = 0,
max_depth: int = 10
) -> Tuple[pd.DataFrame, pd.DataFrame, pd.DataFrame]:
"""
[해외주식] 기본시세
해외주식 현재가 1호가[해외주식-033]
해외주식 현재가 1호가 API를 호출하여 DataFrame으로 반환합니다.
Args:
auth (str): 사용자권한정보
excd (str): 거래소코드 (예: NYS, NAS, AMS, 등)
symb (str): 종목코드 (예: TSLA)
dataframe1 (Optional[pd.DataFrame]): 누적 데이터프레임 (output1)
dataframe2 (Optional[pd.DataFrame]): 누적 데이터프레임 (output2)
dataframe3 (Optional[pd.DataFrame]): 누적 데이터프레임 (output3)
tr_cont (str): 연속 거래 여부
depth (int): 현재 재귀 깊이
max_depth (int): 최대 재귀 깊이 (기본값: 10)
Returns:
Tuple[pd.DataFrame, pd.DataFrame, pd.DataFrame]: 해외주식 현재가 1호가 데이터
Example:
>>> df1, df2, df3 = inquire_asking_price(auth="your_auth_token", excd="NAS", symb="TSLA")
>>> print(df1)
>>> print(df2)
>>> print(df3)
"""
# [필수 파라미터 검증]
if not excd:
logger.error("excd is required. (e.g. 'NAS')")
raise ValueError("excd is required. (e.g. 'NAS')")
if not symb:
logger.error("symb is required. (e.g. 'TSLA')")
raise ValueError("symb is required. (e.g. 'TSLA')")
# 최대 재귀 깊이 체크
if depth >= max_depth:
logger.warning("Maximum recursion depth (%d) reached. Stopping further requests.", max_depth)
return dataframe1 if dataframe1 is not None else pd.DataFrame(), dataframe2 if dataframe2 is not None else pd.DataFrame(), dataframe3 if dataframe3 is not None else pd.DataFrame()
tr_id = "HHDFS76200100"
params = {
"AUTH": auth,
"EXCD": excd,
"SYMB": symb,
}
res = ka._url_fetch(API_URL, tr_id, tr_cont, params)
if res.isOK():
# output1 처리
if hasattr(res.getBody(), 'output1'):
output_data = res.getBody().output1
if output_data:
if isinstance(output_data, list):
current_data1 = pd.DataFrame(output_data)
else:
current_data1 = pd.DataFrame([output_data])
if dataframe1 is not None:
dataframe1 = pd.concat([dataframe1, current_data1], ignore_index=True)
else:
dataframe1 = current_data1
else:
if dataframe1 is None:
dataframe1 = pd.DataFrame()
else:
if dataframe1 is None:
dataframe1 = pd.DataFrame()
# output2 처리
if hasattr(res.getBody(), 'output2'):
output_data = res.getBody().output2
if output_data:
if isinstance(output_data, list):
current_data2 = pd.DataFrame(output_data)
else:
current_data2 = pd.DataFrame([output_data])
if dataframe2 is not None:
dataframe2 = pd.concat([dataframe2, current_data2], ignore_index=True)
else:
dataframe2 = current_data2
else:
if dataframe2 is None:
dataframe2 = pd.DataFrame()
else:
if dataframe2 is None:
dataframe2 = pd.DataFrame()
# output3 처리
if hasattr(res.getBody(), 'output3'):
output_data = res.getBody().output3
if output_data:
if isinstance(output_data, list):
current_data3 = pd.DataFrame(output_data)
else:
current_data3 = pd.DataFrame([output_data])
if dataframe3 is not None:
dataframe3 = pd.concat([dataframe3, current_data3], ignore_index=True)
else:
dataframe3 = current_data3
else:
if dataframe3 is None:
dataframe3 = pd.DataFrame()
else:
if dataframe3 is None:
dataframe3 = pd.DataFrame()
tr_cont = res.getHeader().tr_cont
if tr_cont in ["M", "F"]:
logger.info("Calling next page...")
ka.smart_sleep()
return inquire_asking_price(
auth,
excd,
symb,
"N", dataframe1, dataframe2, dataframe3, depth + 1, max_depth
)
else:
logger.info("Data fetch complete.")
return dataframe1, dataframe2, dataframe3
else:
logger.error("API call failed: %s - %s", res.getErrorCode(), res.getErrorMessage())
res.printError(API_URL)
return pd.DataFrame(), pd.DataFrame(), pd.DataFrame()