(feat) update pages

pages/orchestration/trading/README.md

@@ -0,0 +1,97 @@
+# Trading Hub
+
+The Trading Hub provides a comprehensive interface for executing trades, monitoring positions, and analyzing markets in real-time.
+
+## Features
+
+### 🎯 Real-time Market Data
+- **OHLC Candlestick Chart**: 5-minute interval price action with volume overlay
+- **Live Order Book**: Real-time bid/ask levels with configurable depth (10-100 levels)
+- **Current Price Display**: Live price updates with auto-refresh capability
+- **Volume Analysis**: Trading volume visualization
+
+### ⚡ Quick Trading
+- **Market Orders**: Instant buy/sell execution at current market price
+- **Limit Orders**: Set specific price levels for order execution
+- **Position Management**: Open/close positions for perpetual contracts
+- **Multi-Exchange Support**: Trade across Binance, KuCoin, OKX, and more
+
+### 📊 Portfolio Monitoring
+- **Open Positions**: Real-time P&L tracking with entry/mark prices
+- **Active Orders**: Monitor pending orders with one-click cancellation
+- **Account Overview**: Multi-account position and order management
+
+### 🔄 Real-time Performance
+- **Memory-Cached Candles**: Ultra-fast updates from backend memory cache (typically <100ms)
+- **Configurable Intervals**: 2-second auto-refresh for real-time trading experience
+- **Performance Monitoring**: Live display of data fetch times
+- **Optimized Updates**: Efficient data streaming for minimal latency
+
+## How to Use
+
+### Market Selection
+1. **Choose Exchange**: Select from available connectors (binance_perpetual, binance, kucoin, okx_perpetual)
+2. **Select Trading Pair**: Enter the trading pair (e.g., BTC-USDT, ETH-USDT)
+3. **Set Order Book Depth**: Choose how many price levels to display (10-100)
+
+### Placing Orders
+1. **Account Setup**: Specify the account name (default: master_account)
+2. **Order Configuration**:
+   - **Side**: Choose BUY or SELL
+   - **Order Type**: Select MARKET, LIMIT, or LIMIT_MAKER
+   - **Amount**: Enter the quantity to trade
+   - **Price**: Set price for limit orders (auto-filled for market orders)
+   - **Position Action**: Choose OPEN or CLOSE for perpetual contracts
+
+### Managing Positions
+- **View Open Positions**: Monitor unrealized P&L, entry prices, and position sizes
+- **Track Performance**: Real-time updates of mark prices and P&L calculations
+- **Multi-Account Support**: View positions across different trading accounts
+
+### Order Management
+- **Active Orders**: View all pending orders with real-time status
+- **Bulk Cancellation**: Select multiple orders for batch cancellation
+- **Order History**: Track order execution and fill status
+
+## Technical Features
+
+### Market Data Integration
+- **Memory-Cached Candles**: Real-time OHLC data from backend memory (1m, 3m, 5m, 15m, 1h intervals)
+- **Ultra-Fast Updates**: Sub-100ms data fetching from cached candle streams
+- **Order Book Depth**: Configurable bid/ask level display (10-100 levels)
+- **Live Price Feeds**: Real-time price updates across multiple exchanges
+- **Performance Metrics**: Live monitoring of data fetch speeds
+
+### Chart Visualization
+- **Candlestick Chart**: Interactive price action with zoom and pan
+- **Order Book Overlay**: Visualized bid/ask levels on the chart
+- **Volume Bars**: Trading volume display below price chart
+- **Dark Theme**: Futuristic styling optimized for trading environments
+
+### Auto-Refresh System
+- **Streamlit Fragments**: Efficient real-time updates without full page refresh
+- **Configurable Intervals**: Adjustable refresh rates (default: 5 seconds)
+- **Manual Control**: Start/stop auto-refresh as needed
+- **Error Handling**: Graceful handling of connection issues
+
+## Supported Exchanges
+
+- **Binance Spot**: Standard spot trading
+- **Binance Perpetual**: Futures and perpetual contracts
+- **KuCoin**: Spot and margin trading
+- **OKX Perpetual**: Futures and perpetual contracts
+
+## Error Handling
+
+The trading interface includes comprehensive error handling:
+- **Connection Errors**: Graceful handling of backend connectivity issues
+- **Order Errors**: Clear error messages for failed order placement
+- **Data Errors**: Fallback displays when market data is unavailable
+- **Validation**: Input validation for trading parameters
+
+## Security Considerations
+
+- **Account Isolation**: Each account's positions and orders are tracked separately
+- **Order Validation**: Server-side validation of all trading parameters
+- **Error Recovery**: Automatic retry mechanisms for transient failures
+- **Safe Defaults**: Conservative default values for trading parameters

pages/orchestration/trading/__init__.py

@@ -0,0 +1 @@
+# Trading page module