initial commit
This commit is contained in:
111
한국투자증권(API)/examples_llm/domestic_stock/ccnl_total/ccnl_total.py
Normal file
111
한국투자증권(API)/examples_llm/domestic_stock/ccnl_total/ccnl_total.py
Normal file
@@ -0,0 +1,111 @@
|
||||
"""
|
||||
Created on 2025-07-09
|
||||
"""
|
||||
|
||||
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__)
|
||||
|
||||
##############################################################################################
|
||||
# [국내주식] 실시간시세 > 국내주식 실시간체결가 (통합)
|
||||
##############################################################################################
|
||||
|
||||
|
||||
def ccnl_total(
|
||||
tr_type: str,
|
||||
tr_key: str,
|
||||
) -> tuple[dict, list[str]]:
|
||||
"""
|
||||
국내주식 실시간체결가 (통합)[H0UNCNT0]
|
||||
국내주식 실시간체결가 (통합) API를 통해 실시간 데이터를 구독합니다.
|
||||
|
||||
Args:
|
||||
tr_type (str): [필수] 구독 등록("1") 또는 해제("0") 여부를 나타내는 값
|
||||
tr_key (str): [필수] 종목코드, 실시간 데이터를 구독할 주식의 종목코드
|
||||
|
||||
Returns:
|
||||
message (dict): 실시간 체결가 데이터 메시지
|
||||
columns (list[str]): 데이터의 컬럼 정보 리스트
|
||||
|
||||
Raises:
|
||||
ValueError: tr_key가 빈 문자열인 경우 발생
|
||||
|
||||
Example:
|
||||
>>> msg, columns = ccnl_total("1", "005930")
|
||||
>>> print(msg, columns)
|
||||
|
||||
Note:
|
||||
이 함수는 웹소켓을 통해 실시간 데이터를 구독합니다. 구독을 시작하려면 tr_type을 "1"로 설정하고,
|
||||
구독을 해제하려면 "0"으로 설정하십시오.
|
||||
"""
|
||||
|
||||
# 필수 파라미터 검증
|
||||
if not tr_key:
|
||||
raise ValueError("tr_key is required and cannot be an empty string")
|
||||
|
||||
tr_id = "H0UNCNT0"
|
||||
|
||||
params = {
|
||||
"tr_key": tr_key,
|
||||
}
|
||||
|
||||
# 웹소켓을 통해 실시간 데이터를 가져옵니다.
|
||||
msg = ka.data_fetch(tr_id, tr_type, params)
|
||||
|
||||
# API 메타데이터에 기반한 정확한 컬럼 리스트
|
||||
columns = [
|
||||
"MKSC_SHRN_ISCD",
|
||||
"STCK_CNTG_HOUR",
|
||||
"STCK_PRPR",
|
||||
"PRDY_VRSS_SIGN",
|
||||
"PRDY_VRSS",
|
||||
"PRDY_CTRT",
|
||||
"WGHN_AVRG_STCK_PRC",
|
||||
"STCK_OPRC",
|
||||
"STCK_HGPR",
|
||||
"STCK_LWPR",
|
||||
"ASKP1",
|
||||
"BIDP1",
|
||||
"CNTG_VOL",
|
||||
"ACML_VOL",
|
||||
"ACML_TR_PBMN",
|
||||
"SELN_CNTG_CSNU",
|
||||
"SHNU_CNTG_CSNU",
|
||||
"NTBY_CNTG_CSNU",
|
||||
"CTTR",
|
||||
"SELN_CNTG_SMTN",
|
||||
"SHNU_CNTG_SMTN",
|
||||
"CNTG_CLS_CODE",
|
||||
"SHNU_RATE",
|
||||
"PRDY_VOL_VRSS_ACML_VOL_RATE",
|
||||
"OPRC_HOUR",
|
||||
"OPRC_VRSS_PRPR_SIGN",
|
||||
"OPRC_VRSS_PRPR",
|
||||
"HGPR_HOUR",
|
||||
"HGPR_VRSS_PRPR_SIGN",
|
||||
"HGPR_VRSS_PRPR",
|
||||
"LWPR_HOUR",
|
||||
"LWPR_VRSS_PRPR_SIGN",
|
||||
"LWPR_VRSS_PRPR",
|
||||
"BSOP_DATE",
|
||||
"NEW_MKOP_CLS_CODE",
|
||||
"TRHT_YN",
|
||||
"ASKP_RSQN1",
|
||||
"BIDP_RSQN1",
|
||||
"TOTAL_ASKP_RSQN",
|
||||
"TOTAL_BIDP_RSQN",
|
||||
"VOL_TNRT",
|
||||
"PRDY_SMNS_HOUR_ACML_VOL",
|
||||
"PRDY_SMNS_HOUR_ACML_VOL_RATE",
|
||||
"HOUR_CLS_CODE",
|
||||
"MRKT_TRTM_CLS_CODE",
|
||||
"VI_STND_PRC",
|
||||
]
|
||||
|
||||
return msg, columns
|
||||
@@ -0,0 +1,126 @@
|
||||
"""
|
||||
Created on 2025-07-09
|
||||
"""
|
||||
|
||||
import logging
|
||||
import sys
|
||||
|
||||
import pandas as pd
|
||||
|
||||
sys.path.extend(['../..', '.'])
|
||||
import kis_auth as ka
|
||||
from ccnl_total import ccnl_total
|
||||
|
||||
# 로깅 설정
|
||||
logging.basicConfig(level=logging.INFO, format='%(levelname)s - %(message)s')
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
##############################################################################################
|
||||
# [국내주식] 실시간시세 > 국내주식 실시간체결가 (통합)
|
||||
##############################################################################################
|
||||
|
||||
COLUMN_MAPPING = {
|
||||
"MKSC_SHRN_ISCD": "유가증권 단축 종목코드",
|
||||
"STCK_CNTG_HOUR": "주식 체결 시간",
|
||||
"STCK_PRPR": "주식 현재가",
|
||||
"PRDY_VRSS_SIGN": "전일 대비 부호",
|
||||
"PRDY_VRSS": "전일 대비",
|
||||
"PRDY_CTRT": "전일 대비율",
|
||||
"WGHN_AVRG_STCK_PRC": "가중 평균 주식 가격",
|
||||
"STCK_OPRC": "주식 시가",
|
||||
"STCK_HGPR": "주식 최고가",
|
||||
"STCK_LWPR": "주식 최저가",
|
||||
"ASKP1": "매도호가1",
|
||||
"BIDP1": "매수호가1",
|
||||
"CNTG_VOL": "체결 거래량",
|
||||
"ACML_VOL": "누적 거래량",
|
||||
"ACML_TR_PBMN": "누적 거래 대금",
|
||||
"SELN_CNTG_CSNU": "매도 체결 건수",
|
||||
"SHNU_CNTG_CSNU": "매수 체결 건수",
|
||||
"NTBY_CNTG_CSNU": "순매수 체결 건수",
|
||||
"CTTR": "체결강도",
|
||||
"SELN_CNTG_SMTN": "총 매도 수량",
|
||||
"SHNU_CNTG_SMTN": "총 매수 수량",
|
||||
"CNTG_CLS_CODE": "체결구분",
|
||||
"SHNU_RATE": "매수비율",
|
||||
"PRDY_VOL_VRSS_ACML_VOL_RATE": "전일 거래량 대비 등락율",
|
||||
"OPRC_HOUR": "시가 시간",
|
||||
"OPRC_VRSS_PRPR_SIGN": "시가대비구분",
|
||||
"OPRC_VRSS_PRPR": "시가대비",
|
||||
"HGPR_HOUR": "최고가 시간",
|
||||
"HGPR_VRSS_PRPR_SIGN": "고가대비구분",
|
||||
"HGPR_VRSS_PRPR": "고가대비",
|
||||
"LWPR_HOUR": "최저가 시간",
|
||||
"LWPR_VRSS_PRPR_SIGN": "저가대비구분",
|
||||
"LWPR_VRSS_PRPR": "저가대비",
|
||||
"BSOP_DATE": "영업 일자",
|
||||
"NEW_MKOP_CLS_CODE": "신 장운영 구분 코드",
|
||||
"TRHT_YN": "거래정지 여부",
|
||||
"ASKP_RSQN1": "매도호가 잔량1",
|
||||
"BIDP_RSQN1": "매수호가 잔량1",
|
||||
"TOTAL_ASKP_RSQN": "총 매도호가 잔량",
|
||||
"TOTAL_BIDP_RSQN": "총 매수호가 잔량",
|
||||
"VOL_TNRT": "거래량 회전율",
|
||||
"PRDY_SMNS_HOUR_ACML_VOL": "전일 동시간 누적 거래량",
|
||||
"PRDY_SMNS_HOUR_ACML_VOL_RATE": "전일 동시간 누적 거래량 비율",
|
||||
"HOUR_CLS_CODE": "시간 구분 코드",
|
||||
"MRKT_TRTM_CLS_CODE": "임의종료구분코드",
|
||||
"VI_STND_PRC": "정적VI발동기준가"
|
||||
}
|
||||
|
||||
NUMERIC_COLUMNS = [
|
||||
"주식 현재가", "전일 대비", "전일 대비율", "가중 평균 주식 가격", "주식 시가",
|
||||
"주식 최고가", "주식 최저가", "매도호가1", "매수호가1", "체결 거래량",
|
||||
"누적 거래량", "누적 거래 대금", "매도 체결 건수", "매수 체결 건수",
|
||||
"순매수 체결 건수", "체결강도", "총 매도 수량", "총 매수 수량", "매수비율",
|
||||
"전일 거래량 대비 등락율", "시가대비", "고가대비", "저가대비", "매도호가 잔량1",
|
||||
"매수호가 잔량1", "총 매도호가 잔량", "총 매수호가 잔량", "거래량 회전율",
|
||||
"전일 동시간 누적 거래량", "전일 동시간 누적 거래량 비율", "정적VI발동기준가"
|
||||
]
|
||||
|
||||
|
||||
def main():
|
||||
"""
|
||||
국내주식 실시간체결가 (통합)
|
||||
|
||||
국내주식 실시간체결가 (통합) API입니다.
|
||||
"""
|
||||
|
||||
# pandas 출력 옵션 설정
|
||||
pd.set_option('display.max_columns', None) # 모든 컬럼 표시
|
||||
pd.set_option('display.width', None) # 출력 너비 제한 해제
|
||||
pd.set_option('display.max_rows', None) # 모든 행 표시
|
||||
|
||||
# 인증 토큰 발급
|
||||
ka.auth()
|
||||
ka.auth_ws()
|
||||
|
||||
# 인증(auth_ws()) 이후에 선언
|
||||
kws = ka.KISWebSocket(api_url="/tryitout")
|
||||
|
||||
# 조회
|
||||
kws.subscribe(request=ccnl_total, data=["005930", "000660"])
|
||||
|
||||
# 결과 표시
|
||||
def on_result(ws, tr_id: str, result: pd.DataFrame, data_map: dict):
|
||||
try:
|
||||
# 컬럼명 매핑
|
||||
result.rename(columns=COLUMN_MAPPING, inplace=True)
|
||||
|
||||
# 숫자형 컬럼 변환
|
||||
|
||||
for col in NUMERIC_COLUMNS:
|
||||
if col in result.columns:
|
||||
result[col] = pd.to_numeric(result[col], errors='coerce')
|
||||
|
||||
logging.info("결과:")
|
||||
print(result)
|
||||
except Exception as e:
|
||||
logging.error(f"결과 처리 중 오류: {e}")
|
||||
logging.error(f"받은 데이터: {result}")
|
||||
|
||||
kws.start(on_result=on_result)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user