feat: Complete Trading Bot v4 with Drift Protocol integration
Features: - Autonomous trading system with Drift Protocol on Solana - Real-time position monitoring with Pyth price feeds - Dynamic stop-loss and take-profit management - n8n workflow integration for TradingView signals - Beautiful web UI for settings management - REST API for trade execution and monitoring - Next.js 15 with standalone output mode - TypeScript with strict typing - Docker containerization with multi-stage builds - PostgreSQL database for trade history - Singleton pattern for Drift client connection pooling - BN.js for BigNumber handling (Drift SDK requirement) - Configurable stop-loss and take-profit levels - Breakeven trigger and profit locking - Daily loss limits and trade cooldowns - Slippage tolerance controls - DRY_RUN mode for safe testing - Real-time risk calculator - Interactive sliders for all parameters - Live preview of trade outcomes - Position sizing and leverage controls - Beautiful gradient design with Tailwind CSS - POST /api/trading/execute - Execute trades - POST /api/trading/close - Close positions - GET /api/trading/positions - Monitor active trades - GET /api/trading/check-risk - Validate trade signals - GET /api/settings - View configuration - POST /api/settings - Update configuration - Fixed Borsh serialization errors (simplified order params) - Resolved RPC rate limiting with singleton pattern - Fixed BigInt vs BN type mismatches - Corrected order execution flow - Improved position state management - Complete setup guides - Docker deployment instructions - n8n workflow configuration - API reference documentation - Risk management guidelines - Runs on port 3001 (external), 3000 (internal) - Uses Helius RPC for optimal performance - Production-ready with error handling - Health monitoring and logging
This commit is contained in:
mindesbunister
196
README.md
Normal file
196
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