programgarden-core 1.9.4__tar.gz → 1.9.5__tar.gz

{programgarden_core-1.9.4 → programgarden_core-1.9.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: programgarden-core
-Version: 1.9.4
+Version: 1.9.5
 Summary: ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의
 Author: 프로그램동산
 Author-email: coding@programgarden.com

{programgarden_core-1.9.4 → programgarden_core-1.9.5}/programgarden_core/i18n/locales/en.json

@@ -158,7 +158,7 @@
   "nodes.OverseasStockOpenOrdersNode.name": "Stock Open Orders",
   "nodes.OverseasStockRealAccountNode.description": "Streams real-time overseas stock holdings, balance, open orders, and P&L via WebSocket with periodic REST sync. Account data updates automatically as market prices change. Configure sync_interval_sec for REST refresh frequency (10-3600 seconds), commission_rate, and tax_rate for accurate P&L calculation. stay_connected=true keeps the stream running continuously; false fetches once and disconnects. Typical connection: StockBrokerNode → StockRealAccountNode → ThrottleNode → [downstream logic].",
   "nodes.OverseasStockRealAccountNode.name": "Stock Real-Time Account",
-  "nodes.OverseasStockRealMarketDataNode.description": "Streams real-time price, volume, and quote updates for overseas stocks via WebSocket. Every trade tick triggers downstream node execution. Outputs both OHLCV data and full market data (bid/ask, accumulated volume). stay_connected=true keeps the stream running; false gets a single update. Must use ThrottleNode before AI or HTTP nodes to prevent excessive execution. Real-time data is available for live trading only (not paper trading). Typical connection: StockBrokerNode → StockRealMarketDataNode → ThrottleNode → ConditionNode. Supported exchanges: NYSE, NASDAQ, AMEX.",
+  "nodes.OverseasStockRealMarketDataNode.description": "Streams real-time price and volume for overseas stocks via WebSocket using GSC (trade) TR. Order book (GSH) data is NOT included due to LS Securities API limitation — overseas stock real-time quotes do not provide per-level order quantities. Every trade tick triggers downstream node execution. Outputs OHLCV data and full market data (accumulated volume). stay_connected=true keeps the stream running; false gets a single update. Must use ThrottleNode before AI or HTTP nodes to prevent excessive execution. Real-time data is available for live trading only (not paper trading). Typical connection: StockBrokerNode → StockRealMarketDataNode → ThrottleNode → ConditionNode. Supported exchanges: NYSE, NASDAQ, AMEX.",
   "nodes.OverseasStockRealMarketDataNode.name": "Stock Real-Time Data",
   "nodes.OverseasStockRealOrderEventNode.description": "Receives real-time overseas stock order events via WebSocket, including order accepted, filled, modified, cancelled, and rejected notifications (AS0-AS4 protocols). Each event type routes to a dedicated output port for targeted downstream processing. Use event_filter to subscribe to specific event types or 'all'. stay_connected=true keeps listening continuously. Typical connection: StockBrokerNode → StockRealOrderEventNode → TelegramNode (for fill alerts) or → NewOrderNode (for order-driven logic).",
   "nodes.OverseasStockRealOrderEventNode.name": "Stock Order Event",

{programgarden_core-1.9.4 → programgarden_core-1.9.5}/programgarden_core/i18n/locales/ko.json

@@ -158,7 +158,7 @@
   "nodes.OverseasStockOpenOrdersNode.name": "해외주식 미체결 조회",
   "nodes.OverseasStockRealAccountNode.description": "WebSocket으로 해외주식 보유종목, 잔고, 미체결, 손익을 실시간 스트리밍하며 주기적 REST 동기화를 수행합니다. 시세 변동에 따라 계좌 데이터가 자동 갱신됩니다. sync_interval_sec으로 REST 갱신 주기(10-3600초), commission_rate와 tax_rate으로 정확한 손익 계산을 설정합니다. stay_connected=true로 연속 스트리밍; false면 1회 조회 후 연결 해제. 일반적인 연결: StockBrokerNode → StockRealAccountNode → ThrottleNode → [하위 로직].",
   "nodes.OverseasStockRealAccountNode.name": "해외주식 실시간 계좌",
-  "nodes.OverseasStockRealMarketDataNode.description": "WebSocket으로 해외주식 종목의 현재가, 거래량, 호가를 실시간 스트리밍합니다. 매 체결 틱마다 하위 노드가 실행됩니다. 출력: OHLCV 데이터, 전체 시세(매수/매도 호가, 누적 거래량). stay_connected=true로 연속 스트리밍; false면 1회 업데이트. AI/HTTP 노드 연결 전 ThrottleNode 필수. 해외주식 실시간 데이터는 실전투자만 지원(모의투자 불가). 일반적인 연결: StockBrokerNode → StockRealMarketDataNode → ThrottleNode → ConditionNode. 지원 거래소: NYSE, NASDAQ, AMEX.",
+  "nodes.OverseasStockRealMarketDataNode.description": "WebSocket으로 해외주식 종목의 현재가, 거래량을 실시간 스트리밍합니다. GSC(체결) TR을 사용하며, 호가(GSH) 데이터는 포함되지 않습니다(LS증권 API 제약으로 해외주식 실시간 호가는 개별 단계별 잔량 미제공). 매 체결 틱마다 하위 노드가 실행됩니다. 출력: OHLCV 데이터, 전체 시세(누적 거래량). stay_connected=true로 연속 스트리밍; false면 1회 업데이트. AI/HTTP 노드 연결 전 ThrottleNode 필수. 해외주식 실시간 데이터는 실전투자만 지원(모의투자 불가). 일반적인 연결: StockBrokerNode → StockRealMarketDataNode → ThrottleNode → ConditionNode. 지원 거래소: NYSE, NASDAQ, AMEX.",
   "nodes.OverseasStockRealMarketDataNode.name": "해외주식 실시간 시세",
   "nodes.OverseasStockRealOrderEventNode.description": "WebSocket으로 해외주식 주문 이벤트를 실시간 수신합니다. 접수, 체결, 정정, 취소, 거부 알림을 포함합니다(AS0-AS4 프로토콜). 각 이벤트 유형이 전용 출력 포트로 라우팅되어 타겟 하위 처리가 가능합니다. event_filter로 특정 이벤트만 구독하거나 'all'로 전체 수신. stay_connected=true로 연속 수신. 일반적인 연결: StockBrokerNode → StockRealOrderEventNode → TelegramNode (체결 알림) 또는 → NewOrderNode (주문 기반 로직).",
   "nodes.OverseasStockRealOrderEventNode.name": "해외주식 주문 이벤트",

{programgarden_core-1.9.4 → programgarden_core-1.9.5}/programgarden_core/nodes/base.py

@@ -308,8 +308,8 @@ MARKET_DATA_FULL_FIELDS: List[Dict[str, str]] = [
     {"name": "exchange", "type": "string", "description": "거래소 코드"},
     {"name": "symbol", "type": "string", "description": "종목코드"},
     {"name": "current_price", "type": "number", "description": "현재가"},
-    {"name": "bid_price", "type": "number", "description": "매수호가"},
-    {"name": "ask_price", "type": "number", "description": "매도호가"},
+    {"name": "bid_price", "type": "number", "description": "매수호가 (해외주식 실시간에서는 미제공)"},
+    {"name": "ask_price", "type": "number", "description": "매도호가 (해외주식 실시간에서는 미제공)"},
     {"name": "volume", "type": "number", "description": "거래량"},
     {"name": "change_percent", "type": "number", "description": "등락률 (%)"},
     {"name": "timestamp", "type": "string", "description": "시세 시각"},

{programgarden_core-1.9.4 → programgarden_core-1.9.5}/programgarden_core/nodes/realtime_stock.py

@@ -35,7 +35,8 @@ class OverseasStockRealMarketDataNode(BaseNode):
     """
     해외주식 실시간 시세 노드
 
-    WebSocket을 통해 해외주식 실시간 시세(가격, 거래량, 호가)를 수신합니다.
+    WebSocket을 통해 해외주식 실시간 체결 데이터(가격, 거래량)를 수신합니다.
+    GSC(체결) TR을 사용하며, 호가(GSH) 데이터는 포함되지 않습니다.
     거래소: NYSE, NASDAQ, AMEX
     """
 

{programgarden_core-1.9.4 → programgarden_core-1.9.5}/pyproject.toml

@@ -5,7 +5,7 @@ authors = [
 homepage = "https://programgarden.com"
 requires-python = ">=3.12"
 name = "programgarden-core"
-version = "1.9.4"
+version = "1.9.5"
 description = "ProgramGarden Core - 노드 기반 DSL 핵심 타입 정의"
 readme = "README.md"