initial commit

This commit is contained in:
2026-02-04 00:16:34 +09:00
commit ae11528dd9
867 changed files with 209640 additions and 0 deletions

View File

@@ -0,0 +1,135 @@
"""
Created on 20250601
"""
import logging
import sys
import pandas as pd
sys.path.extend(['../..', '.'])
import kis_auth as ka
from stock_futures_realtime_quote import stock_futures_realtime_quote
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내선물옵션] 실시간시세 > 주식선물 실시간호가 [실시간-030]
##############################################################################################
COLUMN_MAPPING = {
"futs_shrn_iscd": "선물단축종목코드",
"bsop_hour": "영업시간",
"askp1": "매도호가1",
"askp2": "매도호가2",
"askp3": "매도호가3",
"askp4": "매도호가4",
"askp5": "매도호가5",
"askp6": "매도호가6",
"askp7": "매도호가7",
"askp8": "매도호가8",
"askp9": "매도호가9",
"askp10": "매도호가10",
"bidp1": "매수호가1",
"bidp2": "매수호가2",
"bidp3": "매수호가3",
"bidp4": "매수호가4",
"bidp5": "매수호가5",
"bidp6": "매수호가6",
"bidp7": "매수호가7",
"bidp8": "매수호가8",
"bidp9": "매수호가9",
"bidp10": "매수호가10",
"askp_csnu1": "매도호가건수1",
"askp_csnu2": "매도호가건수2",
"askp_csnu3": "매도호가건수3",
"askp_csnu4": "매도호가건수4",
"askp_csnu5": "매도호가건수5",
"askp_csnu6": "매도호가건수6",
"askp_csnu7": "매도호가건수7",
"askp_csnu8": "매도호가건수8",
"askp_csnu9": "매도호가건수9",
"askp_csnu10": "매도호가건수10",
"bidp_csnu1": "매수호가건수1",
"bidp_csnu2": "매수호가건수2",
"bidp_csnu3": "매수호가건수3",
"bidp_csnu4": "매수호가건수4",
"bidp_csnu5": "매수호가건수5",
"bidp_csnu6": "매수호가건수6",
"bidp_csnu7": "매수호가건수7",
"bidp_csnu8": "매수호가건수8",
"bidp_csnu9": "매수호가건수9",
"bidp_csnu10": "매수호가건수10",
"askp_rsqn1": "매도호가잔량1",
"askp_rsqn2": "매도호가잔량2",
"askp_rsqn3": "매도호가잔량3",
"askp_rsqn4": "매도호가잔량4",
"askp_rsqn5": "매도호가잔량5",
"askp_rsqn6": "매도호가잔량6",
"askp_rsqn7": "매도호가잔량7",
"askp_rsqn8": "매도호가잔량8",
"askp_rsqn9": "매도호가잔량9",
"askp_rsqn10": "매도호가잔량10",
"bidp_rsqn1": "매수호가잔량1",
"bidp_rsqn2": "매수호가잔량2",
"bidp_rsqn3": "매수호가잔량3",
"bidp_rsqn4": "매수호가잔량4",
"bidp_rsqn5": "매수호가잔량5",
"bidp_rsqn6": "매수호가잔량6",
"bidp_rsqn7": "매수호가잔량7",
"bidp_rsqn8": "매수호가잔량8",
"bidp_rsqn9": "매수호가잔량9",
"bidp_rsqn10": "매수호가잔량10",
"total_askp_csnu": "총매도호가건수",
"total_bidp_csnu": "총매수호가건수",
"total_askp_rsqn": "총매도호가잔량",
"total_bidp_rsqn": "총매수호가잔량",
"total_askp_rsqn_icdc": "총매도호가잔량증감",
"total_bidp_rsqn_icdc": "총매수호가잔량증감"
}
NUMERIC_COLUMNS = []
def main():
"""
주식선물 실시간호가
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=stock_futures_realtime_quote, data=["111W08"])
# 결과 표시
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()

View File

@@ -0,0 +1,128 @@
"""
Created on 20250601
"""
import logging
import sys
sys.path.extend(['../..', '.'])
import kis_auth as ka
# 로깅 설정
logging.basicConfig(level=logging.INFO)
##############################################################################################
# [국내선물옵션] 실시간시세 > 주식선물 실시간호가 [실시간-030]
##############################################################################################
def stock_futures_realtime_quote(
tr_type: str,
tr_key: str,
) -> (dict, list[str]):
"""
주식선물 실시간호가 API입니다.
실시간 웹소켓 연결을 통해 주식선물의 실시간 호가 정보를 수신할 수 있습니다.
매도/매수 호가 1~10단계까지의 확장된 호가 정보를 제공하는 특별한 API입니다.
호가별 건수, 호가별 잔량 등의 상세 정보를 포함합니다.
선물옵션 호가 데이터는 0.2초 필터링 옵션이 적용됩니다.
실전계좌만 지원되며 모의투자는 미지원됩니다.
Args:
tr_type (str): [필수] 구독 등록/해제 여부 (ex. "1": 구독, "2": 해제)
tr_key (str): [필수] 종목코드 (ex. 101S12)
Returns:
message (str): 메시지 데이터
Example:
>>> msg, columns = stock_futures_realtime_quote("1", "101S12")
>>> print(msg, columns)
"""
# 필수 파라미터 검증
if tr_type == "":
raise ValueError("tr_type is required")
if tr_key == "":
raise ValueError("tr_key is required")
tr_id = "H0ZFASP0"
params = {
"tr_key": tr_key,
}
msg = ka.data_fetch(tr_id, tr_type, params)
columns = [
"futs_shrn_iscd",
"bsop_hour",
"askp1",
"askp2",
"askp3",
"askp4",
"askp5",
"askp6",
"askp7",
"askp8",
"askp9",
"askp10",
"bidp1",
"bidp2",
"bidp3",
"bidp4",
"bidp5",
"bidp6",
"bidp7",
"bidp8",
"bidp9",
"bidp10",
"askp_csnu1",
"askp_csnu2",
"askp_csnu3",
"askp_csnu4",
"askp_csnu5",
"askp_csnu6",
"askp_csnu7",
"askp_csnu8",
"askp_csnu9",
"askp_csnu10",
"bidp_csnu1",
"bidp_csnu2",
"bidp_csnu3",
"bidp_csnu4",
"bidp_csnu5",
"bidp_csnu6",
"bidp_csnu7",
"bidp_csnu8",
"bidp_csnu9",
"bidp_csnu10",
"askp_rsqn1",
"askp_rsqn2",
"askp_rsqn3",
"askp_rsqn4",
"askp_rsqn5",
"askp_rsqn6",
"askp_rsqn7",
"askp_rsqn8",
"askp_rsqn9",
"askp_rsqn10",
"bidp_rsqn1",
"bidp_rsqn2",
"bidp_rsqn3",
"bidp_rsqn4",
"bidp_rsqn5",
"bidp_rsqn6",
"bidp_rsqn7",
"bidp_rsqn8",
"bidp_rsqn9",
"bidp_rsqn10",
"total_askp_csnu",
"total_bidp_csnu",
"total_askp_rsqn",
"total_bidp_rsqn",
"total_askp_rsqn_icdc",
"total_bidp_rsqn_icdc"
]
return msg, columns