OKX API Häufig gestellte Fragen
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:
Melde dich bei deinem OKX-Konto an und gehe zu Profil > API.
Du siehst eine Liste deiner vorhandenen API-Schlüssel. Klicke auf den, den du verwalten möchtest.
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 zu konsultieren, um die genauesten und aktuellsten Parameter zu erhalten, die für deine Kontoeinrichtung gelten.
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 Kontrakt-Orders ist die Schnittstelle standardmäßig auf Orders 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-Name 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, über hier. Die Ticker-Schnittstelle wird verwendet, um den neuesten Transaktionspreis von Währungspaaren in Chargen zu erhalten, und Ticker wird verwendet, um den neuesten Transaktionspreis 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
Was soll ich tun, wenn sich WebSocket nicht verbinden kann oder ständig die Verbindung trennt?
Bestätige, dass du die korrekte WebSocket-URL für deine Website und den API-Dienst verwendest. Überprüfe dein Netzwerk, Proxy-, TLS-Einstellungen, Abonnementparameter, Ping/Pong-Herzschlag und die Wiederverbindungslogik. Wenn das Problem weiterhin besteht, gib den Kanal, die Auftretenszeit, die vollständige Fehlermeldung und geschwärzte Protokolle an.
Wie sollte ich bei einem API-Fehlercode oder einem ungültigen Anforderungsparameter vorgehen?
Schau im offiziellen API-Dokumentation deiner Seite nach dem Fehlercode nach und verifiziere dann den Endpunkt, die HTTP-Methode, die Anfrageparameter, den Kontomodus und die Produktbeschränkungen. Wenn die Ursache weiterhin unklar ist, gib den vollständigen Fehlercode, sCode/sMsg, die Auftretenszeit sowie die geschwärzten Anfrage- und Antwortdaten an.
Warum ist meine API-Orderaufgabe, -änderung oder -stornierung fehlgeschlagen?
Bitte verwende die vom API zurückgegebene Fehlermeldung und den Fehlercode, um die genaue Ursache zu bestimmen. Wenn du nicht sicher bist, was der Fehler bedeutet, gib bitte die vollständigen Anforderungsparameter und Fehlerdetails an, damit wir weiter untersuchen können.
Was soll ich tun, wenn Marktdaten, Candlesticks oder Orderbuchdaten falsch aussehen?
Bestätige den Kanalnamen, instId, die Abonnementparameter und die Anforderungsfrequenz und unterscheide zwischen Snapshot-Daten und inkrementellen Updates. Überprüfe bei Orderbüchern außerdem die Sequenz-IDs und Zeitstempel. Wenn Daten fehlen, notiere den Kanal, den Zeitbereich und die geschwärzte Rohantwort.
Warum unterscheiden sich API-Guthaben, Positionen oder Margin-Werte von denen auf der Website oder in der App?
Unterscheide zuerst zwischen dem Handelskonto und dem Finanzierungskonto, verifiziere dann den Kontomodus, die Währungsdimension, den Endpunkt und die Datenaktualisierungszeit. Für Berechnungen von Guthaben, Position und Margin verwende die aktuellste Produkt- und API-Dokumentation für die jeweilige Seite.
Was soll ich tun, wenn eine API-Einzahlung, Auszahlung oder Überweisung fehlschlägt?
Überprüfe die API-Berechtigungen, Währung, das Netzwerk, das Zielkonto sowie eventuelle Anforderungen an das Adressbuch oder die Whitelist und behebe dann Probleme anhand des zurückgegebenen Fehlercodes. Einschränkungen bezüglich Kontosicherheit, Compliance oder Risiko können eine weitere Überprüfung durch den Support der jeweiligen Seite erfordern.
Wie erstelle und verwende ich einen API-Schlüssel für ein Unterkonto?
Erstelle den API-Schlüssel unter dem vorgesehenen Unterkonto und verwende die Berechtigungen, die Passphrase und die Domain dieses Unterkontos. Vermische nicht den API-Schlüssel, das Secret oder die Passphrase des Hauptkontos mit denen des Unterkontos.
Was soll ich tun, nachdem ich ein API-Rate-Limit ausgelöst habe?
Reduziere die Anfragerate entsprechend dem Limit für den jeweiligen Endpunkt und verwende bei Bedarf Warteschlangen, exponentielles Backoff oder Batch-Endpunkte. Der Geltungsbereich und das Kontingent der Ratenbegrenzung können je nach Endpunkt unterschiedlich sein, daher solltest du nicht davon ausgehen, dass alle Endpunkte dieselbe Zulassung haben.
Wo finde ich API-Dokumentationen, SDKs und Codebeispiele?
Du kannst dich auf die API-Dokumentation (V5) beziehen. REST + WebSocket-Referenz, Changelog, Fehlercodes, Beispielanfragen/-antworten pro Endpunkt. Offizielle SDKs (GitHub) — github.com/okxapi Codebeispiele findest du im SDK.
Welche Informationen sollte ich angeben, wenn ich nur sagen kann, dass die API nicht funktioniert?
Gib den Endpunkt, die HTTP-Methode, die beabsichtigte Operation, den vollständigen Fehlercode oder die Fehlermeldung, die Auftretenszeit, die Kontoseite, die Netzwerkumgebung sowie die geschwärzten Anfrage- und Antwortdaten an. Sende niemals einen API-Secret, Passphrase, Verifizierungscode oder eine ungeschwärzte Signatur.
Was soll ich tun, wenn ich noch Fragen zur API habe? Oder kann ich mit dem API-Kundendienst chatten?
Wenn du weitere Fragen hast, kannst du gerne unserer API-Support-Gruppe beitreten:
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.