So verwenden Sie die API für den automatisierten Handel mit OKX

Die OKX-API ermöglicht den automatisierten Handel über REST- und WebSocket-Schnittstellen, sodass Bestellplatzierung, Echtzeitdaten-Streaming und Kontoverwaltung mit sichere HMAC-Authentifizierung ermöglicht werden.

Aug 07, 2025 at 05:21 pm

Verständnis der OKX -API für den automatisierten Handel

Die OKX-API bietet Benutzern eine leistungsstarke Schnittstelle, um ihre Handelsstrategien zu automatisieren, auf Echtzeit-Marktdaten zuzugreifen und ihre Konten programmgesteuert zu verwalten. Vor dem Initiieren eines automatisierten Handels ist es wichtig, die von OKX angebotenen APIs zu verstehen. Die Plattform unterstützt REST -API , WebSocket -API und Web3.JS -API , wobei die ersten beiden für den automatisierten Handel am relevantesten sind. Mit der Rest -API können Sie Bestellungen aufgeben, Balden überprüfen und historische Daten mithilfe von HTTP -Anforderungen abrufen. Die WebSocket-API ermöglicht das Echtzeit-Streaming von Marktdaten, Bestellaktualisierungen und Kontoänderungen mit geringer Latenz.

Um loszulegen, müssen Sie einen API -Schlüssel aus Ihrem OKX -Konto generieren. Navigieren Sie zum API -Verwaltungsabschnitt unter Ihren Kontoeinstellungen. Hier erstellen Sie einen neuen API -Schlüssel, indem Sie einen Namen, eine Passphrase und einen Bindungs -IP -Adressen für die Sicherheit angeben. Es ist wichtig, den Zugriff auf bestimmte IPs einzuschränken, um die nicht autorisierte Nutzung zu verhindern. Der generierte Schlüssel besteht aus drei Komponenten: API -Schlüssel , geheimer Schlüssel und Passphrase . Diese müssen sicher gespeichert werden, da sie Ihren Handelskonto voll und ganz zugreifen können.

Einrichten Ihrer Entwicklungsumgebung

Um die OKX -API effektiv zu verwenden, benötigen Sie eine geeignete Entwicklungsumgebung. Die meisten Entwickler verwenden Python aufgrund seiner Einfachheit und des reichen Ökosystems von Bibliotheken. Installieren Sie Python (vorzugsweise Version 3.8 oder höher) und richten Sie eine virtuelle Umgebung ein, um Abhängigkeiten zu verwalten. Verwenden Sie PIP , um die erforderlichen Pakete wie requests für HTTP -Kommunikation und websockets für die Behandlung von WebSocket -Verbindungen zu installieren.

 pip install requests websockets

Erstellen Sie anschließend eine Konfigurationsdatei (z. B. config.py ), um Ihre API -Anmeldeinformationen sicher zu speichern. Hardcodieren Sie Ihre Schlüssel niemals in Ihrem Hauptskript. Ihre Konfiguration sollte enthalten:

• API -Schlüssel
• Geheimer Schlüssel
• Passphrase
• Basis -URL (z. B. https://www.okx.com für Ruhe)

Stellen Sie sicher, dass diese Datei zu .gitignore hinzugefügt wird, wenn Sie die Versionskontrolle verwenden. Dies verhindert eine versehentliche Exposition von sensiblen Daten.

Authentifizierung von Anfragen mit OKX API

OKX verwendet die HMAC-SHA256 -Verschlüsselung zur Anforderungsauthentifizierung. Jede private API-Anfrage muss Header mit bestimmten Feldern enthalten: OK-ACCESS-KEY , OK-ACCESS-SIGN , OK-ACCESS-TIMESTAMP und OK-ACCESS-PASSPHRASE . Die Signatur wird durch Verkettung des Zeitstempels, HTTP -Methode, Endpunktpfad und Anforderungskörper (falls vorhanden) generiert und dann mit Ihrem geheimen Schlüssel unterzeichnet.

Hier erfahren Sie, wie Sie die Signatur in Python generieren können:

 import hmac
 import hashlib
 import json Def generate_signature (Zeitstempel, Methode, URL, Körper, Secret_key):

message = timestamp + method + url + (json.dumps(body) if body else '') mac = hmac.new(bytes(secret_key, 'utf-8'), bytes(message, 'utf-8'), hashlib.sha256) return mac.hexdigest()
 Geben Sie diese Funktion in Ihre API -Wrapper ein. Der Zeitstempel muss im ISO-Format sein (z. B. 2024-04-05T12:00:00.000Z ). Überprüfen Sie immer, ob die Systemuhr mit UTC synchronisiert ist, um Authentifizierungsfehler zu vermeiden.
 
Bestellungen über REST -API geben
 Verwenden Sie zum automatischen Ausführen von Trades den Endpunkt der Ortsbestellung . Die Endpunkt -URL ist /api/v5/trade/order . Sie müssen eine Postanforderung mit einem JSON -Körper mit den erforderlichen Parametern senden:
 
Instid : Instrumenten-ID (z. BTC-USDT-SWAP )
 TDMODE : Handelsmodus ( cash , isolated oder cross )
 ordType : Bestellentyp ( limit , market , post_only usw.)
 SZ : Bestellgröße
 PX : Preis (erforderlich für Grenzbestellungen)
 Beispiel Anfragekörper:
 
{
 'Instid': 'BTC-Usdt-Swap',
 'tdmode': 'cross',
 'ordtype': 'limit',,
 'SZ': '0,001',,
 'PX': '60000'
 }

Verwenden Sie die requests , um die Anfrage zu senden:

 import requests
 from config import API_KEY, SECRET_KEY, PASSPHRASE url = 'https://www.okx.com/api/v5/trade/order'
 Headers = {

'OK-ACCESS-KEY': API_KEY, 'OK-ACCESS-PASSPHRASE': PASSPHRASE, 'Content-Type': 'application/json'
 }
 
Body = {
 
'instId': 'BTC-USDT-SWAP', 'tdMode': 'cross', 'ordType': 'limit', 'sz': '0.001', 'px': '60000'
 }
 
TIMESTAMP = '2024-04-05T12: 00: 00.000Z'
 Signature = generate_signature (Zeitstempel, 'post', '/api/v5/fach/order', body, secry_key)
 
Header ['OK-Access-Sign'] = Signatur
 Header ['Ok-Access-Timestamp'] = Zeitstempel
 
response = requests.post (URL, Header = Header, JSON = Körper)
 print (response.json ())

Überprüfen Sie die Antwort auf code und msg . Ein code von 0 zeigt den Erfolg an.

Streaming -Marktdaten mit WebSocket

Für Echtzeit-Handelsentscheidungen stellen Sie eine Verbindung zur WebSocket-API von OKX her. Auf diese Weise können Sie Live -Updates für Bestellbücher, Trades und Ihren Bestellstatus erhalten. Verwenden Sie die websockets -Bibliothek, um eine Verbindung zu wss://ws.okx.com:8443/ws/v5/public für öffentliche Kanäle oder wss://ws.okx.com:8443/ws/v5/private für private Daten herzustellen.

Abonnieren Sie den Ticker- oder Tiefenkanal , um Preisänderungen zu überwachen:

 import asyncio
 import websockets
 import json Async def hör_to_ticker ():

uri = 'wss://ws.okx.com:8443/ws/v5/public' async with websockets.connect(uri) as websocket: subscribe_message = { 'op': 'subscribe', 'args': [ { 'channel': 'tickers', 'instId': 'BTC-USDT' } ] } await websocket.send(json.dumps(subscribe_message)) while True: response = await websocket.recv() data = json.loads(response) if 'data' in data: print('Latest price:', data['data'][0]['last'])
 Führen Sie diese Coroutine aus, um kontinuierlich Aktualisierungen zu erhalten. Behandeln Sie Unterbrechungen und implementieren Sie die Wiederverbindungslogik für Robustheit.
 
Verwaltung von Risiken und Überwachungsaufträgen
 Der automatische Handel erfordert eine ständige Überwachung. Verwenden Sie den Endpunkt ( /api/v5/trade/order ) abrufen , um den Status einer bestimmten Bestellung nach ordId zu überprüfen. Bestellungen unter Verwendung des Endpunkts der Bestellung von Abbrechen ( /api/v5/trade/cancel-order ) Wenn sich die Marktbedingungen ändern.
 
Implementieren Sie die Protokollierung, um alle Aktionen aufzuzeichnen:
 
import logging
 logging.basicconfig (Dateiname = 'trading.log', Level = logging.info)
 
logging.info (f'order platziert: {response.json ()} ')

Richten Sie Warnungen für fehlgeschlagene Anfragen oder unerwartete Preisbewegungen ein. Verwenden Sie Leistungsschalter, um den Handel zu stoppen, wenn Verluste einen Schwellenwert überschreiten.

Häufig gestellte Fragen

Kann ich die OKX-API verwenden, ohne die Zwei-Faktor-Authentifizierung (2FA) zu aktivieren?

Nein. Aus Sicherheitsgründen erfordert OKX, dass 2FA in Ihrem Konto aktiviert werden soll, bevor Sie API -Schlüssel erstellen können. Dies fügt eine zusätzliche Schutzschicht vor unbefugtem Zugriff hinzu.

Welche Ratenbegrenzungen gelten für die OKX -API?

OKX erzwingt die Tarifgrenzen basierend auf der Art der Anfrage. Öffentliche Endpunkte ermöglichen bis zu 20 Anfragen pro 2 Sekunden pro IP . Die privaten Endpunkte sind auf 6 Anfragen pro 2 Sekunden pro API -Schlüssel begrenzt. Das Überschreiten dieser Grenzen führt zu einem 429 -Fehler.

Ist TestNet für die OKX -API -Entwicklung verfügbar?

Ja. OKX bietet eine Demo -Handelsumgebung, die über eine andere Basis -URL zugänglich ist: https://www.okx.com . Sie können Trades simulieren, ohne echte Fonds zu riskieren. Schalten Sie die Basis-URL in Ihrer Konfiguration und verwenden Sie demo-spezifische API-Schlüssel.

Wie gehe ich mit API -Ausfallzeiten oder Verbindungsverlust um?

Implementieren Sie die Wiederholungslogik mit exponentiellem Backoff. Für Websocket -Verbindungen hören Sie nach close Ereignissen und versuchen Sie nach einer Verzögerung wieder einher. Lagern Sie die Zustände vor Ort, um sich von Unterbrechungen zu erholen.