So zeigen Sie historische Futures-Aufträge auf OKX an

Zugriff auf historische Futures-Aufträge über die OKX-Webschnittstelle

1. Melden Sie sich bei Ihrem OKX-Konto an und navigieren Sie zum Abschnitt „Futures -Handel“.

2. Klicken Sie oben in der Handelsoberfläche auf die Registerkarte „Bestellungen“ .

3. Wählen Sie die Unterregisterkarte „Verlauf “, um abgeschlossene, stornierte und abgelaufene Futures-Bestellungen anzuzeigen.

4. Verwenden Sie den Datumsbereichsfilter, um die Start- und Endzeitstempel für den Abruf festzulegen – das Standardfenster deckt die letzten 90 Tage ab.

5. Wenden Sie Instrumentenfilter wie BTC-USDT-SWAP oder ETH-USDT-QUARTER an, um die Ergebnisse nach Vertragstyp und Basiswert einzugrenzen.

Abrufen der Futures-Auftragshistorie über die REST-API

1. Initialisieren Sie die TradeAPI- Klasse von python-okx mit gültigen Anmeldeinformationen und setzen Sie flag='0' für die Produktionsumgebung.

2. Rufen Sie die Methode get_orders_history_archive auf und übergeben Sie Parameter wie instType='SWAP' , instId='BTC-USDT-SWAP' und limit=100 .

3. Blättern Sie mithilfe des Parameters before durch die Antworten. Der Wert wird aus dem ordId Feld des ältesten Datensatzes in jedem Stapel extrahiert.

4. Parse zurückgegebene JSON-Struktur: Jeder Eintrag enthält ordId , px , sz , side , state , fillSz , avgPx und ts (Millisekunden-Zeitstempel).

5. Speichern Sie Rohantworten in chronologischer Reihenfolge, nachdem Sie die standardmäßige absteigende Sortierung umgedreht haben, und überprüfen Sie dann die Vollständigkeit, indem Sie auf aufeinanderfolgenden Seiten auf Lücken in ts Werten prüfen.

Datenintegrität und Zeitbereichsbeschränkungen

1. OKX speichert den Futures-Auftragsverlauf bis zu 180 Tage lang auf der Weboberfläche, der API-Zugriff erstreckt sich jedoch auf 365 Tage für institutionelle Konten.

2. Datensätze, die älter als 90 Tage sind, erfordern eine explizite instType Angabe. Wenn Sie diese weglassen, werden leere Daten zurückgegeben, selbst wenn instId angegeben wird.

3. Das state enthält Werte wie „filled“ , „canceled “, „partial_filled “, „ expired “ und „ failed “. „fehlgeschlagen“ weist auf eine Auftragsablehnung aufgrund unzureichender Marge oder ungültiger Parameter hin.

4. Zeitstempel sind immer in UTC und passen sich nicht an die Sommerzeit an; Die lokale Zeitkonvertierung muss clientseitig mithilfe von datetime.timezone.utc in Python erfolgen.

5. Bestell-IDs sind unveränderliche Zeichenfolgen mit dem Präfix ORD , gefolgt von 18 alphanumerischen Zeichen – es gibt keine Garantien für die numerische Reihenfolge über Chargen hinweg.

Häufige Fallstricke beim Abrufen historischer Bestellungen

1. Die Verwendung get_orders_history anstelle von get_orders_history_archive liefert unabhängig von Paginierungsversuchen nur die letzten 90 Tage.

2. Die Übergabe eines ungültigen before Werts – etwa einer nicht vorhandenen ordId oder einer, die älter als 365 Tage ist – löst den Fehlercode 50015 („Ungültiger Vor-Parameter“) aus.

3. Das Weglassen von instType bei der Angabe von instId gibt HTTP 200 mit leerem data zurück, anstatt einen expliziten Validierungsfehler auszulösen.

4. Das Mischen von flag='1' (Demo-Modus) mit Produktions instId Werten führt zu stillen Nichtübereinstimmungen – im Demo-Modus aufgegebene Bestellungen erscheinen nie in Endpunkten mit realem Kontoverlauf.

5. Unter der Annahme, dass fillSz für ausgeführte Aufträge gleich sz ist, werden Teilausführungen aus durch Liquidation ausgelösten Ausführungen ignoriert, wobei fillSz aufgrund kaskadierender Marktauswirkungen den ursprünglichen sz überschreiten kann.

Häufig gestellte Fragen

F: Kann ich historische Futures-Aufträge ohne API-Schlüssel abrufen? Nein. Alle Endpunkte unter /api/v5/trade/orders-history-archive erfordern eine vollständige Authentifizierung, einschließlich OK-ACCESS-KEY , OK-ACCESS-SIGN , OK-ACCESS-TIMESTAMP und OK-ACCESS-PASSPHRASE . Öffentliche Endpunkte legen den Bestellverlauf nicht offen.

F: Warum erscheint in den Antworten orders-history und orders-history-archive dieselbe ordId ? Dies geschieht, wenn eine Bestellung innerhalb der letzten 90 Tage aufgegeben wurde und auch für die Archivierung in Frage kommt. Das System behält die doppelte Indizierung bei, garantiert aber bei überlappenden Datensätzen identische Nutzlastinhalte auf beiden Endpunkten.

F: Gibt es eine Ratenbegrenzung für get_orders_history_archive -Aufrufe? Ja. Der Endpunkt erzwingt 20 Anfragen alle 2 Sekunden pro IP-Adresse. Bei Überschreitung wird HTTP 429 mit Retry-After Header ausgelöst, der die obligatorische Pausendauer angibt.

F: Erscheinen Stop-Market-Orders in historischen Orderdatensätzen, wenn sie nie ausgelöst wurden? Ja. Nicht ausgelöste bedingte Bestellungen bleiben im Verlauf mit state='canceled' wenn sie manuell entfernt werden, oder state='pending' wenn sie über ihre Ablaufzeit hinaus noch aktiv sind. Diese beträgt standardmäßig 30 Tage, sofern sie nicht bei der Platzierung überschrieben wird.