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,116 @@
"""
Created on 20250601
"""
import logging
import sys
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
from commodity_futures_realtime_conclusion import commodity_futures_realtime_conclusion
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내선물옵션] 실시간시세 > 상품선물 실시간체결가[실시간-022]
##############################################################################################
COLUMN_MAPPING = {
"futs_shrn_iscd": "선물 단축 종목코드",
"bsop_hour": "영업 시간",
"futs_prdy_vrss": "선물 전일 대비",
"prdy_vrss_sign": "전일 대비 부호",
"futs_prdy_ctrt": "선물 전일 대비율",
"futs_prpr": "선물 현재가",
"futs_oprc": "선물 시가2",
"futs_hgpr": "선물 최고가",
"futs_lwpr": "선물 최저가",
"last_cnqn": "최종 거래량",
"acml_vol": "누적 거래량",
"acml_tr_pbmn": "누적 거래 대금",
"hts_thpr": "HTS 이론가",
"mrkt_basis": "시장 베이시스",
"dprt": "괴리율",
"nmsc_fctn_stpl_prc": "근월물 약정가",
"fmsc_fctn_stpl_prc": "원월물 약정가",
"spead_prc": "스프레드1",
"hts_otst_stpl_qty": "HTS 미결제 약정 수량",
"otst_stpl_qty_icdc": "미결제 약정 수량 증감",
"oprc_hour": "시가 시간",
"oprc_vrss_prpr_sign": "시가2 대비 현재가 부호",
"oprc_vrss_nmix_prpr": "시가 대비 지수 현재가",
"hgpr_hour": "최고가 시간",
"hgpr_vrss_prpr_sign": "최고가 대비 현재가 부호",
"hgpr_vrss_nmix_prpr": "최고가 대비 지수 현재가",
"lwpr_hour": "최저가 시간",
"lwpr_vrss_prpr_sign": "최저가 대비 현재가 부호",
"lwpr_vrss_nmix_prpr": "최저가 대비 지수 현재가",
"shnu_rate": "매수2 비율",
"cttr": "체결강도",
"esdg": "괴리도",
"otst_stpl_rgbf_qty_icdc": "미결제 약정 직전 수량 증감",
"thpr_basis": "이론 베이시스",
"futs_askp1": "선물 매도호가1",
"futs_bidp1": "선물 매수호가1",
"askp_rsqn1": "매도호가 잔량1",
"bidp_rsqn1": "매수호가 잔량1",
"seln_cntg_csnu": "매도 체결 건수",
"shnu_cntg_csnu": "매수 체결 건수",
"ntby_cntg_csnu": "순매수 체결 건수",
"seln_cntg_smtn": "총 매도 수량",
"shnu_cntg_smtn": "총 매수 수량",
"total_askp_rsqn": "총 매도호가 잔량",
"total_bidp_rsqn": "총 매수호가 잔량",
"prdy_vol_vrss_acml_vol_rate": "전일 거래량 대비 등락율",
"dscs_bltr_acml_qty": "협의 대량 거래량",
"dynm_mxpr": "실시간상한가",
"dynm_llam": "실시간하한가",
"dynm_prc_limt_yn": "실시간가격제한구분"
}
NUMERIC_COLUMNS = []
def main():
"""
상품선물 실시간체결가
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()
ka.auth_ws()
# 인증(auth_ws()) 이후에 선언
kws = ka.KISWebSocket(api_url="/tryitout")
# 조회
kws.subscribe(request=commodity_futures_realtime_conclusion, data=["165W09"])
# 결과 표시
def on_result(ws, tr_id: str, result: pd.DataFrame, data_map: dict):
result = result.rename(columns=COLUMN_MAPPING)
for col in NUMERIC_COLUMNS:
if col in result.columns:
result[col] = pd.to_numeric(result[col], errors='coerce').round(2)
logging.info("결과:")
print(result)
kws.start(on_result=on_result)
if __name__ == "__main__":
main()

View File

@@ -0,0 +1,108 @@
"""
Created on 20250601
"""
import logging
import sys
sys.path.extend(['../..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내선물옵션] 실시간시세 > 상품선물 실시간체결가[실시간-022]
##############################################################################################
def commodity_futures_realtime_conclusion(
tr_type: str,
tr_key: str,
) -> (dict, list[str]):
"""
상품선물 실시간체결가 API입니다.
실시간 웹소켓 연결을 통해 상품선물의 실시간 체결가 정보를 수신할 수 있습니다.
현재가, 시고저가, 체결량, 누적거래량, 이론가, 베이시스, 괴리율 등의 상세 정보를 제공합니다.
매도/매수 호가, 체결 건수, 미결제 약정 수량 등의 선물거래 필수 정보를 포함합니다.
Args:
tr_type (str): [필수] 구독 등록/해제 여부 (ex. "1": 구독, "2": 해제)
tr_key (str): [필수] 종목코드 (ex. 101S12)
Returns:
message (str): 메시지 데이터
Example:
>>> msg, columns = commodity_futures_realtime_conclusion("1", "101S12")
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if tr_type == "":
raise ValueError("tr_type is empty")
if tr_key == "":
raise ValueError("tr_key is required")
tr_id = "H0CFCNT0"
params = {
"tr_key": tr_key,
}
msg = ka.data_fetch(tr_id, tr_type, params)
columns = [
"futs_shrn_iscd",
"bsop_hour",
"futs_prdy_vrss",
"prdy_vrss_sign",
"futs_prdy_ctrt",
"futs_prpr",
"futs_oprc",
"futs_hgpr",
"futs_lwpr",
"last_cnqn",
"acml_vol",
"acml_tr_pbmn",
"hts_thpr",
"mrkt_basis",
"dprt",
"nmsc_fctn_stpl_prc",
"fmsc_fctn_stpl_prc",
"spead_prc",
"hts_otst_stpl_qty",
"otst_stpl_qty_icdc",
"oprc_hour",
"oprc_vrss_prpr_sign",
"oprc_vrss_nmix_prpr",
"hgpr_hour",
"hgpr_vrss_prpr_sign",
"hgpr_vrss_nmix_prpr",
"lwpr_hour",
"lwpr_vrss_prpr_sign",
"lwpr_vrss_nmix_prpr",
"shnu_rate",
"cttr",
"esdg",
"otst_stpl_rgbf_qty_icdc",
"thpr_basis",
"futs_askp1",
"futs_bidp1",
"askp_rsqn1",
"bidp_rsqn1",
"seln_cntg_csnu",
"shnu_cntg_csnu",
"ntby_cntg_csnu",
"seln_cntg_smtn",
"shnu_cntg_smtn",
"total_askp_rsqn",
"total_bidp_rsqn",
"prdy_vol_vrss_acml_vol_rate",
"dscs_bltr_acml_qty",
"dynm_mxpr",
"dynm_llam",
"dynm_prc_limt_yn"
]
return msg, columns