# VectorEX: Paper-Trading Bots & Research

**Homepage:** https://vectorex.io

## Overview

VectorEX runs four rule-based trading bots that trade paper money (simulated) on real OKX market prices. The bots implement trend-following, Donchian-breakout, and opening-range strategies. All code, backtests, and research are public.

## The Bots

### Trend BTC & Trend ETH
**Style:** Trend-following ensemble (4-hour bars)

Signals:
- 14/30/60/120-day momentum votes on 4h bars (buy if 3+ votes agree on direction, close if none agree)
- Position size targets 50%/year volatility
- Rebalance only if the new target is >25% away from current size
- Each bot trades one coin (BTC or ETH)

Live start: Oct 4, 2026, $333 per bot
Backtest (2020-07 to 2026-09): $333 → $4,722 (BTC) / $6,540 (ETH)
- Sharpe: 1.86 (BTC) / 1.91 (ETH) all-time
- Returns 2024+: +14.5% (BTC) / +65.8% (ETH) vs. buy-hold +27.7% (BTC) / +4.5% (ETH)
- Max drawdown: -42% (both)
- Taker fees: 0.06% per side on every rebalance, real funding costs

### NY Open
**Style:** Opening-range breakout with trend bias (1-minute bars)

Signals:
- 09:30–10:00 NY time: measure the range
- If the range is ≥0.2% AND the 4h trend (same as Trend bots) agrees:
  - Enter at market open (10:00 NY), stop at the range's far edge
  - Risk 1% equity per trade, max 2x notional exposure
  - Exit at 16:00 NY close or when stopped out
- BTC first; ETH only if BTC doesn't qualify that day

Live start: Oct 4, 2026, $333
Backtest (2025-02 to 2026-09): $333 → $380 (+14%)
- 2025: +17.6%, 2026: -3.1%
- Win rate: 34%, avg per trade: −0.04R
- Max drawdown: -15%
- Taker fees: 0.06% per side (entry + exit), 1% risk per trade

### Breezy
**Style:** Donchian-channel breakout ensemble (4-hour bars), BTC and ETH in one bot

Signals:
- 9 Donchian lookbacks (5/10/20/30/60/90/150/250/360 days) vote on direction; size scales with vote count
- Trailing channel-midpoint stop, 25% rebalance band, 60% annualised vol target, long or short
- Position floor 0.5× when any signal is present

Live start: Oct 6, 2026, $333
Backtest (walk-forward, fees and funding included): OOS Sharpe 0.719 (BTC) / 1.287 (ETH); OOS CAGR +23.9% (BTC) / +59.7% (ETH); OOS max drawdown −45.8% (BTC) / −32.4% (ETH). Full report: research/nextday/BREEZY_REPLICATION.md.

## Research & Backtesting

**Repository:** https://github.com/vectorx4/VectorEX

All backtests are walk-forward (in-sample 2020–2023 for trends, 2025 for NY Open; out-of-sample 2024+ / 2026):
- Sweep of 294 lower-timeframe configs (1m/5m/15m SMC, ICT, momentum families): no edge after fees
- Trend ensemble (4h TSMOM): IS→OOS correlation 0.44, stable Sharpe across periods
- NY-open: positive in 2025, slightly negative in 2026, edge weaker than trend bots

**Data sources:** Binance USDT-M perpetual (1m bars 2025+), OKX USDT futures (live), real funding & maker/taker fees included.

## Dashboard Endpoints

- `GET /profile` — Current setup, bee definitions, and backtest data for each bot
- `GET /snapshot` — Live positions, balances, and P&L
- `GET /history` — Hourly equity curve and closed trades
- `GET /equity` — Per-bot equity timeseries
- `GET /events` — Server-sent event stream of live trades and updates
- `GET /setup/status` — Whether the dashboard is in first-run setup mode

## Support (Optional)

If the research or the bots are useful, tips help pay for the server and data:

**ETH / BSC (ERC-20 or BEP-20):**
0xb9b94bEc6f427E3756d015e113F0495A863B7885

**BTC (native SegWit):**
bc1qaelhgclnkm3k4hn4kzh94utcsgdctjx5rs5pwg

## Code & License

- **GitHub:** https://github.com/vectorx4/VectorEX
- **Engine:** TypeScript, Node.js 22+ with SQLite
- **Dashboard:** React, Vite
- **License:** MIT (research, bees, engine) + specific restrictions on the beebots engine (see repo)

## Contact & Updates

- **Live:** https://vectorex.io
- **Weekly report:** Sundays 20:00 via WhatsApp (Vector's choice; others can check the dashboard)

---

*Last updated: 2026-10-06. Backtest data is regenerated whenever bot rules change (see research/nextday/bot_backtests.py).*