Wenn Sie einen Börsen-API-Schlüssel hinzufügen, prüft Freya ihn vor dem Speichern — und wenn etwas nicht stimmt, sagt es Ihnen, was Sie korrigieren müssen. Dieser Leitfaden hilft Ihnen, dieses Ergebnis zu lesen und zu beheben. (Wenn Ihr Schlüssel bereits einwandfrei verbunden war, ein Bot aber später stoppte, ist das ein anderes Problem — siehe Warum wurde mein Bot pausiert oder gestoppt?.)
Für die Schritte der Ersteinrichtung beginnen Sie mit So verbinden Sie Ihre Börse; in diesem Artikel geht es darum, was zu tun ist, wenn diese Verbindung fehlschlägt.
Das Wichtigste
- Wenn Sie einen Schlüssel hinzufügen, prüft Freya vor dem Speichern, dass er sich verbindet und die richtigen Berechtigungen hat — wenn etwas fehlschlägt, sagt Ihnen der Fehler, was zu korrigieren ist.
- "Ungültiger API-Schlüssel/Secret" bedeutet meist einen Kopier-/Einfügefehler oder einen neu generierten Schlüssel; "IP"-Fehler bedeuten, dass die IP-Beschränkung des Schlüssels nicht zu dem passt, was Freya benötigt.
- Ihr Schlüssel muss Lese- und Handelsberechtigungen haben (niemals Abheben) und für den richtigen Markt — Spot oder Futures — freigeschaltet sein, passend zu Ihrem Bot.
- OKX-Schlüssel erfordern eine Passphrase, die exakt übereinstimmen muss; bei Futures-Schlüsseln bereitet Freya Ihr Konto automatisch vor, damit der Bot korrekt handeln kann.
- Ein allgemeines "Verbindung fehlgeschlagen" ist oft ein kurzzeitiger Netzwerk- oder Börsen-Schluckauf — versuchen Sie es einfach erneut.
Wenn sich ein Schlüssel nicht verbinden lässt
Einen Schlüssel hinzuzufügen ist kein blindes Speichern — Freya verifiziert, dass der Schlüssel funktioniert und die richtigen Berechtigungen hat, bevor er verschlüsselt gespeichert wird. Wenn etwas nicht stimmt, weist Sie der Fehler direkt auf die Ursache hin — meist den Schlüssel oder das Secret, die IP-Beschränkung oder eine fehlende Berechtigung. Die folgenden Abschnitte gehen jeden Fehler durch und zeigen, wie Sie ihn beheben.
"Ungültiger API-Schlüssel" oder "Ungültiges Secret"
Der häufigste Verbindungsfehler und meist der einfachste:
- Ein Kopier-/Einfügefehler — ein verirrtes Leerzeichen oder ein fehlendes Zeichen. Kopieren Sie sowohl den Schlüssel als auch das Secret sorgfältig erneut.
- Das Secret wird nur einmal angezeigt. Börsen zeigen das Secret bei der Erstellung ein einziges Mal an. Wenn Sie es nicht gespeichert haben, können Sie es nicht wiederherstellen — erstellen Sie einen neuen Schlüssel.
- Der Schlüssel wurde gelöscht oder neu generiert an der Börse, sodass er nicht mehr übereinstimmt.
Lösung: Geben Sie Schlüssel und Secret exakt erneut ein oder erstellen Sie einen frischen Schlüssel und versuchen Sie es erneut.
IP-Beschränkungsfehler
Freya verbindet sich von seinen eigenen Servern aus, daher sind die IP-Einstellungen des Schlüssels wichtig. Es gibt zwei verschiedene Fälle:
- "IP nicht freigegeben" — Ihr Schlüssel ist IP-beschränkt, aber die Serveradresse von Freya steht nicht auf seiner Freigabeliste. Der Bildschirm „API-Schlüssel hinzufügen" zeigt Ihnen die hinzuzufügende(n) IP-Adresse(n) (mit Kopier-Button) — fügen Sie sie an der Börse zur Whitelist des Schlüssels hinzu.
- "Unbeschränkt" — Ihr Schlüssel hat gar keine IP-Beschränkung. Zu Ihrer Sicherheit bittet Freya Sie, die IP-Beschränkung zu aktivieren und die angezeigte Adresse hinzuzufügen, und es dann erneut zu versuchen.
In beiden Fällen ist die Lösung dieselbe Idee: Beschränken Sie den Schlüssel auf die IP, die Freya im Dialog anzeigt.
Berechtigungsfehler
Der Schlüssel hat sich verbunden, kann aber nicht tun, was Ihr Bot benötigt:
- Lesen deaktiviert — aktivieren Sie die Lese-/Ansichtsberechtigung für den Schlüssel.
- Handelsberechtigung fehlt — aktivieren Sie den Handel (Spot und/oder Futures, passend zu Ihrem Bot).
- Spot vs. Futures stimmt nicht überein — ein Futures-Bot benötigt einen Schlüssel mit aktiviertem Futures-Handel; ein Spot-Bot benötigt Spot-Handel. Wenn Sie einen Spot-only-Schlüssel für einen Futures-Bot hinzugefügt haben (oder umgekehrt), kennzeichnet Freya das. Stellen Sie sicher, dass der freigeschaltete Markt des Schlüssels zu dem Bot passt, den Sie erstellen.
Denken Sie daran: Freya benötigt immer nur Lese- und Handelsberechtigungen — niemals Abheben. Ein Schlüssel ohne Abhebeberechtigung ist genau das, was Sie wollen.
Börsenspezifische Stolperfallen
- OKX benötigt eine Passphrase. Wenn Sie einen OKX-Schlüssel erstellen, legen Sie eine Passphrase fest — geben Sie genau diese Passphrase in Freya ein, exakt so, wie Sie sie festgelegt haben. Eine falsche Passphrase ist ein häufiger OKX-Verbindungsfehler.
- OKX-Futures-Setup. Der OKX-Futures-Handel benötigt einen bestimmten Kontomodus, den Freya automatisch für Sie einrichtet — Sie müssen ihn nicht manuell konfigurieren.
- Hedge-Modus (Futures). Freya verwendet den Hedge-Modus für Futures-Konten. Wenn Sie bereits offene One-Way-Positionen haben, die in Konflikt stehen, sehen Sie möglicherweise eine Warnung statt eines Fehlers — der Schlüssel wird trotzdem gespeichert, und Ihr Bot kann handeln, sobald diese bestehenden Positionen geschlossen sind.
- Binance und Bybit verwenden keine Passphrase — für sie gibt es kein Passphrase-Feld.
"Verbindung fehlgeschlagen" ohne klaren Grund
Ein allgemeiner Verbindungsfehler liegt oft nicht an Ihnen — ein kurzzeitiger Netzwerk-Aussetzer oder die Börse, die gerade kurz ausgelastet ist. Warten Sie einen Moment und versuchen Sie es erneut. Wenn es nach einigen Versuchen weiterhin fehlschlägt, überprüfen Sie die oben genannten Schlüssel-/Secret- und IP-Einstellungen erneut.
Hängt immer noch? Eine kurze Checkliste
- Erstellen Sie den Schlüssel neu an der Börse mit nur Lesen + Handeln (niemals Abheben).
- Beschränken Sie ihn auf die IP, die Freya im Bildschirm „API-Schlüssel hinzufügen" anzeigt.
- Passen Sie den Markt an — Spot-Schlüssel für einen Spot-Bot, Futures-Schlüssel für einen Futures-Bot.
- OKX: Geben Sie die exakte Passphrase ein.
- Immer noch erfolglos? Kontaktieren Sie [email protected].
Häufig gestellte Fragen
Freya sagt „Ungültiger API-Schlüssel", aber ich bin sicher, dass ich ihn korrekt kopiert habe — was ist falsch?
Meist hat sich ein verstecktes Zeichen oder Leerzeichen in den Schlüssel oder das Secret eingeschlichen, oder der Schlüssel wurde an der Börse neu generiert/gelöscht, sodass er nicht mehr übereinstimmt. Kopieren Sie beide Felder sorgfältig erneut und denken Sie daran, dass das Secret nur einmal bei der Erstellung angezeigt wird — wenn Sie es nicht haben, erstellen Sie einen frischen Schlüssel.
Was ist der Unterschied zwischen „IP nicht freigegeben" und „Unbeschränkt"?
„IP nicht freigegeben" bedeutet, dass Ihr Schlüssel IP-beschränkt ist, aber die Serveradresse von Freya noch nicht erlaubt ist — fügen Sie die von Freya angezeigte Adresse zur Whitelist des Schlüssels hinzu. „Unbeschränkt" bedeutet, dass der Schlüssel gar keine IP-Beschränkung hat; aus Sicherheitsgründen bittet Freya Sie, die IP-Beschränkung zu aktivieren und seine Adresse hinzuzufügen, bevor Sie speichern.
Mein OKX-Schlüssel verbindet sich nicht — brauche ich die Passphrase?
Ja. OKX-Schlüssel haben eine Passphrase, die Sie beim Erstellen des Schlüssels festlegen. Sie müssen genau diese Passphrase in Freya eingeben — eine falsche oder fehlende Passphrase ist ein häufiger OKX-Verbindungsfehler. Binance und Bybit verwenden keine.
Freya sagt, mein Schlüssel kann keine Trades platzieren — wie behebe ich das?
Ihr Schlüssel hat den Handel für den Markt, den Ihr Bot nutzt, nicht aktiviert. Aktivieren Sie an der Börse die Handelsberechtigung — Spot-Handel für einen Spot-Bot, Futures-Handel für einen Futures-Bot — und verbinden Sie dann erneut. Freya benötigt Lese- und Handelsberechtigungen, niemals Abheben.
Mein Futures-Schlüssel benötigt zusätzliche Einrichtung (Kontomodus / Hedge-Modus) — ist das ein Problem?
Nein. Der Futures-Handel benötigt einen bestimmten Kontomodus und Hedge-Modus, den Freya automatisch für Sie einrichtet. Wenn Sie bestehende One-Way-Positionen haben, sehen Sie möglicherweise eine Hedge-Modus-Warnung statt eines Fehlers — der Schlüssel wird trotzdem gespeichert, und Ihr Bot kann handeln, sobald diese Positionen geschlossen sind.
Ich habe einen Spot-Schlüssel hinzugefügt, aber mein Futures-Bot will ihn nicht verwenden (oder umgekehrt) — warum?
Ein Schlüssel ist für einen bestimmten Markt freigeschaltet. Ein Futures-Bot benötigt einen Schlüssel mit aktiviertem Futures-Handel, und ein Spot-Bot benötigt Spot-Handel. Wenn sie nicht übereinstimmen, kennzeichnet Freya das. Verbinden Sie einen Schlüssel, dessen freigeschalteter Markt zu dem Bot passt, den Sie erstellen.
Die Verbindung ist einfach „fehlgeschlagen" ohne klaren Grund — liegt es an mir oder an der Börse?
Oft ist es ein kurzzeitiger Netzwerk- oder Börsen-Schluckauf und nicht Ihre Einstellungen. Versuchen Sie es gleich noch einmal. Wenn es weiterhin fehlschlägt, überprüfen Sie den Schlüssel und das Secret auf Kopierfehler und bestätigen Sie, dass die IP-Beschränkung mit der von Freya angezeigten Adresse übereinstimmt.