Häufig gestellte Fragen zur OKX-API

Veröffentlicht am 20. Sept. 2024Aktualisiert am 29. Okt. 2025Lesezeit: 7 Min.111

Auf was bezieht sich die Passphrase?

Dies ist das Passwort, das du bei der Beantragung des API-Schlüssels eingegeben hast. Du musst dich selbst daran erinnern. Wenn du ihn vergessen hast, kannst du ihn nicht mehr abrufen und musst einen neuen API-Schlüssel erstellen.

Wie erstelle ich einen Demo-Disk-API-Schlüssel?

Um über die Demo-Disk-API zu handeln, musst du einen API-Schlüssel auf der Demo-Disk erstellen. Befolge dafür einfach die folgenden Schritte:

Melde dich bei deinem OKX-Konto an und gehe zu Handel > Demo-Handel > Persönliches Center > Demo-Konto-API-Schlüssel erstellen > Demo-Handel starten.

Läuft der API-Schlüssel ab?

API-Schlüssel, die nicht an eine IP gebunden sind und die Transaktions- oder Auszahlungsberechtigungen haben, werden nach 14 Tagen Inaktivität automatisch gelöscht. API-Schlüssel gelten nicht als inaktiv, wenn sie zum Aufrufen privater oder kontobezogener Schnittstellen verwendet werden, die eine Identitätsverifizierung erfordern, z. B. zum Anzeigen des Kontostands, von Rechnungsdaten oder zur Platzierung von Orders.

Nur Read-Only-API-Schlüssel, die an eine IP oder bestimmte Berechtigungen gebunden sind, laufen nicht ab.

Können Orders über die Schnittstelle in Währungseinheiten platziert werden?

Nein; Kontrakt-Orders werden in der Schnittstelle standardmäßig mit der Anzahl der Kontrakte platziert. Wenn du die Konvertierung zwischen der Anzahl der Kontrakte und den Coins berechnen musst, kannst du die Schnittstelle zur Konvertierung von Kontrakten in Coins hier aufrufen.

Wie wird die Fluktuationsrate der Schnittstelle ermittelt?

Die Schnittstelle kann die Preiserhöhung oder -senkung nicht direkt ermitteln, aber sie kann anhand einer Berechnungsformel berechnet werden.

Der Anstieg und Rückgang des letzten Transaktionspreises im Vergleich zum Eröffnungskurs der K-Linie vor 24 Stunden/100 % des Eröffnungskurses der K-Linie vor 24 Stunden.

Die oben genannten Formeldaten können hier über die Marktschnittstelle (last-open24h)/open24h abgerufen werden.

Was ist der Grund für die Fehlermeldung „51000 Parameter posSide error“, wenn ich eine Order platziere?

Überprüfe zuerst den Kontomodus, also den Kauf- und Verkaufsmodus bzw. den Eröffnungs- und Schließmodus, den du hier einsehen kannst, um den posMode abzurufen.

Hinweis:

  • Beim Öffnen und Schließen von Positionen und beim Platzieren von Orders unter Verwendung eines Kontrakts ist der Parameter „posSide“ erforderlich, der „long“ oder „short“ ausgeführt wird.

  • Wenn es sich um einen Kauf- und Verkaufsmodus handelt oder eine Kryptowährung oder eine gehebelte Transaktion im Eröffnungs- und Schließmodus durchgeführt wird, unterstützt posSide nur Netto- oder keine Übertragung.

Welche Schnittstelle kann verwendet werden, um den Nennwert des Kontrakts und die minimale Ordermenge zu erhalten?

Hier kannst du die Schnittstelle nutzen, um Basisinformationen über Handelsprodukte zu erhalten.

Nominalwert des Kontrakts: ctVal, Minimale Ordermenge: minSz.

Welches Format hat instId?

Hier kannst du die Schnittstelle direkt nutzen, um die Basisinformationen der Handelsprodukte zu erhalten.

Wie kann ich Stop-Loss und Take-Profit einrichten?

Wenn die Order mit einem Take-Profit oder Stop-Loss verbunden ist, kannst du die Order-Schnittstelle hier aufrufen: attachAlgoOrds Array-Parameter.

Wenn es sich jedoch um eine separate Stop-Loss-Order handelt, kannst du die Schnittstelle der Strategie-Provision hier einsehen.

Warum wird beim Festlegen des Auslösungspreises für Take-Profit und Stop-Loss ein Fehler gemeldet: 51046, 51047, 51048, 51049?

Regeln für die Festlegung des Stop-Loss-Auslösungspreises/Take-Profit-Auslösungspreises – beim Verkauf ist der Take-Profit-Auslösungspreis höher als der letzte Transaktionspreis und der Stop-Loss-Auslösungspreis niedriger als der letzte Transaktionspreis; beim Kauf hingegen ist der Take-Profit-Auslösungspreis niedriger als der letzte Transaktionspreis und der Stop-Loss-Auslösungspreis höher als der letzte Transaktionspreis.

Was bedeutet „Interface error: 50102 Timestamp request expired“?

Dieser Fehler tritt auf, wenn der Zeitstempel abgelaufen ist. Hierbei musst du die Schnittstelle der Systemzeit aufrufen, um deine lokale Zeit mit der Zeit unseres Servers zu synchronisieren. Ein Zeitunterschied von höchstens 30 Sekunden kann dabei helfen, dieses Problem zu vermeiden.

Hinweis: Die Zeit in der Kopfzeile der Anfrage ist in UTC0 angegeben. Beim Aufruf der Schnittstelle der Serverzeit wird die Zeit in UTC+8 angegeben.

Was bedeutet „Interface error: 50101 APIKey does not match the current environment“?

Dies liegt an der Nichtübereinstimmung zwischen dem API-Schlüssel und der aktuellen Umgebung. Abfragen eines echten Kontos erfordern die Verwendung des API-Schlüssels des echten Kontos, und der Wert des x-simulated-trading-Parameters im Request-Header muss 0 betragen. Abfragen für ein Simulationskonto erfordern die Verwendung des API-Schlüssels des Simulationskontos, und der Wert des x-simulated-trading-Parameters im Request-Header muss 1 betragen.

Was bedeutet „Interface error: 51010 Request unsupported under current account mode“?

Dies hängt mit deinem Kontomodus zusammen. Wenn du einen Hebel oder Kontrakt für eine einzelne Währung platzieren möchtest, musst du dich an die anderen drei Modi außer dem Spot-Modus anpassen! Du kannst sie entweder hier über die Schnittstelle Einstellungen oder im Web oder der App einstellen.

Hinweis: Die erste Einstellung muss auf der Seite oder in der App vorgenommen werden; Einstellungsoption im Hauptmenü der Handelsseite – Kontomodus.

Was bedeutet „Interface error: 51121 Order quantity must be a multiple of the lot size“?

In der API werden Kontraktorders in Sheets angegeben und müssen ein Vielfaches der Mindestordermenge des jeweiligen Währungspaares sein. Die Mindest-Ordermenge kann hier über das Feld minSz der Produktschnittstelle abgerufen werden.

„Auszahlungsfehler: 58207 Die Auszahlungsadresse ist nicht für die Verifizierungsbefreiung auf der Whitelist aufgeführt.“ Warum meldet die Whitelist-Überprüfung immer noch einen Fehler, obwohl sie auf der Auszahlungsseite geschlossen ist?

Um Coins über die API-Schnittstelle auszuzahlen, musst du eine Auszahlungsadresse auf der Seite hinzufügen und die Schaltfläche „Nicht von Visa verifiziert“ aktivieren. Ob die Allowlist-Verifizierung auf der Seite ausgeschaltet ist, hat keinen Einfluss auf die Funktion der Schnittstelle.

Was bedeutet „Schnittstellenfehler: 50004 Zeitüberschreitung bei der API-Endpunkt-Anfrage“ (bedeutet nicht, dass die Anfrage erfolgreich war oder fehlgeschlagen ist, bitte überprüfe das Ergebnis der Anfrage)

50004 wird in der Regel durch übermäßigen Druck auf den Server verursacht. Die Kapitalgebühren werden täglich um 8, 16 und 24 Uhr eingezogen. Zu dieser Zeit ist der Druck auf die Server hoch. Es wird empfohlen, Transaktionen zu diesen Zeiten zu staffeln. Wenn zu anderen Zeiten ein Fehler 50004 gemeldet wird, kann der Vorgang später wiederholt werden. Wenn eine Order mit der Fehlermeldung 50004 platziert wird, entspricht dies nicht dem tatsächlichen Ergebnis der Schnittstellenanfrage. Die Anfrage kann erfolgreich sein oder fehlschlagen. Bitte beachte das tatsächliche Ergebnis.

Hinweis: Wenn du weitere Fragen oder andere API-bezogene Anfragen hast, kannst du uns kontaktieren, indem du den untenstehenden Code über die App scannst.

Was bedeutet der Fehler „50119 API-Schlüssel existiert nicht“?

Dieser Fehler tritt normalerweise auf, wenn die Domain deines Kontos nicht mit deiner Region übereinstimmt.

  • EWR-Nutzer ändern bitte den Domain-Namen ihrer API-Anfrage von www.okx.com in eea.okx.com.

  • US-Nutzer ändern bitte den Domain-Namen ihrer API-Anfrage von www.okx.com in us.okx.com.

  • Wenn du für die Verbindung mit OKX eine Software von Drittanbietern verwendest und diese Fehlermeldung erhältst, erkundige dich bitte beim Softwareanbieter, ob regionale Domains unterstützt werden. EWR-Nutzer müssen sich beispielsweise über eea.okx.com verbinden. Andernfalls wird die Anfrage fehlschlagen.

Warum wird beim Verbinden mit einer Drittanbietersoftware der Fehler „50110“ angezeigt?

Dieser Fehler kann auftreten, wenn der aktuelle API-Schlüsseltyp nicht mit der Verbindung zur Drittanbietersoftware kompatibel ist. Beantrage den API-Schlüsseltransaktionstyp, ohne eine IP-Liste zu verbinden, und stelle dann die Verbindung zur Drittanbietersoftware erneut her.