99 lines
2.9 KiB
Python
99 lines
2.9 KiB
Python
"""
|
|
Created on 20250601
|
|
"""
|
|
|
|
import logging
|
|
import sys
|
|
|
|
sys.path.extend(['../..', '.'])
|
|
import kis_auth as ka
|
|
|
|
# 로깅 설정
|
|
logging.basicConfig(level=logging.INFO)
|
|
|
|
##############################################################################################
|
|
# [해외선물옵션]실시간시세 > 해외선물옵션 실시간호가[실시간-018]
|
|
##############################################################################################
|
|
|
|
def asking_price(
|
|
tr_type: str,
|
|
tr_key: str,
|
|
) -> tuple[dict, list[str]]:
|
|
"""
|
|
[해외선물옵션]실시간시세 > 해외선물옵션 실시간호가[실시간-018]
|
|
|
|
※ CME, SGX 실시간시세 유료시세 신청 필수 (KIS포털 > FAQ > 자주 묻는 질문 > 해외선물옵션 API 유료시세 신청방법(CME, SGX 거래소))
|
|
- CME, SGX 거래소 실시간시세는 유료시세 신청 후 이용하시는 모든 계좌에 대해서 접근토큰발급 API 호출하셔야 하며,
|
|
접근토큰발급 이후 2시간 이내로 신청정보가 동기화되어 유료시세 수신이 가능해집니다.
|
|
- CME, SGX 거래소 종목은 유료시세 신청되어 있지 않으면 실시간시세 종목등록이 불가하며,
|
|
등록 시도 시 "SUBSCRIBE ERROR : mci send failed" 에러가 발생합니다.
|
|
|
|
(중요) 해외선물옵션시세 출력값을 해석하실 때 ffcode.mst(해외선물종목마스터 파일)에 있는 sCalcDesz(계산 소수점) 값을 활용하셔야 정확한 값을 받아오실 수 있습니다.
|
|
|
|
Args:
|
|
tr_type (str): [필수] 등록/해제
|
|
tr_key (str): [필수] 종목코드
|
|
|
|
Returns:
|
|
message (dict): 메시지 데이터
|
|
columns (list[str]): 컬럼 정보
|
|
|
|
Example:
|
|
>>> msg, columns = asking_price("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 = "HDFFF010"
|
|
|
|
params = {
|
|
"tr_key": tr_key,
|
|
}
|
|
|
|
msg = ka.data_fetch(tr_id, tr_type, params)
|
|
|
|
columns = [
|
|
"series_cd",
|
|
"recv_date",
|
|
"recv_time",
|
|
"prev_price",
|
|
"bid_qntt_1",
|
|
"bid_num_1",
|
|
"bid_price_1",
|
|
"ask_qntt_1",
|
|
"ask_num_1",
|
|
"ask_price_1",
|
|
"bid_qntt_2",
|
|
"bid_num_2",
|
|
"bid_price_2",
|
|
"ask_qntt_2",
|
|
"ask_num_2",
|
|
"ask_price_2",
|
|
"bid_qntt_3",
|
|
"bid_num_3",
|
|
"bid_price_3",
|
|
"ask_qntt_3",
|
|
"ask_num_3",
|
|
"ask_price_3",
|
|
"bid_qntt_4",
|
|
"bid_num_4",
|
|
"bid_price_4",
|
|
"ask_qntt_4",
|
|
"ask_num_4",
|
|
"ask_price_4",
|
|
"bid_qntt_5",
|
|
"bid_num_5",
|
|
"bid_price_5",
|
|
"ask_qntt_5",
|
|
"ask_num_5",
|
|
"ask_price_5",
|
|
"sttl_price"
|
|
]
|
|
|
|
return msg, columns |