docs: update all documentation to v3.1.0

- Update docs/index.rst with v3.1.0 features and TradingSuite examples
- Modernize docs/quickstart.rst to use TradingSuite instead of factories
- Update indicator count from 55+ to 58+ (includes pattern recognition)
- Add v3.1.0 performance notes to examples/README.md
- Simplify all code examples to use unified TradingSuite interface

Key changes:
- Replace factory function examples with TradingSuite.create()
- Highlight 2-5x performance improvements in v3.1.0
- Update quick start guide for simplified initialization
- Ensure all examples reflect current best practices

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: TexasCoding

docs/index.rst

@@ -17,10 +17,10 @@ project-x-py Documentation
    :target: https://project-x-py.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status
 
-**project-x-py** is a high-performance **async Python SDK** for the `ProjectX Trading Platform <https://www.projectx.com/>`_ Gateway API. This library enables developers to build sophisticated trading strategies and applications by providing comprehensive async access to futures trading operations, real-time market data, Level 2 orderbook analysis, and a complete technical analysis suite with 55+ TA-Lib compatible indicators.
+**project-x-py** is a high-performance **async Python SDK** for the `ProjectX Trading Platform <https://www.projectx.com/>`_ Gateway API. This library enables developers to build sophisticated trading strategies and applications by providing comprehensive async access to futures trading operations, real-time market data, Level 2 orderbook analysis, and a complete technical analysis suite with 58+ TA-Lib compatible indicators including pattern recognition.
 
 .. note::
-   **Version 3.0.0**: Complete async architecture with EventBus integration for unified event handling. All components now use factory functions and dependency injection patterns. Enterprise-grade error handling with centralized logging and comprehensive retry mechanisms.
+   **Version 3.1.0**: High-performance production suite with 2-5x performance improvements. Features memory-mapped overflow storage, orjson integration, WebSocket message batching, and advanced caching with compression. Complete async architecture with unified TradingSuite interface.
 
 .. warning::
    **Development Phase**: This project is under active development. New updates may introduce breaking changes without backward compatibility. During this development phase, we prioritize clean, modern code architecture over maintaining legacy implementations.
@@ -47,37 +47,33 @@ Set up your credentials::
 Start trading::
 
    import asyncio
-   from project_x_py import ProjectX
+   from project_x_py import TradingSuite
    from project_x_py.indicators import RSI, SMA, MACD
    
    async def main():
-       # V3: Create client with async context manager
-       async with ProjectX.from_env() as client:
-           await client.authenticate()
-           
-           # Get market data with technical analysis
-           data = await client.get_bars('MNQ', days=30, interval=60)  # V3: actual symbol
-           data = RSI(data, period=14)         # Add RSI
-           data = SMA(data, period=20)         # Add moving average
-           data = MACD(data)                   # Add MACD
-           
-           # V3: Place an order with JWT authentication
-           from project_x_py import create_order_manager, create_realtime_client
-           instrument = await client.get_instrument('MNQ')
-           
-           # V3: Create realtime client with JWT and account ID
-           realtime_client = await create_realtime_client(
-               jwt_token=client.jwt_token,
-               account_id=str(client.account_id)
-           )
-           order_manager = create_order_manager(client, realtime_client)
-           
-           response = await order_manager.place_limit_order(
-               contract_id=instrument.id, 
-               side=0, 
-               size=1, 
-               limit_price=21050.0  # V3: realistic MNQ price
-           )
+       # V3.1: Use unified TradingSuite for simplified initialization
+       suite = await TradingSuite.create(
+           instrument="MNQ",
+           timeframes=["1min", "5min"],
+           features=["orderbook", "risk_manager"]
+       )
+       
+       # Get market data with technical analysis
+       data = await suite.client.get_bars('MNQ', days=30, interval=60)
+       data = RSI(data, period=14)         # Add RSI
+       data = SMA(data, period=20)         # Add moving average
+       data = MACD(data)                   # Add MACD
+       
+       # Place an order using the integrated order manager
+       response = await suite.orders.place_limit_order(
+           contract_id=suite.instrument.id, 
+           side=0, 
+           size=1, 
+           limit_price=21050.0
+       )
+       
+       # Clean up when done
+       await suite.disconnect()
    
    # Run the async function
    asyncio.run(main())
@@ -95,7 +91,7 @@ Key Features
    * Async historical OHLCV data with multiple timeframes
    * Real-time market data feeds via async WebSocket
    * **Level 2 orderbook analysis** with institutional-grade features
-   * **55+ Technical Indicators** with TA-Lib compatibility (RSI, MACD, Bollinger Bands, etc.)
+   * **58+ Technical Indicators** with TA-Lib compatibility (RSI, MACD, Bollinger Bands, Pattern Recognition, etc.)
    * **Advanced market microstructure** analysis (iceberg detection, order flow, volume profile)
 
 🔧 **Developer Tools**

docs/quickstart.rst

@@ -81,34 +81,26 @@ Step 4: Place Your First Order
 
 .. code-block:: python
 
-   from project_x_py import create_order_manager, create_realtime_client
+   from project_x_py import TradingSuite
 
    async def place_order():
-       async with ProjectX.from_env() as client:
-           await client.authenticate()
-           
-           # Get instrument details first
-           instrument = await client.get_instrument('MNQ')  # V3: actual symbol
-           
-           # V3: Create realtime client with JWT token and account ID
-           realtime_client = await create_realtime_client(
-               jwt_token=client.jwt_token,
-               account_id=str(client.account_id)
-           )
-           order_manager = create_order_manager(client, realtime_client)
-
-           # Place a limit order
-           response = await order_manager.place_limit_order(
-               contract_id=instrument.id,  # Use instrument ID
-               side=0,                     # 0=Buy, 1=Sell
-               size=1,                     # 1 contract
-               limit_price=21050.0         # Limit price (V3: realistic MNQ price)
-           )
-
-           if response.success:
-               print(f"Order placed! Order ID: {response.orderId}")
-           else:
-               print(f"Order failed: {response}")
+       # V3.1: Use TradingSuite for simplified initialization
+       suite = await TradingSuite.create("MNQ")
+       
+       # Place a limit order using the integrated order manager
+       response = await suite.orders.place_limit_order(
+           contract_id=suite.instrument.id,  # Use pre-loaded instrument ID
+           side=0,                     # 0=Buy, 1=Sell
+           size=1,                     # 1 contract
+           limit_price=21050.0         # Limit price
+       )
+
+       if response.success:
+           print(f"Order placed! Order ID: {response.orderId}")
+       else:
+           print(f"Order failed: {response}")
+       
+       await suite.disconnect()
 
    asyncio.run(place_order())
 
@@ -117,28 +109,23 @@ Step 5: Monitor Positions
 
 .. code-block:: python
 
-   from project_x_py import create_position_manager, create_realtime_client
+   from project_x_py import TradingSuite
 
    async def monitor_positions():
-       async with ProjectX.from_env() as client:
-           await client.authenticate()
-           
-           # V3: Create realtime client with JWT and account ID
-           realtime_client = await create_realtime_client(
-               jwt_token=client.jwt_token,
-               account_id=str(client.account_id)
-           )
-           position_manager = create_position_manager(client, realtime_client)
-
-           # Get all open positions
-           positions = await position_manager.get_all_positions()
-           for position in positions:
-               direction = "LONG" if position.side == 0 else "SHORT"
-               print(f"{position.contract_id}: {direction} {position.size} @ ${position.average_price:.2f}")
-
-           # Get portfolio metrics
-           portfolio = await position_manager.get_portfolio_pnl()
-           print(f"Total positions: {portfolio['position_count']}")
+       # V3.1: Use TradingSuite for all components
+       suite = await TradingSuite.create("MNQ")
+       
+       # Get all open positions using integrated position manager
+       positions = await suite.positions.get_all_positions()
+       for position in positions:
+           direction = "LONG" if position.side == 0 else "SHORT"
+           print(f"{position.contract_id}: {direction} {position.size} @ ${position.average_price:.2f}")
+
+       # Get portfolio metrics
+       portfolio = await suite.positions.get_portfolio_pnl()
+       print(f"Total positions: {portfolio['position_count']}")
+       
+       await suite.disconnect()
 
    asyncio.run(monitor_positions())
 
@@ -147,38 +134,27 @@ Step 6: Real-time Data (Optional)
 
 .. code-block:: python
 
-   from project_x_py import create_trading_suite
-   from project_x_py.events import EventBus, EventType
+   from project_x_py import TradingSuite, EventType
 
    async def setup_realtime():
-       async with ProjectX.from_env() as client:
-           await client.authenticate()
-           
-           # V3: Create complete trading suite with EventBus
-           suite = await create_trading_suite(
-               instrument='MNQ',  # V3: actual symbol
-               project_x=client,
-               jwt_token=client.jwt_token,
-               account_id=client.account_id,
-               timeframes=['1min', '5min', '15min']
-           )
-
-           # V3: Register event handlers via EventBus
-           @suite.event_bus.on(EventType.NEW_BAR)
-           async def on_new_bar(data):
-               print(f"New bar: {data['timeframe']} - {data['close']}")
-
-           # V3: Connect and start real-time feeds
-           await suite.realtime_client.connect()
-           await suite.data_manager.initialize(initial_days=1)
-           await suite.data_manager.start_realtime_feed()
-
-           # V3: Access components directly
-           live_data = await suite.data_manager.get_data('5min')
-           print(f"Live data: {len(live_data)} bars")
-           
-           # Keep running for 60 seconds to collect data
-           await asyncio.sleep(60)
+       # V3.1: Use TradingSuite for complete setup
+       suite = await TradingSuite.create(
+           instrument='MNQ',
+           timeframes=['1min', '5min', '15min']
+       )
+
+       # Register event handlers via integrated EventBus
+       @suite.events.on(EventType.NEW_BAR)
+       async def on_new_bar(event):
+           print(f"New bar: {event.data['timeframe']} - {event.data['close']}")
+
+       # Access live data (automatically initialized)
+       live_data = await suite.data.get_data('5min')
+       print(f"Live data: {len(live_data)} bars")
+       
+       # Keep running for 60 seconds to collect data
+       await asyncio.sleep(60)
+       await suite.disconnect()
 
    asyncio.run(setup_realtime())
 

examples/README.md

@@ -1,6 +1,8 @@
-# ProjectX Python SDK Examples
+# ProjectX Python SDK Examples (v3.1.0)
 
-This directory contains comprehensive working examples demonstrating all major features of the ProjectX Python SDK. All examples use **MNQ (Micro E-mini NASDAQ)** contracts to minimize risk during testing.
+This directory contains comprehensive working examples demonstrating all major features of the ProjectX Python SDK v3.1.0. All examples use **MNQ (Micro E-mini NASDAQ)** contracts to minimize risk during testing.
+
+**Note:** Version 3.1.0 includes significant performance improvements with memory-mapped overflow storage, orjson integration, and WebSocket batching for 2-5x performance gains.
 
 ## ⚠️ Important Safety Notice