OKX API Häufig gestellte Fragen

Veröffentlicht am 20. Sept. 2024Aktualisiert am 20. Juli 2026Lesezeit: 11 Min.142

Wofür steht Passphrase?

Dies ist das Passwort, das du bei der Beantragung des API-Schlüssels eingegeben hast. Du musst es dir selbst merken. Wenn du es vergisst, kannst du es nicht wiederherstellen und musst einen neuen API-Schlüssel erstellen.

Wie erstelle ich einen API-Schlüssel?

In der App:

1. Melde dich bei deinem OKX-Konto an > Wähle Menü (⋮⋮⋮) > Scrolle nach unten und wähle API > API-Schlüssel erstellen

2. Fülle den API-Namen aus > Wähle Konto und Zweck aus > Gib die IP-Adresse Allowlist ein > Wähle Berechtigungen aus > Gib die Passphrase ein

Im Web:

1. Melde dich bei deinem OKX-Konto an > Gehe zu deinem Profil und wähle API und Verbindungen > API-Schlüssel erstellen

2. Gib den API-Schlüssel-Namen ein > Wähle Konto und Verwendung aus

3. Gib die IP-Adress-Allowlist ein > Wähle Berechtigungen > Gib die Passphrase ein

Hinweis:

  • IP-Adressen helfen, deinen API-Schlüssel zu sichern. Du kannst bis zu 20 Adressen pro Schlüssel verknüpfen, getrennt durch ein Komma oder ein Leerzeichen.

  • Du musst die API-Informationen ansehen und auf die Schnittstelle zugreifen. Bitte bewahre dein Passwort sicher auf. Du kannst eine neue API erstellen, wenn du das Passwort verlierst, da wir APIs nicht wiederherstellen können.

Wie verwalte oder bearbeite ich den API-Schlüssel?

Um deinen API-Schlüssel bei OKX zu verwalten oder zu bearbeiten:

  1. Melde dich bei deinem OKX-Konto an und gehe zu Profil > API.

  2. Du siehst eine Liste deiner vorhandenen API-Schlüssel. Klicke auf den, den du verwalten möchtest.

  3. Von hier aus kannst du:

    • Sieh dir den Namen des API-Schlüssels, die Berechtigungen und die verknüpfte IP-Whitelist an.

    • Bearbeite den Schlüsselnamen, die Berechtigungen (Lesen, Handeln, Auszahlen) oder die gebundenen IP-Adressen.

    • Lösche den Schlüssel, wenn er nicht mehr benötigt wird.

Hinweis: Du kannst die Passphrase nach der ersten Erstellung nicht mehr ansehen. Wenn du sie verlierst, musst du den bestehenden Schlüssel löschen und einen neuen erstellen. Bewahre deine Zugangsdaten immer sicher auf.

Wie kann ich zwischen Spot- und Margin-Trading unterscheiden, wenn ich über die API handle?

Die Unterscheidung zwischen Spot- und Margin-Trading über die API kann je nach deinem Kontotyp und deinen Einstellungen variieren. Wir empfehlen, die OKX API-Dokumentation für die genauesten und aktuellsten Parameter zu deinem Kontoeinrichtung zu konsultieren.

Wenn du weitere Klarstellungen benötigst, wende dich bitte an den OKX Assistant für eine persönliche Beratung.

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

Um auf der Demo-Disk-API zu traden, musst du einen API-Schlüssel auf der Demo-Disk erstellen. Folge den untenstehenden Schritten:

Melde dich bei deinem OKX-Konto an > Handel > Demo-Trading > Persönliches Zentrum > API-Schlüssel für Demo-Konto erstellen > Demo-Trading starten

Läuft der API-Schlüssel ab?

API-Schlüssel, die nicht an eine IP gebunden sind und Transaktions- oder Auszahlungserlaubnisse haben, werden nach 14 Tagen Inaktivität automatisch gelöscht. API-Schlüssel gelten nicht als inaktiv, wenn sie verwendet werden, um private oder kontobezogene Schnittstellen aufzurufen, die eine Identitätsverifizierung erfordern, wie z. B. das Anzeigen des Guthabens, der Abrechnungsdaten oder das Platzieren von Aufträgen.

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

Was sind die Berechtigungen für Loan, Earn und Transfer?

  • Transfer: Ermöglicht dem Schlüssel, Gelder zwischen deinen Konten zu transferieren. Für alle Konten verfügbar.

  • Loan: Ermöglicht es dem Schlüssel, Loans zu leihen, zurückzuzahlen und zu verwalten. Nur sichtbar, wenn dein Konto die erforderliche Funktionsberechtigung hat.

  • Earn: Ermöglicht dem Schlüssel, Earn-Produkte zu abonnieren und auszahlen zu lassen. Nur sichtbar, wenn dein Konto die erforderliche Funktionsberechtigung hat.

Wenn dein API-Schlüssel zuvor die Trade-Berechtigungen aktiviert hatte, werden mit diesem Update alle drei Berechtigungen automatisch aktiviert. Keine manuelle Einrichtung ist erforderlich.

Können Bestellungen beim Aufgeben von Aufträgen über die Benutzeroberfläche in Währungseinheiten getätigt werden?

Nein; bei Kontraktaufträgen ist die Schnittstelle standardmäßig auf Aufträge in Anzahl der Kontrakte eingestellt. Wenn du die Umrechnung zwischen der Anzahl der Kontrakte und Coins berechnen musst, kannst du dich an der Schnittstelle zur Umrechnung von Kontrakten in Coins hier orientieren.

Wie erhält man die Schwankungsrate der Schnittstelle?

Die Oberfläche kann die Preissteigerung oder den Preisrückgang nicht direkt ermitteln, aber sie kann über eine Berechnungsformel berechnet werden.

Der Anstieg und Fall des Werts des letzten Transaktionspreises im Vergleich zum Eröffnungspreis der K-Linie vor 24 Stunden / 100 % des Eröffnungspreises der K-Linie vor 24 Stunden.

Die obigen Formeldaten können über die Marktoberfläche hier abgerufen werden.

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

Du musst zuerst den Kontomodus überprüfen; Kauf- und Verkaufsmodus/Öffnungs- und Schließmodus, der hier eingesehen werden kann, um posMode zu erhalten.

Hinweis:

  • Beim Öffnen und Schließen von Positionen sowie beim Platzieren von Orders mit einem Kontrakt ist der Parameter posSide erforderlich, und es wird Long oder Short eingetragen.

  • Wenn es sich um einen Kauf- und Verkaufsmodus handelt oder eine Kryptowährungs- oder 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?

Du kannst die Oberfläche nutzen, um grundlegende Informationen zu Handelsprodukten hier zu erhalten.

Nennwert des Kontrakts: ctVal, Mindestbestellmenge: minSz.

Wie ist das Format von instId?

Du kannst die Schnittstelle direkt nutzen, um die Basisinformationen zu Handelsprodukten hier zu erhalten.

Wie setzt man Stop-Loss und Take-Profit?

Wenn die Order an Take-Profit oder Stop-Loss angehängt ist, kannst du dich an der Order-Oberfläche hier orientieren: Parameter des attachAlgoOrds-Arrays.

Wenn es sich jedoch um einen separaten Stop-Loss für eine Order handelt, kannst du die Strategie-Provision-Schnittstelle hier einsehen.

Warum wird ein Fehler gemeldet, wenn der Trigger-Preis für Take-Profit und Stop-Loss auf 51046, 51047, 51048, 51049 gesetzt wird?

Regeln für das Festlegen des Stop-Loss-Trigger-Preises/Take-Profit-Trigger-Preises – beim Verkauf ist der Take-Profit-Trigger-Preis höher als der letzte Transaktionspreis, und der Stop-Loss-Trigger-Preis ist niedriger als der letzte Transaktionspreis; beim Kauf ist der Take-Profit-Trigger-Preis niedriger als der letzte Transaktionspreis, und der Stop-Loss-Trigger-Preis ist höher als der letzte Transaktionspreis.

Was bedeutet „Interface-Fehler: 50102 Timestamp-Anfrage verfallen“?

Dieser Fehler tritt auf, wenn der Zeitstempel verfallen ist. Du musst hier die Systemzeit-Schnittstelle aufrufen, um deine lokale Zeit mit der Serverzeit von uns zu synchronisieren. Wenn die Zeitdifferenz innerhalb von 30 Sekunden bleibt, kann dies helfen, dieses Problem zu vermeiden.

Hinweis: Die Zeit im Anforderungsheader ist in UTC0 angegeben. Beim Aufruf der Serverzeit-Schnittstelle wird die Zeit in UTC + 8 bereitgestellt.

Was bedeutet „Interface-Fehler: 50101 APIKey stimmt nicht mit der aktuellen Umgebung überein“?

Dies liegt an der Nichtübereinstimmung zwischen dem API-Schlüssel und der aktuellen Umgebung. Für Aufrufe des echten Kontos muss der API-Schlüssel des echten Kontos verwendet werden, und der Wert des Parameters x-simulated-trading im Anforderungsheader muss 0 sein. Für Aufrufe des simulierten Kontos muss der API-Schlüssel des simulierten Kontos verwendet werden, und der Wert des Parameters x-simulated-trading im Anforderungsheader muss 1 sein.

Was bedeutet „Interface-Fehler: 51010 Anfrage unter dem aktuellen Kontomodus nicht unterstützt“?

Das hängt mit deinem Kontomodus zusammen. Wenn du einen Hebel oder Kontrakt für eine einzelne Währung platzieren möchtest, musst du auf einen der drei anderen Modi wechseln, außer dem Spot-Modus! Du kannst dies über die Einstellungen in der Benutzeroberfläche hier vornehmen oder es auf der Webseite oder in der App einstellen.

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

Was bedeutet „Interface-Fehler: 51121 Die Order-Menge muss ein Vielfaches der Losgröße sein“?

Im API sind Kontrakt-Orders in Einheiten von Sheets angegeben und müssen ein Vielfaches der Mindestbestellmenge des Währungspaars sein. Die Mindestbestellmenge kann über das Feld minSz der Produkt-Schnittstelle hier abgerufen werden.

„Auszahlungsfehler: 58207 Auszahlungsadresse ist nicht auf der Allowlist für Verifizierungsausnahme“; warum wird bei geschlossener Allowlist-Verifizierung auf der Auszahlungsseite trotzdem ein Fehler angezeigt?

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

Was bedeutet „Interface-Fehler: 50004 API-Endpunkt-Anforderungszeitüberschreitung“ (bedeutet nicht, dass die Anfrage erfolgreich oder fehlgeschlagen ist, bitte überprüfe das Ergebnis der Anfrage)?

50004 wird normalerweise durch übermäßigen Serverdruck verursacht. 8, 16 und 24 Uhr sind die Zeitpunkte für die Erhebung von Kapitalgebühren jeden Tag. Zu diesen Zeiten ist der Serverdruck hoch. Es wird empfohlen, Transaktionen zu diesen Zeiten zu staffeln. Wenn zu anderen Zeiten ein Fehler 50004 gemeldet wird, kann es später erneut versucht werden. Wenn eine Order mit einem Fehler 50004 aufgegeben wird, stellt dies nicht das tatsächliche Ergebnis der Schnittstellenanfrage dar. Die Anfrage kann erfolgreich sein oder fehlschlagen. Bitte orientiere dich am tatsächlichen Ergebnis.

Was bedeutet der Fehler „50119 API key existiert nicht“?

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

  • Für EEA-Nutzer ändere bitte deinen API-Anforderungs-Domain-Namen zu eea.okx.com anstelle von www.okx.com.

  • Für US-Nutzer ändere bitte deinen API-Anforderungs-Domain-Name zu us.okx.com anstelle von www.okx.com.

  • Wenn du eine Drittanbieter-Software verwendest, um dich mit OKX zu verbinden, und diesen Fehler siehst, überprüfe bitte beim Softwareanbieter, ob regionale Domains unterstützt werden. Zum Beispiel müssen Nutzer aus dem EWR über eea.okx.com verbinden, sonst schlägt die Anfrage fehl.

Warum wird der Fehler „50110“ angezeigt, wenn du dich mit einer Drittanbieter-Software verbindest?

Dieser Fehler kann auftreten, wenn der aktuelle API-Schlüsseltyp nicht mit der Drittanbieter-Softwarebindung kompatibel ist. Versuche, den API-Schlüssel für den Transaktionstyp zu beantragen, ohne eine IP-Liste zu binden, und verbinde dann die Drittanbieter-Software erneut.

Wie erhalte ich den neuesten Transaktionspreis eines bestimmten Währungspaars?

Verwende Details hier für Ticker und für Ticker einzeln hier. Die Ticker-Schnittstelle wird verwendet, um die neuesten Transaktionspreise von Währungspaaren in Chargen zu erhalten, und Ticker wird verwendet, um die neuesten Transaktionspreise einzelner Währungspaare zu erhalten.

Beispiel für den Antwortparameter des zuletzt gehandelten Preises im Bereich Ticker

Was sind die Voraussetzungen, um einen API-Schlüssel zu erstellen?

Ein Mindestguthaben von 100 USD an verwaltetem Vermögen (Assets Under Management, AUM) ist erforderlich, um einen API-Schlüssel zu erstellen.

  • Ein AUM von mehr als 100 USD (AUM > 100U) ist erforderlich, um einen API-Schlüssel zu erstellen

  • Für Hauptkonten oder Unterkonten dürfen nur Konten mit einem AUM > 100U API-Schlüssel erstellen.

Hinweis: Diese Anforderung gilt nur für Nutzer in bestimmten Regionen

Hinweis:

Wenn du Fragen zu WebSocket oder anderen API-bezogenen Themen hast, klicke auf den Artikel-Link und scanne den QR-Code am Ende des Artikels mit der OKX-App, um der Gruppe beizutreten und unseren API-Support-Spezialisten zu kontaktieren.

So scannst du: Tippe in der App auf Menü > das Scan-Symbol und scanne den QR-Code.