So verbindest du deinen OKX API-Schlüssel und behebst Fehler 50119

Dein OKX API-Schlüssel kann gültig sein und trotzdem „API-Schlüssel existiert nicht.“ zurückgeben. Wenn ein EEA-Schlüssel die globale API statt der Infrastruktur von OKX Europe erreicht, löst ein neuer Schlüssel das Problem nicht. Ich zeige dir, wie du deinen OKX API-Schlüssel verbindest, die richtige Kontoregion auswählst und den Fehler diagnostizierst, bevor du Zugangsdaten änderst.

Entscheidend ist die Kombination aus Zugangsdaten und regionalem Endpunkt. Ein korrekt kopierter Schlüssel, der an den falschen regionalen Host gesendet wird, kann scheitern, noch bevor seine Berechtigungen relevant werden.

Ein gültiger OKX API-Schlüssel kann am falschen regionalen Endpunkt scheitern

Nach einer fehlgeschlagenen Verbindung liegt es nahe, einen weiteren Schlüssel zu erstellen, ihn erneut einzufügen und zusätzliche Berechtigungen auszuprobieren. Dieser Ansatz behandelt jeden Authentifizierungsfehler als Problem mit den Zugangsdaten.

Die regionale Struktur von OKX macht diese Annahme unzuverlässig.

OKX Europe Limited ist eine eigenständige, nach MiCA regulierte Gesellschaft, die von Maltas MFSA lizenziert ist. EEA-Konten befinden sich auf my.okx.com, und ihre API-Schlüssel sind ausschließlich für die API-Infrastruktur von OKX Europe gültig.

Sende einen vollkommen gültigen EEA-Schlüssel an die globale API unter www.okx.com, und die Antwort kann 50119: „API-Schlüssel existiert nicht.“ lauten. Der Schlüssel existiert, aber die Anfrage hat den falschen regionalen Endpunkt erreicht.

US-Konten haben einen eigenen regionalen Host: us.okx.com. Auch ihre Verbindungen benötigen die entsprechende regionale Infrastruktur.

Brasilianische OKX-Konten nutzen die globale Plattform und dieselbe API. Wähle deshalb Global. Eine lokale Marktpräsenz bedeutet nicht automatisch, dass es eine eigene API-Region gibt.

Ich beginne die Fehlersuche hier, weil weder eine geänderte Passphrase noch erweiterte Berechtigungen eine falsche Regionszuordnung korrigieren können. Die Anfrage muss die Infrastruktur erreichen, die den Schlüssel erkennt.

So erstellst du einen OKX API-Schlüssel mit den benötigten Berechtigungen

Eine Verbindung sollte genügend Zugriff erhalten, um ihre vorgesehene Aufgabe zu erfüllen. Zusätzliche Berechtigungen zu vergeben, damit ein Fehler verschwindet, ist eine schlechte Diagnosemethode.

Für die Portfolioansicht verwendest du Read. Ergänze Trade nur, wenn du Bots nutzen möchtest, die Orders platzieren.

Aktiviere für diese Verbindung niemals Withdrawal.

Schritt für Schritt zum OKX API-Schlüssel

1. Öffne die API-Verwaltung in deinem OKX-Konto.

Melde dich bei dem Konto an, das du verbinden möchtest, und öffne dessen API-Verwaltung. Kläre vor dem Erstellen des Schlüssels, ob dieses Konto zu Global, EEA oder US gehört.

1. Erstelle einen eigenen API-Schlüssel für diese Verbindung.

Gib ihm einen eindeutigen Namen, damit du seinen Zweck bei einer späteren Überprüfung der Zugriffe erkennst. Ein eigener Schlüssel erleichtert es außerdem, den Zugriff dieser Verbindung separat zu ändern oder zu widerrufen.

1. Lege beim Erstellen die API-Passphrase fest.

Diese Passphrase wählst du für den API-Schlüssel. Sie ist nicht dein OKX-Kontopasswort, und du benötigst sie beim Verbinden zusammen mit dem API-Schlüssel und dem Secret.

1. Aktiviere Read für die Portfolioansicht.

Wenn du Portfolioinformationen einsehen möchtest, beginne mit Read-Zugriff. Eine Verbindung, die ausschließlich der Anzeige dient, benötigt keine Handelsberechtigung.

1. Ergänze Trade nur für Bots, die Orders platzieren müssen.

Die Trade-Berechtigung erlaubt Handelsaktivitäten. Aktiviere sie gezielt für diesen Zweck, nicht als Experiment zur Behebung eines Authentifizierungsfehlers.

1. Lass Withdrawal deaktiviert.

Weder die Portfolioansicht noch das Platzieren von Orders durch Bots erfordert eine Auszahlungsberechtigung. Erteile sie nicht, um diese Einrichtung abzuschließen. Bedenke, dass deaktivierte Auszahlungen keine Handelsverluste verhindern: Ein Schlüssel mit Trade-Berechtigung kann weiterhin verlustbringende Orders platzieren. Begrenze deshalb das Guthaben auf dem Konto, auf das eine Handelsverbindung zugreifen kann.

1. Binde den Schlüssel an die IP-Adressen der Verbindung, sofern verfügbar.

Verwende die IP-Adressen, die der Dienst angibt, der die API-Anfragen sendet. Halte diese Konfiguration auf die Verbindung abgestimmt, die du tatsächlich nutzt.

1. Bewahre API-Schlüssel, Secret und Passphrase sicher auf.

Behandle sie als Zugangsdaten. Prüfe beim Eingeben in das Verbindungsformular, ob jeder Wert vollständig ist und alle Werte zum selben API-Schlüssel gehören.

Das Erstellen des Schlüssels ist nur ein Teil der Einrichtung. Die Verbindung, in der du ihn hinterlegst, muss außerdem wissen, welchen regionalen Host sie verwenden soll.

Warum die IP-Whitelist wichtig ist

Die IP-Bindung schränkt ein, von wo aus ein Schlüssel verwendet werden kann. Sie ist auch für die Lebensdauer des Schlüssels relevant: OKX kann inaktive API-Schlüssel ohne IP-Bindung löschen. Ein Schlüssel, den du erstellt und dann nicht genutzt hast, existiert möglicherweise nicht mehr, wenn du darauf zurückkommst.

Gehe nicht davon aus, dass ein Schlüssel aktiv bleibt, nur weil du seine Zugangsdaten noch gespeichert hast. Prüfe seinen Status in der API-Verwaltung von OKX.

Achte außerdem auf ein separates Konfigurationsproblem: Ein aktiver Schlüssel kann eine Anfrage zurückweisen, wenn die IP-Adresse des Absenders nicht auf seiner Whitelist steht. Das führt zu einem IP-spezifischen Fehler, der dich zu den IP-Einstellungen führen sollte, statt zurück zur Schlüsselerstellung.

Warum OKX „API-Schlüssel existiert nicht“ meldet, obwohl der Schlüssel gültig ist

Die Formulierung klingt eindeutig. Ihre diagnostische Aussage ist enger, als sie erscheint.

Bei einem EEA-Konto kann Fehler 50119 bedeuten, dass der globale Endpunkt einen Schlüssel nicht erkennt, der auf der Infrastruktur von OKX Europe gültig ist. Wenn eine Verbindungsanleitung nie danach fragt, welcher Gesellschaft dein Konto zugeordnet ist, kann sie diesen Fall nicht aufdecken.

Die regionale Trennung ist dokumentiert, keine Theorie über Zugangsdaten

Die OKX EEA API FAQ dokumentiert den regionalen Kontext von my.okx.com und die ausschließliche Gültigkeit der Schlüssel innerhalb der EEA-Infrastruktur. Öffentliche Fehlermeldungen in Freqtrade, CCXT und Hummingbot bestätigen ebenfalls das Muster: EEA-Nutzer erhalten „API-Schlüssel existiert nicht“, wenn ihre Integration den globalen Host verwendet.

Diese Berichte sprechen dafür, den regionalen Endpunkt zu überprüfen. Sie belegen nicht, dass jedes Auftreten dieselbe Ursache hat.

Meine diagnostische Schlussfolgerung ist eindeutig: Prüfe die Kontoregion, bevor du einen Schlüssel ersetzt, den OKX weiterhin als aktiv aufführt. Wenn ein Konnektor davon ausgeht, dass jedes Konto die globale API nutzt, ändert wiederholtes Erstellen neuer Schlüssel nichts an dieser Annahme.

Andere Ursachen für Fehler 50119 müssen ebenfalls geprüft werden

Eine falsche Regionszuordnung ist nicht die einzige Erklärung. Derselbe Fehler kann auch mit Folgendem zusammenhängen:

• Ein Schlüssel für den Demo-Handel wird in der falschen Umgebung verwendet. Prüfe, ob die Zugangsdaten zur Umgebung passen, die die Verbindung erwartet.
• Ein automatisch gelöschter Schlüssel. Prüfe, ob der Schlüssel in der API-Verwaltung von OKX noch existiert.
• Ein unvollständig eingefügter Wert. Stelle sicher, dass der vollständige API-Schlüssel eingegeben wurde.
• Ein tatsächlich unbekannter Schlüssel. Prüfe, ob die Zugangsdaten aus dem vorgesehenen Konto stammen.

Ich würde diese Möglichkeiten nacheinander prüfen, statt alles gleichzeitig zu ändern. Wenn du Zugangsdaten, Berechtigungen, Umgebung und Region auf einmal austauschst, sagt ein erfolgreicher neuer Versuch kaum etwas darüber aus, was falsch war.

Die hilfreiche Frage lautet: Erkennt dieser Endpunkt diesen aktiven Schlüssel für dieses Konto und diese Umgebung?

Entschlüssle den OKX-Fehlercode vor dem nächsten Versuch

Eine fehlgeschlagene Verbindung ist ein Symptom. Der OKX-Fehlercode liefert den nützlicheren Hinweis.

Die öffentliche Referenz der OKX API-Fehlercodes unterscheidet einen unbekannten Schlüssel von einer falschen Passphrase, einer ungültigen Signatur und einer IP-Beschränkung. Jeder Fehler verweist auf einen anderen Teil der Verbindung.

Fehlercode	Bedeutung	Was du prüfen solltest
50119	API-Schlüssel existiert nicht	Kontoregion und regionaler Host; Demo-Umgebung gegenüber vorgesehener Umgebung; ob der Schlüssel gelöscht wurde; ob der eingefügte Schlüssel vollständig ist
50105	Falsche API-Passphrase	Verwende die Passphrase, die beim Erstellen dieses API-Schlüssels festgelegt wurde, nicht das Kontopasswort
50113	Ungültige Signatur	Prüfe das API-Secret und die Implementierung der Anfragesignierung in der Integration
50110	Die IP-Adresse der Anfrage steht nicht auf der Whitelist	Prüfe, ob die IP-Adresse des Absenders in der Konfiguration der erlaubten IP-Adressen des Schlüssels enthalten ist

Fehler 50105: Prüfe die API-Passphrase

Die API-Passphrase ist eine separate Zugangsinformation. Dein OKX-Anmeldepasswort in dieses Feld einzutragen, erfüllt diese Anforderung nicht.

Prüfe außerdem, ob die Passphrase zum selben Schlüssel wie der API-Schlüssel und das Secret gehört. Wenn du Zugangsdaten aus verschiedenen Erstellungsversuchen vermischst, können die einzelnen Werte plausibel aussehen, ohne zusammenzugehören.

Fehler 50113: Untersuche die Anfragesignierung

Eine ungültige Signatur verweist auf die Authentifizierungssignatur der Anfrage. Prüfe das API-Secret und, falls du die Integration betreust, deren Signierungsimplementierung.

Wenn du ein Verbindungsformular nutzt, ziehe den Support oder die technische Dokumentation des Konnektors hinzu, um die Anfragesignierung zu untersuchen. Trade oder Withdrawal zu aktivieren, behebt keine ungültige Signatur.

Fehler 50110: Prüfe die IP-Whitelist

Dieser Fehler verweist auf die Konfiguration der erlaubten IP-Adressen. Prüfe, welche IP-Adresse der Dienst für die Anfrage verwendet, und vergleiche sie anschließend mit der Whitelist des Schlüssels.

Dieselbe Anfrage blind zu wiederholen, lässt die Abweichung bestehen. Korrigiere die betreffende Einstellung, bevor du erneut testest.

So verbindest du OKX mit Anny

Mein Verbindungsformular enthält eine Auswahl für die Kontoregion mit den Optionen Global, EEA und US. Diese Auswahl stellt sicher, dass der Schlüssel beim passenden regionalen Host überprüft wird.

So läuft die Verbindung ab:

1. Öffne das Formular zum Hinzufügen einer Börse und wähle OKX.

Halte deinen API-Schlüssel, dein Secret und deine API-Passphrase bereit.

1. Wähle deine Kontoregion.

Wähle EEA für ein Konto bei OKX Europe, US für ein Konto bei OKX US oder Global für ein Konto auf der globalen Plattform. Brasilianische Konten wählen Global.

1. Gib die zusammengehörigen Zugangsdaten ein.

Füge den vollständigen API-Schlüssel und das Secret ein und gib anschließend die Passphrase ein, die du beim Erstellen des Schlüssels festgelegt hast.

1. Bestätige, dass die Berechtigungen zu deinem Zweck passen.

Nutze Read für die Portfolioansicht. Ergänze Trade nur für Bots und lass Withdrawal deaktiviert.

1. Überprüfe die Verbindung.

Falls sie fehlschlägt, leite aus dem zurückgegebenen Fehlercode die nächste Prüfung ab. Prüfe bei 50119 erneut die Region, bevor du einen weiteren Schlüssel erstellst.

OKX mit Anny verbinden

Die Regionsauswahl ist eine Voraussetzung für die Authentifizierung, keine Anzeigepräferenz. Sie bestimmt, wo die Zugangsdaten geprüft werden.

So nutzt du die OKX API-Dokumentation bei der Fehlersuche

Wenn du die Verbindung über ein vorhandenes Formular herstellst, sind die Regionsauswahl und die Fehlertabelle die praktischen Ausgangspunkte. Wenn du eine Integration betreust, lies die regionalen Hinweise zusammen mit der Authentifizierungsdokumentation.

Die relevanten Teile der OKX API-Dokumentation beantworten unterschiedliche Fragen:

• Regionale API-Hinweise: Welche Infrastruktur soll die Anfragen dieses Kontos empfangen?
• Authentifizierungshinweise: Welche Zugangsdaten sind erforderlich, und wie müssen Anfragen signiert werden?
• Fehlercode-Referenz: Welcher Teil der übermittelten Anfrage wurde zurückgewiesen?

Eine korrekte Signierungsimplementierung kann eine Anfrage trotzdem an den falschen regionalen Host senden. Ein korrekter regionaler Host kann trotzdem eine falsche Passphrase zurückweisen.

Ich halte diese Prüfungen getrennt, weil sie zu unterschiedlichen Korrekturen führen. Eine erfolgreiche Verbindung setzt voraus, dass Endpunkt, Zugangsdaten, Umgebung, Berechtigungen und IP-Konfiguration zusammenpassen.

Häufig gestellte Fragen zu OKX API-Verbindungen

Läuft ein OKX API-Schlüssel ab?

Gehe nicht davon aus, dass ein API-Schlüssel unbegrenzt verfügbar bleibt. OKX kann inaktive Schlüssel ohne IP-Bindung löschen. Prüfe deshalb die API-Verwaltung, wenn zuvor gespeicherte Zugangsdaten nicht mehr funktionieren.

Binde den Schlüssel an die für die Verbindung angegebenen IP-Adressen, sofern verfügbar, und prüfe, ob er noch aktiv ist, bevor du seine Passphrase oder Berechtigungen untersuchst.

Warum wird mein gültiger OKX API-Schlüssel als nicht existent gemeldet?

Ein gültiger Schlüssel kann 50119 zurückgeben, wenn er an den falschen regionalen Endpunkt gesendet wird. Insbesondere gehört ein EEA-Schlüssel auf die Infrastruktur von OKX Europe. Wird er an die globale API unter www.okx.com gesendet, kann das zu „API-Schlüssel existiert nicht“ führen.

Prüfe außerdem, ob die Demo-Umgebung nicht zur Verbindung passt, der Schlüssel automatisch gelöscht wurde oder der eingefügte Wert unvollständig ist.

Welche Berechtigungen benötigt ein OKX Trading-Bot?

Nutze Read für die Portfolioansicht und ergänze Trade, wenn der Bot Orders platzieren muss. Aktiviere für diese Verbindung niemals Withdrawal.

Zusätzliche Berechtigungen beheben weder eine falsche Regionszuordnung noch eine falsche Passphrase, eine ungültige Signatur oder einen Fehler in der IP-Whitelist.

Ist die OKX API-Passphrase dasselbe wie mein Passwort?

Nein. Die API-Passphrase wird beim Erstellen des API-Schlüssels festgelegt und ist von deinem OKX-Kontopasswort getrennt.

Gib die Passphrase ein, die genau diesem Schlüssel zugeordnet ist.

Welche Region sollte ein brasilianisches OKX-Konto auswählen?

Wähle Global. OKX Brazil arbeitet auf der globalen Plattform und verwendet dieselbe API.

Sollte ich bei jeder fehlgeschlagenen Verbindung einen neuen Schlüssel erstellen?

Nein. Lies zuerst den Fehlercode und prüfe die Einstellung, auf die er verweist.

Prüfe bei 50119 den regionalen Host, die Umgebung, den aktiven Status des Schlüssels und die Vollständigkeit des eingefügten Werts. Ein neuer Schlüssel repariert keine Verbindung, die ihn weiterhin an den falschen regionalen Endpunkt sendet.

Der nächste sinnvolle Schritt ist eine Diagnose, kein weiterer identischer Versuch. Beginne mit der Region, lies den Code und ändere die Einstellung, auf die die Hinweise deuten.

Dieser Artikel dient der Information und ist keine Finanzberatung. Vergangene Performance ≠ zukünftige Ergebnisse. Anny ist eine KI-gestützte Analyseplattform, keine registrierte Anlageberaterin.