Freqtrade Anleitung Krypto-Bot aufsetzen und ehrlich testen.

Eine Freqtrade Anleitung beginnt nicht mit der Strategie, sondern mit der Prüfkette: Docker-Installation, Dry-Run als Standard, Backtest mit lookahead-analysis, Hyperopt nur mit zurückgehaltenem Prüfzeitraum und erst dann ein kleiner Live-Start. Freqtrade ist ein kostenloser, quelloffener Krypto-Bot in Python, der all diese Schritte mitbringt, Stand Oktober 2026 in Version 2026.9 vom 29.09.2026. Er nimmt Ihnen Programmierarbeit ab, aber nicht das Risiko. Dieser Leitfaden zeigt, wie Sie den Bot aufsetzen, wie Sie typische Testfehler wie Look-ahead-Bias und Überanpassung erkennen, wie Sie ihn auf einem Server absichern und wo die Grenzen liegen, vom Totalverlustrisiko bis zur Börsenwahl unter MiCA. Er richtet sich an private Trader ebenso wie an Unternehmen, die Krypto-Handel automatisieren wollen. Strategieempfehlungen oder Renditeaussagen finden Sie hier bewusst nicht.

Hinweis: Dieser Beitrag gibt den Rechts- und Steuerstand zum unten angegebenen Datum allgemein wieder. Er ist keine Rechts- oder Steuerberatung und ersetzt nicht die Prüfung Ihres Einzelfalls durch eine Rechtsanwältin, einen Rechtsanwalt, eine Steuerberaterin oder einen Steuerberater. Alle Angaben ohne Gewähr für Vollständigkeit und Aktualität.

Was ist Freqtrade und für wen eignet es sich?

Freqtrade ist ein quelloffener Krypto-Trading-Bot in Python. Das Projekt deckt die ganze Kette ab: historische Kursdaten laden, Strategien als Python-Klasse schreiben, im Backtest prüfen, Parameter per Hyperopt optimieren, im Dry-Run simulieren und schließlich live an einer Börse handeln. Gesteuert wird der Bot über Telegram oder die Weboberfläche FreqUI. Mit FreqAI gibt es zusätzlich ein Modul für Machine-Learning-Modelle. Die Software ist kostenlos; Sie bezahlen mit Zeit, einem Server und dem Risiko, das Sie mit echtem Geld eingehen.

Technisch sitzt Freqtrade auf CCXT, einer Bibliothek, die die Programmierschnittstellen (APIs) von über 100 Börsen vereinheitlicht. Freqtrade selbst testet aber nur einen Teil davon. Die Dokumentation nennt für den Spot-Handel unter anderem Binance, BingX, Bitget, Bybit, Gate, HTX, Hyperliquid, Kraken und OKX, für Futures eine kürzere Liste. Die Liste ändert sich: Mit Version 2026.8 wurde etwa die Unterstützung für Bitmart entfernt, weil die Börse den Betrieb eingestellt hatte.

Freqtrade passt zu Ihnen, wenn Sie Python lesen und anpassen können, mit der Kommandozeile und Docker zurechtkommen und bereit sind, Wochen in Tests zu stecken, bevor echtes Geld fließt. Das gilt für private Trader genauso wie für kleine Teams in Unternehmen, die regelbasierte Krypto-Strategien automatisieren wollen. Wer eine fertige Gewinnmaschine sucht, ist falsch: Die Entwickler schreiben selbst, die Software sei „for educational purposes only“, und warnen davor, Geld einzusetzen, dessen Verlust man fürchtet.

Wie wird Freqtrade mit Docker installiert?

Die Dokumentation empfiehlt Docker als Standardweg. Der Vorteil: Python-Version, TA-Lib und alle Abhängigkeiten stecken im Container, und ein Update ist ein einziger Befehl. Wer ohne Docker installiert, braucht Python 3.11 oder neuer, git, TA-Lib und eine virtuelle Umgebung. Als Mindestausstattung empfiehlt das Projekt einen Linux-Cloud-Server mit 2 GB RAM, 1 GB Speicherplatz und zwei virtuellen CPU-Kernen; für Hyperopt über lange Zeiträume darf es mehr sein. Die Einrichtung laut Docker-Quickstart:

mkdir ft_userdata
cd ft_userdata/
curl https://raw.githubusercontent.com/freqtrade/freqtrade/stable/docker-compose.yml -o docker-compose.yml
docker compose pull
docker compose run --rm freqtrade create-userdir --userdir user_data
docker compose run --rm freqtrade new-config --config user_data/config.json
docker compose up -d

Danach liegen im Ordner user_data die Konfiguration config.json, das Verzeichnis strategies/ für Ihre Strategien, die Logdatei und die SQLite-Datenbank mit allen Trades. new-config fragt interaktiv unter anderem Dry-Run, Handelswährung, Einsatz pro Trade, max_open_trades, Zeiteinheit, Börse und Telegram ab. Welche Strategie der Bot handelt, steht im Abschnitt command der docker-compose.yml; voreingestellt ist die reine Demo-Strategie SampleStrategy. Alle Befehle, die nicht dauerhaft handeln sollen, also Daten laden, Backtests oder Analysen, starten Sie mit docker compose run --rm, damit der Container danach wieder verschwindet.

Drei Einstellungen sollten Sie in der ersten Konfiguration bewusst setzen statt sie zu übernehmen:

• max_open_trades: wie viele Positionen gleichzeitig offen sein dürfen. Pro Handelspaar ist ohnehin nur ein offener Trade möglich. Der Wert -1 hebt die Grenze auf; das ist für den Anfang keine gute Idee.
• stake_amount und tradable_balance_ratio: der Einsatz pro Trade und der Anteil des Kontos, den der Bot überhaupt bewegen darf (Standard 0,99). Beides begrenzt den Schaden, wenn etwas schiefgeht.
• Zugangsdaten getrennt: Die Doku empfiehlt eine zweite Datei, etwa config-private.json, mit API-Key, Secret und Telegram-Token. Sie wird zusätzlich per zweitem --config oder über add_config_files geladen. Alternativ lassen sich Werte über Umgebungsvariablen mit dem Präfix FREQTRADE__ setzen. So landen Schlüssel nicht versehentlich in einem Repository oder Screenshot.

Dry-Run: warum der Bot zuerst nur simuliert.

Freqtrade startet ab Werk im Dry-Run: dry_run steht standardmäßig auf true. Der Bot verbindet sich mit der echten Börse, liest echte Kurse und trifft echte Entscheidungen, platziert aber keine Orders, sondern führt Buch über ein simuliertes Guthaben (dry_run_wallet, Standard 1.000 Einheiten der Handelswährung). Laut Doku ist ein API-Key im Dry-Run optional, weil nur lesende Abfragen an die Börse gehen.

Der Dry-Run ist kein lästiges Pflichtprogramm, sondern der erste Test unter Live-Bedingungen. Er zeigt, was ein Backtest nicht zeigen kann: ob die Strategie mit unvollständigen Kerzen, Verbindungsabbrüchen, Ratenlimits und dem Takt der Börse zurechtkommt. Die Freqtrade-Doku formuliert es deutlich: Backtesting ersetze niemals einen Dry-Run. Ein typischer Prüfpunkt: Weichen Einstiege im Dry-Run systematisch von denen ab, die ein Backtest über denselben Zeitraum liefert, steckt oft ein Look-ahead-Fehler oder eine unrealistische Annahme im Code.

Lassen Sie den Dry-Run lange genug laufen, um unterschiedliche Marktphasen zu sehen, und protokollieren Sie die Abweichungen. Wenn Sie danach live gehen, empfiehlt die Dokumentation eine neue, separate Datenbank, damit simulierte Trades nicht mit echten vermischt werden. Im Docker-Setup ist der Datenbankpfad (--db-url) in der docker-compose.yml fest eingetragen; ändern Sie ihn vor dem Wechsel bewusst. Beginnen Sie live mit einem bewusst kleinen Einsatz; der Wechsel von dry_run: true auf false ist technisch eine Zeile, praktisch der wichtigste Schritt des ganzen Projekts.

Backtesting und lookahead-analysis: Look-ahead-Fehler finden.

Für Backtests laden Sie zuerst Daten mit download-data und starten dann backtesting mit Strategie, Zeitraum (--timerange) und Zeiteinheit. Wichtig ist, die Annahmen des Backtesters zu kennen. Laut Dokumentation erfolgen Einstiege zum Eröffnungskurs der Kerze, Orders werden ohne Slippage zum gewünschten Preis gefüllt, solange er innerhalb von Hoch und Tief der Kerze liegt, und Stopps werden exakt zum Stoppkurs ausgeführt, auch wenn das Tief darunter lag. In schnellen Krypto-Märkten ist das optimistisch. Mit --timeframe-detail simuliert Freqtrade Bewegungen innerhalb einer Kerze auf einer feineren Zeiteinheit, etwa 5-Minuten-Daten unter einer 1-Stunden-Strategie. Das kostet Rechenzeit, deckt aber Strategien auf, die von den Vereinfachungen leben.

Der gefährlichste Fehler heißt Look-ahead-Bias: Die Strategie nutzt im Backtest Informationen, die zum Entscheidungszeitpunkt noch nicht bekannt waren, etwa den Schlusskurs der laufenden Kerze, ein über den gesamten Datensatz berechnetes Maximum oder ein nach vorn verschobenes Signal. Das Ergebnis sieht hervorragend aus und ist wertlos. Freqtrade bringt dafür den Befehl lookahead-analysis mit:

docker compose run --rm freqtrade lookahead-analysis \
  --config user_data/config.json \
  --strategy MeineStrategie --timerange 20250101-20260101

Das Werkzeug rechnet zuerst einen Basis-Backtest und danach für die gefundenen Einstiegs- und Ausstiegssignale (standardmäßig 20) je einen eigenen Backtest auf Daten, die beim Signal enden. Unterscheiden sich Indikatorwerte oder Signale zwischen beiden Varianten, meldet es die betroffenen Signale und Indikatoren. Dabei erzwingt es Marktorders, einen festen Einsatz und deaktivierte Schutzmechanismen, um Fehlalarme zu vermeiden. Die wichtigste Einschränkung: Geprüft werden nur Signale, die im Testzeitraum tatsächlich ausgelöst wurden. Ein fehlerhaftes Signal, das nie feuert, bleibt unentdeckt. Ergänzend prüft recursive-analysis, ob rekursive Indikatoren wie exponentielle Durchschnitte je nach Zahl der Vorlaufkerzen (startup_candle_count) unterschiedliche Werte liefern; auch das verfälscht den Vergleich von Backtest und Live-Betrieb. Grundlagen zu weiteren Verzerrungen wie Survivorship oder Selection Bias finden Sie im Artikel zur Bias-Korrektur in Backtests.

Hyperopt ohne Überanpassung: die Prüfung auf ungesehenen Daten.

Hyperopt sucht automatisch nach Parameterwerten, etwa Indikatorlängen, Schwellen, Stoploss oder ROI-Tabelle, indem es viele Backtests mit wechselnden Werten rechnet. Intern nutzt Freqtrade dafür die Bibliothek Optuna; welche Kombination als „gut“ gilt, entscheidet eine Verlustfunktion wie SharpeHyperOptLossDaily, SortinoHyperOptLoss, CalmarHyperOptLoss oder MaxDrawDownHyperOptLoss. Die Doku warnt selbst: Präziser als drei Nachkommastellen zu optimieren, führe in der Regel zu überangepassten Ergebnissen. Seit Version 2026.8 gibt Hyperopt zudem eine Warnung aus, wenn Optimierungsparameter in populate_indicators verwendet werden.

Das Grundproblem bleibt: Hyperopt findet immer eine Kombination, die in der Vergangenheit gut aussieht. Je mehr Parameter und Durchläufe, desto sicherer passt sich das Ergebnis an Zufallsmuster an (Überanpassung, englisch Overfitting). Schützen können Sie sich nur mit Daten, die die Optimierung nie gesehen hat. Wenn ich Trading-Systeme entwickle, trenne ich deshalb vor der ersten Optimierung einen Zeitraum ab, der erst ganz am Ende angefasst wird. Typisches Beispiel für die Aufteilung:

# Optimierung nur auf dem Trainingszeitraum
docker compose run --rm freqtrade hyperopt --config user_data/config.json \
  --strategy MeineStrategie --hyperopt-loss SharpeHyperOptLossDaily \
  --spaces buy sell -e 500 --timerange 20230101-20250630

# Einmalige Prüfung auf dem zurückgehaltenen Zeitraum
docker compose run --rm freqtrade backtesting --config user_data/config.json \
  --strategy MeineStrategie --timerange 20250701-20260630

Bricht das Ergebnis auf dem zurückgehaltenen Zeitraum deutlich ein, ist das eine ehrliche Antwort und kein Anlass, so lange nachzuoptimieren, bis es passt; damit wäre auch dieser Zeitraum verbraucht. Belastbarer als eine einzelne Aufteilung ist eine rollierende Prüfung über mehrere Fenster, wie sie im Beitrag zu Walk-Forward in der Praxis beschrieben ist. Weitere Faustregeln: wenige Parameter, plausible Wertebereiche, Gebühren realistisch ansetzen und Schutzmechanismen im Backtest mit --enable-protections einschalten, denn ohne diesen Schalter rechnen Backtest und Hyperopt ohne sie. Prüfen Sie außerdem, ob die übernommenen Werte in einem normalen Backtest mit gleicher Konfiguration und gleichem Zeitraum dasselbe Ergebnis liefern wie in Hyperopt; sonst wurden Parameter falsch übernommen.

Betrieb auf dem VPS: Telegram, FreqUI, Stoploss an der Börse und Updates.

Für den Dauerbetrieb läuft Freqtrade in der Regel auf einem gemieteten Linux-Server (VPS) mit Docker; ein Laptop, der in den Ruhezustand wechselt, unterbricht den Bot. Achten Sie auf eine korrekte Systemzeit: Version 2026.9 prüft den Zeitversatz gegenüber der Börsenuhr, ein laufender Zeitdienst wie NTP gehört trotzdem zur Grundausstattung. Die wichtigsten Betriebsbausteine im Überblick:

Scheitert das Platzieren des Börsen-Stopps, greift laut Doku ein Notausstieg (emergency_exit, standardmäßig per Marktorder). Für Futures bringt 2026.9 konfigurierbare Liquidationswarnungen. Beides ersetzt keine Überwachung: Ein externer Wächter, der Alarm schlägt, wenn der Bot keine Lebenszeichen mehr sendet, gehört deshalb dazu. Den API-Key legen Sie für den Live-Betrieb nur mit Lese- und Handelsrecht an, ohne Auszahlungsrecht, und beschränken ihn, wo die Börse das anbietet, auf die IP-Adresse Ihres Servers.

Grenzen und Risiken: Totalverlust, Hebel, Börsenwahl.

Freqtrade ist ein Werkzeug, keine Strategie. Die Software kann nur so gut handeln wie die Regeln, die Sie ihr geben, und selbst sorgfältig getestete Regeln können im Live-Markt dauerhaft Geld verlieren. Die wichtigsten Grenzen:

• Totalverlust: Kryptowerte können in kurzer Zeit massiv fallen, Börsen können ausfallen, Handelspaare können eingestellt werden. Setzen Sie nur Geld ein, dessen vollständigen Verlust Sie tragen können.
• Futures und Hebel: Mit Hebel kann eine Position liquidiert werden, bevor Ihr Stopp greift; Finanzierungszahlungen (Funding) verändern das Ergebnis laufend. Liquidationswarnungen informieren, schützen aber nicht.
• Backtest ist nicht Live: Slippage, Teilfüllungen, Gebührenänderungen und Ausfälle bildet kein Backtest vollständig ab. Auch eine bestandene lookahead-analysis beweist nur, dass ausgelöste Signale keinen offensichtlichen Blick in die Zukunft enthalten.
• Fremder Code: Strategien aus Foren oder Repositories können Fehler oder Look-ahead-Bias enthalten. Lesen und verstehen Sie jede Zeile, bevor Sie sie handeln lassen.
• Betriebsrisiko: Ein ungesicherter Server, ein offener FreqUI-Port oder ein Key mit Auszahlungsrecht machen aus einem Strategie-Risiko ein Sicherheitsrisiko.

Bei der Börsenwahl zählt neben Technik die Zulassung. Die MiCA-Übergangsfrist für Kryptowerte-Dienstleister ist EU-weit am 01.07.2026 ausgelaufen. ESMA rät Anlegern, vor Einzahlungen zu prüfen, ob der Anbieter im Interim-MiCA-Register als zugelassen geführt wird, und genau hinzusehen, welche juristische Person der Vertragspartner ist: Der Schutz gilt nur gegenüber dem zugelassenen EU-Unternehmen, nicht gegenüber anderen Gesellschaften derselben Marke. Dass eine Börse in Freqtrade unterstützt wird, sagt über ihre Zulassung nichts aus. Was das für Ihren Bot im Detail bedeutet, beschreibt der Artikel zu MiCA und Krypto-Trading-Bots; steuerliche Fragen klären Sie im Einzelfall mit Ihrer Steuerberatung.

Was Sie jetzt konkret tun können.

Wer Freqtrade ernsthaft einsetzen will, arbeitet am besten eine feste Prüfkette ab und geht erst zum nächsten Schritt, wenn der vorige sauber bestanden ist:

1. Umgebung: Freqtrade per Docker auf einem Testrechner oder VPS einrichten, Version notieren, Zugangsdaten in eine separate Datei auslagern.
2. Daten und Regeln: Daten für wenige Paare laden, eine einfache, verständliche Strategie formulieren und den Code selbst lesen, auch wenn er aus einer Vorlage stammt.
3. Ehrlicher Backtest: mit realistischen Gebühren, --timeframe-detail und --enable-protections; danach lookahead-analysis und recursive-analysis.
4. Optimierung mit Reserve: Hyperopt nur auf dem Trainingszeitraum, Prüfung einmalig auf zurückgehaltenen Daten oder per Walk-Forward.
5. Dry-Run: mehrere Wochen auf dem Server, Abweichungen zum Backtest dokumentieren, Telegram-Steuerung und Alarme testen.
6. Kleiner Live-Start: Börse mit MiCA-Zulassung prüfen, Key ohne Auszahlungsrecht mit IP-Bindung, frische Datenbank, stoploss_on_exchange wo verfügbar, niedriges max_open_trades und kleiner Einsatz.

Diese Kette ist unabhängig davon, ob Sie privat traden oder in einem Unternehmen ein Handelssystem aufbauen. Wenn Sie dabei Unterstützung beim Programmieren, Testen oder beim Serverbetrieb wollen, finden Sie mein Angebot unter Trading-Automatisierung. Die Strategie und die Entscheidung über Ihr Geld bleiben dabei bei Ihnen.

Häufige Fragen.

Ist Freqtrade kostenlos?

Ja. Freqtrade ist Open-Source-Software und kostet keine Lizenzgebühr. Kosten entstehen trotzdem: für einen Server im Dauerbetrieb, für Börsengebühren und vor allem durch mögliche Verluste im Live-Handel. Dazu kommt Zeit für Einrichtung, Tests und Wartung. Die Entwickler weisen ausdrücklich darauf hin, dass die Software nur zu Lernzwecken gedacht ist und jede Nutzung auf eigenes Risiko erfolgt.

Brauche ich für den Freqtrade Dry-Run einen API-Key?

Nein, laut Dokumentation ist er im Dry-Run optional. Freqtrade liest dann echte Marktdaten von der Börse, platziert aber keine Orders und rechnet mit einem simulierten Guthaben, standardmäßig 1.000 Einheiten der Handelswährung. Einen Key mit Handelsrecht benötigen Sie erst für den Live-Betrieb. Legen Sie ihn dann ohne Auszahlungsrecht an und binden Sie ihn, wo möglich, an die IP-Adresse Ihres Servers.

Wie erkenne ich Look-ahead-Bias in einer Freqtrade-Strategie?

Mit dem Befehl lookahead-analysis. Er rechnet einen Basis-Backtest und für die ausgelösten Signale, standardmäßig 20, je einen eigenen Backtest, der nur Daten bis zu diesem Zeitpunkt kennt. Weichen Indikatoren oder Signale ab, meldet das Werkzeug die betroffenen Stellen. Signale, die im Testzeitraum nie ausgelöst wurden, prüft es nicht. Ergänzend lohnt ein Vergleich von Backtest und Dry-Run über denselben Zeitraum.

Kann ich Freqtrade auf einem Raspberry Pi oder Laptop laufen lassen?

Grundsätzlich ja. Die Dokumentation beschreibt eine Installation auf dem Raspberry Pi, empfiehlt dort das Docker-Image und rät von Hyperopt auf so schwacher Hardware ab. Als Mindestausstattung nennt das Projekt einen Linux-Server mit 2 GB RAM, 1 GB Speicher und zwei virtuellen CPU-Kernen. Wichtiger sind stabile Stromversorgung, Internetverbindung und korrekte Systemzeit. Ein Laptop im Ruhezustand unterbricht den Bot; für den Dauerbetrieb bietet sich daher ein gemieteter Server an.

Welche Börse ist für Freqtrade am besten?

Eine pauschale Antwort gibt es nicht. Prüfen Sie zuerst, ob die Börse in der Freqtrade-Dokumentation als unterstützt geführt wird und ob sie Funktionen wie Stoploss an der Börse anbietet. Für Kunden in der EU zählt außerdem, ob der konkrete Anbieter im Interim-MiCA-Register der ESMA als zugelassen erscheint. Die Unterstützung durch Freqtrade sagt nichts über die Zulassung aus.

Quellen und Stand.

• Freqtrade Documentation: Introduction — Freqtrade
• Freqtrade Releases (2026.9 und 2026.8) — GitHub / Freqtrade
• Using Freqtrade with Docker — Freqtrade
• Lookahead analysis — Freqtrade
• Configure the bot — Freqtrade
• Backtesting — Freqtrade
• Hyperopt — Freqtrade
• Statement on the End of Transitional Periods under MiCA (17.04.2026) — ESMA

Stand: 7. Oktober 2026. Produkte, Funktionen und Preise ändern sich schnell; maßgeblich sind die Angaben der Anbieter und Behörden.

Sie wollen eine Freqtrade-Strategie sauber testen und auf einem eigenen Server betreiben? Unverbindlich anfragen — wir klären Prüfkette, Server-Setup, Absicherung und den Weg vom Dry-Run in den Live-Betrieb. Mehr zu meinem Angebot: Trading-Systeme entwickeln lassen.