initial commit

한국투자증권(API)/examples_llm/domestic_futureoption/stock_futures_realtime_conclusion/chk_stock_futures_realtime_conclusion.py

@@ -0,0 +1,116 @@
+"""
+Created on 20250601
+"""
+
+import logging
+import sys
+
+import pandas as pd
+
+sys.path.extend(['../..', '.'])
+import kis_auth as ka
+
+from stock_futures_realtime_conclusion import stock_futures_realtime_conclusion
+
+# 로깅 설정
+logging.basicConfig(level=logging.INFO)
+
+##############################################################################################
+# [국내선물옵션] 실시간시세 > 주식선물 실시간체결가 [실시간-029]
+##############################################################################################
+
+COLUMN_MAPPING = {
+    "futs_shrn_iscd": "선물단축종목코드",
+    "bsop_hour": "영업시간",
+    "stck_prpr": "주식현재가",
+    "prdy_vrss_sign": "전일대비부호",
+    "prdy_vrss": "전일대비",
+    "futs_prdy_ctrt": "선물전일대비율",
+    "stck_oprc": "주식시가2",
+    "stck_hgpr": "주식최고가",
+    "stck_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_prpr": "시가2대비현재가",
+    "hgpr_hour": "최고가시간",
+    "hgpr_vrss_prpr_sign": "최고가대비현재가부호",
+    "hgpr_vrss_prpr": "최고가대비현재가",
+    "lwpr_hour": "최저가시간",
+    "lwpr_vrss_prpr_sign": "최저가대비현재가부호",
+    "lwpr_vrss_prpr": "최저가대비현재가",
+    "shnu_rate": "매수2비율",
+    "cttr": "체결강도",
+    "esdg": "괴리도",
+    "otst_stpl_rgbf_qty_icdc": "미결제약정직전수량증감",
+    "thpr_basis": "이론베이시스",
+    "askp1": "매도호가1",
+    "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": "전일거래량대비등락율",
+    "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=stock_futures_realtime_conclusion, data=["111W08"])
+
+    # 결과 표시
+    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()

한국투자증권(API)/examples_llm/domestic_futureoption/stock_futures_realtime_conclusion/stock_futures_realtime_conclusion.py

@@ -0,0 +1,108 @@
+"""
+Created on 20250601
+"""
+
+import logging
+import sys
+
+sys.path.extend(['../..', '.'])
+import kis_auth as ka
+
+# 로깅 설정
+logging.basicConfig(level=logging.INFO)
+
+##############################################################################################
+# [국내선물옵션] 실시간시세 > 주식선물 실시간체결가 [실시간-029]
+##############################################################################################
+
+def stock_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 = stock_futures_realtime_conclusion("1", "101S12")
+        >>> print(msg, columns)
+    """
+
+    # 필수 파라미터 검증
+    if tr_type == "":
+        raise ValueError("tr_type is required")
+
+    if tr_key == "":
+        raise ValueError("tr_key is required")
+
+    tr_id = "H0ZFCNT0"
+
+    params = {
+        "tr_key": tr_key,
+    }
+
+    msg = ka.data_fetch(tr_id, tr_type, params)
+
+    columns = [
+        "futs_shrn_iscd",
+        "bsop_hour",
+        "stck_prpr",
+        "prdy_vrss_sign",
+        "prdy_vrss",
+        "futs_prdy_ctrt",
+        "stck_oprc",
+        "stck_hgpr",
+        "stck_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_prpr",
+        "hgpr_hour",
+        "hgpr_vrss_prpr_sign",
+        "hgpr_vrss_prpr",
+        "lwpr_hour",
+        "lwpr_vrss_prpr_sign",
+        "lwpr_vrss_prpr",
+        "shnu_rate",
+        "cttr",
+        "esdg",
+        "otst_stpl_rgbf_qty_icdc",
+        "thpr_basis",
+        "askp1",
+        "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",
+        "dynm_mxpr",
+        "dynm_llam",
+        "dynm_prc_limt_yn"
+    ]
+
+    return msg, columns