feat: Complete Phase 2 - Autonomous Trading System
- Add Pyth Network price monitoring (WebSocket + polling fallback) - Add Position Manager with automatic exit logic (TP1/TP2/SL) - Implement dynamic stop-loss adjustment (breakeven + profit lock) - Add real-time P&L tracking and multi-position support - Create comprehensive test suite (3 test scripts) - Add 5 detailed documentation files (2500+ lines) - Update configuration to $50 position size for safe testing - All Phase 2 features complete and tested Core Components: - v4/lib/pyth/price-monitor.ts - Real-time price monitoring - v4/lib/trading/position-manager.ts - Autonomous position management - v4/app/api/trading/positions/route.ts - Query positions endpoint - v4/test-*.ts - Comprehensive testing suite Documentation: - PHASE_2_COMPLETE_REPORT.md - Implementation summary - v4/PHASE_2_SUMMARY.md - Detailed feature overview - v4/TESTING.md - Testing guide - v4/QUICKREF_PHASE2.md - Quick reference - install-phase2.sh - Automated installation script
This commit is contained in:
mindesbunister
196
v4/README.md
Normal file
196
v4/README.md
Normal file
@@ -0,0 +1,196 @@
|
||||
# Trading Bot v4 🚀
|
||||
|
||||
**Fully Autonomous Trading Bot** for TradingView → n8n → Drift Protocol (Solana)
|
||||
|
||||
## Status
|
||||
|
||||
| Phase | Status | Description |
|
||||
|-------|--------|-------------|
|
||||
| Phase 1 | ✅ **COMPLETE** | Trade execution from TradingView signals |
|
||||
| Phase 2 | ✅ **COMPLETE** | Real-time monitoring & automatic exits |
|
||||
| Phase 3 | 🚧 **PLANNED** | Database, risk manager, notifications |
|
||||
|
||||
## What It Does
|
||||
|
||||
1. **Receives signals** from TradingView (5-minute chart)
|
||||
2. **Executes trades** on Drift Protocol (Solana DEX)
|
||||
3. **Monitors prices** in real-time via Pyth Network
|
||||
4. **Closes positions** automatically at TP1/TP2/SL
|
||||
5. **Adjusts stops** dynamically (breakeven, profit lock)
|
||||
|
||||
**100% autonomous. No manual intervention required!**
|
||||
|
||||
## Quick Start
|
||||
|
||||
### 1. Install Phase 2
|
||||
```bash
|
||||
# From project root
|
||||
./install-phase2.sh
|
||||
```
|
||||
|
||||
### 2. Configure
|
||||
```bash
|
||||
# Edit .env.local
|
||||
DRIFT_WALLET_PRIVATE_KEY=your_base58_key
|
||||
SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=YOUR_KEY
|
||||
API_KEY=your_random_secret_key
|
||||
```
|
||||
|
||||
### 3. Test
|
||||
```bash
|
||||
cd v4
|
||||
|
||||
# Test price monitoring (safe)
|
||||
npx tsx test-price-monitor.ts
|
||||
|
||||
# Test position manager (safe)
|
||||
npx tsx test-position-manager.ts
|
||||
|
||||
# Test full flow (REAL TRADE - use small size!)
|
||||
npx tsx test-full-flow.ts
|
||||
```
|
||||
|
||||
### 4. Trade
|
||||
```bash
|
||||
# Start server
|
||||
npm run dev
|
||||
|
||||
# Configure TradingView alerts → n8n webhook
|
||||
# Bot handles everything automatically!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Features
|
||||
|
||||
### Phase 1: Trade Execution ✅
|
||||
- Drift Protocol integration
|
||||
- Market order execution
|
||||
- TradingView signal normalization
|
||||
- n8n webhook endpoint
|
||||
- Risk validation API
|
||||
|
||||
### Phase 2: Autonomous Trading ✅
|
||||
- **Pyth price monitoring** (WebSocket + polling)
|
||||
- **Position manager** (tracks all trades)
|
||||
- **Automatic exits** (TP1/TP2/SL/Emergency)
|
||||
- **Dynamic SL** (breakeven + profit lock)
|
||||
- **Multi-position** support
|
||||
- **Real-time P&L** tracking
|
||||
|
||||
### Phase 3: Coming Soon 🚧
|
||||
- Database persistence (PostgreSQL/Prisma)
|
||||
- Advanced risk manager
|
||||
- Trade history & analytics
|
||||
- Enhanced notifications
|
||||
- Web dashboard
|
||||
|
||||
---
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
v4/
|
||||
├── README.md ← You are here
|
||||
├── QUICKREF_PHASE2.md ← Quick reference
|
||||
├── PHASE_2_COMPLETE.md ← Phase 2 features
|
||||
├── PHASE_2_SUMMARY.md ← Detailed summary
|
||||
├── TESTING.md ← Testing guide
|
||||
├── SETUP.md ← Setup instructions
|
||||
│
|
||||
├── config/
|
||||
│ └── trading.ts ← Trading configuration
|
||||
│
|
||||
├── lib/
|
||||
│ ├── drift/
|
||||
│ │ ├── client.ts ← Drift SDK wrapper
|
||||
│ │ └── orders.ts ← Order execution
|
||||
│ ├── pyth/
|
||||
│ │ └── price-monitor.ts ← Real-time prices
|
||||
│ └── trading/
|
||||
│ └── position-manager.ts ← Auto-exit logic
|
||||
│
|
||||
├── app/
|
||||
│ └── api/
|
||||
│ └── trading/
|
||||
│ ├── execute/
|
||||
│ │ └── route.ts ← Execute trade
|
||||
│ ├── check-risk/
|
||||
│ │ └── route.ts ← Risk validation
|
||||
│ └── positions/
|
||||
│ └── route.ts ← Query positions
|
||||
│
|
||||
└── test-*.ts ← Test scripts
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Documentation
|
||||
|
||||
| Document | Purpose |
|
||||
|----------|---------|
|
||||
| `README.md` | This overview |
|
||||
| `QUICKREF_PHASE2.md` | Quick reference card |
|
||||
| `SETUP.md` | Detailed setup instructions |
|
||||
| `TESTING.md` | Comprehensive testing guide |
|
||||
| `PHASE_2_COMPLETE.md` | Phase 2 feature overview |
|
||||
| `PHASE_2_SUMMARY.md` | Detailed Phase 2 summary |
|
||||
|
||||
**Root documentation:**
|
||||
- `../TRADING_BOT_V4_MANUAL.md` - Complete manual
|
||||
- `../QUICKSTART_V4.md` - Quick start guide
|
||||
- `../N8N_SETUP_GUIDE.md` - n8n configuration
|
||||
|
||||
---
|
||||
|
||||
## Trade Example
|
||||
|
||||
### Entry Signal
|
||||
```
|
||||
TradingView: LONG SOL @ $140.00
|
||||
Position: $1,000 (10x = $10,000)
|
||||
SL: $137.90 (-1.5%)
|
||||
TP1: $140.98 (+0.7%)
|
||||
TP2: $142.10 (+1.5%)
|
||||
```
|
||||
|
||||
### TP1 Hit
|
||||
```
|
||||
✅ Price reaches $140.98
|
||||
→ Auto-close 50% (+$70)
|
||||
→ Move SL to $140.21 (breakeven)
|
||||
→ Trade is now RISK-FREE
|
||||
```
|
||||
|
||||
### TP2 Hit
|
||||
```
|
||||
✅ Price reaches $142.10
|
||||
→ Auto-close remaining 50% (+$150)
|
||||
→ Total P&L: +$220 (+22% account)
|
||||
→ Trade complete!
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Safety Guidelines
|
||||
|
||||
1. **Start Small**: Use $10-50 positions first
|
||||
2. **Test Thoroughly**: Run all test scripts
|
||||
3. **Monitor Closely**: Watch first 10 auto-exits
|
||||
4. **Verify Fills**: Check Drift UI after exits
|
||||
5. **Scale Gradually**: Increase size weekly
|
||||
|
||||
---
|
||||
|
||||
## Resources
|
||||
|
||||
- **Drift Protocol**: https://drift.trade
|
||||
- **Drift Docs**: https://docs.drift.trade
|
||||
- **Pyth Network**: https://pyth.network
|
||||
- **Solana RPC**: https://helius.dev
|
||||
|
||||
---
|
||||
|
||||
**Ready to trade autonomously? Read `QUICKREF_PHASE2.md` to get started! 🚀**
|
||||
|
||||
*Start small, monitor closely, scale gradually!*
|
||||
Reference in New Issue
Block a user