1345a35680
- 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
197 lines
4.7 KiB
Markdown
197 lines
4.7 KiB
Markdown
# 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!*
|