5e44b86f8b
- _feed_fallback 미러 OFF, LS cap/grace/hold RAM을 KIS·키움 spill과 정합 - LS 접근토큰 .ls_token_cache_*.json (재시작 재사용, revoke 루프 없음) - 호가 RAM을 틱과 동일 LIVE_FEED_FALLBACK(snap_time)로 컷, 필터 max_age=0은 유지 - 익절 지정가 로그에 실제 호가 벤더(kis/kiwoom/ls 1·2·3차) 표기 Co-authored-by: Cursor <cursoragent@cursor.com>
628 lines
26 KiB
Python
628 lines
26 KiB
Python
"""
|
|
kis_trader/ws/kis_ws_overseas.py — KIS 해외주식 실시간(지연)체결가 수신기 (HDFSCNT0)
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
역할: 미국 ETF/주식(QQQM·SPYM 등) 영구구독 실시간 체결가를 push 로 받아 캐시/봉집계.
|
|
국내 WS(kis_ws.KISWebSocketPriceCache, H0STCNT0)와 **완전히 분리된 별도 인스턴스**.
|
|
→ 국내 라이브 매매 경로(실거래)에 일절 영향 없음 (회귀 위험 0).
|
|
|
|
왜 분리했나 (구조 결정):
|
|
- 기존 KISWebSocketPriceCache 의 _is_market_hours() 는 국장만 True →
|
|
그 외 시간엔 다음 국장까지 슬립. 미국장은 한국 밤이라 야간 전용 루프 필요.
|
|
- ★ approval_key : WS 세션 = 1:1 (국내·해외 동일 ops:21000).
|
|
→ KR hold / US hold 시간분할로 소켓을 번갈아 점유. 동시 연결 금지.
|
|
→ REST 재발급은 하지 않음 (공유 캐시 6h/24h 정책 유지).
|
|
|
|
KIS 공식 스펙:
|
|
TR_ID : HDFSCNT0 (해외주식 실시간지연체결가)
|
|
tr_key : D + 시세거래소(NAS/NYS/AMS) + 심볼 예) DNASQQQM, DAMSSPYM
|
|
실전 URL : ws://ops.koreainvestment.com:21000
|
|
세션 구독 한도: 최대 41
|
|
|
|
⚠️ 실시간 vs 지연:
|
|
'해외주식 실시간시세' 신청이 안 돼 있으면 HDFSCNT0 는 **15분 지연**으로 옵니다.
|
|
15분봉 전략에선 신청 필수. 미신청 시에도 동작은 하나 데이터가 지연됩니다.
|
|
|
|
KIS 안티-어뷰즈 정책 준수: 재연결 횟수/시간 제한 + 단계 대기 (WS_RECONNECT_DELAY_SECS, 기본 1,3,5,7,10초).
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import datetime as _dt
|
|
import json
|
|
import logging
|
|
import threading
|
|
import time
|
|
from typing import Any, Dict, Optional, Set
|
|
|
|
import requests
|
|
|
|
logger = logging.getLogger("KISWebSocketOverseas")
|
|
|
|
from .ws_reconnect_backoff import ws_reconnect_delay_for_attempt
|
|
|
|
try:
|
|
from kis_trader.utils.env import get_env_from_db, get_env_bool, get_env_int, get_env_float
|
|
except ImportError: # 단독 실행 fallback
|
|
def get_env_from_db(key, default=""): # type: ignore[misc]
|
|
return default
|
|
|
|
def get_env_bool(key, default=False): # type: ignore[misc]
|
|
return default
|
|
|
|
def get_env_int(key, default): # type: ignore[misc]
|
|
return default
|
|
|
|
def get_env_float(key, default): # type: ignore[misc]
|
|
return default
|
|
|
|
|
|
class KISOverseasWebSocket:
|
|
"""
|
|
KIS HDFSCNT0 해외 실시간(지연)체결가 수신기.
|
|
|
|
사용법:
|
|
ws = KISOverseasWebSocket(app_key, app_secret)
|
|
ws.add_symbol("QQQM", "NASD") # 거래소(NASD/NYSE/AMEX) → tr_key 자동 변환
|
|
ws.add_symbol("SPYM", "AMEX")
|
|
ws.start()
|
|
data = ws.get_price("QQQM") # inquire_price 호환 dict (None=미수신/만료)
|
|
ws.stop()
|
|
"""
|
|
|
|
# HDFSCNT0 데이터 필드 인덱스 ('^' 구분, 0-based) — KIS 해외 실시간지연체결가 전문
|
|
IDX_RSYM = 0 # 실시간종목코드 (DNASQQQM)
|
|
IDX_SYMB = 1 # 종목코드 (QQQM)
|
|
IDX_ZDIV = 2 # 소수점자리수
|
|
IDX_KHMS = 7 # 한국시간 (HHMMSS)
|
|
IDX_OPEN = 8 # 시가
|
|
IDX_HIGH = 9 # 고가
|
|
IDX_LOW = 10 # 저가
|
|
IDX_LAST = 11 # 현재가(체결가)
|
|
IDX_SIGN = 12 # 대비구분
|
|
IDX_DIFF = 13 # 전일대비
|
|
IDX_RATE = 14 # 등락율
|
|
IDX_TVOL = 20 # 거래량(누적)
|
|
|
|
MAX_SUBSCRIPTIONS = 41
|
|
MAX_RECONNECT_ATTEMPTS = 10
|
|
MAX_RECONNECTS_PER_HOUR = 6
|
|
# 재연결 sleep — ws_reconnect_backoff (기본 1,3,5,7,10초)
|
|
STABLE_CONN_RESET_SEC = 300.0
|
|
APPROVAL_KEY_CACHE_SEC = 82800
|
|
|
|
# 시세 거래소 코드 매핑 (주문용 → 시세용)
|
|
_EXCD_MAP = {
|
|
"NASD": "NAS", "NAS": "NAS",
|
|
"NYSE": "NYS", "NYS": "NYS",
|
|
"AMEX": "AMS", "AMS": "AMS",
|
|
}
|
|
|
|
def __init__(self, app_key: str, app_secret: str):
|
|
self.app_key = app_key
|
|
self.app_secret = app_secret
|
|
|
|
self._ws_url = get_env_from_db(
|
|
"KIS_WS_URL_REAL", "ws://ops.koreainvestment.com:21000"
|
|
)
|
|
self._base_url = "https://openapi.koreainvestment.com:9443"
|
|
|
|
# 가격 캐시 { code: {"data": dict, "ts": float} }
|
|
self._cache: Dict[str, Dict] = {}
|
|
self._cache_lock = threading.Lock()
|
|
|
|
# 구독 종목 메타 { code: tr_key } (예: QQQM → DNASQQQM)
|
|
self._symbols: Dict[str, str] = {}
|
|
self._sym_lock = threading.Lock()
|
|
# tr_key → code 역매핑 (메시지 파싱용)
|
|
self._key2code: Dict[str, str] = {}
|
|
|
|
self._ws = None
|
|
self._ws_thread: Optional[threading.Thread] = None
|
|
self._running = False
|
|
self._connected = False
|
|
|
|
self._approval_key: Optional[str] = None
|
|
self._approval_key_ts: float = 0.0
|
|
|
|
self._reconnect_count = 0
|
|
self._reconnect_times: list = []
|
|
self._last_connect_time = 0.0
|
|
|
|
self._candle_agg: Optional[Any] = None
|
|
self._tick_recorder: Optional[Any] = None
|
|
# 틱마다 get_env 금지 — 기동/주기 갱신
|
|
self._save_us_ticks_db: bool = bool(get_env_bool("WS_TICK_SAVE_US_ENABLED", True))
|
|
self._save_us_ticks_ts: float = 0.0
|
|
# approval 세션 시간분할 — US hold 이탈 시 능동 close (국내 WS 양보)
|
|
self._session_guard_thread: Optional[threading.Thread] = None
|
|
|
|
try:
|
|
import websocket as _ws_lib
|
|
self._ws_lib = _ws_lib
|
|
self._available = True
|
|
except ImportError:
|
|
self._ws_lib = None
|
|
self._available = False
|
|
logger.warning("⚠️ websocket-client 미설치 → 해외 WS 비활성 (pip install websocket-client)")
|
|
|
|
# ==================================================================
|
|
# Public API
|
|
# ==================================================================
|
|
def attach_candle_aggregator(self, agg: Any) -> None:
|
|
self._candle_agg = agg
|
|
logger.info("✅ 해외 CandleAggregator 연결 완료 (봉 집계 활성화)")
|
|
|
|
def attach_tick_recorder(self, recorder: Any) -> None:
|
|
self._tick_recorder = recorder
|
|
logger.info("✅ 해외 TickRecorder 연결 완료 (HDFSCNT0)")
|
|
|
|
def _make_tr_key(self, exchange: str, symbol: str) -> str:
|
|
ex = str(exchange or "NASD").strip().upper()
|
|
excd = self._EXCD_MAP.get(ex, "NAS")
|
|
sym = str(symbol or "").strip().upper()
|
|
return f"D{excd}{sym}"
|
|
|
|
def add_symbol(self, code: str, exchange: str = "NASD", symbol: Optional[str] = None) -> None:
|
|
"""구독할 해외 종목 등록 (start 전/후 모두 가능)."""
|
|
code = str(code or "").strip().upper()
|
|
if not code:
|
|
return
|
|
sym = str(symbol or code).strip().upper()
|
|
tr_key = self._make_tr_key(exchange, sym)
|
|
with self._sym_lock:
|
|
if code in self._symbols:
|
|
return
|
|
if len(self._symbols) >= self.MAX_SUBSCRIPTIONS:
|
|
logger.warning("⚠️ 해외 WS 구독 한도 초과(%d) → %s 거부", self.MAX_SUBSCRIPTIONS, code)
|
|
return
|
|
self._symbols[code] = tr_key
|
|
self._key2code[tr_key] = code
|
|
if self._connected and self._ws:
|
|
self._send_sub_msg(tr_key, subscribe=True)
|
|
logger.info("📡 해외 WS 구독 추가: %s (tr_key=%s)", code, tr_key)
|
|
|
|
def remove_symbol(self, code: str) -> None:
|
|
code = str(code or "").strip().upper()
|
|
with self._sym_lock:
|
|
tr_key = self._symbols.pop(code, None)
|
|
if tr_key:
|
|
self._key2code.pop(tr_key, None)
|
|
with self._cache_lock:
|
|
self._cache.pop(code, None)
|
|
if tr_key and self._connected and self._ws:
|
|
self._send_sub_msg(tr_key, subscribe=False)
|
|
|
|
def get_price(self, code: str, max_age_sec: Optional[float] = None) -> Optional[Dict]:
|
|
"""
|
|
해외 캐시에서 가격 dict 반환 (inquire_price 호환 키).
|
|
max_age_sec is None 이면 나이 무시(마지막 RAM). 체결 공백 ≠ 가격 삭제.
|
|
"""
|
|
if not self._available or not self._connected:
|
|
return None
|
|
code = str(code or "").strip().upper()
|
|
with self._cache_lock:
|
|
entry = self._cache.get(code)
|
|
if not entry:
|
|
return None
|
|
if max_age_sec is not None and (time.time() - entry.get("ts", 0)) > max_age_sec:
|
|
return None
|
|
return entry.get("data")
|
|
|
|
def get_price_last(self, code: str) -> Optional[Dict]:
|
|
return self.get_price(code, max_age_sec=None)
|
|
|
|
@property
|
|
def is_active(self) -> bool:
|
|
return bool(self._available and self._connected and self._running)
|
|
|
|
def start(self, force_cleanup: bool = True) -> bool:
|
|
if not self._available:
|
|
return False
|
|
if self._running:
|
|
return True
|
|
if force_cleanup:
|
|
# 가격 캐시만 리셋. approval 은 국내와 공유 파일 재사용
|
|
# (재기동마다 REST 재발급하면 국내 H0STCNT0 키가 서버에서 무효화됨)
|
|
with self._cache_lock:
|
|
self._cache.clear()
|
|
if not self._get_approval_key():
|
|
logger.warning("⚠️ 해외 WS approval_key 발급 실패 → 비활성")
|
|
return False
|
|
self._running = True
|
|
self._ws_thread = threading.Thread(
|
|
target=self._run_ws_loop, daemon=True, name="KIS-WS-HDFSCNT0"
|
|
)
|
|
self._ws_thread.start()
|
|
self._session_guard_thread = threading.Thread(
|
|
target=self._session_guard_loop, daemon=True, name="KIS-WS-US-Guard"
|
|
)
|
|
self._session_guard_thread.start()
|
|
logger.info("✅ KIS 해외 WebSocket 수신 스레드 시작 (HDFSCNT0 | url=%s)", self._ws_url)
|
|
return True
|
|
|
|
def _unsubscribe_all_before_close(self, reason: str = "", *, clear_ram: bool = False) -> int:
|
|
"""세션 close 전 HDFSCNT0 구독 해제. 양보 시 RAM 심볼은 유지."""
|
|
if not self._ws:
|
|
if clear_ram:
|
|
with self._sym_lock:
|
|
self._symbols.clear()
|
|
self._key2code.clear()
|
|
return 0
|
|
with self._sym_lock:
|
|
pairs = list(self._symbols.items())
|
|
if clear_ram:
|
|
self._symbols.clear()
|
|
self._key2code.clear()
|
|
if not pairs:
|
|
return 0
|
|
gap = max(0.0, float(get_env_float("KIS_WS_SUBSCRIBE_GAP_MIN_SEC", 0.08)))
|
|
n = 0
|
|
for i, (code, tr_key) in enumerate(pairs):
|
|
if i > 0 and gap > 0:
|
|
time.sleep(gap)
|
|
self._send_sub_msg(tr_key, subscribe=False)
|
|
n += 1
|
|
if gap > 0:
|
|
time.sleep(gap)
|
|
logger.info("✅ 해외 세션 종료 전 구독 해제 %d종목 (%s)", n, reason or "-")
|
|
return n
|
|
|
|
def stop(self) -> None:
|
|
try:
|
|
self._unsubscribe_all_before_close(reason="stop", clear_ram=True)
|
|
except Exception as e:
|
|
logger.warning("해외 WS 종료 전 구독 해제 실패: %s", e)
|
|
self._running = False
|
|
self._connected = False
|
|
if self._ws:
|
|
try:
|
|
self._ws.close()
|
|
except Exception:
|
|
pass
|
|
if self._ws_thread and self._ws_thread.is_alive():
|
|
self._ws_thread.join(timeout=5)
|
|
logger.info("🛑 KIS 해외 WebSocket 종료")
|
|
|
|
# ==================================================================
|
|
# 내부: approval_key / 구독 메시지 / 파싱
|
|
# ==================================================================
|
|
def _get_approval_key(self, *, force_refresh: bool = False) -> Optional[str]:
|
|
"""
|
|
국내 WS 와 동일 KISApprovalManager 파일 캐시 공유.
|
|
해외 단독 REST 재발급은 국내 approval 을 서버에서 무효화 → invalid approval 루프.
|
|
"""
|
|
try:
|
|
from kis_approval_manager import KISApprovalManager
|
|
except ImportError as exc:
|
|
logger.error("kis_approval_manager import 실패: %s", exc)
|
|
return None
|
|
prev = self._approval_key
|
|
mgr = KISApprovalManager.instance(False)
|
|
key = mgr.get_approval_key(
|
|
self.app_key,
|
|
self.app_secret,
|
|
self._base_url,
|
|
force_refresh=force_refresh,
|
|
)
|
|
if key:
|
|
self._approval_key = key
|
|
self._approval_key_ts = mgr.issued_ts or time.time()
|
|
if key != prev:
|
|
logger.info(
|
|
"✅ 해외 WS approval_key 공유캐시 사용 (앞8자: %s…, age=%.0f분)",
|
|
key[:8],
|
|
mgr.age_sec() / 60.0,
|
|
)
|
|
return key
|
|
logger.error("❌ 해외 WS approval_key 확보 실패")
|
|
return None
|
|
|
|
def _build_sub_payload(self, tr_key: str, subscribe: bool) -> str:
|
|
return json.dumps({
|
|
"header": {
|
|
"approval_key": self._approval_key or "",
|
|
"custtype": "P",
|
|
"tr_type": "1" if subscribe else "2",
|
|
"content-type": "utf-8",
|
|
},
|
|
"body": {"input": {"tr_id": "HDFSCNT0", "tr_key": tr_key}},
|
|
})
|
|
|
|
def _send_sub_msg(self, tr_key: str, subscribe: bool = True) -> None:
|
|
if not self._ws:
|
|
return
|
|
try:
|
|
self._ws.send(self._build_sub_payload(tr_key, subscribe))
|
|
except Exception as e:
|
|
logger.debug("해외 구독 메시지 전송 실패(%s): %s", tr_key, e)
|
|
|
|
def _parse_realtime_msg(self, raw: str) -> None:
|
|
"""HDFSCNT0 실시간(지연)체결가 파싱 → 캐시 갱신."""
|
|
if not raw:
|
|
return
|
|
# KIS Application-Level PINGPONG
|
|
if raw.strip() == "PINGPONG":
|
|
if self._ws:
|
|
try:
|
|
self._ws.send("PINGPONG")
|
|
except Exception:
|
|
pass
|
|
return
|
|
# 구독 응답(JSON) — rt_cd 는 INFO (즉시 끊김 원인 추적; DEBUG면 실운영에서 실명)
|
|
if raw.startswith("{"):
|
|
try:
|
|
j = json.loads(raw)
|
|
if j.get("header", {}).get("tr_id") == "HDFSCNT0":
|
|
b = j.get("body", {}) or {}
|
|
rt = str(b.get("rt_cd") or "")
|
|
msg1 = str(b.get("msg1") or b.get("msg_cd") or "")
|
|
if rt and rt != "0":
|
|
logger.warning(
|
|
"⚠️ HDFSCNT0 구독 거부 rt_cd=%s msg=%s", rt, msg1
|
|
)
|
|
else:
|
|
logger.info("HDFSCNT0 구독 응답: rt_cd=%s msg=%s", rt, msg1)
|
|
except Exception:
|
|
pass
|
|
return
|
|
|
|
parts = raw.split("|")
|
|
if len(parts) < 4 or parts[1] != "HDFSCNT0":
|
|
return
|
|
if parts[0] == "1": # 암호화 미지원
|
|
logger.debug("HDFSCNT0 암호화 데이터 수신 (스킵)")
|
|
return
|
|
|
|
fields = parts[3].split("^")
|
|
if len(fields) <= self.IDX_LAST:
|
|
return
|
|
try:
|
|
tr_key = fields[self.IDX_RSYM].strip()
|
|
symb = fields[self.IDX_SYMB].strip().upper()
|
|
code = self._key2code.get(tr_key) or symb
|
|
price = float(fields[self.IDX_LAST])
|
|
if not code or price <= 0:
|
|
return
|
|
|
|
def _g(i, d="0"):
|
|
return fields[i] if len(fields) > i else d
|
|
|
|
data_compat = {
|
|
"stck_prpr": str(price), # 현재가 (해외는 소수점 → 문자열 그대로)
|
|
"prdy_vrss": _g(self.IDX_DIFF),
|
|
"prdy_ctrt": _g(self.IDX_RATE, "0.00"),
|
|
"stck_oprc": _g(self.IDX_OPEN),
|
|
"stck_hgpr": _g(self.IDX_HIGH),
|
|
"stck_lwpr": _g(self.IDX_LOW),
|
|
"last": str(price), # 해외 표기 호환
|
|
}
|
|
with self._cache_lock:
|
|
self._cache[code] = {"data": data_compat, "ts": time.time()}
|
|
|
|
if self._candle_agg is not None or self._tick_recorder is not None:
|
|
khms = _g(self.IDX_KHMS, "").strip()
|
|
try:
|
|
tick_vol = int(float(_g(self.IDX_TVOL, "0")))
|
|
except ValueError:
|
|
tick_vol = 0
|
|
if self._candle_agg is not None:
|
|
# 해외 체결 → ws_candles.market=US. TF는 1분만 (국내 1/3/15/60 전부 X)
|
|
self._candle_agg.on_tick(
|
|
code, price, tick_vol, khms,
|
|
market="US",
|
|
timeframes=[1],
|
|
)
|
|
if self._tick_recorder is not None:
|
|
# 60초마다 플래그만 갱신 (틱 핫패스 get_env 금지)
|
|
now_ts = time.time()
|
|
if now_ts - float(getattr(self, "_save_us_ticks_ts", 0) or 0) >= 60.0:
|
|
self._save_us_ticks_db = bool(
|
|
get_env_bool("WS_TICK_SAVE_US_ENABLED", True)
|
|
)
|
|
self._save_us_ticks_ts = now_ts
|
|
if not getattr(self, "_save_us_ticks_db", False):
|
|
pass
|
|
else:
|
|
try:
|
|
# 국내 기본값(KR)로 덮이지 않게 US 메타 명시 (Optuna·필터용)
|
|
tr_key = ""
|
|
with self._sym_lock:
|
|
tr_key = str(self._symbols.get(code) or "")
|
|
excd = tr_key[1:4] if len(tr_key) >= 4 else "NAS"
|
|
ex_name = {"NAS": "NASD", "NYS": "NYSE", "AMS": "AMEX"}.get(excd, "NASD")
|
|
self._tick_recorder.on_tick(
|
|
code, price, tick_vol, khms,
|
|
market="US",
|
|
exchange=ex_name,
|
|
currency="USD",
|
|
source="kis_us",
|
|
)
|
|
except Exception as ex:
|
|
logger.debug("HDFSCNT0→TickRecorder 실패 %s: %s", code, ex)
|
|
|
|
logger.debug("HDFSCNT0 수신: %s → %s", code, price)
|
|
except (ValueError, IndexError) as e:
|
|
logger.debug("HDFSCNT0 파싱 오류: %s | raw=%s", e, raw[:80])
|
|
|
|
# ==================================================================
|
|
# 미국장 WS hold 게이팅 (국내와 approval 세션 시간분할)
|
|
# ==================================================================
|
|
def _is_us_market_window(self) -> bool:
|
|
"""해외 WS 가 approval 세션을 점유해도 되는 시간 (US hold, 여유 버퍼 env)."""
|
|
from kis_trader.utils.kis_ws_session_windows import in_us_ws_hold_window
|
|
return bool(in_us_ws_hold_window())
|
|
|
|
def _seconds_until_us_open(self) -> float:
|
|
"""다음 해외 hold 시작까지 초."""
|
|
from kis_trader.utils.kis_ws_session_windows import seconds_until_us_ws_open
|
|
return float(seconds_until_us_ws_open())
|
|
|
|
def _force_close_socket(self, reason: str) -> None:
|
|
ws = self._ws
|
|
if ws is None:
|
|
return
|
|
try:
|
|
self._unsubscribe_all_before_close(reason=reason, clear_ram=False)
|
|
except Exception as exc:
|
|
logger.warning("해외 세션 양보 전 구독 해제 실패: %s", exc)
|
|
try:
|
|
logger.info("🔌 [해외WS] 세션 양보 close (%s)", reason)
|
|
ws.close()
|
|
except Exception as exc:
|
|
logger.debug("해외WS force close 예외: %s", exc)
|
|
|
|
def _session_guard_loop(self) -> None:
|
|
"""US hold 이탈·국내 hold 진입 시 해외 소켓 능동 종료."""
|
|
from kis_trader.utils.kis_ws_session_windows import (
|
|
in_kr_ws_hold_window,
|
|
session_guard_interval_sec,
|
|
)
|
|
while self._running:
|
|
try:
|
|
time.sleep(session_guard_interval_sec())
|
|
except Exception:
|
|
time.sleep(15.0)
|
|
if not self._running:
|
|
break
|
|
if not self._connected:
|
|
continue
|
|
if not self._is_us_market_window():
|
|
why = "국내hold" if in_kr_ws_hold_window() else "US hold외"
|
|
self._force_close_socket("%s → approval 세션 비움" % why)
|
|
|
|
# ==================================================================
|
|
# WebSocket 메인 루프
|
|
# ==================================================================
|
|
def _run_ws_loop(self) -> None:
|
|
INSTANT_DROP_SEC = float(get_env_float("KIS_WS_INSTANT_DROP_SEC", 3.0) or 3.0)
|
|
INSTANT_DROP_MAX = int(get_env_int("KIS_WS_INSTANT_DROP_MAX", 3) or 3)
|
|
_instant_streak = 0
|
|
|
|
while self._running:
|
|
now = time.time()
|
|
|
|
if not self._is_us_market_window():
|
|
if self._connected:
|
|
self._force_close_socket("US hold 외 — 루프 대기 전 양보")
|
|
wait_sec = self._seconds_until_us_open()
|
|
logger.info(
|
|
"🌙 미국장 WS hold 외 — 해외 WS 대기 (다음 hold까지 %.0f분, "
|
|
"approval 재발급 없음)",
|
|
wait_sec / 60,
|
|
)
|
|
self._reconnect_count = 0
|
|
self._reconnect_times = []
|
|
_instant_streak = 0
|
|
for _ in range(int(wait_sec // 60)):
|
|
if not self._running:
|
|
return
|
|
time.sleep(60)
|
|
time.sleep(wait_sec % 60)
|
|
continue
|
|
|
|
if _instant_streak >= INSTANT_DROP_MAX:
|
|
# hold 안이면 짧은 쿨다운만 (다음 개장까지 1300분 sleep 금지 — 로그·실대기 일치)
|
|
wait_sec = max(
|
|
30.0,
|
|
float(get_env_float("KIS_WS_INSTANT_DROP_COOLDOWN_SEC", 90.0) or 90.0),
|
|
)
|
|
logger.warning(
|
|
"⚠️ 해외 WS 연속 즉시 끊김 %d회 → %.0f초 쿨다운 "
|
|
"(국내 WS가 세션 점유 중이면 국내 양보 후 재시도)",
|
|
_instant_streak, wait_sec,
|
|
)
|
|
self._reconnect_count = 0
|
|
self._reconnect_times = []
|
|
_instant_streak = 0
|
|
time.sleep(wait_sec)
|
|
continue
|
|
|
|
if (self._last_connect_time > 0
|
|
and (now - self._last_connect_time) > self.STABLE_CONN_RESET_SEC
|
|
and self._reconnect_count > 0):
|
|
self._reconnect_count = 0
|
|
self._reconnect_times = []
|
|
|
|
self._reconnect_times = [t for t in self._reconnect_times if now - t < 3600]
|
|
if len(self._reconnect_times) >= self.MAX_RECONNECTS_PER_HOUR:
|
|
wait = max(10, 3600 - (now - self._reconnect_times[0]) + 10)
|
|
logger.warning("⛔ 해외 WS 1시간 재연결 한도 초과 → %.0f분 대기", wait / 60)
|
|
time.sleep(wait)
|
|
continue
|
|
if self._reconnect_count >= self.MAX_RECONNECT_ATTEMPTS:
|
|
logger.error("❌ 해외 WS 최대 재연결 초과 → 종료")
|
|
self._running = False
|
|
break
|
|
|
|
# 캐시 approval 재사용만 (force_refresh 금지 — 국내 세션 무효화 방지)
|
|
if not self._get_approval_key(force_refresh=False):
|
|
_attempt = max(1, self._reconnect_count)
|
|
time.sleep(ws_reconnect_delay_for_attempt(_attempt))
|
|
continue
|
|
|
|
# 국내가 아직 붙잡고 있으면 짧게 양보 대기 (재발급 없음)
|
|
try:
|
|
from kis_trader.utils.kis_ws_session_windows import in_kr_ws_hold_window
|
|
if in_kr_ws_hold_window():
|
|
logger.info("⏳ 국내 KR hold 중 — 해외 접속 보류")
|
|
time.sleep(30.0)
|
|
continue
|
|
except Exception:
|
|
pass
|
|
|
|
self._reconnect_count += 1
|
|
if self._reconnect_count > 1:
|
|
self._reconnect_times.append(time.time())
|
|
# 끊긴 직후 서버 세션 해제 대기 (국내와 동일 사상)
|
|
sess_wait = max(
|
|
0.0,
|
|
float(get_env_float("KIS_WS_RECONNECT_SESSION_WAIT_SEC", 2.0) or 2.0),
|
|
)
|
|
_attempt = self._reconnect_count - 1
|
|
_delay = ws_reconnect_delay_for_attempt(_attempt)
|
|
time.sleep(max(_delay, sess_wait))
|
|
|
|
_conn_start = time.time()
|
|
try:
|
|
ws_app = self._ws_lib.WebSocketApp(
|
|
self._ws_url,
|
|
on_open = self._on_open,
|
|
on_message = self._on_message,
|
|
on_error = self._on_error,
|
|
on_close = self._on_close,
|
|
)
|
|
self._ws = ws_app
|
|
ws_app.run_forever(ping_interval=20, ping_timeout=10)
|
|
except Exception as e:
|
|
logger.error("해외 WS run_forever 예외: %s", e)
|
|
|
|
if not self._running:
|
|
break
|
|
if (time.time() - _conn_start) < INSTANT_DROP_SEC:
|
|
_instant_streak += 1
|
|
else:
|
|
_instant_streak = 0
|
|
|
|
logger.info("KIS 해외 WebSocket 루프 종료")
|
|
|
|
def _on_open(self, ws) -> None:
|
|
self._connected = True
|
|
self._last_connect_time = time.time()
|
|
logger.info("✅ KIS 해외 WebSocket 연결 성공 (HDFSCNT0)")
|
|
with self._sym_lock:
|
|
keys = list(self._symbols.values())
|
|
for tr_key in keys:
|
|
self._send_sub_msg(tr_key, subscribe=True)
|
|
if keys:
|
|
logger.info("📡 해외 WS 구독 일괄 등록: %s", ", ".join(keys))
|
|
|
|
def _on_message(self, ws, message: str) -> None:
|
|
self._parse_realtime_msg(message)
|
|
|
|
def _on_error(self, ws, error) -> None:
|
|
self._connected = False
|
|
logger.warning("⚠️ KIS 해외 WebSocket 오류: %s", error)
|
|
|
|
def _on_close(self, ws, close_status_code, close_msg) -> None:
|
|
self._connected = False
|
|
logger.info("🔌 KIS 해외 WebSocket 종료 (code=%s msg=%s)", close_status_code, close_msg or "")
|