programgarden-core 1.2.0__tar.gz → 1.4.0__tar.gz

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/PKG-INFO

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

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/i18n/locales/en.json

@@ -36,6 +36,8 @@
   "nodes.AIAgentNode.name": "AI Agent",
   "nodes.AggregateNode.description": "Collect individual items into a list. Use with SplitNode.",
   "nodes.AggregateNode.name": "Aggregate",
+  "nodes.IfNode.description": "Branch execution flow based on a condition (if/else)",
+  "nodes.IfNode.name": "If Branch",
   "nodes.AlertNode.description": "Send notifications (email, SMS, webhook).",
   "nodes.AlertNode.name": "Alert",
   "nodes.BacktestEngineNode.description": "Run backtest with signals and historical data, calculate performance metrics.",
@@ -110,6 +112,8 @@
   "nodes.OverseasStockCancelOrderNode.name": "Stock Cancel Order",
   "nodes.OverseasStockHistoricalDataNode.description": "Get historical OHLCV data for overseas stocks. (NYSE, NASDAQ, AMEX)",
   "nodes.OverseasStockHistoricalDataNode.name": "Stock Historical Data",
+  "nodes.OverseasStockFundamentalNode.description": "Get fundamental data including PER, EPS, market cap, and 52-week high/low for overseas stocks. (NYSE, NASDAQ, AMEX)",
+  "nodes.OverseasStockFundamentalNode.name": "Stock Fundamentals",
   "nodes.OverseasStockMarketDataNode.description": "Get current price and volume for overseas stocks. (NYSE, NASDAQ, AMEX)",
   "nodes.OverseasStockMarketDataNode.name": "Stock Market Data",
   "nodes.OverseasStockModifyOrderNode.description": "Modify the price or quantity of pending US stock orders.",
@@ -182,6 +186,9 @@
   "fields.AggregateNode.mode": "Select aggregation mode",
   "fields.AggregateNode.value_field": "Field name for calculation (for sum/avg/min/max modes)",
   "fields.AggregateNode.value_field_helper": "Specify a field containing numeric values",
+  "fields.IfNode.left": "Left value (comparison target)",
+  "fields.IfNode.operator": "Comparison operator",
+  "fields.IfNode.right": "Right value (comparison reference)",
   "fields.AlertNode.credential_id": "Alert service credential",
   "fields.AlertNode.message_template": "Message template (variables supported)",
   "fields.BacktestEngineNode.allow_fractional": "Allow fractional shares",
@@ -337,6 +344,10 @@
   "fields.OverseasStockHistoricalDataNode.symbol.exchange": "Exchange",
   "fields.OverseasStockHistoricalDataNode.symbol.help_text": "Direct input or binding available (fx toggle)",
   "fields.OverseasStockHistoricalDataNode.symbol.symbol": "Symbol",
+  "fields.OverseasStockFundamentalNode.symbol": "Enter the symbol code for fundamental data lookup",
+  "fields.OverseasStockFundamentalNode.symbol.exchange": "Exchange",
+  "fields.OverseasStockFundamentalNode.symbol.help_text": "Direct input or binding available (fx toggle)",
+  "fields.OverseasStockFundamentalNode.symbol.symbol": "Symbol",
   "fields.OverseasStockMarketDataNode.symbol": "Enter the symbol code for current price lookup",
   "fields.OverseasStockMarketDataNode.symbol.exchange": "Exchange",
   "fields.OverseasStockMarketDataNode.symbol.help_text": "Direct input or binding available (fx toggle)",
@@ -437,6 +448,9 @@
   "fieldNames.AggregateNode.filter_field": "Filter Field",
   "fieldNames.AggregateNode.mode": "Mode",
   "fieldNames.AggregateNode.value_field": "Value Field",
+  "fieldNames.IfNode.left": "Left Value",
+  "fieldNames.IfNode.operator": "Operator",
+  "fieldNames.IfNode.right": "Right Value",
   "fieldNames.BacktestEngineNode.allow_fractional": "Allow Fractional",
   "fieldNames.BacktestEngineNode.allow_short": "Allow Short",
   "fieldNames.BacktestEngineNode.atr_period": "ATR Period",
@@ -559,6 +573,7 @@
   "fieldNames.OverseasStockHistoricalDataNode.interval": "Interval",
   "fieldNames.OverseasStockHistoricalDataNode.start_date": "Start Date",
   "fieldNames.OverseasStockHistoricalDataNode.symbol": "Symbol",
+  "fieldNames.OverseasStockFundamentalNode.symbol": "Symbol",
   "fieldNames.OverseasStockMarketDataNode.symbol": "Symbol",
   "fieldNames.OverseasStockModifyOrderNode.exchange": "Exchange",
   "fieldNames.OverseasStockModifyOrderNode.new_price": "New Price",
@@ -666,6 +681,9 @@
   "ports.aggregate_count": "Item count",
   "ports.aggregate_item": "Item to collect",
   "ports.aggregate_value": "Calculated result (sum/avg/min/max)",
+  "ports.if_true": "Output when condition is true",
+  "ports.if_false": "Output when condition is false",
+  "ports.if_result": "Condition evaluation result (boolean)",
   "ports.allocated_capital": "Allocated capital",
   "ports.allocation_weights": "Allocation weights",
   "ports.approved_symbols": "Approved symbols",
@@ -693,12 +711,15 @@
   "ports.current_value": "Current value",
   "ports.data": "Data",
   "ports.data_to_save": "Data to save",
+  "ports.deposit": "Deposit",
   "ports.drawdown_curve": "Drawdown curve",
   "ports.equity_curve": "Equity curve",
+  "ports.exchange_rate": "Exchange rate",
   "ports.error_data": "Error data",
   "ports.event": "Event data",
   "ports.failed": "Failed",
   "ports.failed_symbols": "Failed symbols",
+  "ports.foreign_cash": "Foreign currency cash (USD)",
   "ports.filled": "Order filled",
   "ports.halted": "Halted signal",
   "ports.held_symbols": "Held symbols",
@@ -715,10 +736,14 @@
   "ports.liquidated_positions": "Liquidated positions",
   "ports.liquidation_result": "Liquidation result",
   "ports.loaded_data": "Loaded data",
+  "ports.maintenance_margin": "Maintenance margin",
   "ports.mapped_data": "Transformed data",
   "ports.mapped_fields": "Mapped field names list",
+  "ports.margin": "Initial margin",
+  "ports.margin_call_rate": "Margin call rate (%)",
   "ports.market_data": "Market data",
   "ports.market_data_full": "Full market data",
+  "ports.fundamental_data_value": "Fundamental data (PER, EPS, market cap, etc.)",
   "ports.market_data_value": "Market data value",
   "ports.market_data_values": "Market data (price/volume per symbol)",
   "ports.metrics": "Performance metrics",
@@ -733,6 +758,7 @@
   "ports.ohlcv_value": "OHLCV value",
   "ports.open": "Exchange open",
   "ports.open_orders": "Open orders",
+  "ports.orderable_amount": "Orderable amount",
   "ports.order": "Order data",
   "ports.order_id": "Order ID",
   "ports.order_ids": "Order IDs per symbol",
@@ -763,6 +789,7 @@
   "ports.resume_at": "Resume time",
   "ports.saved_data": "Saved data",
   "ports.sell_signal": "Sell signal",
+  "ports.settlement_pnl": "Settlement P&L",
   "ports.signals": "Signal data",
   "ports.split_array": "Array to split",
   "ports.split_index": "Current index (0-based)",
@@ -785,6 +812,8 @@
   "ports.target_orders": "Target orders",
   "ports.throttle_stats": "Throttle stats (skip count, countdown, etc.)",
   "ports.tick_data": "Tick data",
+  "ports.total_eval": "Total evaluation amount",
+  "ports.total_orderable": "Total orderable amount",
   "ports.total_pnl": "Total P&L",
   "ports.trades": "Trades",
   "ports.trigger": "Trigger signal",
@@ -800,6 +829,18 @@
   "enums.aggregate_mode.max": "Maximum",
   "enums.aggregate_mode.min": "Minimum",
   "enums.aggregate_mode.sum": "Sum",
+  "enums.if_operator.eq": "Equals (==)",
+  "enums.if_operator.ne": "Not equals (!=)",
+  "enums.if_operator.gt": "Greater than (>)",
+  "enums.if_operator.gte": "Greater or equal (>=)",
+  "enums.if_operator.lt": "Less than (<)",
+  "enums.if_operator.lte": "Less or equal (<=)",
+  "enums.if_operator.in": "Is in (in)",
+  "enums.if_operator.not_in": "Is not in (not in)",
+  "enums.if_operator.contains": "Contains",
+  "enums.if_operator.not_contains": "Does not contain",
+  "enums.if_operator.is_empty": "Is empty",
+  "enums.if_operator.is_not_empty": "Is not empty",
   "enums.allocation_method.custom": "Custom Allocation",
   "enums.allocation_method.equal": "Equal Weight",
   "enums.allocation_method.momentum": "Momentum Based",

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/i18n/locales/ko.json

@@ -36,6 +36,8 @@
   "nodes.AIAgentNode.name": "AI 에이전트",
   "nodes.AggregateNode.description": "개별 아이템을 리스트로 수집합니다. SplitNode와 함께 사용하세요.",
   "nodes.AggregateNode.name": "집계",
+  "nodes.IfNode.description": "조건에 따라 실행 흐름을 분기합니다 (if/else)",
+  "nodes.IfNode.name": "조건 분기",
   "nodes.AlertNode.description": "알림 발송 (이메일, SMS, 웹훅).",
   "nodes.AlertNode.name": "알림",
   "nodes.BacktestEngineNode.description": "시그널과 과거 데이터로 백테스트 실행 및 성과 지표 계산.",
@@ -110,6 +112,8 @@
   "nodes.OverseasStockCancelOrderNode.name": "해외주식 취소주문",
   "nodes.OverseasStockHistoricalDataNode.description": "해외주식 종목의 과거 OHLCV 데이터를 조회합니다. (NYSE, NASDAQ, AMEX)",
   "nodes.OverseasStockHistoricalDataNode.name": "해외주식 과거데이터",
+  "nodes.OverseasStockFundamentalNode.description": "해외주식 종목의 PER, EPS, 시가총액, 52주 고/저가 등 펀더멘털 데이터를 조회합니다. (NYSE, NASDAQ, AMEX)",
+  "nodes.OverseasStockFundamentalNode.name": "해외주식 종목정보",
   "nodes.OverseasStockMarketDataNode.description": "해외주식 종목의 현재가와 거래량을 조회합니다. (NYSE, NASDAQ, AMEX)",
   "nodes.OverseasStockMarketDataNode.name": "해외주식 현재가",
   "nodes.OverseasStockModifyOrderNode.description": "미국 주식 미체결 주문의 가격이나 수량을 정정합니다.",
@@ -182,6 +186,9 @@
   "fields.AggregateNode.mode": "집계 방식을 선택하세요",
   "fields.AggregateNode.value_field": "계산에 사용할 필드명 (sum/avg/min/max 모드용)",
   "fields.AggregateNode.value_field_helper": "숫자 값이 있는 필드를 지정하세요",
+  "fields.IfNode.left": "왼쪽 값 (비교 대상)",
+  "fields.IfNode.operator": "비교 연산자",
+  "fields.IfNode.right": "오른쪽 값 (비교 기준)",
   "fields.AlertNode.credential_id": "알림 서비스 인증정보",
   "fields.AlertNode.message_template": "메시지 템플릿 (변수 사용 가능)",
   "fields.BacktestEngineNode.allow_fractional": "소수점 주식 허용",
@@ -337,6 +344,10 @@
   "fields.OverseasStockHistoricalDataNode.symbol.exchange": "거래소",
   "fields.OverseasStockHistoricalDataNode.symbol.help_text": "직접 입력 또는 바인딩 가능 (fx 토글)",
   "fields.OverseasStockHistoricalDataNode.symbol.symbol": "종목코드",
+  "fields.OverseasStockFundamentalNode.symbol": "펀더멘털 데이터를 조회할 종목 코드를 입력하세요",
+  "fields.OverseasStockFundamentalNode.symbol.exchange": "거래소",
+  "fields.OverseasStockFundamentalNode.symbol.help_text": "직접 입력 또는 바인딩 가능 (fx 토글)",
+  "fields.OverseasStockFundamentalNode.symbol.symbol": "종목코드",
   "fields.OverseasStockMarketDataNode.symbol": "현재가를 조회할 종목 코드를 입력하세요",
   "fields.OverseasStockMarketDataNode.symbol.exchange": "거래소",
   "fields.OverseasStockMarketDataNode.symbol.help_text": "직접 입력 또는 바인딩 가능 (fx 토글)",
@@ -437,6 +448,9 @@
   "fieldNames.AggregateNode.filter_field": "필터필드",
   "fieldNames.AggregateNode.mode": "집계방식",
   "fieldNames.AggregateNode.value_field": "값필드",
+  "fieldNames.IfNode.left": "왼쪽 값",
+  "fieldNames.IfNode.operator": "연산자",
+  "fieldNames.IfNode.right": "오른쪽 값",
   "fieldNames.BacktestEngineNode.allow_fractional": "소수점매매허용",
   "fieldNames.BacktestEngineNode.allow_short": "공매도허용",
   "fieldNames.BacktestEngineNode.atr_period": "ATR기간",
@@ -559,6 +573,7 @@
   "fieldNames.OverseasStockHistoricalDataNode.interval": "봉종류",
   "fieldNames.OverseasStockHistoricalDataNode.start_date": "시작일",
   "fieldNames.OverseasStockHistoricalDataNode.symbol": "종목",
+  "fieldNames.OverseasStockFundamentalNode.symbol": "종목",
   "fieldNames.OverseasStockMarketDataNode.symbol": "종목",
   "fieldNames.OverseasStockModifyOrderNode.exchange": "거래소",
   "fieldNames.OverseasStockModifyOrderNode.new_price": "정정가격",
@@ -666,6 +681,9 @@
   "ports.aggregate_count": "아이템 개수",
   "ports.aggregate_item": "수집할 아이템",
   "ports.aggregate_value": "계산 결과 (sum/avg/min/max)",
+  "ports.if_true": "조건이 참일 때 출력",
+  "ports.if_false": "조건이 거짓일 때 출력",
+  "ports.if_result": "조건 평가 결과 (boolean)",
   "ports.allocated_capital": "배분된 자본",
   "ports.allocation_weights": "배분 비중",
   "ports.approved_symbols": "승인된 종목",
@@ -693,12 +711,15 @@
   "ports.current_value": "현재 값",
   "ports.data": "데이터",
   "ports.data_to_save": "저장할 데이터",
+  "ports.deposit": "예수금",
   "ports.drawdown_curve": "낙폭 곡선",
   "ports.equity_curve": "자산 곡선",
+  "ports.exchange_rate": "기준환율",
   "ports.error_data": "에러 데이터",
   "ports.event": "이벤트 데이터",
   "ports.failed": "실패",
   "ports.failed_symbols": "미통과 종목",
+  "ports.foreign_cash": "외화예수금 (USD)",
   "ports.filled": "체결됨",
   "ports.halted": "중단 신호",
   "ports.held_symbols": "보유 종목",
@@ -715,10 +736,14 @@
   "ports.liquidated_positions": "청산된 포지션",
   "ports.liquidation_result": "청산 결과",
   "ports.loaded_data": "로드된 데이터",
+  "ports.maintenance_margin": "유지증거금",
   "ports.mapped_data": "변환된 데이터",
   "ports.mapped_fields": "매핑된 필드명 목록",
+  "ports.margin": "위탁증거금",
+  "ports.margin_call_rate": "마진콜율 (%)",
   "ports.market_data": "시세 데이터",
   "ports.market_data_full": "전체 시세 데이터",
+  "ports.fundamental_data_value": "펀더멘털 데이터 (PER, EPS, 시가총액 등)",
   "ports.market_data_value": "시세 값",
   "ports.market_data_values": "시세 데이터 (종목별 가격/거래량)",
   "ports.metrics": "성과 지표",
@@ -733,6 +758,7 @@
   "ports.ohlcv_value": "OHLCV 값",
   "ports.open": "거래소 개장",
   "ports.open_orders": "미체결 주문",
+  "ports.orderable_amount": "주문가능금액",
   "ports.order": "주문 데이터",
   "ports.order_id": "주문 번호",
   "ports.order_ids": "종목별 주문번호",
@@ -763,6 +789,7 @@
   "ports.resume_at": "재개 시간",
   "ports.saved_data": "저장된 데이터",
   "ports.sell_signal": "매도 시그널",
+  "ports.settlement_pnl": "청산손익",
   "ports.signals": "시그널 데이터",
   "ports.split_array": "분리할 리스트",
   "ports.split_index": "현재 인덱스 (0부터)",
@@ -785,6 +812,8 @@
   "ports.target_orders": "대상 주문",
   "ports.throttle_stats": "쓰로틀 통계 (스킵 횟수, 카운트다운 등)",
   "ports.tick_data": "틱 데이터",
+  "ports.total_eval": "평가예탁총금액",
+  "ports.total_orderable": "전체 주문가능금액 합산",
   "ports.total_pnl": "총 손익",
   "ports.trades": "거래 내역",
   "ports.trigger": "트리거 신호",
@@ -800,6 +829,18 @@
   "enums.aggregate_mode.max": "최댓값",
   "enums.aggregate_mode.min": "최솟값",
   "enums.aggregate_mode.sum": "합계",
+  "enums.if_operator.eq": "같음 (==)",
+  "enums.if_operator.ne": "다름 (!=)",
+  "enums.if_operator.gt": "초과 (>)",
+  "enums.if_operator.gte": "이상 (>=)",
+  "enums.if_operator.lt": "미만 (<)",
+  "enums.if_operator.lte": "이하 (<=)",
+  "enums.if_operator.in": "포함됨 (in)",
+  "enums.if_operator.not_in": "미포함됨 (not in)",
+  "enums.if_operator.contains": "포함함 (contains)",
+  "enums.if_operator.not_contains": "미포함함 (not contains)",
+  "enums.if_operator.is_empty": "비어있음",
+  "enums.if_operator.is_not_empty": "비어있지 않음",
   "enums.allocation_method.custom": "커스텀 배분",
   "enums.allocation_method.equal": "균등 배분",
   "enums.allocation_method.momentum": "모멘텀 기반",

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/models/edge.py

@@ -58,6 +58,10 @@ class Edge(BaseModel):
         alias="to",
         description="도착 노드 ID",
     )
+    from_port: Optional[str] = Field(
+        default=None,
+        description="출발 포트 (예: IfNode의 true/false)",
+    )
     edge_type: EdgeType = Field(
         default=EdgeType.MAIN,
         alias="type",
@@ -78,20 +82,27 @@ class Edge(BaseModel):
     @classmethod
     def extract_node_ids(cls, values: dict) -> dict:
         """
-        from/to 값에서 노드 ID만 추출 (하위호환성)
-        
-        "nodeA.portX" → "nodeA"
-        "nodeA" → "nodeA"
+        from/to 값에서 노드 ID만 추출하고 포트 정보를 보존
+
+        "nodeA.portX" → from="nodeA", from_port="portX"
+        "nodeA" → from="nodeA"
         """
         if isinstance(values, dict):
             from_val = values.get('from') or values.get('from_node')
             to_val = values.get('to') or values.get('to_node')
-            
+
             if from_val:
-                values['from'] = from_val.split('.')[0]
+                from_str = str(from_val)
+                if '.' in from_str:
+                    parts = from_str.split('.', 1)
+                    values['from'] = parts[0]
+                    if not values.get('from_port'):
+                        values['from_port'] = parts[1]
+                else:
+                    values['from'] = from_str
             if to_val:
-                values['to'] = to_val.split('.')[0]
-        
+                values['to'] = str(to_val).split('.')[0]
+
         return values
 
     # 하위호환성을 위한 property (기존 코드가 참조하는 경우)

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/__init__.py

@@ -1,10 +1,10 @@
 """
 ProgramGarden Core - 노드 타입 정의
 
-48개 노드 타입을 카테고리로 분류:
-- infra (4): StartNode, ThrottleNode, SplitNode, AggregateNode
+49개 노드 타입을 카테고리로 분류:
+- infra (5): StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode
 - broker (2): OverseasStockBrokerNode, OverseasFuturesBrokerNode
-- market (12): OverseasStockMarketDataNode, OverseasFuturesMarketDataNode, OverseasStockHistoricalDataNode, OverseasFuturesHistoricalDataNode,
+- market (13): OverseasStockMarketDataNode, OverseasStockFundamentalNode, OverseasFuturesMarketDataNode, OverseasStockHistoricalDataNode, OverseasFuturesHistoricalDataNode,
               OverseasStockRealMarketDataNode, OverseasFuturesRealMarketDataNode, OverseasStockSymbolQueryNode, OverseasFuturesSymbolQueryNode,
               WatchlistNode, MarketUniverseNode, ScreenerNode, SymbolFilterNode
 - account (6): OverseasStockAccountNode, OverseasFuturesAccountNode, OverseasStockRealAccountNode, OverseasFuturesRealAccountNode,
@@ -22,10 +22,11 @@ ProgramGarden Core - 노드 타입 정의
 """
 
 from programgarden_core.nodes.base import BaseNode, NodeCategory, Position
-from programgarden_core.nodes.infra import StartNode, ThrottleNode, SplitNode, AggregateNode
+from programgarden_core.nodes.infra import StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode
 from programgarden_core.nodes.broker import OverseasStockBrokerNode, OverseasFuturesBrokerNode
 # Market - 상품별 분리 노드
 from programgarden_core.nodes.data_stock import OverseasStockMarketDataNode
+from programgarden_core.nodes.fundamental_stock import OverseasStockFundamentalNode
 from programgarden_core.nodes.data_futures import OverseasFuturesMarketDataNode
 from programgarden_core.nodes.backtest_stock import OverseasStockHistoricalDataNode
 from programgarden_core.nodes.backtest_futures import OverseasFuturesHistoricalDataNode
@@ -95,11 +96,13 @@ __all__ = [
     "ThrottleNode",
     "SplitNode",
     "AggregateNode",
+    "IfNode",
     # Broker (상품별 분리)
     "OverseasStockBrokerNode",
     "OverseasFuturesBrokerNode",
     # Market - Stock (해외주식)
     "OverseasStockMarketDataNode",
+    "OverseasStockFundamentalNode",
     "OverseasStockHistoricalDataNode",
     "OverseasStockRealMarketDataNode",
     "OverseasStockSymbolQueryNode",

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/account_futures.py

@@ -18,7 +18,7 @@ from programgarden_core.nodes.base import (
     OutputPort,
     ProductScope,
     BrokerProvider,
-    BALANCE_FIELDS,
+    OVERSEAS_FUTURES_BALANCE_FIELDS,
     POSITION_FIELDS,
     SYMBOL_LIST_FIELDS,
 )
@@ -53,7 +53,7 @@ class OverseasFuturesAccountNode(BaseNode):
     ]
     _outputs: List[OutputPort] = [
         OutputPort(name="held_symbols", type="symbol_list", description="i18n:ports.held_symbols", fields=SYMBOL_LIST_FIELDS),
-        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=BALANCE_FIELDS),
+        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=OVERSEAS_FUTURES_BALANCE_FIELDS),
         OutputPort(name="positions", type="position_data", description="i18n:ports.positions", fields=POSITION_FIELDS),
     ]
 

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/account_stock.py

@@ -18,7 +18,7 @@ from programgarden_core.nodes.base import (
     OutputPort,
     ProductScope,
     BrokerProvider,
-    BALANCE_FIELDS,
+    OVERSEAS_STOCK_BALANCE_FIELDS,
     POSITION_FIELDS,
     SYMBOL_LIST_FIELDS,
 )
@@ -53,7 +53,7 @@ class OverseasStockAccountNode(BaseNode):
     ]
     _outputs: List[OutputPort] = [
         OutputPort(name="held_symbols", type="symbol_list", description="i18n:ports.held_symbols", fields=SYMBOL_LIST_FIELDS),
-        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=BALANCE_FIELDS),
+        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=OVERSEAS_STOCK_BALANCE_FIELDS),
         OutputPort(name="positions", type="position_data", description="i18n:ports.positions", fields=POSITION_FIELDS),
     ]
 

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/ai.py

@@ -100,7 +100,7 @@ class LLMModelNode(BaseNode):
                 category=FieldCategory.PARAMETERS,
                 expression_mode=ExpressionMode.FIXED_ONLY,
                 ui_component=UIComponent.CUSTOM_CREDENTIAL_SELECT,
-                credential_types=["llm_openai", "llm_anthropic", "llm_google", "llm_azure_openai", "llm_ollama"],
+                credential_types=["llm_openai", "llm_anthropic", "llm_google"],
             ),
             "model": FieldSchema(
                 name="model",

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/base.py

@@ -112,7 +112,39 @@ SYMBOL_LIST_FIELDS: List[Dict[str, str]] = [
     {"name": "symbol", "type": "string", "description": "종목코드"},
 ]
 
-BALANCE_FIELDS: List[Dict[str, str]] = [
+# ── 해외주식 REST AccountNode 전용 ──
+OVERSEAS_STOCK_BALANCE_FIELDS: List[Dict[str, str]] = [
+    {"name": "total_pnl_rate", "type": "number", "description": "수익률 (%)"},
+    {"name": "cash_krw", "type": "number", "description": "원화예수금"},
+    {"name": "stock_eval_krw", "type": "number", "description": "주식환산평가금액"},
+    {"name": "total_eval_krw", "type": "number", "description": "원화평가합계"},
+    {"name": "total_pnl_krw", "type": "number", "description": "환산평가손익"},
+    {"name": "orderable_amount", "type": "number", "description": "외화주문가능금액 (USD)"},
+    {"name": "foreign_cash", "type": "number", "description": "외화예수금 (USD)"},
+    {"name": "exchange_rate", "type": "number", "description": "기준환율"},
+]
+
+# ── 해외선물 REST AccountNode 전용 ──
+OVERSEAS_FUTURES_BALANCE_FIELDS: List[Dict[str, str]] = [
+    {"name": "deposit", "type": "number", "description": "예수금"},
+    {"name": "orderable_amount", "type": "number", "description": "주문가능금액"},
+    {"name": "total_orderable", "type": "number", "description": "전체 주문가능금액 합산"},
+    {"name": "margin", "type": "number", "description": "위탁증거금"},
+    {"name": "maintenance_margin", "type": "number", "description": "유지증거금"},
+    {"name": "margin_call_rate", "type": "number", "description": "마진콜율 (%)"},
+    {"name": "total_eval", "type": "number", "description": "평가예탁총금액"},
+    {"name": "settlement_pnl", "type": "number", "description": "청산손익"},
+]
+
+# ── 해외주식 RealAccountNode 전용 ──
+OVERSEAS_STOCK_REAL_BALANCE_FIELDS: List[Dict[str, str]] = [
+    {"name": "total", "type": "number", "description": "총 예수금"},
+    {"name": "available", "type": "number", "description": "매수 가능 금액"},
+    {"name": "currency", "type": "string", "description": "통화 코드 (USD 등)"},
+]
+
+# ── 해외선물 RealAccountNode 전용 ──
+OVERSEAS_FUTURES_REAL_BALANCE_FIELDS: List[Dict[str, str]] = [
     {"name": "total", "type": "number", "description": "총 예수금"},
     {"name": "available", "type": "number", "description": "매수 가능 금액"},
     {"name": "currency", "type": "string", "description": "통화 코드 (USD 등)"},
@@ -144,6 +176,27 @@ PRICE_DATA_FIELDS: List[Dict[str, str]] = [
     {"name": "current_price", "type": "number", "description": "현재가"},
     {"name": "volume", "type": "number", "description": "거래량"},
     {"name": "change_percent", "type": "number", "description": "등락률 (%)"},
+    {"name": "per", "type": "number", "description": "PER (주가수익비율)"},
+    {"name": "eps", "type": "number", "description": "EPS (주당순이익)"},
+]
+
+FUNDAMENTAL_DATA_FIELDS: List[Dict[str, str]] = [
+    {"name": "exchange", "type": "string", "description": "거래소 코드"},
+    {"name": "symbol", "type": "string", "description": "종목코드"},
+    {"name": "name", "type": "string", "description": "영문 종목명"},
+    {"name": "industry", "type": "string", "description": "업종명"},
+    {"name": "nation", "type": "string", "description": "국가명"},
+    {"name": "exchange_name", "type": "string", "description": "거래소명"},
+    {"name": "current_price", "type": "number", "description": "현재가"},
+    {"name": "volume", "type": "number", "description": "거래량"},
+    {"name": "change_percent", "type": "number", "description": "등락률 (%)"},
+    {"name": "per", "type": "number", "description": "PER (주가수익비율)"},
+    {"name": "eps", "type": "number", "description": "EPS (주당순이익)"},
+    {"name": "market_cap", "type": "number", "description": "시가총액"},
+    {"name": "shares_outstanding", "type": "number", "description": "발행주식수"},
+    {"name": "high_52w", "type": "number", "description": "52주 최고가"},
+    {"name": "low_52w", "type": "number", "description": "52주 최저가"},
+    {"name": "exchange_rate", "type": "number", "description": "환율"},
 ]
 
 HISTORICAL_DATA_FIELDS: List[Dict[str, str]] = [

programgarden_core-1.4.0/programgarden_core/nodes/fundamental_stock.py

@@ -0,0 +1,91 @@
+"""
+ProgramGarden Core - Stock Fundamental Node
+
+해외주식 종목정보(펀더멘털) 조회:
+- OverseasStockFundamentalNode: g3104 API 기반 종목정보 조회
+
+Item-based execution:
+- Input: 단일 symbol (SplitNode에서 분리된 아이템)
+- Output: 단일 value (해당 종목의 펀더멘털 데이터)
+"""
+
+from typing import List, Literal, Dict, ClassVar, Optional, TYPE_CHECKING
+from pydantic import Field
+
+if TYPE_CHECKING:
+    from programgarden_core.models.field_binding import FieldSchema
+
+from programgarden_core.nodes.base import (
+    BaseNode,
+    NodeCategory,
+    InputPort,
+    OutputPort,
+    ProductScope,
+    BrokerProvider,
+    FUNDAMENTAL_DATA_FIELDS,
+)
+
+
+class OverseasStockFundamentalNode(BaseNode):
+    """
+    해외주식 종목정보(펀더멘털) 조회 노드 (단일 종목)
+
+    PER, EPS, 시가총액, 발행주식수, 52주 고/저가, 업종 등
+    종목의 기본적 분석 데이터를 조회합니다.
+    거래소: NYSE, NASDAQ, AMEX
+
+    Item-based execution:
+    - Input: symbol (단일 종목 {exchange, symbol})
+    - Output: value (해당 종목의 펀더멘털 데이터)
+    """
+
+    type: Literal["OverseasStockFundamentalNode"] = "OverseasStockFundamentalNode"
+    category: NodeCategory = NodeCategory.MARKET
+    description: str = "i18n:nodes.OverseasStockFundamentalNode.description"
+    _img_url: ClassVar[str] = "https://cdn.programgarden.io/nodes/fundamental_stock.svg"
+    _product_scope: ClassVar[ProductScope] = ProductScope.STOCK
+    _broker_provider: ClassVar[BrokerProvider] = BrokerProvider.LS
+
+    # 단일 종목 (Item-based execution)
+    symbol: Optional[Dict[str, str]] = Field(
+        default=None,
+        description="Single symbol entry with exchange and symbol code",
+    )
+
+    @classmethod
+    def is_tool_enabled(cls) -> bool:
+        return True
+
+    _inputs: List[InputPort] = [
+        InputPort(name="symbol", type="symbol", description="i18n:ports.symbol"),
+        InputPort(name="trigger", type="signal", description="i18n:ports.trigger", required=False),
+    ]
+    _outputs: List[OutputPort] = [
+        OutputPort(name="value", type="fundamental_data", description="i18n:ports.fundamental_data_value", fields=FUNDAMENTAL_DATA_FIELDS),
+    ]
+
+    @classmethod
+    def get_field_schema(cls) -> Dict[str, "FieldSchema"]:
+        from programgarden_core.models.field_binding import FieldSchema, FieldType, FieldCategory, UIComponent, ExpressionMode
+        return {
+            "symbol": FieldSchema(
+                name="symbol",
+                type=FieldType.OBJECT,
+                display_name="i18n:fieldNames.OverseasStockFundamentalNode.symbol",
+                description="i18n:fields.OverseasStockFundamentalNode.symbol",
+                default=None,
+                category=FieldCategory.PARAMETERS,
+                expression_mode=ExpressionMode.EXPRESSION_ONLY,
+                example={"exchange": "NASDAQ", "symbol": "AAPL"},
+                example_binding="{{ nodes.split.item }}",
+                bindable_sources=[
+                    "SplitNode.item",
+                ],
+                expected_type="{exchange: str, symbol: str}",
+                help_text="i18n:fields.OverseasStockFundamentalNode.symbol.help_text",
+                object_schema=[
+                    {"name": "exchange", "type": "STRING", "label": "i18n:fields.OverseasStockFundamentalNode.symbol.exchange", "required": True},
+                    {"name": "symbol", "type": "STRING", "label": "i18n:fields.OverseasStockFundamentalNode.symbol.symbol", "required": True},
+                ],
+            ),
+        }

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/infra.py

@@ -6,6 +6,7 @@ Infrastructure nodes:
 - ThrottleNode: Data flow control
 - SplitNode: Split list into individual items (item-based execution)
 - AggregateNode: Aggregate individual items into a list
+- IfNode: Conditional branching (if/else)
 """
 
 from typing import Optional, List, Literal, Dict, TYPE_CHECKING, ClassVar, Any
@@ -309,3 +310,106 @@ class AggregateNode(BaseNode):
                 helper_text="i18n:fields.AggregateNode.value_field_helper",
             ),
         }
+
+
+class IfNode(BaseNode):
+    """
+    조건 분기 노드
+
+    left와 right 값을 operator로 비교하여 true/false 브랜치로 실행 흐름을 분기합니다.
+    조건이 참이면 true 포트로, 거짓이면 false 포트로 데이터가 전달됩니다.
+
+    Edge에 from_port를 지정하여 분기 경로를 설정합니다:
+    - {"from": "if1", "to": "order", "from_port": "true"}
+    - {"from": "if1", "to": "notify", "from_port": "false"}
+    """
+
+    type: Literal["IfNode"] = "IfNode"
+    category: NodeCategory = NodeCategory.INFRA
+    description: str = "i18n:nodes.IfNode.description"
+
+    _img_url: ClassVar[str] = "https://cdn.programgarden.io/nodes/if.svg"
+
+    # 비교 연산 필드
+    left: Any = Field(default=None, description="왼쪽 피연산자 (표현식 바인딩 가능)")
+    operator: Literal[
+        "==", "!=", ">", ">=", "<", "<=",
+        "in", "not_in",
+        "contains", "not_contains",
+        "is_empty", "is_not_empty",
+    ] = Field(default="==", description="비교 연산자")
+    right: Any = Field(default=None, description="오른쪽 피연산자 (표현식 바인딩 가능)")
+
+    _inputs: List[InputPort] = [
+        InputPort(name="trigger", type="signal", description="i18n:ports.trigger"),
+    ]
+    _outputs: List[OutputPort] = [
+        OutputPort(name="true", type="any", description="i18n:ports.if_true"),
+        OutputPort(name="false", type="any", description="i18n:ports.if_false"),
+        OutputPort(name="result", type="boolean", description="i18n:ports.if_result"),
+    ]
+
+    @classmethod
+    def get_field_schema(cls) -> Dict[str, "FieldSchema"]:
+        from programgarden_core.models.field_binding import (
+            FieldSchema, FieldType, FieldCategory, ExpressionMode,
+        )
+        return {
+            "left": FieldSchema(
+                name="left",
+                type=FieldType.STRING,
+                description="i18n:fields.IfNode.left",
+                required=True,
+                expression_mode=ExpressionMode.BOTH,
+                category=FieldCategory.PARAMETERS,
+                placeholder="{{ nodes.account.balance }}",
+                example="{{ nodes.account.balance }}",
+                expected_type="any",
+            ),
+            "operator": FieldSchema(
+                name="operator",
+                type=FieldType.ENUM,
+                description="i18n:fields.IfNode.operator",
+                default="==",
+                enum_values=[
+                    "==", "!=", ">", ">=", "<", "<=",
+                    "in", "not_in",
+                    "contains", "not_contains",
+                    "is_empty", "is_not_empty",
+                ],
+                enum_labels={
+                    "==": "i18n:enums.if_operator.eq",
+                    "!=": "i18n:enums.if_operator.ne",
+                    ">": "i18n:enums.if_operator.gt",
+                    ">=": "i18n:enums.if_operator.gte",
+                    "<": "i18n:enums.if_operator.lt",
+                    "<=": "i18n:enums.if_operator.lte",
+                    "in": "i18n:enums.if_operator.in",
+                    "not_in": "i18n:enums.if_operator.not_in",
+                    "contains": "i18n:enums.if_operator.contains",
+                    "not_contains": "i18n:enums.if_operator.not_contains",
+                    "is_empty": "i18n:enums.if_operator.is_empty",
+                    "is_not_empty": "i18n:enums.if_operator.is_not_empty",
+                },
+                required=True,
+                expression_mode=ExpressionMode.FIXED_ONLY,
+                category=FieldCategory.PARAMETERS,
+            ),
+            "right": FieldSchema(
+                name="right",
+                type=FieldType.STRING,
+                description="i18n:fields.IfNode.right",
+                required=False,
+                expression_mode=ExpressionMode.BOTH,
+                category=FieldCategory.PARAMETERS,
+                placeholder="1000000",
+                example="1000000",
+                expected_type="any",
+                visible_when={
+                    "operator": [
+                        "==", "!=", ">", ">=", "<", "<=",
+                        "in", "not_in", "contains", "not_contains",
+                    ],
+                },
+            ),
+        }

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/realtime_futures.py

@@ -20,7 +20,7 @@ from programgarden_core.nodes.base import (
     OutputPort,
     ProductScope,
     BrokerProvider,
-    BALANCE_FIELDS,
+    OVERSEAS_FUTURES_REAL_BALANCE_FIELDS,
     MARKET_DATA_FULL_FIELDS,
     OHLCV_DATA_FIELDS,
     ORDER_EVENT_FIELDS,
@@ -130,7 +130,7 @@ class OverseasFuturesRealAccountNode(BaseNode):
     _inputs: List[InputPort] = []
     _outputs: List[OutputPort] = [
         OutputPort(name="held_symbols", type="symbol_list", description="i18n:ports.held_symbols", fields=SYMBOL_LIST_FIELDS),
-        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=BALANCE_FIELDS),
+        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=OVERSEAS_FUTURES_REAL_BALANCE_FIELDS),
         OutputPort(name="open_orders", type="order_list", description="i18n:ports.open_orders", fields=ORDER_LIST_FIELDS),
         OutputPort(name="positions", type="position_data", description="i18n:ports.positions", fields=POSITION_FIELDS),
     ]

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/nodes/realtime_stock.py

@@ -20,7 +20,7 @@ from programgarden_core.nodes.base import (
     OutputPort,
     ProductScope,
     BrokerProvider,
-    BALANCE_FIELDS,
+    OVERSEAS_STOCK_REAL_BALANCE_FIELDS,
     MARKET_DATA_FULL_FIELDS,
     OHLCV_DATA_FIELDS,
     ORDER_EVENT_FIELDS,
@@ -134,7 +134,7 @@ class OverseasStockRealAccountNode(BaseNode):
     _inputs: List[InputPort] = []
     _outputs: List[OutputPort] = [
         OutputPort(name="held_symbols", type="symbol_list", description="i18n:ports.held_symbols", fields=SYMBOL_LIST_FIELDS),
-        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=BALANCE_FIELDS),
+        OutputPort(name="balance", type="balance_data", description="i18n:ports.balance", fields=OVERSEAS_STOCK_REAL_BALANCE_FIELDS),
         OutputPort(name="open_orders", type="order_list", description="i18n:ports.open_orders", fields=ORDER_LIST_FIELDS),
         OutputPort(name="positions", type="position_data", description="i18n:ports.positions", fields=POSITION_FIELDS),
     ]

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/programgarden_core/registry/node_registry.py

@@ -76,10 +76,11 @@ class NodeTypeRegistry:
         """Register built-in node types"""
         # 지연 임포트로 순환 참조 방지
         from programgarden_core.nodes import (
-            StartNode, ThrottleNode, SplitNode, AggregateNode,
+            StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode,
             OverseasStockBrokerNode, OverseasFuturesBrokerNode,
             # Market - Stock (해외주식)
-            OverseasStockMarketDataNode, OverseasStockHistoricalDataNode,
+            OverseasStockMarketDataNode, OverseasStockFundamentalNode,
+            OverseasStockHistoricalDataNode,
             OverseasStockRealMarketDataNode,
             OverseasStockSymbolQueryNode,
             # Market - Futures (해외선물)
@@ -110,11 +111,12 @@ class NodeTypeRegistry:
 
         node_classes = [
             # Infra
-            StartNode, ThrottleNode, SplitNode, AggregateNode,
+            StartNode, ThrottleNode, SplitNode, AggregateNode, IfNode,
             # Broker (상품별 분리)
             OverseasStockBrokerNode, OverseasFuturesBrokerNode,
             # Market - Stock (해외주식)
-            OverseasStockMarketDataNode, OverseasStockHistoricalDataNode,
+            OverseasStockMarketDataNode, OverseasStockFundamentalNode,
+            OverseasStockHistoricalDataNode,
             OverseasStockRealMarketDataNode,
             OverseasStockSymbolQueryNode,
             # Market - Futures (해외선물)

{programgarden_core-1.2.0 → programgarden_core-1.4.0}/pyproject.toml

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