Bevor ein Bot für Sie handeln kann, braucht Freya eine Verbindung zur Börse, auf der Ihre Gelder liegen — Binance, OKX oder Bybit. Dafür bewegen Sie weder Ihre Gelder, noch geben Sie Ihr Passwort weiter. Stattdessen erstellen Sie einen API-Schlüssel: eine eingeschränkte Zugangsberechtigung, die Freya erlaubt, in Ihrem Namen Trades zu platzieren, während Ihr Geld auf Ihrem eigenen Börsenkonto bleibt.
Diese Anleitung erklärt genau, welche Berechtigungen Sie erteilen (und welche niemals), wie Sie den Schlüssel in Freya hinzufügen und was zu tun ist, wenn die Verbindung nicht validiert wird. Wenn Sie das große Ganze verstehen möchten, warum dies sicher ist, lesen Sie zuerst Ist mein Geld bei Freya Finance sicher?.
Das Wichtigste
- Sie verbinden eine Börse mit einem API-Schlüssel — einer eingeschränkten Zugangsberechtigung — nicht durch das Bewegen von Geldern oder die Weitergabe Ihres Börsenpassworts.
- Der Schlüssel benötigt Berechtigungen für Lesen sowie Spot- und/oder Futures-Handel. Er darf NIEMALS eine Auszahlungsberechtigung haben.
- OKX-Schlüssel erfordern eine Passphrase, die Sie beim Erstellen festlegen; Binance und Bybit nicht.
- Fügen Sie den Schlüssel in Freya unter Einstellungen → API-Schlüssel → API-Schlüssel hinzufügen hinzu, und Freya validiert ihn sofort.
- Schlägt die Validierung fehl, sagt Freya Ihnen genau warum — ungültiger Schlüssel, IP nicht freigegeben oder eine fehlende Berechtigung — und jeder Fall hat eine einfache Lösung.
Ein kurzer Überblick über die Schritte
- Erstellen Sie einen API-Schlüssel auf Ihrer Börse mit Lese- und Handelsberechtigungen, aber ohne Auszahlung.
- Kopieren Sie die Zugangsdaten — den API-Schlüssel, den Geheimschlüssel und (bei OKX) die Passphrase.
- Fügen Sie den Schlüssel in Freya hinzu unter Einstellungen → API-Schlüssel → API-Schlüssel hinzufügen, und wählen Sie Ihre Börse aus.
- Lassen Sie Freya ihn validieren — Freya prüft die Verbindung und die Berechtigungen sofort.
- Beheben Sie jeden gemeldeten Fehler — Freya sagt Ihnen genau, was nicht stimmt, falls die Validierung fehlschlägt.
Was ein API-Schlüssel ist — und welche Berechtigungen Freya braucht
Ein API-Schlüssel ist ein Paar von Zugangsdaten (ein Schlüssel und ein Geheimschlüssel), das einer App erlaubt, auf eingeschränkte Weise mit Ihrem Börsenkonto zu kommunizieren. Sie entscheiden, was dieser Schlüssel darf. Aktivieren Sie für Freya nur:
- Lesen — damit Freya Ihre Guthaben, Positionen und den Orderstatus einsehen kann.
- Spot-Handel und/oder Futures-Handel — damit Ihr Bot die benötigten Orders platzieren kann. Aktivieren Sie das, was zu den Bots passt, die Sie betreiben möchten.
Freya platziert Trades; sie muss niemals Geld aus Ihrem Konto bewegen. Lassen Sie die Auszahlungsberechtigung immer deaktiviert auf dem Schlüssel, den Sie verbinden. Dies ist eine Berechtigung, die Sie auf der Börse steuern — ist sie deaktiviert, kann weder Freya noch jemand, der den Schlüssel erlangen könnte, Ihre Gelder auszahlen. Es ist die wichtigste Gewohnheit beim Verbinden jeder Bot-Plattform.
Schritt 1: Erstellen Sie einen API-Schlüssel auf Ihrer Börse
Erstellen Sie im Bereich API-Verwaltung Ihrer Börse einen neuen API-Schlüssel:
- Binance — erstellen Sie den Schlüssel unter API Management, aktivieren Sie Lesen und Spot- und/oder Futures-Handel und lassen Sie Auszahlungen deaktiviert.
- OKX — erstellen Sie den Schlüssel und legen Sie eine Passphrase fest (Sie brauchen sie in Freya); aktivieren Sie Lesen und Handeln, nicht aber Auszahlungen.
- Bybit — erstellen Sie den Schlüssel mit Lese- und Handelsberechtigungen für die Produkte, die Sie nutzen, und lassen Sie Auszahlungen deaktiviert.
Wenn Ihre Börse IP-Whitelisting anbietet, ist es gute Praxis, den Schlüssel auf die IP-Adressen von Freya zu beschränken. Falls Sie das tun, geben Sie unbedingt die IPs von Freya frei, sonst wird die Verbindung abgelehnt (siehe Fehlertabelle weiter unten).
Wenn Sie den Schlüssel erstellen, zeigt die Börse den Geheimschlüssel ein einziges Mal an. Kopieren Sie ihn sofort und bewahren Sie ihn sicher auf. Wenn Sie ihn verlieren, können Sie ihn nicht wiederherstellen — Sie müssen den Schlüssel löschen und einen neuen erstellen.
Schritt 2: Fügen Sie den Schlüssel in Freya hinzu
Gehen Sie in Freya zu Einstellungen → API-Schlüssel und wählen Sie API-Schlüssel hinzufügen. Dann:
- Wählen Sie Ihre Börse (Binance, OKX oder Bybit).
- Fügen Sie den API-Schlüssel und den Geheimschlüssel ein. Geben Sie bei OKX zusätzlich die festgelegte Passphrase ein.
- Geben Sie dem Schlüssel einen Namen, damit Sie ihn später wiedererkennen.
Sie können mehr als eine Börse verbinden und Ihre Schlüssel jederzeit auf derselben Seite verwalten oder löschen.
Schritt 3: Freya validiert Ihren Schlüssel
Sobald Sie den Schlüssel hinzufügen, prüft Freya die Verbindung und die Berechtigungen — kein Rätselraten. Ist alles korrekt, wird der Schlüssel verifiziert und ist einsatzbereit. Stimmt etwas nicht, zeigt Freya eine klare Meldung an, die genau erklärt, was zu beheben ist.
Validierungsfehler verstehen
Schlägt die Validierung fehl, ordnen Sie die von Freya angezeigte Meldung der Lösung unten zu:
| Was Freya anzeigt | Was es bedeutet | Wie Sie es beheben |
|---|---|---|
| Ungültiger API-Schlüssel | Der Schlüssel wurde falsch kopiert oder auf der Börse gelöscht | Kopieren Sie den API-Schlüssel exakt erneut oder erstellen Sie einen neuen |
| Ungültiger Geheimschlüssel | Der Geheimschlüssel passt nicht zum Schlüssel | Kopieren Sie den Geheimschlüssel erneut; falls verloren, erstellen Sie einen neuen Schlüssel |
| IP-Adresse nicht freigegeben | Der Schlüssel ist IP-beschränkt und die Adresse von Freya ist nicht erlaubt | Geben Sie die IPs von Freya für den Schlüssel frei oder entfernen Sie die IP-Beschränkung |
| Fehlende Berechtigungen | Dem Schlüssel fehlt die Lese- oder Handelsberechtigung | Aktivieren Sie Lesen und Spot-/Futures-Handel für den Schlüssel |
| Leseberechtigung deaktiviert | Freya kann Ihr Konto nicht lesen | Aktivieren Sie die Lese-/Anzeigeberechtigung für den Schlüssel |
| Spot-/Futures-Berechtigung deaktiviert | Der Schlüssel kann die von Ihrem Bot benötigten Orders nicht platzieren | Aktivieren Sie den Handelstyp (Spot oder Futures), der zu Ihrem Bot passt |
| Verbindung fehlgeschlagen | Ein vorübergehendes Netzwerk- oder Börsenproblem | Warten Sie einen Moment und versuchen Sie erneut, den Schlüssel hinzuzufügen |
Freya markiert außerdem einen Schlüssel, der sich im „Unrestricted"-Modus befindet — also keine IP-Beschränkung hat. Zu Ihrer Sicherheit bittet Freya Sie, die IP-Beschränkung zu aktivieren und die angezeigte Adresse hinzuzufügen, bevor der Schlüssel gespeichert werden kann. Aktivieren Sie nur Lesen und Handeln (niemals Auszahlung) und beschränken Sie den Schlüssel auf die IP von Freya. (Mehr zu Verbindungsfehlern in Können Sie Ihre Börse nicht verbinden?.)
Ein Hinweis zur Sicherheit
Die Verbindung ist von Grund auf sicher gestaltet, aber ein paar Gewohnheiten halten sie so:
- Auszahlung immer deaktiviert — Freya braucht sie nie.
- Nutzen Sie IP-Whitelisting, wenn Ihre Börse es unterstützt.
- Ein Schlüssel, ein Zweck — und löschen Sie Schlüssel, die Sie nicht mehr verwenden.
Für das vollständige Bild, wie Ihre Gelder und Schlüssel geschützt sind, lesen Sie Ist mein Geld bei Freya Finance sicher? und Börsen-API-Sicherheit & Risikominderung.
Häufig gestellte Fragen
Welche Berechtigungen braucht Freya für meinen API-Schlüssel?
Lesen (um Ihre Guthaben, Positionen und Orders einzusehen) sowie Spot- und/oder Futures-Handel (um die Orders Ihres Bots zu platzieren). Aktivieren Sie den Handelstyp, der zu den Bots passt, die Sie betreiben. Freya braucht niemals eine Auszahlungsberechtigung, lassen Sie diese also immer deaktiviert.
Braucht Freya die Berechtigung, meine Gelder auszuzahlen?
Nein. Freya platziert und verwaltet nur Trades; sie kann und soll keine Gelder aus Ihrer Börse bewegen. Lassen Sie die Auszahlungsberechtigung auf dem verbundenen Schlüssel immer deaktiviert — es ist eine Berechtigung, die Sie auf der Börse steuern.
Warum sagt Freya „IP-Adresse nicht freigegeben"?
Ihr API-Schlüssel ist auf bestimmte IP-Adressen beschränkt, und die Adresse von Freya steht nicht auf der Liste. Fügen Sie entweder die IP-Adressen von Freya zur Whitelist des Schlüssels auf Ihrer Börse hinzu oder entfernen Sie die IP-Beschränkung vom Schlüssel. Nach der Aktualisierung fügen Sie den Schlüssel in Freya erneut hinzu.
Warum erscheint „Ungültiger API-Schlüssel" oder „Ungültiger Geheimschlüssel"?
Meist wurde der Schlüssel oder Geheimschlüssel falsch kopiert oder der Schlüssel auf der Börse gelöscht oder neu generiert. Kopieren Sie beide Werte exakt erneut. Da der Geheimschlüssel beim Erstellen nur einmal angezeigt wird, löschen Sie den Schlüssel auf der Börse und erstellen einen neuen, falls Sie ihn nicht mehr haben.
Was ist die Passphrase, und warum fragt OKX danach?
OKX-API-Schlüssel enthalten eine Passphrase, die Sie beim Erstellen des Schlüssels selbst festlegen — sie ist eine zusätzliche Zugangsberechtigung neben Schlüssel und Geheimschlüssel. Geben Sie in Freya dieselbe Passphrase ein, wenn Sie einen OKX-Schlüssel hinzufügen. Binance und Bybit verwenden keine Passphrase.
Kann ich mehr als eine Börse verbinden?
Ja. Sie können API-Schlüssel für Binance, OKX und Bybit hinzufügen und sie jederzeit unter Einstellungen → API-Schlüssel verwalten oder löschen.
Ist es sicher, Freya meinen API-Schlüssel zu geben?
Ja, wenn der Schlüssel korrekt eingerichtet ist — nur Lesen und Handeln, keine Auszahlung und nach Möglichkeit IP-freigegeben. Ihre Gelder bleiben auf Ihrer eigenen Börse, und der Schlüssel, den Sie weitergeben, kann sie nicht bewegen. Für die vollständige Erklärung lesen Sie Ist mein Geld bei Freya Finance sicher?.
Welche Börsen unterstützt Freya?
Freya verbindet sich derzeit mit Binance, OKX und Bybit (Spot und Futures). Im Laufe der Zeit können weitere Börsen hinzukommen. Sie handeln auf derjenigen, die Sie verbinden — Ihre Gelder und die verfügbaren Märkte bleiben auf dieser Börse.
Welche Coins oder Handelspaare kann ich handeln?
Die verfügbaren Paare stammen aus den eigenen Listings Ihrer verbundenen Börse, nicht aus einer separaten Freya-Liste — wenn Ihre Börse also ein Paar listet (z.B. BTC/USDT, ETH/USDT), können Sie einen Bot darauf erstellen. Die meisten Trades laufen gegen USDT als Quote-Währung. Wenn eine Börse ein Paar delistet, ist es dort nicht mehr handelbar.