trading_bot_v3/v4

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

# From project root
./install-phase2.sh

2. Configure

# 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

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

# 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!