initial commit

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

@@ -0,0 +1,87 @@
+"""
+Created on 20250116
+"""
+
+import sys
+import logging
+
+import pandas as pd
+
+sys.path.extend(['../..', '.'])
+import kis_auth as ka
+from order import order
+
+# 로깅 설정
+logging.basicConfig(level=logging.INFO)
+
+##############################################################################################
+# [국내선물옵션] 주문/계좌 > 선물옵션 주문[v1_국내선물-001]
+##############################################################################################
+
+COLUMN_MAPPING = {
+    'KRX_FWDG_ORD_ORGNO': '한국거래소전송주문조직번호',
+    'ODNO': '주문번호',
+    'ORD_TMD': '주문시각'
+}
+
+NUMERIC_COLUMNS = []
+
+
+def main():
+    """
+    선물옵션 주문 테스트 함수
+    
+    이 함수는 선물옵션 주문 API를 호출하여 결과를 출력합니다.
+    
+    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()
+
+    trenv = ka.getTREnv()
+
+    # case1 조회
+    logging.info("=== case1 조회 ===")
+    try:
+        result = order(
+            env_dv="real",
+            ord_dv="day",
+            ord_prcs_dvsn_cd="02",
+            cano=trenv.my_acct,
+            acnt_prdt_cd=trenv.my_prod,
+            sll_buy_dvsn_cd="02",
+            shtn_pdno="101W09",
+            ord_qty="1",
+            unit_price="0",
+            nmpr_type_cd="02",
+            krx_nmpr_cndt_cd="0",
+            ord_dvsn_cd="02"
+        )
+    except ValueError as e:
+        logging.error("에러 발생: %s" % str(e))
+        return
+
+    logging.info("사용 가능한 컬럼: %s", result.columns.tolist())
+
+    # 컬럼명 한글 변환 및 데이터 출력
+    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)
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,149 @@
+"""
+Created on 20250116
+"""
+
+
+import sys
+import logging
+
+import pandas as pd
+
+sys.path.extend(['../..', '.'])
+import kis_auth as ka
+
+# 로깅 설정
+logging.basicConfig(level=logging.INFO)
+
+##############################################################################################
+# [국내선물옵션] 주문/계좌 > 선물옵션 주문[v1_국내선물-001]
+##############################################################################################
+
+# 상수 정의
+API_URL = "/uapi/domestic-futureoption/v1/trading/order"
+
+def order(
+    env_dv: str,  # 실전모의구분
+    ord_dv: str,  # 매도매수구분  
+    ord_prcs_dvsn_cd: str,  # 주문처리구분코드
+    cano: str,  # 종합계좌번호
+    acnt_prdt_cd: str,  # 계좌상품코드
+    sll_buy_dvsn_cd: str,  # 매도매수구분코드
+    shtn_pdno: str,  # 단축상품번호
+    ord_qty: str,  # 주문수량
+    unit_price: str,  # 주문가격1
+    nmpr_type_cd: str,  # 호가유형코드
+    krx_nmpr_cndt_cd: str,  # 한국거래소호가조건코드
+    ord_dvsn_cd: str,  # 주문구분코드
+    ctac_tlno: str = "",  # 연락전화번호
+    fuop_item_dvsn_cd: str = ""  # 선물옵션종목구분코드
+) -> pd.DataFrame:
+    """
+    [국내선물옵션] 주문/계좌 > 선물옵션 주문[v1_국내선물-001]
+    선물옵션 주문 API입니다.
+    * 선물옵션 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
+
+    ※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
+    (EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
+
+    ※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
+    https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
+    
+    Args:
+        env_dv (str): [필수] 실전모의구분 (ex. real:실전, demo:모의)
+        ord_dv (str): [필수] 매도매수구분 (ex. day:주간, night:야간)
+        ord_prcs_dvsn_cd (str): [필수] 주문처리구분코드 (ex. 02:주문전송)
+        cano (str): [필수] 종합계좌번호 (ex. 계좌번호 체계(8-2)의 앞 8자리)
+        acnt_prdt_cd (str): [필수] 계좌상품코드 (ex. 계좌번호 체계(8-2)의 뒤 2자리)
+        sll_buy_dvsn_cd (str): [필수] 매도매수구분코드 (ex. 01:매도, 02:매수)
+        shtn_pdno (str): [필수] 단축상품번호 (ex. 종목번호, 선물 6자리 (예: 101W09), 옵션 9자리 (예: 201S03370))
+        ord_qty (str): [필수] 주문수량
+        unit_price (str): [필수] 주문가격1 (ex. 시장가나 최유리 지정가인 경우 0으로 입력)
+        nmpr_type_cd (str): [필수] 호가유형코드 (ex. 01:지정가, 02:시장가, 03:조건부, 04:최유리)
+        krx_nmpr_cndt_cd (str): [필수] 한국거래소호가조건코드 (ex. 0:없음, 3:IOC, 4:FOK)
+        ord_dvsn_cd (str): [필수] 주문구분코드 (ex. 01:지정가, 02:시장가, 03:조건부, 04:최유리, 10:지정가(IOC), 11:지정가(FOK), 12:시장가(IOC), 13:시장가(FOK), 14:최유리(IOC), 15:최유리(FOK))
+        ctac_tlno (str): 연락전화번호 (ex. 고객의 연락 가능한 전화번호)
+        fuop_item_dvsn_cd (str): 선물옵션종목구분코드 (ex. 공란(Default))
+
+    Returns:
+        pd.DataFrame: 선물옵션 주문 결과 데이터
+        
+    Example:
+        >>> df = order(env_dv="real", ord_dv="day", ord_prcs_dvsn_cd="02", cano=trenv.my_acct, acnt_prdt_cd=trenv.my_prod, sll_buy_dvsn_cd="02", shtn_pdno="101W09", ord_qty="1", unit_price="0", nmpr_type_cd="02", krx_nmpr_cndt_cd="0", ord_dvsn_cd="02")
+        >>> print(df)
+    """
+
+    # 필수 파라미터 검증
+    if env_dv == "":
+        raise ValueError("env_dv is required (e.g. 'real', 'demo')")
+    
+    if ord_dv == "":
+        raise ValueError("ord_dv is required (e.g. 'day', 'night')")
+        
+    if ord_prcs_dvsn_cd == "":
+        raise ValueError("ord_prcs_dvsn_cd is required (e.g. '02')")
+        
+    if cano == "":
+        raise ValueError("cano is required (e.g. '계좌번호 체계(8-2)의 앞 8자리')")
+        
+    if acnt_prdt_cd == "":
+        raise ValueError("acnt_prdt_cd is required (e.g. '계좌번호 체계(8-2)의 뒤 2자리')")
+        
+    if sll_buy_dvsn_cd == "":
+        raise ValueError("sll_buy_dvsn_cd is required (e.g. '01', '02')")
+        
+    if shtn_pdno == "":
+        raise ValueError("shtn_pdno is required (e.g. '101W09', '201S03370')")
+        
+    if ord_qty == "":
+        raise ValueError("ord_qty is required")
+        
+    if unit_price == "":
+        raise ValueError("unit_price is required (e.g. '0')")
+        
+    if nmpr_type_cd == "":
+        raise ValueError("nmpr_type_cd is required (e.g. '01', '02', '03', '04')")
+        
+    if krx_nmpr_cndt_cd == "":
+        raise ValueError("krx_nmpr_cndt_cd is required (e.g. '0', '3', '4')")
+        
+    if ord_dvsn_cd == "":
+        raise ValueError("ord_dvsn_cd is required (e.g. '01', '02', '03', '04', '10', '11', '12', '13', '14', '15')")
+
+    # tr_id 설정
+    if env_dv == "real":
+        if ord_dv == "day":
+            tr_id = "TTTO1101U"
+        elif ord_dv == "night":
+            tr_id = "STTN1101U"
+        else:
+            raise ValueError("ord_dv can only be 'day' or 'night'")
+    elif env_dv == "demo":
+        if ord_dv == "day":
+            tr_id = "VTTO1101U" 
+        else:
+            raise ValueError("ord_dv can only be 'day' for demo environment")
+    else:
+        raise ValueError("env_dv can only be 'real' or 'demo'")
+
+    params = {
+        "ORD_PRCS_DVSN_CD": ord_prcs_dvsn_cd,
+        "CANO": cano,
+        "ACNT_PRDT_CD": acnt_prdt_cd,
+        "SLL_BUY_DVSN_CD": sll_buy_dvsn_cd,
+        "SHTN_PDNO": shtn_pdno,
+        "ORD_QTY": ord_qty,
+        "UNIT_PRICE": unit_price,
+        "NMPR_TYPE_CD": nmpr_type_cd,
+        "KRX_NMPR_CNDT_CD": krx_nmpr_cndt_cd,
+        "ORD_DVSN_CD": ord_dvsn_cd,
+        "CTAC_TLNO": ctac_tlno,
+        "FUOP_ITEM_DVSN_CD": fuop_item_dvsn_cd
+    }
+    
+    res = ka._url_fetch(API_URL, tr_id, "", params, postFlag=True)
+    
+    if res.isOK():
+        return pd.DataFrame(res.getBody().output, index=[0])
+    else:
+        res.printError(url=API_URL)
+        return pd.DataFrame()