49 lines
2.9 KiB
Markdown
49 lines
2.9 KiB
Markdown
# 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.
|