Installationsanleitung

Voraussetzungen

• Docker Desktop (nur erforderlich bei Verwendung von Redis)
• Ein unterstütztes Exchange-Konto mit API-Schlüsseln
• Die öffentliche IP-Adresse Ihres Servers (für API-Whitelist)

Inhaltsverzeichnis

1. Bot-Konfiguration
2. API-Schlüssel-Einrichtung
3. Redis-Einrichtung
4. RedisMarketBridge
5. Bot starten
6. Fehlerbehebung
7. TradingView-Integration

1. Bot-Konfiguration

Die gesamte Konfiguration erfolgt über den Online-Konfigurator.

1. Öffnen: Konfigurator
2. MagicTradeBot auswählen
3. Konfigurieren:

Export-Einstellungen:

1. Klicken Sie auf Export All YAML
2. ZIP-Datei entpacken
3. /settings-Ordner im Projekt ersetzen

magictradebot/
├── settings/  ← ersetzen
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. API-Schlüssel-Einrichtung

🔐 Sicherheit: Verwenden Sie immer Umgebungsvariablen. Speichern Sie API-Schlüssel niemals in Konfigurationsdateien.

IP-Whitelist

curl ifconfig.me

Fügen Sie diese IP zur API-Whitelist Ihrer Exchange hinzu.

.env verwenden

BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ Fügen Sie .env zu .gitignore hinzu

3. Redis-Einrichtung (Optional)

Nur erforderlich, wenn Redis aktiviert ist.

Redis via Docker starten

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

Überprüfen

docker exec -it magictradebot-redis redis-cli ping

Erwartet: PONG

4. RedisMarketBridge

Diese Komponente speist Live-Marktdaten in Redis ein.

⚠️ Exchange + Paare + Intervalle MÜSSEN exakt mit der Bot-Konfiguration übereinstimmen

Schritte:

1. Über Konfigurator einrichten
2. YAML exportieren
3. adapters/redismarketbridge/settings ersetzen

5. Bot starten

Startreihenfolge

1. Redis starten
2. RedisMarketBridge starten
3. 2 Minuten warten
4. MagicTradeBot starten

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 Im Terminal ausführen, um Logs zu sehen

6. Fehlerbehebung

API-Fehler

• IP-Whitelist prüfen
• Berechtigungen prüfen
• Umgebungsvariablen überprüfen

Keine Marktdaten

• 2 Minuten nach Start von RedisMarketBridge warten
• Konfiguration überprüfen

Redis-Probleme

• Prüfen, ob Docker läuft
• Port 6379 geöffnet

7. TradingView Signal-Integration

MagicTradeBot unterstützt externe Signale von TradingView über Webhooks.

So funktioniert es

• TradingView sendet Alerts → Webhook
• MagicTradeBot empfängt Signale
• Der Bot führt Trades automatisch aus

Schritt 1 — Webhook im Bot aktivieren

In der Bot-Konfiguration:

• Signals → Webhook aktivieren
• Webhook-URL kopieren

Beispiel:

http://your-server:port/webhook

Schritt 2 — TradingView Alert erstellen

1. TradingView Chart öffnen
2. Indikator oder Strategie hinzufügen
3. Auf Alert klicken
4. Webhook URL aktivieren
5. Webhook-URL des Bots einfügen

Schritt 3 — Alert-Nachricht definieren

Beispiel JSON-Payload:

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

Unterstützte Aktionen

• buy
• sell
• close

Wichtige Hinweise

• Stellen Sie sicher, dass das Symbol exakt mit der Bot-Konfiguration übereinstimmt
• Richtige Timeframe-Ausrichtung verwenden
• Zuerst mit kleinen Trades testen

⚠️ Falsches Payload-Format = Signale werden ignoriert

Test

Webhook kann so simuliert werden:

curl -X POST http://your-server/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ Wenn korrekt konfiguriert, führt der Bot einen Trade aus

💡 Weitere Details finden Sie in der offiziellen TradingView-Dokumentation.