initial commit

한국투자증권(API)/examples_llm/overseas_stock/delayed_asking_price_asia/chk_delayed_asking_price_asia.py

@@ -0,0 +1,87 @@
+"""
+Created on 20250601
+"""
+
+import logging
+import sys
+
+import pandas as pd
+
+sys.path.extend(['../..', '.'])
+import kis_auth as ka
+from delayed_asking_price_asia import delayed_asking_price_asia
+
+# 로깅 설정
+logging.basicConfig(level=logging.INFO)
+
+##############################################################################################
+# [해외주식] 실시간시세 > 해외주식 지연호가(아시아)[실시간-008]
+##############################################################################################
+
+# 컬럼 매핑 정의
+COLUMN_MAPPING = {
+    "symb": "종목코드",
+    "zdiv": "소숫점자리수",
+    "xymd": "현지일자",
+    "xhms": "현지시간",
+    "kymd": "한국일자",
+    "khms": "한국시간",
+    "bvol": "매수총잔량",
+    "avol": "매도총잔량",
+    "bdvl": "매수총잔량대비",
+    "advl": "매도총잔량대비",
+    "pbid1": "매수호가1",
+    "pask1": "매도호가1",
+    "vbid1": "매수잔량1",
+    "vask1": "매도잔량1",
+    "dbid1": "매수잔량대비1",
+    "dask1": "매도잔량대비1"
+}
+
+# 숫자형 컬럼 정의
+NUMERIC_COLUMNS = ["매수호가1", "매도호가1", "매수잔량1", "매도잔량1"]
+
+def main():
+    """
+    해외주식 지연호가(아시아) 조회 테스트 함수
+    
+    이 함수는 해외주식 지연호가(아시아) API를 호출하여 결과를 출력합니다.
+    테스트 데이터로 DHKS00003을 사용합니다.
+    
+    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=delayed_asking_price_asia, data=["DHKS00003"])
+
+    # 결과 표시
+    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/overseas_stock/delayed_asking_price_asia/delayed_asking_price_asia.py

@@ -0,0 +1,77 @@
+"""
+Created on 20250601
+"""
+
+import logging
+import sys
+
+sys.path.extend(['../..', '.'])
+import kis_auth as ka
+
+# 로깅 설정
+logging.basicConfig(level=logging.INFO)
+
+##############################################################################################
+# [해외주식] 실시간시세 > 해외주식 지연호가(아시아)[실시간-008]
+##############################################################################################
+
+def delayed_asking_price_asia(
+        tr_type: str,
+        tr_key: str,
+) -> tuple[dict, list[str]]:
+    """
+    해외주식 지연호가(아시아)의 경우 아시아 무료시세(지연호가)가 제공됩니다.
+
+    HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시, 
+    "해외주식 실시간호가 HDFSASP0" 을 이용하여 아시아국가 유료시세(실시간호가)를 받아보실 수 있습니다. (24.11.29 반영)
+
+    ※ 지연시세 지연시간 : 홍콩, 베트남, 중국, 일본 - 15분지연
+
+    Args:
+        tr_type (str): [필수] 등록/해제
+        tr_key (str): [필수] 종목코드
+
+    Returns:
+        message (dict): 메시지 데이터
+        columns (list[str]): 컬럼 정보
+
+    Example:
+        >>> msg, columns = delayed_asking_price_asia("1", "DHKS00003")
+        >>> print(msg, columns)
+    """
+
+    # 필수 파라미터 검증
+    if tr_type == "":
+        raise ValueError("tr_type is required")
+
+    if tr_key == "":
+        raise ValueError("tr_key is required")
+
+    tr_id = "HDFSASP1"
+
+    params = {
+        "tr_key": tr_key,
+    }
+
+    msg = ka.data_fetch(tr_id, tr_type, params)
+
+    columns = [
+        "symb",
+        "zdiv",
+        "xymd",
+        "xhms",
+        "kymd",
+        "khms",
+        "bvol",
+        "avol",
+        "bdvl",
+        "advl",
+        "pbid1",
+        "pask1",
+        "vbid1",
+        "vask1",
+        "dbid1",
+        "dask1"
+    ]
+
+    return msg, columns