149 lines
6.1 KiB
Python
149 lines
6.1 KiB
Python
"""
|
|
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() |