Wie finde ich den BTC/USDT-Markt auf OKX?

Zuordnung von Marktsymbolen

1. OKX verwendet ein standardisiertes Instrument-ID-Format, das sich von der üblichen Handelspaarnotation unterscheidet. Das Symbol BTC-USDT ist die offizielle Instrument-ID, die für alle OKX-API-Endpunkte und UI-Elemente verwendet wird.

2. Ältere Notationen wie BTC/USDT oder BTCUSDT werden von den Backend-Systemen von OKX nicht erkannt. Der Versuch, sie in API-Aufrufen zu verwenden, führt zu einer OkxParamsException mit dem Fehlercode 51000.

3. Das Format mit Bindestrich wird für alle Spot-, Margin- und unbefristeten Instrumente strikt eingehalten. Dazu gehören ETH-USDT, SOL-USDT und XRP-USDT – keine Schrägstriche, keine Verkettung, keine Unterstriche.

4. Beim Abrufen von Marktdaten über python-okx benötigt die Methode MarketAPI.get_ticker() die genaue Instrument-ID. Eine fehlerhafte Zeichenfolge löst eine sofortige Ablehnung aus, bevor eine Netzwerkanfrage gesendet wird.

5. Frontend-Benutzer können BTC-USDT finden, indem sie „BTC“ in die Suchleiste auf der Web- oder Mobilschnittstelle von OKX eingeben. Die automatische Vorschlagsliste zeigt nur gültige Instrumenten-IDs an und filtert nicht konforme Varianten heraus.

API-Endpunktnavigation

1. Der RESTful-Endpunkt für Tickerdaten ist /api/v5/market/ticker?instId=BTC-USDT . Bei diesem Pfad wird die Groß-/Kleinschreibung beachtet und es werden keine separaten Abfrageparameter wie „base“ oder „quote“ akzeptiert.

2. Der K-Line-Abruf verwendet /api/v5/market/candles?instId=BTC-USDT&bar=1H . Der Balkenparameter muss eines der vordefinierten Intervalle von OKX sein: 1m, 3m, 5m, 15m, 30m, 1H, 2H, 4H, 6H, 12H, 1D, 1W, 1M.

3. Auftragserteilungsendpunkte erfordern eine identische instId-Formatierung. Eine Handelsanfrage mit instId: „BTC/USDT“ gibt HTTP 400 mit der Meldung „Instrument ID invalid“ zurück.

4. WebSocket-Abonnementnachrichten folgen derselben Regel. Die Kanalticker erwarten JSON-Nutzlast {'channel':'tickers','instId':'BTC-USDT'} . Jede Abweichung führt zu einer stillen Trennung ohne Fehlermeldung.

5. CCXT abstrahiert diese Zuordnung intern, macht sie jedoch transparent über das Exchange.markets -Objekt verfügbar. Entwickler können Exchange.markets['BTC/USDT'].id überprüfen, um das aufgelöste OKX-native-Symbol zu überprüfen.

Verhalten der Frontend-Schnittstelle

1. Auf der Haupthandelsseite von OKX erscheint BTC-USDT standardmäßig unter der Registerkarte „Spot“ . Der Wechsel zu Margin oder Futures ändert den sichtbaren Instrumentensatz, ohne die zugrunde liegende Symbolstruktur zu ändern.

2. Das Orderbuch-Tiefendiagramm wird nur angezeigt, wenn die richtige Instrument-ID aktiv ist. Wenn die URL ?instrument_id=BTC%2FUSDT enthält, bleibt das Diagramm leer und es werden keine API-Anfragen ausgelöst.

3. Die Navigation in mobilen Apps basiert auf der dauerhaften Zwischenspeicherung der Instrumenten-ID. Wenn Sie in der Asset-Liste über BTC-USDT hinaus scrollen, wird das Symbol nicht neu geladen – es behält den letzten gültigen InstId-Status bei, bis es manuell geändert wird.

4. Historische Handelsprotokolle im Abschnitt „Konto > Verlauf“ verweisen ausschließlich auf alle Transaktionen, die BTC-USDT verwenden. Exportierte CSV-Dateien behalten dieses Format ohne Konvertierung bei.

5. Preiswarnungen, die über die UI-Store-Trigger unter Verwendung der nativen Instrument-ID konfiguriert werden. Wenn Sie eine Warnung für BTC/USDT bearbeiten, wird diese vor der Persistenz automatisch in BTC-USDT konvertiert.

Datenkonsistenz über Module hinweg

1. Die Module MarketData.py, Trade.py und Account.py in python-okx teilen sich eine einheitliche Symbolregistrierung. Es gibt keine separate Konfiguration pro Modul – eine Inkonsistenz würde die internen Validierungsprüfungen beeinträchtigen.

2. Websocket-Streams für die Kanäle „books5“ und „candle1m“ geben Nachrichten aus, die in jeder Nutzlast „instId“: „BTC-USDT“ enthalten. Clients, die Roh-JSON analysieren, müssen genau mit dieser Zeichenfolge übereinstimmen, um eine korrekte Weiterleitung zu ermöglichen.

3. Stapelabfragen für mehrere Instrumente erfordern durch Kommas getrennte BTC-USDT, ETH-USDT, SOL-USDT. Leerzeichen, Semikolons oder Klammern machen die gesamte Anfrage ungültig.

4. Fehlerantworten von fehlgeschlagenen Bestellungen enthalten „instId“: „BTC-USDT“ im Antworttext, auch wenn die ursprüngliche Anfrage ein falsches Format verwendete – das System normalisiert sich vor der Protokollierung.

5. Die öffentlichen Dokumentationsbeispiele von OKX verwenden durchgängig BTC-USDT. Abweichungen in Community-Tutorials führen häufig zu Integrationsfehlern aufgrund der Verbreitung veralteter Muster durch Kopieren und Einfügen.

Häufig gestellte Fragen

F: Kann ich BTCUSDT anstelle von BTC-USDT verwenden? A: Nein. BTCUSDT wird von allen OKX-APIs und Frontend-Komponenten abgelehnt. Es wird nur BTC-USDT akzeptiert.

F: Beeinflusst der Bindestrich die WebSocket-Wiederverbindungslogik? A: Ja. Abonnementnutzlasten mit falscher instId führen dazu, dass der Server die Verbindung trennt, ohne einen Schließrahmen zu senden. Bei Wiederverbindungsversuchen muss das Symbol vor dem erneuten Abonnieren korrigiert werden.

F: Warum konvertiert CCXT BTC/USDT intern, Python-OKX jedoch nicht? A: CCXT ist als Multi-Exchange-Abstraktionsschicht konzipiert. python-okx ist börsenspezifisch und geht davon aus, dass Entwickler direkt mit den nativen Konventionen von OKX arbeiten.

F: Wird bei API-Aufrufen bei BTC-USDT die Groß-/Kleinschreibung beachtet? A: Ja. btc-usdt oder Btc-Usdt geben den Fehlercode 51000 zurück. Großbuchstaben und die Platzierung von Bindestrichen sind obligatorisch.