trading-bot/GEMINI.md

Trading212 Python Scalping Bot - "Touch & Turn" (Opening Range Reversal)

This project implements the "Touch & Turn" scalping strategy for the Trading212 API, optimized for the UK ISA environment with optional CFD integration for shorting.

Strategy Logic (The Workflow)

1. Identify Opening Candle: Capture the 15m candle (09:30 to 09:45 EST).
2. Filter for Liquidity: Opening range must be >= 25% of 14-day ATR.
3. Determine Direction:
   • Bearish (Close < Open): Prepare LONG (Buy at Low).
   • Bullish (Close > Open): Prepare SHORT (Sell at High).
4. Execution (09:45 EST):
   • Entry via Market Order for immediate fill.
   • Actual Fill Price fetched from portfolio is used for all bracket calculations.
5. Split-Account Routing (ISA / CFD):
   • ISA Account: Used for all LONG trades and SHORT trades where an Inverse ETP is available.
   • CFD Account: Used for SHORT trades on stocks without Inverse ETPs (requires SPLIT_ACCOUNT_MODE=True).
6. Hybrid Exit Strategy:
   • Broker-Side: Physical Stop Loss order placed immediately for protection.
   • Bot-Side: Take Profit monitored manually by polling current market price.
7. Automatic Exit (11:00 EST): Force close via Market Order and cleanup pending SL.

Risk & Capital Management

• Virtual Balance Simulation: In demo mode, subtracts £4,750 from total equity to simulate a realistic £250 starting point.
• 5% Risk Rule: Risks exactly 5% of the Virtual Balance per trade.
• Capital Partitioning: Divides total available capital (£250) and risk budget equally among all active ticker threads for the day (max 3) per account.
• Precision & Minimums: Automatically detects "precision-mismatch" or "min-quantity-exceeded" errors from T212 and retries with corrected values.

Technical Architecture

• main.py: Daily orchestrator. Handles dual-account initialization, trade routing, and parallel thread management.
• src/api/client.py: REST wrapper with Basic Auth.
• src/strategy/touch_turn.py: Setup logic, Fibonacci calculation, and ATR-based SL padding.
• src/execution/manager.py: Handles ticker swapping (Inverse ETPs), market entries, hybrid brackets, and retry loops.
• src/strategy/inverse_mapping.py: Map of US stocks to 3x Short Inverse ETPs for ISA shorting.

Resilience Features

• API Backoff: Random jitter (1-10s) and exponential retry on 429 errors.
• Order Tracking: Uses portfolio checks to infer status if order IDs disappear (404).
• Aggressive Logging: Custom HardFlushHandler uses os.fsync() to ensure real-time log writes to disk.

Operation

1. Timer: Service managed by systemd timer firing at 09:30 America/New_York.
2. Tracking: P&L recorded in pnl_tracking.csv.
3. Verification: Always run ./venv/bin/python3 test_api_connection.py before live days.