trading_bot_v4/N8N_WORKFLOW_SETUP.md

# n8n Trading Bot v4 Workflow - Setup Instructions

## Step 1: Create API Credential in n8n

1. Go to n8n → **Credentials** → **New Credential**
2. Search for **"Header Auth"**
3. Configure:
   - **Name**: `Trading Bot API Key`
   - **Name** (field): `Authorization`
   - **Value**: `Bearer 2a344f0149442c857fb56c038c0c7d1b113883b830bec792c76f1e0efa15d6bb`
4. Click **Save**

## Step 2: Update Your Telegram Credential

Make sure your Telegram Bot credential exists in n8n:
- **Credential Name**: `Telegram Bot`
- **Chat ID**: `579304651` (or change in workflow to your ID)

## Step 3: Import the Workflow

1. Download: `/home/icke/traderv4/n8n-complete-workflow.json`
2. Go to n8n → **Workflows** → **Import from File**
3. Select the downloaded JSON file
4. Click **Import**

## Step 4: Configure Credentials

After importing, update the credential references:

### For "Check Risk" and "Execute Trade" nodes:
- Click on the node
- Under **Authentication** → **Credential for Header Auth**
- Select: `Trading Bot API Key` (the one you created in Step 1)

### For all Telegram nodes:
- Click on each Telegram node
- Under **Credential for Telegram API**
- Select your Telegram Bot credential

## Step 5: Test the Webhook

1. **Activate** the workflow
2. Get the webhook URL (shown in the Webhook node)
3. Test with curl:

```bash
curl -X POST "https://your-n8n-instance.com/webhook/tradingview-bot-v4" \\
  -H "Content-Type: application/json" \\
  -d '{"body": "Buy SOL | Entry: 140.50"}'
```

## Workflow Flow

```
TradingView Alert
       ↓
[Webhook] Receives signal
       ↓
[Parse Signal] Extracts data (symbol, direction, timeframe)
       ↓
[Check Risk] Validates trade (API call)
       ↓
[Risk Passed?] Decision
       ↓                    ↓
   YES                    NO
       ↓                    ↓
[Execute Trade]    [Risk Blocked Message]
       ↓
[Trade Success?] Decision
       ↓                ↓
   SUCCESS         FAILED
       ↓                ↓
[Success Msg]    [Error Msg]
```

## Expected Telegram Notifications

### Success Message:
```
🟢 TRADE OPENED SUCCESSFULLY

Buy SOL | Entry: 140.50

📊 Symbol: SOL-PERP
📈 Direction: LONG
💰 Entry: $140.5000
💵 Size: $500.00
⚡ Leverage: 10x

🎯 Take Profit:
   TP1: $141.48 (+0.7%)
   TP2: $142.63 (+1.5%)

🛑 Stop Loss:
   SL: $138.39 (-1.5%)

📊 Slippage: 0.023%
⏰ 14:32

✅ Position monitored automatically
🤖 Auto-exit at TP/SL levels
```

### Risk Blocked Message:
```
⚠️ TRADE BLOCKED - RISK LIMITS

Buy SOL | Entry: 140.50

📊 Symbol: SOL-PERP
📈 Direction: LONG

🛑 Reason: Daily drawdown limit reached
📝 Details: Check risk management settings

⏰ 14:32

✅ Trade will be allowed when conditions improve
```

### Error Message:
```
🔴 TRADE EXECUTION FAILED

Buy SOL | Entry: 140.50

📊 Symbol: SOL-PERP
📈 Direction: LONG

❌ Error: Drift wallet not configured

⏰ 14:32

⚠️ Check bot logs:
docker logs trading-bot-v4 --tail=50
```

## TradingView Alert Format

Your TradingView alerts should send data in this format:

**Simple format (recommended):**
```
Buy SOL | Entry: 140.50
```
or
```
Sell BTC | Entry: 67890.00
```

The workflow will automatically detect:
- **Symbol**: SOL, BTC, ETH (defaults to SOL if not found)
- **Direction**: Buy/Long → long, Sell/Short → short
- **Timeframe**: Fixed at 5 minutes

## API Endpoints Used

1. **Risk Check**: `http://10.0.0.48:3001/api/trading/check-risk`
   - Method: POST
   - Body: `{"symbol": "SOL-PERP", "direction": "long"}`

2. **Execute Trade**: `http://10.0.0.48:3001/api/trading/execute`
   - Method: POST
   - Body: `{"symbol": "SOL-PERP", "direction": "long", "timeframe": "5", "signalStrength": "strong"}`

## Troubleshooting

### "Connection refused" error:
- Check if trading bot is running: `docker ps | grep trading-bot`
- Verify the bot is accessible: `curl http://10.0.0.48:3001/api/trading/positions`

### "Unauthorized" error:
- Check API key credential is set correctly
- Verify the Bearer token format: `Bearer <your-api-key>`

### Telegram not sending:
- Verify your Telegram bot token is valid
- Check chat ID is correct (must be a number)
- Test Telegram node independently

### No response from webhook:
- Make sure workflow is **activated**
- Check webhook path matches your TradingView alert
- Verify n8n is accessible from TradingView

## Quick Commands

```bash
# Check bot status
docker ps | grep trading-bot

# View bot logs
docker logs trading-bot-v4 --tail=50 -f

# Test API directly
curl -X POST http://10.0.0.48:3001/api/trading/check-risk \\
  -H "Authorization: Bearer 2a344f0149442c857fb56c038c0c7d1b113883b830bec792c76f1e0efa15d6bb" \\
  -H "Content-Type: application/json" \\
  -d '{"symbol":"SOL-PERP","direction":"long"}'

# Check active positions
curl http://localhost:3001/api/trading/positions \\
  -H "Authorization: Bearer 2a344f0149442c857fb56c038c0c7d1b113883b830bec792c76f1e0efa15d6bb"
```

## Next Steps

1. ✅ Import workflow
2. ✅ Configure credentials
3. ✅ Activate workflow
4. ⚠️ Configure Drift wallet in trading bot (see main README.md)
5. 🚀 Set up TradingView alerts
6. 💰 Start trading!