85 lines
2.4 KiB
Python
85 lines
2.4 KiB
Python
"""
|
|
Created on 20250601
|
|
"""
|
|
|
|
import logging
|
|
import sys
|
|
|
|
sys.path.extend(['../..', '.'])
|
|
import kis_auth as ka
|
|
|
|
# 로깅 설정
|
|
logging.basicConfig(level=logging.INFO)
|
|
|
|
##############################################################################################
|
|
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간체결가[실시간-017]
|
|
##############################################################################################
|
|
|
|
def ccnl(
|
|
tr_type: str,
|
|
tr_key: str,
|
|
) -> tuple[dict, list[str]]:
|
|
"""
|
|
※ CME, SGX 실시간시세 유료시세 신청 필수 (KIS포털 > FAQ > 자주 묻는 질문 > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소))
|
|
- CME, SGX 거래소 실시간시세는 유료시세 신청 후 이용하시는 모든 계좌에 대해서 접근토큰발급 API 호출하셔야 하며,
|
|
접근토큰발급 이후 2시간 이내로 신청정보가 동기화되어 유료시세 수신이 가능해집니다.
|
|
- CME, SGX 거래소 종목은 유료시세 신청되어 있지 않으면 실시간시세 종목등록이 불가하며,
|
|
등록 시도 시 "SUBSCRIBE ERROR : mci send failed" 에러가 발생합니다.
|
|
|
|
Args:
|
|
tr_type (str): [필수] 등록/해제
|
|
tr_key (str): [필수] 종목코드
|
|
|
|
Returns:
|
|
message (dict): 메시지 데이터
|
|
columns (list[str]): 컬럼 정보
|
|
|
|
Example:
|
|
>>> msg, columns = ccnl("1", "DNASAAPL")
|
|
>>> print(msg, columns)
|
|
"""
|
|
|
|
# 필수 파라미터 검증
|
|
if tr_type == "":
|
|
raise ValueError("tr_type is required")
|
|
|
|
if tr_key == "":
|
|
raise ValueError("tr_key is required")
|
|
|
|
tr_id = "HDFFF020"
|
|
|
|
params = {
|
|
"tr_key": tr_key,
|
|
}
|
|
|
|
msg = ka.data_fetch(tr_id, tr_type, params)
|
|
|
|
columns = [
|
|
"series_cd",
|
|
"bsns_date",
|
|
"mrkt_open_date",
|
|
"mrkt_open_time",
|
|
"mrkt_close_date",
|
|
"mrkt_close_time",
|
|
"prev_price",
|
|
"recv_date",
|
|
"recv_time",
|
|
"active_flag",
|
|
"last_price",
|
|
"last_qntt",
|
|
"prev_diff_price",
|
|
"prev_diff_rate",
|
|
"open_price",
|
|
"high_price",
|
|
"low_price",
|
|
"vol",
|
|
"prev_sign",
|
|
"quotsign",
|
|
"recv_time2",
|
|
"psttl_price",
|
|
"psttl_sign",
|
|
"psttl_diff_price",
|
|
"psttl_diff_rate"
|
|
]
|
|
|
|
return msg, columns |