Supports Interactive Brokers, US and Hong Kong stocks.

Signed-off-by: TIANHE <TIANHE@GMAIL.COM>

backend_api_python/app/services/live_trading/factory.py

@@ -1,10 +1,14 @@
 """
 Factory for direct exchange clients.
+
+Supports:
+- Crypto exchanges: Binance, OKX, Bitget, Bybit, Coinbase, Kraken, KuCoin, Gate, Bitfinex
+- Traditional brokers: Interactive Brokers (IBKR) for US/HK stocks
 """
 
 from __future__ import annotations
 
-from typing import Any, Dict
+from typing import Any, Dict, Union
 
 from app.services.live_trading.base import BaseRestClient, LiveTradingError
 from app.services.live_trading.binance import BinanceFuturesClient
@@ -20,6 +24,10 @@ from app.services.live_trading.kucoin import KucoinSpotClient, KucoinFuturesClie
 from app.services.live_trading.gate import GateSpotClient, GateUsdtFuturesClient
 from app.services.live_trading.bitfinex import BitfinexClient, BitfinexDerivativesClient
 
+# Lazy import IBKR to avoid ImportError if ib_insync not installed
+IBKRClient = None
+IBKRConfig = None
+
 
 def _get(cfg: Dict[str, Any], *keys: str) -> str:
     for k in keys:
@@ -101,6 +109,53 @@ def create_client(exchange_config: Dict[str, Any], *, market_type: str = "swap")
             return BitfinexClient(api_key=api_key, secret_key=secret_key, base_url=base_url)
         return BitfinexDerivativesClient(api_key=api_key, secret_key=secret_key, base_url=base_url)
 
+    # Traditional brokers (IBKR for US/HK stocks)
+    if exchange_id == "ibkr":
+        return create_ibkr_client(exchange_config)
+
     raise LiveTradingError(f"Unsupported exchange_id: {exchange_id}")
 
 
+def create_ibkr_client(exchange_config: Dict[str, Any]):
+    """
+    Create IBKR client for US/HK stock trading.
+
+    exchange_config should contain:
+    - ibkr_host: TWS/Gateway host (default: 127.0.0.1)
+    - ibkr_port: TWS/Gateway port (default: 7497)
+    - ibkr_client_id: Client ID (default: 1)
+    - ibkr_account: Account ID (optional, auto-select if empty)
+    """
+    global IBKRClient, IBKRConfig
+
+    # Lazy import to avoid ImportError if ib_insync not installed
+    if IBKRClient is None or IBKRConfig is None:
+        try:
+            from app.services.ibkr_trading import IBKRClient as _IBKRClient, IBKRConfig as _IBKRConfig
+            IBKRClient = _IBKRClient
+            IBKRConfig = _IBKRConfig
+        except ImportError:
+            raise LiveTradingError("IBKR trading requires ib_insync. Run: pip install ib_insync")
+
+    host = str(exchange_config.get("ibkr_host") or "127.0.0.1").strip()
+    port = int(exchange_config.get("ibkr_port") or 7497)
+    client_id = int(exchange_config.get("ibkr_client_id") or 1)
+    account = str(exchange_config.get("ibkr_account") or "").strip()
+
+    config = IBKRConfig(
+        host=host,
+        port=port,
+        client_id=client_id,
+        account=account,
+        readonly=False,
+    )
+
+    client = IBKRClient(config)
+
+    # Connect immediately (IBKR requires active connection)
+    if not client.connect():
+        raise LiveTradingError("Failed to connect to IBKR TWS/Gateway. Please check if it's running.")
+
+    return client
+
+