Wie verwalte ich API-Berechtigungen für den Spothandel auf OKX?

API-Berechtigungskonfiguration für Spot-Handel

1. Greifen Sie nach Abschluss der Identitätsüberprüfung auf den Abschnitt „API-Verwaltung“ in Ihrem OKX-Konto-Dashboard zu.

2. Klicken Sie auf „API-Schlüssel erstellen“ und wählen Sie die spezifischen Berechtigungen aus, die für Spot-Handelsvorgänge erforderlich sind.

3. Aktivieren Sie die Berechtigung „Lesen“, um Kontostandinformationen, Bestellhistorie und Marktdaten abzurufen.

4. Aktivieren Sie die Berechtigung „Handel“, um Spot-Orders für alle unterstützten Handelspaare zu platzieren, zu stornieren und zu ändern.

5. Vermeiden Sie es , „Auszahlung“ zu aktivieren, es sei denn, dies ist ausdrücklich erforderlich, da dies ein erhöhtes Sicherheitsrisiko mit sich bringt, das nichts mit der Spot-Ausführung zu tun hat.

IP-Whitelisting und Authentifizierungshärtung

1. Weisen Sie jedem API-Schlüssel, der für den Spothandel verwendet wird, eine statische IPv4- oder IPv6-Adresse oder ein CIDR-Subnetz zu.

2. Bestätigen Sie, dass die IP-Bindung aktiv ist, bevor Sie handelsbezogene Anfragen initiieren. Ungebundene Schlüssel mit Handelserlaubnis verfallen nach 14 Tagen Inaktivität.

3. Verwenden Sie HMAC-SHA256-Signaturen für jeden privaten Endpunktaufruf, einschließlich Zeitstempel, HTTP-Methode, Anforderungspfad und Body-Hash.

4. Speichern Sie die Passphrase getrennt vom geheimen Schlüssel und stellen Sie sicher, dass sie niemals protokolliert oder in Stack-Traces offengelegt wird.

5. Tauschen Sie API-Schlüssel vierteljährlich aus und widerrufen Sie veraltete Schlüssel sofort über die API-Verwaltungsschnittstelle.

Einschränkungen bei der Ausführung von Spot-Orders

1. Geben Sie tdMode = 'cash' in allen Spot-Order-Nutzlasten an, um eine versehentliche Aktivierung des Margin- oder Finanzierungsmodus zu verhindern.

2. Überprüfen Sie die Preis- und Größengenauigkeit anhand der Instrumentenmetadaten von OKX, bevor Sie Aufträge absenden. BTC-USDT erfordert eine Preisgenauigkeit von 0,01 und eine Größengenauigkeit von 0,00000001.

3. Setzen Sie ordType = 'limit' oder 'market' explizit; Das Weglassen dieses Felds führt zu einem inkonsistenten Standardverhalten in allen Umgebungen.

4. Schließen Sie clOrdId für die clientseitige Auftragsverfolgung ein und vermeiden Sie die Wiederverwendung von Kennungen über mehrere Sitzungen hinweg.

5. Überwachen Sie Antwortcodes wie 50113 (Signaturkonflikt) und 58007 (Preisabweichung außerhalb des Auktionsbereichs), die beide häufig bei falsch konfigurierten Spot-Einreichungen auftreten.

Testen des Workflows mit der OKX-Demoumgebung

1. Registrieren Sie einen separaten API-Schlüssel unter der Testnet-Domäne mit Flag=1, um den Simulationsverkehr von Live-Guthaben zu isolieren.

2. Laden Sie Demokonten mit dem OKX-Faucet ohne KYC-Anforderungen auf – jede Zuweisung läuft nach 72 Stunden ab.

3. Führen Sie eine identische Spot-Order-Logik sowohl im Testnetz als auch in der Produktion aus und vergleichen Sie Latenz, Ablehnungsraten und Zeitpunkt der Ausführungsbestätigung.

4. Stellen Sie sicher, dass GET /api/v5/trade/orders-history-archive eine konsistente Paginierungsstruktur zwischen den Umgebungen zurückgibt.

5. Bestätigen Sie, dass das WebSocket-Abonnement für die Kanäle „books50-l2-tbt“ Tiefenaktualisierungen in Echtzeit ohne Authentifizierungsfehler liefert.

MiCA-konforme API-Governance für EU-Benutzer

1. OKX European Ltd verfügt seit dem 27. Januar 2025 über die vollständige MiCA-Zulassung für alle 30 EWR-Gerichtsbarkeiten.

2. EU-basierte API-Schlüssel erzwingen automatisch strengere Ratenbegrenzungen: 15 Anfragen pro Sekunde statt des globalen Standardwerts von 20.

3. Handelsendpunkte geben zusätzliche regulatorische Header zurück, einschließlich X-MiCA-Jurisdiction und X-Compliance-Level .

4. Alle Spot-Order-Bestätigungen enthalten eine unveränderliche ComplianceReferenceId, die an den MiCA-Registrierungsstatus des Basiswerts gebunden ist.

5. Abhebungsbezogene Endpunkte bleiben für EU-Schlüssel deaktiviert, sofern sie nicht ausdrücklich über das MiCA-Compliance-Portal aktiviert werden.

Häufig gestellte Fragen

F: Kann ich denselben API-Schlüssel sowohl für den Spot- als auch für den Futures-Handel verwenden? Ja, aber nur, wenn bei der Erstellung die Berechtigung „Handel“ für beide InstType-Kategorien aktiviert ist. Aus Gründen der Prüfungsklarheit werden separate Schlüssel empfohlen.

F: Warum gibt meine Spotbestellung den Fehlercode 58000 zurück? Dies zeigt an, dass das angeforderte Instrument für den Handel ausgesetzt ist. Überprüfen Sie die offizielle Instrumentenstatusseite von OKX oder rufen Sie GET /api/v5/public/instruments mit instType=SPOT auf.

F: Ist bei der Passphrase die Groß-/Kleinschreibung beachtet? Ja. OKX speichert seinen SHA-256-Hash und jede Abweichung in der Groß-/Kleinschreibung führt zu einer ungültigen Signatur.

F: Wie überprüfe ich, ob mein API-Schlüssel kompromittiert wurde? Überprüfen Sie die Registerkarte „Letzte Aktivität“ in API Management. Nicht erkannte IP-Adressen, unerwartete Abhebungsversuche oder Spitzen im Auftragsstornierungsvolumen signalisieren die Gefährdung.