Was macht OKX CEX Portfolio & Account CLI?
Kontostand, Positionen, Gewinn/Verlust, Gebühren und Überweisungen auf der OKX-Börse. Erfordert API-Anmeldedaten.
Voraussetzungen
- Installieren Sie die
okxCLI:npm install -g @okx_ai/okx-trade-cli - Konfigurieren Sie die Anmeldedaten:
Oder setzen Sie Umgebungsvariablen:okx config initexport OKX_API_KEY=your_key export OKX_SECRET_KEY=your_secret export OKX_PASSPHRASE=your_passphrase - Testen Sie mit dem Demo-Modus:
okx --profile demo account balance
Anmeldedaten- & Profilprüfung
Führen Sie diese Prüfung vor jedem authentifizierten Befehl durch.
Schritt A – Anmeldedaten überprüfen
okx config show # Konfigurationsstatus überprüfen (Ausgabe wird maskiert)
- Wenn der Befehl einen Fehler zurückgibt oder keine Konfiguration anzeigt: Alle Operationen stoppen, den Benutzer anleiten,
okx config initauszuführen, und warten, bis die Einrichtung abgeschlossen ist, bevor ein erneuter Versuch unternommen wird. - Wenn Anmeldedaten konfiguriert sind: mit Schritt B fortfahren.
Schritt B – Profil bestätigen (erforderlich)
--profile ist für alle authentifizierten Befehle erforderlich. Fügen Sie niemals implizit ein Profil hinzu.
| Wert | Modus | Gelder |
|---|---|---|
live | Echtgeld | Echte Gelder |
demo | Demokonto | Simulierte Gelder |
Auflösungsregeln:
- Die Absicht der aktuellen Nachricht ist klar (z. B. "real" / "Echtgeld" / "live" →
live; "test" / "Demo" / "demo" →demo) → verwenden und den Benutzer informieren:"Verwende --profile live (Echtgeld)"oder"Verwende --profile demo (Demokonto)" - Die aktuelle Nachricht enthält keine explizite Angabe → Konversationskontext auf ein vorheriges Profil prüfen:
- Gefunden → verwenden, Benutzer informieren:
"Fortfahren mit --profile live (Echtgeld) von zuvor" - Nicht gefunden → fragen:
"Echtgeld (live) oder Demokonto (demo)?"– auf Antwort warten, bevor fortgefahren wird
- Gefunden → verwenden, Benutzer informieren:
Umgang mit 401-Authentifizierungsfehlern
Wenn ein Befehl einen 401- / Authentifizierungsfehler zurückgibt:
- Sofort anhalten – denselben Befehl nicht wiederholen
- Den Benutzer informieren: "Die Authentifizierung ist fehlgeschlagen (401). Ihre API-Anmeldedaten sind möglicherweise ungültig oder abgelaufen."
- Den Benutzer anleiten, die Anmeldedaten zu aktualisieren, indem die Datei direkt mit einem lokalen Editor bearbeitet wird:
Aktualisieren Sie die Felder~/.okx/config.tomlapi_key,secret_key,passphraseim entsprechenden Profil. Geben Sie die neuen Anmeldedaten NICHT im Chat ein. - Nachdem der Benutzer bestätigt hat, dass die Datei aktualisiert wurde, führen Sie
okx config showaus, um zu überprüfen (Ausgabe wird maskiert) - Erst dann den ursprünglichen Vorgang wiederholen
Demo- vs. Live-Modus
Das Profil ist die einzige Kontrolle für das Umschalten zwischen Echtgeld-/Demokonto – genau zwei Optionen:
--profile | Modus | Gelder |
|---|---|---|
live | Echtgeld | Echte Gelder |
demo | Demokonto | Simulierte Gelder |
okx --profile live account balance # Echtgeld
okx --profile demo account balance # Demokonto (simulierter Kontostand)
Regeln:
- Lesebefehle (Kontostand, Positionen, Rechnungen usw.): immer angeben, welches Profil verwendet wurde
- Schreibbefehle (
transfer,set-position-mode): Profil muss vor Ausführung bestätigt werden (siehe „Anmeldedaten- & Profilprüfung" Schritt B); insbesondere bei Überweisungen – falsches Profil bedeutet falsches Konto - Jede Antwort nach einem Befehl muss anhängen:
[profile: live]oder[profile: demo] - Verwenden Sie nicht das
--demo-Flag – verwenden Sie stattdessen--profile
Skill-Routing
- Für Marktdaten (Preise, Charts, Tiefe, Finanzierungsraten) →
okx-cex-marketverwenden - Für Kontostand, Gewinn/Verlust, Positionen, Gebühren, Überweisungen →
okx-cex-portfolio(dieser Skill) - Für reguläre Spot-/Swap-/Futures-/Algo-Orders →
okx-cex-tradeverwenden - Für Grid- und DCA-Trading-Bots →
okx-cex-botverwenden
Schnellstart
# Handelskontostand (alle Währungen mit Saldo > 0)
okx account balance
# Nur USDT-Kontostand prüfen
okx account balance USDT
# Guthaben des Finanzierungskontos
okx account asset-balance
# Alle offenen Positionen
okx account positions
# Verlauf geschlossener Positionen mit realisiertem Gewinn/Verlust
okx account positions-history
# Aktuelle Kontobewegungen (letzte 100)
okx account bills
# Meine Handelsgebührenstufe
okx account fees --instType SPOT
# 100 USDT vom Finanzierungskonto (18) auf das Handelskonto (6) überweisen
okx account transfer --ccy USDT --amt 100 --from 18 --to 6
Befehlsindex
Lesebefehle
| # | Befehl | Typ | Beschreibung |
|---|---|---|---|
| 1 | okx account balance [ccy] | LESEN | Eigenkapital, verfügbar, eingefroren im Handelskonto |
| 2 | okx account asset-balance [ccy] | LESEN | Guthaben des Finanzierungskontos |
| 3 | okx account positions | LESEN | Offene Kontrakt-/Swap-Positionen |
| 4 | okx account positions-history | LESEN | Geschlossene Positionen + realisierter Gewinn/Verlust |
| 5 | okx account bills | LESEN | Kontobuch (Einzahlungen, Auszahlungen, Trades) |
| 6 | okx account fees --instType <type> | LESEN | Meine Handelsgebührenstufe (Maker/Taker) |
| 7 | okx account config | LESEN | Kontostufe, Positionsmodus, UID |
| 8 | okx account max-size --instId <id> --tdMode <mode> | LESEN | Maximale Kauf-/Verkaufsgröße zum aktuellen Preis |
| 9 | okx account max-avail-size --instId <id> --tdMode <mode> | LESEN | Verfügbare Größe für die nächste Order |
| 10 | okx account max-withdrawal [ccy] | LESEN | Maximal abhebbarer Betrag pro Währung |
Schreibbefehle
| # | Befehl | Typ | Beschreibung |
|---|---|---|---|
| 11 | okx account set-position-mode <mode> | SCHREIBEN | Positionsmodus (net/hedge) umschalten |
| 12 | okx account transfer | SCHREIBEN | Gelder zwischen Konten überweisen |
Skill-übergreifende Workflows
Kontostandsprüfung vor dem Handel
Benutzer: „Ich möchte 0.1 BTC kaufen – habe ich genug USDT?"
1. okx-cex-portfolio okx account balance USDT → verfügbares Eigenkapital prüfen
2. okx-cex-market okx market ticker BTC-USDT → aktuellen Preis prüfen
↓ Benutzer stimmt zu
3. okx-cex-trade okx spot place --instId BTC-USDT --side buy --ordType market --sz 0.1
Kontostandsprüfung vor Bot-Start
Benutzer: „Ich möchte einen BTC-Grid-Bot mit 1000 USDT starten"
1. okx-cex-portfolio okx account balance USDT → ausreichende Mittel bestätigen ≥ 1000
2. okx-cex-market okx market candles BTC-USDT --bar 4H --limit 50 → Preisspanne ermitteln
↓ Benutzer stimmt zu
3. okx-cex-bot okx bot grid create --instId BTC-USDT --algoOrdType grid \
--minPx 90000 --maxPx 100000 --gridNum 10 --quoteSz 1000
Offene Positionen und Gewinn/Verlust prüfen
Benutzer: „Zeig mir meine aktuellen Positionen und wie sie sich entwickeln"
1. okx-cex-portfolio okx account positions → offene Positionen mit nicht realisiertem Gewinn/Verlust
2. okx-cex-portfolio okx account positions-history → kürzlich geschlossene Positionen
3. okx-cex-market okx market ticker BTC-USDT-SWAP → aktuellen Preis mit Einstiegspreis vergleichen
Überweisung und Handel
Benutzer: „Überweise 500 USDT von meinem Finanzierungskonto, um BTC zu handeln"
1. okx-cex-portfolio okx account asset-balance USDT → Finanzierungsguthaben bestätigen ≥ 500
↓ Benutzer stimmt zu
2. okx-cex-portfolio okx account transfer --ccy USDT --amt 500 --from 18 --to 6
3. okx-cex-portfolio okx account balance USDT → aktualisiertes Handelsguthaben bestätigen
↓ bereit zum Handel
4. okx-cex-trade okx spot place ...
Maximale Positionsgröße vor Einstieg prüfen
Benutzer: „Wie viel BTC kann ich mit Cross-Margin kaufen?"
1. okx-cex-portfolio okx account balance → gesamtes Eigenkapital
2. okx-cex-portfolio okx account max-size --instId BTC-USDT-SWAP --tdMode cross → max. Kauf-/Verkaufsgröße
3. okx-cex-market okx market ticker BTC-USDT-SWAP → aktuellen Preisreferenz
Ablauf
Schritt 0 – Anmeldedaten- & Profilprüfung
Vor jedem authentifizierten Befehl:
Profil bestimmen (erforderlich):
- Optionen:
live(Echtgeld) oderdemo(Demokonto) – genau diese beiden Werte
- Absicht der aktuellen Nachricht klar (z. B. "real"/"Echtgeld"/"live" → live; "test"/"Demo"/"demo" → demo) → verwenden, Benutzer informieren:
"Verwende --profile live (Echtgeld)" - Aktuelle Nachricht enthält keine explizite Angabe → Konversationskontext auf vorheriges Profil prüfen:
- Gefunden → verwenden, Benutzer informieren:
"Fortfahren mit --profile live (Echtgeld) von zuvor" - Nicht gefunden → fragen:
"Echtgeld (live) oder Demokonto (demo)?"– auf Antwort warten
- Gefunden → verwenden, Benutzer informieren:
Wenn keine Anmeldedaten konfiguriert sind: Benutzer anleiten, okx config init auszuführen, alle Handelsaktionen stoppen
Nach jedem Befehlsergebnis: [profile: live] oder [profile: demo] an die Antwort anhängen
Schritt 1: Kontoaktion identifizieren
- Kontostand prüfen →
okx account balance(Handel) oderokx account asset-balance(Finanzierung) - Offene Positionen anzeigen →
okx account positions - Geschlossene Positionen + Gewinn/Verlust anzeigen →
okx account positions-history - Transaktionsverlauf anzeigen →
okx account bills - Gebührenstufe prüfen →
okx account fees - Kontoeinstellungen prüfen →
okx account config - Ordermenge berechnen →
okx account max-sizeoderokx account max-avail-size - Abhebungslimit prüfen →
okx account max-withdrawal - Gelder überweisen →
okx account transfer - Positionsmodus ändern →
okx account set-position-mode
Schritt 2: Lesebefehle sofort ausführen – Profil bestätigen (Schritt 0), dann Schreibbefehle
Lesebefehle (1–10): sofort ausführen, keine Bestätigung erforderlich.
ccy-Filter: Währungssymbol verwenden, z. B.USDT,BTC,ETH--instTypefür Gebühren/Positionen:SPOT,SWAP,FUTURES,OPTION--archivefür Rechnungen: Zugriff auf ältere Aufzeichnungen außerhalb des Standardzeitfensters--tdModefür max-size:cash(Spot),crossoderisolated
Schreibbefehle (11–12): einmal vor der Ausführung bestätigen.
set-position-mode: Modus bestätigen (net= eindirektional,long_short_mode= Hedge-Modus); Umschalten kann offene Positionen beeinflussentransfer:--ccy,--amt,--from,--tobestätigen (Kontotypen:6=Handel,18=Finanzierung); zuerst Quellguthaben überprüfen
Schritt 3: Nach Schreibbefehlen überprüfen
- Nach
set-position-mode:okx account configausführen, um zu bestätigen, dassposModeaktualisiert wurde - Nach
transfer:okx account balanceundokx account asset-balanceausführen, um zu bestätigen, dass die Guthaben aktualisiert wurden
CLI-Befehlsreferenz
Kontostand – Handelskonto
okx account balance [ccy] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
ccy | Nein | - | Auf eine einzelne Währung filtern (z. B. USDT) |
Gibt Tabelle zurück: currency, equity, available, frozen. Zeigt nur Währungen mit Saldo > 0 an.
Asset-Guthaben – Finanzierungskonto
okx account asset-balance [ccy] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
ccy | Nein | - | Auf eine einzelne Währung filtern |
Gibt zurück: ccy, bal, availBal, frozenBal. Zeigt nur Währungen mit Saldo > 0 an.
Positionen – Offene Positionen
okx account positions [--instType <type>] [--instId <id>] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--instType | Nein | - | Filter: SWAP, FUTURES, OPTION |
--instId | Nein | - | Auf ein bestimmtes Instrument filtern |
Gibt zurück: instId, instType, side (posSide), pos, avgPx, upl (nicht realisierter Gewinn/Verlust), lever. Zeigt nur Positionen mit Größe ≠ 0 an.
Positionsverlauf – Geschlossene Positionen
okx account positions-history [--instType <type>] [--instId <id>] [--limit <n>] [--json]
Gibt zurück: instId, direction, openAvgPx, closeAvgPx, realizedPnl, uTime.
Rechnungen – Kontobuch
okx account bills [--archive] [--instType <type>] [--ccy <ccy>] [--limit <n>] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--archive | Nein | false | Zugriff auf ältere Aufzeichnungen (Archiv-Endpunkt) |
--instType | Nein | - | Nach Instrumententyp filtern |
--ccy | Nein | - | Nach Währung filtern |
--limit | Nein | 100 | Anzahl der Datensätze |
Gibt zurück: billId, instId, type, ccy, balChg, bal, ts.
Gebühren – Handelsgebührenstufe
okx account fees --instType <type> [--instId <id>] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--instType | Ja | - | SPOT, SWAP, FUTURES, OPTION |
--instId | Nein | - | Bestimmtes Instrument (optional) |
Gibt zurück: level, maker, taker, makerU, takerU, ts.
Konfiguration – Kontoeinstellungen
okx account config [--json]
Gibt zurück: uid, acctLv (Kontostufe), posMode (net/long_short_mode), autoLoan, greeksType, level, levelTmp.
Max. Größe – Maximale Ordergröße
okx account max-size --instId <id> --tdMode <mode> [--px <price>] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--instId | Ja | - | Instrumenten-ID |
--tdMode | Ja | - | cash (Spot), cross oder isolated |
--px | Nein | - | Referenzpreis (verwendet Mark-Preis, wenn weggelassen) |
Gibt zurück: instId, maxBuy, maxSell.
Max. Verfügbare Größe
okx account max-avail-size --instId <id> --tdMode <mode> [--json]
Gibt zurück: instId, availBuy, availSell – die sofort verfügbare Größe für die nächste Order.
Max. Abhebung
okx account max-withdrawal [ccy] [--json]
Gibt Tabelle zurück: ccy, maxWd, maxWdEx (mit Kreditaufnahme). Zeigt alle Währungen an, wenn kein Filter angegeben ist.
Positionsmodus setzen
okx account set-position-mode <net|long_short_mode> [--json]
| Wert | Verhalten |
|---|---|
net | Eindirektional (Standard) – Long und Short gleichen sich aus |
long_short_mode | Hedge-Modus – Long und Short können nebeneinander bestehen |
Warnung: Das Umschalten des Modus bei offenen Positionen kann zu unerwartetem Verhalten führen. Überprüfen Sie zuerst
okx account positions.
Gelder überweisen
okx account transfer --ccy <ccy> --amt <n> --from <acctType> --to <acctType> \
[--transferType <type>] [--subAcct <name>] [--json]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--ccy | Ja | - | Zu überweisende Währung (z. B. USDT) |
--amt | Ja | - | Zu überweisender Betrag |
--from | Ja | - | Quellkontotyp: 6=Handel, 18=Finanzierung |
--to | Ja | - | Zielkontotyp: 6=Handel, 18=Finanzierung |
--transferType | Nein | 0 | 0=innerhalb des Kontos, 1=zu Unterkonto, 2=von Unterkonto |
--subAcct | Nein | - | Name des Unterkontos (erforderlich für Unterkontobuchungen) |
Gibt zurück: transId, ccy, amt.
MCP-Toolreferenz
| Tool | Beschreibung |
|---|---|
account_get_balance | Handelskontostand |
account_get_asset_balance | Guthaben des Finanzierungskontos |
account_get_positions | Offene Positionen anzeigen |
account_get_positions_history | Verlauf geschlossener Positionen anzeigen |
account_get_bills | Kontobuch (letzte Transaktionen) anzeigen |
account_get_fees | Handelsgebührenstufe abrufen |
account_get_config | Kontoeinstellungen abrufen |
account_get_max_size | Maximale Ordergröße berechnen |
account_get_max_avail_size | Verfügbare Größe für nächste Order abrufen |
account_get_max_withdrawal | Maximalen Abhebungsbetrag abrufen |
account_set_position_mode | Positionsmodus (net/hedge) umschalten |
account_transfer | Gelder zwischen Konten überweisen |