AI Trading Bot

🇩🇪 Deutsch | 🇬🇧 English

🇩🇪 Deutsch

Vollautonomer KI-Trading-Bot für Crypto, Forex und Aktien.
Unterstützt 10+ Crypto-Exchanges (Binance, Bybit, OKX, Kraken, Coinbase...) sowie Forex-Broker (IG, OANDA, Alpaca, IBKR).

Kein Exchange-Account nötig zum Starten. Der Bot beginnt im Paper-Modus — er handelt mit virtuellem Geld und zeigt dir was er getan hätte. Erst wenn du willst (und die Performance überzeugt), wechselst du zu echtem Geld.

Wo soll der Bot laufen?

Ich möchte...	Passende Installation
💻 Den Bot auf meinem Mac ausprobieren	→ Mac
🐧 Den Bot auf meinem Linux-PC ausprobieren	→ Linux
🪟 Den Bot auf meinem Windows-PC ausprobieren	→ Windows
🥧 Den Bot auf einem Raspberry Pi betreiben	→ Raspberry Pi
📦 Den Bot 24/7 auf meinem QNAP NAS laufen lassen	→ QNAP NAS
☁️ Den Bot günstig in der Cloud betreiben (Hetzner/DO)	→ Cloud/VPS
🟠 Den Bot auf AWS EC2 betreiben	→ AWS
🔵 Den Bot auf Azure betreiben	→ Azure
🛠️ Eine manuelle Strategie automatisieren (z.B. S&P 500 Di/Do)	→ Dashboard-Konfiguration

Schnellstart (Mac/Linux — ein Befehl)

bash install.sh

Der Setup-Assistent fragt Exchange, Startkapital, Risikoprofil und optionale Telegram-Alerts — dann startet der Bot automatisch.

Schnellstart (Windows)

Option A — Doppelklick (empfohlen):
Doppelklick auf install.bat im Projektordner.

Option B — PowerShell (nativ, kein WSL2 nötig):

.\install.ps1

Schnellstart (Docker / VPS / Cloud)

Empfohlen: 1-Click mit Terraform (Hetzner ~5 €/Mo, DigitalOcean ~24 $/Mo)

# 1. Server erstellen (einmalig, ~30 Sekunden)
cd terraform/hetzner
cp terraform.tfvars.example terraform.tfvars   # Token + SSH-Key eintragen
make hetzner-init && make hetzner-deploy

# 2. Bot hochladen + starten (auch für spätere Updates)
make vps-deploy VPS=root@SERVER_IP

Oder manuell (Docker Compose direkt):

cp .env.example .env && nano .env   # DOMAIN + Credentials setzen
docker compose -f docker-compose.cloud.yml up -d

Was der Bot macht

Jede Stunde (konfigurierbar):
  1. Marktdaten laden (Crypto: CCXT / Forex: Broker-API)
  2. 50+ Indikatoren + On-Chain-Daten berechnen
  3. KI-Modell analysiert Marktregime (Bull/Bear/Seitwärts/Hoch-Volatilität)
  4. ML-Konfidenz + News-Sentiment + Fear & Greed kombinieren
  5. Signal: KAUFEN / VERKAUFEN / WARTEN
  6. Bei Kauf: Stop-Loss + Take-Profit automatisch setzen (Bracket Order)
  7. Position überwachen, Trailing Stop nachziehen
  8. Telegram-Benachrichtigung bei jedem Trade

Features

Bereich	Was ist enthalten
Exchanges	10 Crypto-Exchanges via CCXT · Binance, Bybit, OKX, Kraken, Coinbase, Gate.io, KuCoin, Bitget, HTX, MEXC · Futures + Margin (TRADING_MARKET=futures\|margin)
Broker	IG, OANDA, Alpaca (Aktien + Crypto), IBKR, Capital.com
KI & ML	XGBoost + LightGBM · LSTM · RL Agent · Anomalie-Erkennung · On-Chain-Daten · Groq LLM News-Sentiment
Marktanalyse	4 Regime · Multi-Timeframe · 50+ Indikatoren · Fear & Greed · Walk-Forward Backtest (Crypto + Forex)
Risiko	ATR-Sizing · Trailing Stop · Bracket Orders (OCO) · Circuit Breaker · Black Swan Guard · Korrelations-Guard · Dynamic Leverage (automatische Hebel-Anpassung)
Strategie	7 Auto-Strategien (Regime-adaptiv) · 5 Plug-in Beispiele (MACross, RSIBB, SuperTrend, MACDCross, BBReversion) · IStrategy Interface · freqtrade-Import (auto-Adapter) · Funding Rate Arbitrage · Donchian Breakout Overlay · Kointegrations-Pair-Trading (BTC/ETH Z-Score) · Risk-Modus (Konservativ/Balanced/Aggressiv)
Execution	TWAP für Orders $10k+ · Slippage-Tracking · Venue Optimizer (Fee-aware Routing)
Multi-Bot	Signal Bus (File + Redis) · Multi-Bot Pub/Sub · N Instanzen parallel (auto-Discovery via `shared/instances/`)
Dashboard	Streamlit Web-UI · Standard/Pro-Modus · Feature-Toggles · Strategy-Selector · Marketplace · dynamische Instanz-Auswahl
Alerts	Telegram · Discord · HTTP Webhook (Grafana/PagerDuty/n8n) · 12 Steuerungsbefehle · BOT_NAME-Prefix pro Instanz
Setup	Hardware-Benchmark + Auto-Config · Setup-Wizard · `make upgrade` (Backup + DB-Migration)
Deployment	Docker · QNAP NAS · Raspberry Pi ARM · Cloud mit HTTPS · Terraform 1-Click für Hetzner (~5 €) + DigitalOcean
Steuer	FIFO Trade-Journal · DE-Format (Elster) · AT-Format · CSV-Export (`make tax-export`)
Zuverlässigkeit	Dead Man's Switch · Heartbeat · Rate-Limit-Monitoring · Live State Reconciliation

Exchange & Broker einrichten

Alle Provider werden über .env konfiguriert. Nur die Keys des gewählten Providers eintragen — der Rest bleibt leer.

Crypto-Exchanges (Crypto Bot — `EXCHANGE=...`)

Exchange	`EXCHANGE=`	Paper	Testnet	Futures/Margin	EU Futures	API-Keys
Binance	`binance`	✅	✅	✅ (bis 125×)	❌ MiCA-Sperre	binance.com/api
Bybit	`bybit`	✅	✅	✅ (bis 100×)	⚠ nur Spot	bybit.com/api
OKX	`okx`	✅ Demo	✅	✅ X-Perps 10×	✅ MiCA	okx.com/api
Kraken	`kraken`	—	—	✅ Perpetuals 10×	✅ MiFID II	kraken.com/api
Coinbase	`coinbase`	—	—	—	✅	coinbase.com/api
Gate.io	`gateio`	—	—	✅	⚠ Grauzone	gate.io/api
KuCoin	`kucoin`	—	—	✅	⚠ Grauzone	kucoin.com/api
Bitget	`bitget`	—	—	✅	⚠ Grauzone	bitget.com/api
HTX	`htx`	—	—	✅	⚠ Grauzone	htx.com/api
MEXC	`mexc`	—	—	✅	⚠ Grauzone	mexc.com/api

✅ EU = MiCA oder MiFID II lizenziert · ⚠ Grauzone = kein EU-Passport, Nutzung auf eigenes Risiko

.env pro Exchange:

Binance

EXCHANGE=binance
TRADING_MODE=paper           # paper | testnet | live

# Testnet (kostenloses virtuelles Geld — empfohlen zum Testen)
BINANCE_API_KEY_TESTNET=xxx
BINANCE_API_SECRET_TESTNET=xxx

# Live (echtes Geld — nur nach ausgiebigem Paper/Testnet-Test!)
BINANCE_API_KEY_LIVE=xxx
BINANCE_API_SECRET_LIVE=xxx

# Futures (separater Key nötig — "Enable Futures" in Binance API-Einstellungen)
# TRADING_MARKET=futures
# MARGIN_TYPE=isolated
# LEVERAGE=3

→ API erstellen: Binance → Profil → API-Verwaltung → "Restrictions": nur "Spot & Margin" (kein Withdraw!)

Bybit

EXCHANGE=bybit
TRADING_MODE=paper           # paper | testnet | live

BYBIT_API_KEY_TESTNET=xxx
BYBIT_API_SECRET_TESTNET=xxx
BYBIT_API_KEY_LIVE=xxx
BYBIT_API_SECRET_LIVE=xxx

# Futures (nicht-EU)
# TRADING_MARKET=futures
# LEVERAGE=5

→ API erstellen: Bybit → Account → API Management → "Permissions": Read + Trade (kein Withdraw!)

OKX (empfohlen für EU-Futures)

EXCHANGE=okx
TRADING_MODE=paper           # paper | live (OKX nutzt "Demo" statt Testnet)

# Demo-Konto (Simulation mit echten Marktdaten)
OKX_API_KEY_DEMO=xxx
OKX_API_SECRET_DEMO=xxx
OKX_PASSPHRASE_DEMO=xxx      # OKX braucht zusätzlich eine Passphrase

# Live
OKX_API_KEY_LIVE=xxx
OKX_API_SECRET_LIVE=xxx
OKX_PASSPHRASE_LIVE=xxx

# EU Futures (X-Perps, MiCA lizenziert, bis 10×)
# TRADING_MARKET=futures
# LEVERAGE=5
# MAX_LEVERAGE=10

→ API erstellen: OKX → Account → API → "Trade" aktivieren, Passphrase setzen

Kraken (beste Wahl für EU-Futures)

EXCHANGE=kraken
TRADING_MODE=live            # Kraken hat kein separates Testnet via CCXT

KRAKEN_API_KEY=xxx
KRAKEN_API_SECRET=xxx

# EU Perpetual Futures (MiFID II, bis 10×)
# TRADING_MARKET=futures
# LEVERAGE=5
# MAX_LEVERAGE=10
# MARGIN_TYPE=isolated

→ API erstellen: Kraken → Security → API → "Query Funds" + "Create & Modify Orders" (kein Withdraw!)

Coinbase Advanced

EXCHANGE=coinbase
TRADING_MODE=live

COINBASE_API_KEY=xxx
COINBASE_API_SECRET=xxx

→ API erstellen: Coinbase → Settings → API → "View" + "Trade" (kein Transfer!)

Gate.io / KuCoin / Bitget / HTX / MEXC

# Gate.io
EXCHANGE=gateio
GATEIO_API_KEY=xxx
GATEIO_API_SECRET=xxx

# KuCoin (braucht Passphrase)
EXCHANGE=kucoin
KUCOIN_API_KEY=xxx
KUCOIN_API_SECRET=xxx
KUCOIN_API_PASSPHRASE=xxx

# Bitget (braucht Passphrase)
EXCHANGE=bitget
BITGET_API_KEY=xxx
BITGET_API_SECRET=xxx
BITGET_API_PASSPHRASE=xxx

# HTX / Huobi
EXCHANGE=htx
HTX_API_KEY=xxx
HTX_API_SECRET=xxx

# MEXC
EXCHANGE=mexc
MEXC_API_KEY=xxx
MEXC_API_SECRET=xxx

Forex-Broker (Multi-Asset Bot — `MULTI_ASSET_BROKER=...`)

Broker	`MULTI_ASSET_BROKER=`	Demo	Hebel	Regulierung	Märkte
OANDA	`oanda`	✅	bis 30:1 (EU Retail)	FCA / BaFin	Forex, Crypto CFD
IG Group	`ig`	✅	bis 30:1 (EU Retail)	FCA / BaFin	Forex, Aktien, Crypto CFD
Capital.com	`capital`	✅	bis 30:1 (EU Retail)	CySEC / FCA	Forex, Aktien, Crypto CFD
Alpaca	`alpaca`	✅ Paper	—	SEC / FINRA	US-Aktien + Crypto (keine EU-Regulierung)
IBKR	`ibkr`	✅ Paper	variabel	MiFID II	Aktien, Futures, Forex, Crypto

.env pro Broker:

OANDA

MULTI_ASSET_BROKER=oanda
OANDA_ENV=practice           # practice | live

OANDA_API_KEY_PRACTICE=xxx
OANDA_ACCOUNT_ID_PRACTICE=xxx
OANDA_API_KEY_LIVE=xxx
OANDA_ACCOUNT_ID_LIVE=xxx

→ Demo-Konto: oanda.com → "Open Demo Account" → API-Key unter Account → Manage API Access

IG Group

MULTI_ASSET_BROKER=ig
IG_ENV=demo                  # demo | live

IG_API_KEY_DEMO=xxx
IG_USERNAME_DEMO=xxx
IG_PASSWORD_DEMO=xxx
IG_API_KEY_LIVE=xxx
IG_USERNAME_LIVE=xxx
IG_PASSWORD_LIVE=xxx
IG_ACCOUNT_ID=xxx            # optional, für mehrere Sub-Accounts

→ Demo-Konto: ig.com → "Demo-Konto eröffnen" → My Account → API → Key generieren

Capital.com

MULTI_ASSET_BROKER=capital
CAPITAL_ENV=demo             # demo | live

CAPITAL_API_KEY_DEMO=xxx
CAPITAL_EMAIL_DEMO=xxx
CAPITAL_PASSWORD_DEMO=xxx
CAPITAL_API_KEY_LIVE=xxx
CAPITAL_EMAIL_LIVE=xxx
CAPITAL_PASSWORD_LIVE=xxx

→ Demo-Konto: capital.com → "Demo ausprobieren" → Account Settings → API Access

Alpaca (US-Aktien + Crypto)

MULTI_ASSET_BROKER=alpaca

ALPACA_API_KEY=xxx
ALPACA_API_SECRET=xxx
ALPACA_BASE_URL=https://paper-api.alpaca.markets   # Paper
# ALPACA_BASE_URL=https://api.alpaca.markets       # Live

→ Account: alpaca.markets → kostenlos → Dashboard → "Generate API Key" → Hinweis: Alpaca ist US-reguliert (SEC/FINRA) — für EU-Nutzer kein EU-Broker-Schutz

Interactive Brokers

MULTI_ASSET_BROKER=ibkr
IBKR_HOST=127.0.0.1
IBKR_PORT=7497               # 7497=TWS Paper, 7496=TWS Live, 4002=IB Gateway Paper

→ IBKR verbindet sich zur lokal laufenden TWS oder IB Gateway App (kein direkter API-Key) → TWS: Datei → Globale Einstellungen → API → "Enable ActiveX and Socket Clients" aktivieren

Setup-Assistent

Beim ersten Start führt dich der Assistent durch alles:

Schritt 1: Exchange oder Broker wählen   [Binance / Bybit / OKX / Alpaca / OANDA ...]
Schritt 2: API-Key eingeben              [mit Link zur Anleitung für jeden Exchange]
Schritt 3: Handelsmodus                  [Paper (empfohlen) oder Live]
Schritt 4: Startkapital                  [virtuell oder echt]
Schritt 5: Risikoprofil                  [Konservativ / Balanced / Aggressiv]
Schritt 6: Telegram-Alerts einrichten    [optional]
→ Hardware-Benchmark läuft automatisch   [passt Feature-Flags ans System an]
→ KI-Modell wird trainiert               [~3-5 Minuten]
→ Bot startet + erste Telegram-Nachricht

Web-Dashboard aufrufen

make crypto-api       # Terminal 1 — API Backend (Port 8000)
make crypto-dashboard # Terminal 2 — Streamlit UI (Port 8501)

Dann im Browser: http://localhost:8501

Dashboard-Tabs: Übersicht · Trades · 🧠 Strategien · Logs · Features · Marketplace · System · ⚙️ Konfiguration · Hilfe
Pro-Modus zusätzlich: Performance · Strategie-Performance · Risk & Market · AI Explainability

Im Strategien-Tab (Crypto Bot): Strategie per Radio-Button wählen (Beschreibung + Parameter erscheinen direkt inline) · Risk-Modus (Konservativ/Balanced/Aggressiv) · Signal-Overlays · ML+Regime-Parameter live editieren (Tooltips: ⚠️ erfordert Retraining · ✅ sofort wirksam) · "🔄 Jetzt neu trainieren"-Button (nur aktiv wenn Timeframe / Lookahead / ML-Modell geändert; Retraining läuft auf dem Bot-Gerät, betrifft nur internal ML+Regime) · Hyperopt Loss-Funktion · Strategie importieren (3 Formate: .py nativ · .zip Bundle · .py freqtrade-Format — auto-erkannt).

Im Konfiguration-Tab (Multi-Asset Bot): Zeitplan-Strategien anlegen + bearbeiten, Broker-Credentials (Demo + Live) eintragen, Trade-History + P&L pro Strategie einsehen — ohne .env-Datei zu bearbeiten. Siehe Dashboard-Konfiguration.

Alle Befehle

make help                       # Alle Befehle mit Beschreibung
make crypto-start               # Crypto Bot lokal starten
make crypto-train               # ML-Modell trainieren
make crypto-backtest            # AI-Pipeline Backtest
make crypto-deploy              # Auf QNAP deployen
make multi-asset-start          # Multi-Asset Bot lokal starten
make multi-asset-deploy         # Multi-Asset auf QNAP deployen
make arm-build                  # Raspberry Pi ARM64 Image bauen
make arm-deploy                 # Auf Raspberry Pi deployen
make hetzner-deploy             # Hetzner Cloud Server erstellen (Terraform)
make do-deploy                  # DigitalOcean Droplet erstellen (Terraform)
make vps-deploy VPS=root@IP     # Bot-Code auf VPS hochladen + starten

Secrets & API-Keys (.env): Deploy-Befehle lesen das vorhandene .env — GPG wird nicht automatisch gefragt. Nur einmalig nach einer Änderung make gen-env-crypto / make gen-env-multi-asset ausführen (benötigt entsperrten GPG-Agent / pass).

🇩🇪 Dokumentation

Dokument	Inhalt
📖 Installationsanleitung	Schritt-für-Schritt für alle Plattformen
☁️ Cloud & VPS Deployment	AWS, Azure, Hetzner, DigitalOcean
⚙️ Konfiguration	Alle Einstellungen erklärt
📊 Dashboard	Web-Dashboard Anleitung
📱 Telegram	Push-Nachrichten & Befehle
🐳 Docker	Produktivbetrieb mit Docker
📦 QNAP NAS	Dauerbetrieb auf QNAP TS-451
🧠 Strategie	Wie der Bot Entscheidungen trifft
💱 Multi-Asset Bot	Multi-Asset Bot — OANDA, Alpaca, Wirtschaftskalender
📅 Calendar Strategy	SPY/GLD saisonale Muster — eigene Bot-Instanz
🛠️ Dashboard-Konfiguration	Strategien ohne .env anlegen — Zeitplan-Trades im Dashboard
🔧 Einrichtung	Erweiterte Einrichtungsoptionen
❓ FAQ	Häufige Fragen & Probleme

🇬🇧 English

Fully autonomous AI trading bot for Crypto, Forex and Equities.
Supports 10+ crypto exchanges (Binance, Bybit, OKX, Kraken, Coinbase...) and Forex brokers (IG, OANDA, Alpaca, IBKR).

No exchange account needed to start. The bot begins in Paper Mode — it trades with virtual money and shows you what it would have done. You only switch to real money when you're ready (and the performance looks good).

Where Should the Bot Run?

I want to...	Right installation
💻 Try the bot on my Mac	→ Mac
🐧 Try the bot on my Linux PC	→ Linux
🪟 Try the bot on my Windows PC	→ Windows
🥧 Run the bot on a Raspberry Pi	→ Raspberry Pi
📦 Run the bot 24/7 on my QNAP NAS	→ QNAP NAS
☁️ Run the bot cheaply in the cloud (Hetzner/DO)	→ Cloud/VPS
🟠 Run the bot on AWS EC2	→ AWS
🔵 Run the bot on Azure	→ Azure
🛠️ Automate a manual strategy (e.g. S&P 500 Tue/Thu)	→ Dashboard Config

Quick Start (Mac/Linux — one command)

bash install.sh

The setup wizard asks for your exchange, starting capital, risk profile, and optional Telegram alerts — then starts the bot automatically.

Quick Start (Windows)

Option A — Double-click (recommended):
Double-click install.bat in the project folder.

Option B — PowerShell (native, no WSL2 needed):

.\install.ps1

Quick Start (Docker / VPS / Cloud)

Recommended: 1-Click with Terraform (Hetzner ~€5/mo, DigitalOcean ~$24/mo)

# 1. Create server (once, ~30 seconds)
cd terraform/hetzner
cp terraform.tfvars.example terraform.tfvars   # Fill in token + SSH key
make hetzner-init && make hetzner-deploy

# 2. Upload bot + start (also for later updates)
make vps-deploy VPS=root@SERVER_IP

Or manually (Docker Compose directly):

cp .env.example .env && nano .env   # Set DOMAIN + credentials
docker compose -f docker-compose.cloud.yml up -d

How the Bot Works

Every hour (configurable):
  1. Load market data (Crypto: CCXT / Forex: Broker API)
  2. Calculate 50+ indicators + on-chain data
  3. AI model analyzes market regime (Bull/Bear/Sideways/High-Volatility)
  4. Combine ML confidence + news sentiment + Fear & Greed
  5. Signal: BUY / SELL / HOLD
  6. On buy: set stop-loss + take-profit automatically (bracket order)
  7. Monitor position, trail stop upward
  8. Telegram notification on every trade

Features

Area	What's included
Exchanges	10 Crypto exchanges via CCXT · Binance, Bybit, OKX, Kraken, Coinbase, Gate.io, KuCoin, Bitget, HTX, MEXC · Futures + Margin (TRADING_MARKET=futures\|margin)
Brokers	IG, OANDA, Alpaca (stocks + crypto), IBKR, Capital.com
AI & ML	XGBoost + LightGBM · LSTM · RL Agent · Anomaly detection · On-chain data · Groq LLM news sentiment
Market Analysis	4 Regimes · Multi-Timeframe · 50+ Indicators · Fear & Greed · Walk-Forward Backtest (Crypto + Forex)
Risk	ATR Sizing · Trailing Stop · Bracket Orders (OCO) · Circuit Breaker · Black Swan Guard · Correlation Guard · Dynamic Leverage (auto leverage adjustment)
Strategy	7 auto-strategies (regime-adaptive) · 5 plug-in examples (MACross, RSIBB, SuperTrend, MACDCross, BBReversion) · IStrategy interface · freqtrade import (auto-adapter) · Funding Rate Arbitrage · Donchian Breakout Overlay · Cointegration Pair Trading (BTC/ETH Z-Score) · Risk mode (Conservative/Balanced/Aggressive)
Execution	TWAP for orders $10k+ · Slippage tracking · Venue Optimizer (fee-aware routing)
Multi-Bot	Signal Bus (File + Redis) · Pub/Sub · N instances in parallel (auto-discovery via `shared/instances/`)
Dashboard	Streamlit Web UI · Standard/Pro mode · Feature toggles · Strategy selector · Marketplace · dynamic instance selector
Alerts	Telegram · Discord · HTTP Webhook (Grafana/PagerDuty/n8n) · 12 control commands · BOT_NAME prefix per instance
Setup	Hardware benchmark + auto-config · Setup wizard · `make upgrade` (backup + DB migration)
Deployment	Docker · QNAP NAS · Raspberry Pi ARM · Cloud with HTTPS · Terraform 1-Click for Hetzner (~€5) + DigitalOcean
Tax	FIFO Trade Journal · German format (Elster) · Austrian format · CSV export (`make tax-export`)
Reliability	Dead Man's Switch · Heartbeat · Rate-limit monitoring · Live State Reconciliation

Exchange & Broker Setup

All providers are configured via .env. Only fill in the keys for your chosen provider — leave the rest empty.

Crypto Exchanges (Crypto Bot — `EXCHANGE=...`)

Exchange	`EXCHANGE=`	Paper	Testnet	Futures/Margin	EU Futures	API Keys
Binance	`binance`	✅	✅	✅ (up to 125×)	❌ MiCA ban	binance.com/api
Bybit	`bybit`	✅	✅	✅ (up to 100×)	⚠ spot only	bybit.com/api
OKX	`okx`	✅ Demo	✅	✅ X-Perps 10×	✅ MiCA	okx.com/api
Kraken	`kraken`	—	—	✅ Perpetuals 10×	✅ MiFID II	kraken.com/api
Coinbase	`coinbase`	—	—	—	✅	coinbase.com/api
Gate.io	`gateio`	—	—	✅	⚠ gray zone	gate.io/api
KuCoin	`kucoin`	—	—	✅	⚠ gray zone	kucoin.com/api
Bitget	`bitget`	—	—	✅	⚠ gray zone	bitget.com/api
HTX	`htx`	—	—	✅	⚠ gray zone	htx.com/api
MEXC	`mexc`	—	—	✅	⚠ gray zone	mexc.com/api

✅ EU = MiCA or MiFID II licensed · ⚠ gray zone = no EU passport, use at your own risk

.env per exchange:

Binance

EXCHANGE=binance
TRADING_MODE=paper           # paper | testnet | live

# Testnet (free virtual money — recommended for testing)
BINANCE_API_KEY_TESTNET=xxx
BINANCE_API_SECRET_TESTNET=xxx

# Live (real money — only after thorough paper/testnet testing!)
BINANCE_API_KEY_LIVE=xxx
BINANCE_API_SECRET_LIVE=xxx

# Futures (separate key needed — enable "Futures" in Binance API settings)
# TRADING_MARKET=futures
# MARGIN_TYPE=isolated
# LEVERAGE=3

→ Create API: Binance → Profile → API Management → Restrictions: "Spot & Margin" only (no Withdraw!)

Bybit

EXCHANGE=bybit
TRADING_MODE=paper           # paper | testnet | live

BYBIT_API_KEY_TESTNET=xxx
BYBIT_API_SECRET_TESTNET=xxx
BYBIT_API_KEY_LIVE=xxx
BYBIT_API_SECRET_LIVE=xxx

# Futures (non-EU)
# TRADING_MARKET=futures
# LEVERAGE=5

→ Create API: Bybit → Account → API Management → Permissions: Read + Trade (no Withdraw!)

OKX (recommended for EU futures)

EXCHANGE=okx
TRADING_MODE=paper           # paper | live (OKX uses "Demo" instead of Testnet)

# Demo account (simulation with real market data)
OKX_API_KEY_DEMO=xxx
OKX_API_SECRET_DEMO=xxx
OKX_PASSPHRASE_DEMO=xxx      # OKX requires an additional passphrase

# Live
OKX_API_KEY_LIVE=xxx
OKX_API_SECRET_LIVE=xxx
OKX_PASSPHRASE_LIVE=xxx

# EU Futures (X-Perps, MiCA licensed, up to 10×)
# TRADING_MARKET=futures
# LEVERAGE=5
# MAX_LEVERAGE=10

→ Create API: OKX → Account → API → enable "Trade", set passphrase

Kraken (best choice for EU futures)

EXCHANGE=kraken
TRADING_MODE=live            # Kraken has no separate testnet via CCXT

KRAKEN_API_KEY=xxx
KRAKEN_API_SECRET=xxx

# EU Perpetual Futures (MiFID II, up to 10×)
# TRADING_MARKET=futures
# LEVERAGE=5
# MAX_LEVERAGE=10
# MARGIN_TYPE=isolated

→ Create API: Kraken → Security → API → "Query Funds" + "Create & Modify Orders" (no Withdraw!)

Coinbase Advanced

EXCHANGE=coinbase
TRADING_MODE=live

COINBASE_API_KEY=xxx
COINBASE_API_SECRET=xxx

→ Create API: Coinbase → Settings → API → "View" + "Trade" (no Transfer!)

Gate.io / KuCoin / Bitget / HTX / MEXC

# Gate.io
EXCHANGE=gateio
GATEIO_API_KEY=xxx
GATEIO_API_SECRET=xxx

# KuCoin (requires passphrase)
EXCHANGE=kucoin
KUCOIN_API_KEY=xxx
KUCOIN_API_SECRET=xxx
KUCOIN_API_PASSPHRASE=xxx

# Bitget (requires passphrase)
EXCHANGE=bitget
BITGET_API_KEY=xxx
BITGET_API_SECRET=xxx
BITGET_API_PASSPHRASE=xxx

# HTX / Huobi
EXCHANGE=htx
HTX_API_KEY=xxx
HTX_API_SECRET=xxx

# MEXC
EXCHANGE=mexc
MEXC_API_KEY=xxx
MEXC_API_SECRET=xxx

Forex Brokers (Multi-Asset Bot — `MULTI_ASSET_BROKER=...`)

Broker	`MULTI_ASSET_BROKER=`	Demo	Leverage	Regulation	Markets
OANDA	`oanda`	✅	up to 30:1 (EU retail)	FCA / BaFin	Forex, Crypto CFD
IG Group	`ig`	✅	up to 30:1 (EU retail)	FCA / BaFin	Forex, Stocks, Crypto CFD
Capital.com	`capital`	✅	up to 30:1 (EU retail)	CySEC / FCA	Forex, Stocks, Crypto CFD
Alpaca	`alpaca`	✅ Paper	—	SEC / FINRA	US stocks + Crypto (no EU regulation)
IBKR	`ibkr`	✅ Paper	variable	MiFID II	Stocks, Futures, Forex, Crypto

.env per broker:

OANDA

MULTI_ASSET_BROKER=oanda
OANDA_ENV=practice           # practice | live

OANDA_API_KEY_PRACTICE=xxx
OANDA_ACCOUNT_ID_PRACTICE=xxx
OANDA_API_KEY_LIVE=xxx
OANDA_ACCOUNT_ID_LIVE=xxx

→ Demo account: oanda.com → "Open Demo Account" → API key under Account → Manage API Access

IG Group

MULTI_ASSET_BROKER=ig
IG_ENV=demo                  # demo | live

IG_API_KEY_DEMO=xxx
IG_USERNAME_DEMO=xxx
IG_PASSWORD_DEMO=xxx
IG_API_KEY_LIVE=xxx
IG_USERNAME_LIVE=xxx
IG_PASSWORD_LIVE=xxx
IG_ACCOUNT_ID=xxx            # optional, for multiple sub-accounts

→ Demo account: ig.com → "Open Demo Account" → My Account → API → Generate key

Capital.com

MULTI_ASSET_BROKER=capital
CAPITAL_ENV=demo             # demo | live

CAPITAL_API_KEY_DEMO=xxx
CAPITAL_EMAIL_DEMO=xxx
CAPITAL_PASSWORD_DEMO=xxx
CAPITAL_API_KEY_LIVE=xxx
CAPITAL_EMAIL_LIVE=xxx
CAPITAL_PASSWORD_LIVE=xxx

→ Demo account: capital.com → "Try demo" → Account Settings → API Access

Alpaca (US stocks + crypto)

MULTI_ASSET_BROKER=alpaca

ALPACA_API_KEY=xxx
ALPACA_API_SECRET=xxx
ALPACA_BASE_URL=https://paper-api.alpaca.markets   # Paper
# ALPACA_BASE_URL=https://api.alpaca.markets       # Live

→ Account: alpaca.markets → free → Dashboard → "Generate API Key" → Note: Alpaca is US-regulated (SEC/FINRA) — no EU broker protection for EU users

Interactive Brokers

MULTI_ASSET_BROKER=ibkr
IBKR_HOST=127.0.0.1
IBKR_PORT=7497               # 7497=TWS Paper, 7496=TWS Live, 4002=IB Gateway Paper

→ IBKR connects to the locally running TWS or IB Gateway app (no direct API key) → TWS: File → Global Configuration → API → enable "Enable ActiveX and Socket Clients"

Setup Wizard

On first start, the wizard guides you through everything:

Step 1: Choose exchange or broker   [Binance / Bybit / OKX / Alpaca / OANDA ...]
Step 2: Enter API key               [with link to guide for each exchange]
Step 3: Trading mode                [Paper (recommended) or Live]
Step 4: Starting capital            [virtual or real]
Step 5: Risk profile                [Conservative / Balanced / Aggressive]
Step 6: Set up Telegram alerts      [optional]
→ Hardware benchmark runs auto      [adjusts feature flags to your hardware]
→ AI model is trained               [~3-5 minutes]
→ Bot starts + first Telegram msg

Open the Web Dashboard

make crypto-api       # Terminal 1 — API backend (port 8000)
make crypto-dashboard # Terminal 2 — Streamlit UI (port 8501)

Then in browser: http://localhost:8501

Dashboard tabs: Overview · Trades · 🧠 Strategies · Logs · Features · Marketplace · System · ⚙️ Config · Help
Pro mode adds: Performance · Strategy Performance · Risk & Market · AI Explainability

The Strategies tab (Crypto Bot): select strategy via radio buttons (description + parameters appear inline) · risk mode (Conservative/Balanced/Aggressive) · signal overlays · live-edit ML+Regime parameters (tooltips: ⚠️ requires retraining · ✅ takes effect immediately) · "🔄 Retrain now" button (active only when Timeframe / Lookahead / ML Model was changed; retraining runs on the bot's host device, affects internal ML+Regime only) · Hyperopt loss function · import strategy (3 formats: .py native · .zip bundle · .py freqtrade format — auto-detected).

The Config tab (Multi-Asset Bot): create and edit schedule strategies, enter broker credentials (demo + live), view trade history and P&L per strategy — all without editing .env. See Dashboard Config.

All Commands

make help                       # All commands with description
make crypto-start               # Start Crypto bot locally
make crypto-train               # Train ML model
make crypto-backtest            # AI-pipeline backtest
make crypto-deploy              # Deploy to QNAP
make multi-asset-start          # Start Multi-Asset bot locally
make multi-asset-deploy         # Deploy Multi-Asset to QNAP
make arm-build                  # Build Raspberry Pi ARM64 image
make arm-deploy                 # Deploy to Raspberry Pi
make hetzner-deploy             # Create Hetzner Cloud server (Terraform)
make do-deploy                  # Create DigitalOcean droplet (Terraform)
make vps-deploy VPS=root@IP     # Upload bot code to VPS + start containers

Secrets & API keys (.env): Deploy commands use the existing .env — GPG is not prompted automatically. Only run make gen-env-crypto / make gen-env-multi-asset once after changing secrets or API keys (requires unlocked GPG agent / pass).

🇬🇧 Documentation

Document	Content
📖 Installation Guide	Step-by-step for all platforms
☁️ Cloud & VPS Deployment	AWS, Azure, Hetzner, DigitalOcean
⚙️ Configuration	All settings explained
📊 Dashboard	Web dashboard guide
📱 Telegram	Push notifications & commands
🐳 Docker	Production deployment with Docker
📦 QNAP NAS	24/7 operation on QNAP TS-451
🧠 Strategy	How the bot makes decisions
💱 Multi-Asset Bot	Forex bot — OANDA, Alpaca, economic calendar
📅 Calendar Strategy	SPY/GLD seasonal patterns — dedicated bot instance
🛠️ Dashboard Config	Set up strategies without .env — schedule trades in the dashboard
🔧 Setup	Advanced setup options
❓ FAQ	Common questions & troubleshooting

Name		Name	Last commit message	Last commit date
Latest commit History 54 Commits
.github		.github
crypto_bot		crypto_bot
docs		docs
multi_asset_bot		multi_asset_bot
scripts		scripts
shared/instances		shared/instances
strategies		strategies
terraform		terraform
.env.example		.env.example
.env.template		.env.template
.gitignore		.gitignore
Dockerfile		Dockerfile
Dockerfile.arm		Dockerfile.arm
Dockerfile.qnap		Dockerfile.qnap
Dockerfile.streamlit		Dockerfile.streamlit
LICENSE		LICENSE
Makefile		Makefile
README.de.md		README.de.md
README.md		README.md
crypto_bot.png		crypto_bot.png
deploy-crypto.sh		deploy-crypto.sh
deploy-image.sh		deploy-image.sh
deploy-multi-asset.sh		deploy-multi-asset.sh
deploy-qnap.sh		deploy-qnap.sh
deploy-vps.sh		deploy-vps.sh
docker-compose.cloud.yml		docker-compose.cloud.yml
docker-compose.qnap.yml		docker-compose.qnap.yml
docker-compose.yml		docker-compose.yml
gld_trades.csv		gld_trades.csv
install.bat		install.bat
install.ps1		install.ps1
install.sh		install.sh
launch.py		launch.py
requirements.qnap.txt		requirements.qnap.txt
requirements.txt		requirements.txt
spy_trades.csv		spy_trades.csv
start_bot.vbs		start_bot.vbs
stop_bot.bat		stop_bot.bat

Folders and files

Latest commit

History

Repository files navigation

AI Trading Bot

🇩🇪 Deutsch

Wo soll der Bot laufen?

Schnellstart (Mac/Linux — ein Befehl)

Schnellstart (Windows)

Schnellstart (Docker / VPS / Cloud)

Was der Bot macht

Features

Exchange & Broker einrichten

Crypto-Exchanges (Crypto Bot — EXCHANGE=...)

Forex-Broker (Multi-Asset Bot — MULTI_ASSET_BROKER=...)

Setup-Assistent

Web-Dashboard aufrufen

Alle Befehle

🇩🇪 Dokumentation

🇬🇧 English

Where Should the Bot Run?

Quick Start (Mac/Linux — one command)

Quick Start (Windows)

Quick Start (Docker / VPS / Cloud)

How the Bot Works

Features

Exchange & Broker Setup

Crypto Exchanges (Crypto Bot — EXCHANGE=...)

Forex Brokers (Multi-Asset Bot — MULTI_ASSET_BROKER=...)

Setup Wizard

Open the Web Dashboard

All Commands

🇬🇧 Documentation

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Crypto-Exchanges (Crypto Bot — `EXCHANGE=...`)

Forex-Broker (Multi-Asset Bot — `MULTI_ASSET_BROKER=...`)

Crypto Exchanges (Crypto Bot — `EXCHANGE=...`)

Forex Brokers (Multi-Asset Bot — `MULTI_ASSET_BROKER=...`)

Packages