Was macht OpenTrade Wallet Portfolio CLI?
4 Befehle für unterstützte Chains, Wallet-Gesamtwert, alle Token-Bestände und spezifische Token-Bestände.
Vorab-Prüfungen
Vor jeder Ausführung eines opentrade-Befehls sind die folgenden Schritte in dieser Reihenfolge durchzuführen. Gib Routine-Befehlsausgaben nicht an den Benutzer aus; gib nur eine kurze Statusmeldung beim Installieren, Aktualisieren oder bei einem Fehler.
-
Installation bestätigen: Führe
which opentradeaus. Wenn nicht gefunden, installiere es:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | shWenn das Installationsskript fehlschlägt, bitte den Benutzer, es manuell gemäß der Anleitung unter https://github.com/6551Team/openskills zu installieren.
-
Auf Updates prüfen: Lese
~/.opentrade/last_checkund vergleiche es mit dem aktuellen Zeitstempel:cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true) now=$(date +%s)- Wenn
cached_tsnicht leer ist und(now - cached_ts) < 43200(12 Stunden) ist, überspringe das Update und fahre fort. - Andernfalls (Datei fehlt oder älter als 12 Stunden), führe das Installationsprogramm aus, um nach Updates zu suchen:
Wenn eine neuere Version installiert ist, informiere den Benutzer und schlage vor, die opentrade-Skills von https://github.com/6551Team/openskills zu aktualisieren, um die neuesten Funktionen zu erhalten.curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
- Wenn
-
Wenn ein
opentrade-Befehl während dieser Sitzung mit einem unerwarteten Fehler fehlschlägt, versuche eine Neuinstallation, bevor du aufgibst:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh -
Finde oder erstelle eine
.env-Datei im Projektstammverzeichnis, um die Standard-API-Anmeldeinformationen zu überschreiben. Lade sie vor der Durchführung von opentrade-Operationen.
OPEN_TOKEN=your_token_here
Hole deinen API-Token unter: https://6551.io/mcp
Sicherheitswarnung: Committe niemals die .env-Datei in Git (füge sie zur .gitignore hinzu) und gib niemals Anmeldeinformationen in Logs, Screenshots oder Chat-Nachrichten preis.
Router-Erkennung
WICHTIG: Wenn der Benutzer keinen Trading-Router angegeben hat, MUSST du zuerst verfügbare Router ermitteln:
opentrade trade routers
Antwortformat:
{
"ok": true,
"data": [
{
"api": "v2",
"created_at": "2026-03-10 01:15:42",
"is_active": true,
"name": "6551dex test",
"quota_reward": 0,
"trader": "6551dex",
"updated_at": "2026-03-10 01:15:42"
},
{
"api": "v1",
"created_at": "2026-03-03 21:24:34",
"is_active": true,
"name": "okx test",
"quota_reward": 0,
"trader": "okx",
"updated_at": "2026-03-03 21:24:34"
}
]
}
Verwendung:
- Extrahiere
traderundapiaus der Antwort - VERPFLICHTEND: ALLE nachfolgenden
opentrade-Befehle in dieser Sitzung MÜSSEN die Flags--trader <trader>und--api <api>enthalten - Beispiel:
opentrade portfolio balance 0x... --chain ethereum --trader okx --api v1 - Standard-Fallback: Wenn die API keine Daten oder leere Daten zurückgibt, verwende
--trader okx --api v1
Skill-Routing
- Für Token-Preise / K-Linien → verwende
opentrade-market - Für Token-Suche / Metadaten → verwende
opentrade-token - Für Swap-Ausführung → verwende
opentrade-dex-swap - Für Transaktionsübertragung → verwende
opentrade-gateway
Schnellstart
# Unterstützte Chains für Bilanzabfragen abrufen
opentrade portfolio chains
# Gesamtwert auf XLayer und Solana abrufen
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# Alle Token-Bestände abrufen
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# Bestimmte Token prüfen (natives OKB + USDC auf XLayer)
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
Unterstützung von Chain-Namen
Die CLI akzeptiert menschenlesbare Chain-Namen und löst sie automatisch auf.
| Chain | Name | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
Hinweis zum Adressformat: EVM-Adressen (0x...) funktionieren auf Ethereum/BSC/Polygon/Arbitrum/Base usw. Solana-Adressen (Base58) und Bitcoin-Adressen (UTXO) haben andere Formate. Mische KEINE Formate verschiedener Chain-Typen.
Befehlsindex
| # | Befehl | Beschreibung |
|---|---|---|
| 1 | opentrade portfolio chains | Unterstützte Chains für Bilanzabfragen abrufen |
| 2 | opentrade portfolio total-value --address ... --chains ... | Gesamtwert eines Wallets abrufen |
| 3 | opentrade portfolio all-balances --address ... --chains ... | Alle Token-Bestände eines Wallets abrufen |
| 4 | opentrade portfolio token-balances --address ... --tokens ... | Bestimmte Token-Bestände abrufen |
Cross-Skill-Workflows
Dieses Skill wird oft vor einem Swap (zur Überprüfung ausreichender Guthaben) oder als Portfolio-Einstiegspunkt verwendet.
Workflow A: Guthabenprüfung vor Swap
Benutzer: "Tausche 1 SOL in BONK"
1. opentrade-token opentrade token search BONK --chains solana → tokenContractAddress abrufen
↓ tokenContractAddress
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains solana
→ Überprüfen, ob SOL-Balance >= 1
↓ balance-Feld (UI-Einheiten) → in minimale Einheiten für Swap umwandeln
3. opentrade-dex-swap opentrade swap quote --from 11111111111111111111111111111111 --to <BONK_address> --amount 1000000000 --chain solana
4. opentrade-dex-swap opentrade swap swap --from ... --to <BONK_address> --amount 1000000000 --chain solana --wallet <addr>
Datenübergabe:
tokenContractAddressvon der Token-Suche → wird in Swap--from/--toeingespeistbalancevom Portfolio ist in UI-Einheiten; Swap benötigt minimale Einheiten → multipliziere mit10^decimal- Wenn Guthaben < benötigter Betrag → Benutzer informieren, nicht zum Swap fortfahren
Workflow B: Portfolio-Übersicht + Analyse
Benutzer: "Zeige mein Portfolio"
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ Gesamtwert in USD
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ Aufschlüsselung pro Token
↓ Top-Bestände nach USD-Wert
3. opentrade-token opentrade token price-info <address> --chain <chain> → mit 24h-Änderung, Marktkapitalisierung anreichern
4. opentrade-market opentrade market kline <address> --chain <chain> → Preischarts für interessante Token
Workflow C: Verkauf unterdurchschnittlicher Token
1. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ Alle Bestände auflisten
↓ tokenContractAddress + chainIndex für jeden
2. opentrade-token opentrade token price-info <address> --chain <chain> → priceChange24H pro Token abrufen
3. Nach negativer Änderung filtern → Benutzer bestätigt, welche verkauft werden sollen
4. opentrade-dex-swap opentrade swap quote → opentrade swap swap → Verkauf ausführen
Wichtige Umrechnung: balance (UI-Einheiten) × 10^decimal = amount (minimale Einheiten) für den Swap.
Ablauf
Schritt 1: Absicht erkennen
- Gesamte Vermögenswerte prüfen →
opentrade portfolio total-value - Alle Token-Bestände anzeigen →
opentrade portfolio all-balances - Bestimmtes Token-Guthaben prüfen →
opentrade portfolio token-balances - Unsicher, welche Chains unterstützt werden → zuerst
opentrade portfolio chains
Schritt 2: Parameter sammeln
- Fehlende Wallet-Adresse → Benutzer fragen
- Fehlende Ziel-Chains → XLayer empfehlen (
--chains xlayer, niedrige Gasgebühren, schnelle Bestätigung) als Standard, dann fragen, welche Chain der Benutzer bevorzugt. Üblicher Satz:"xlayer,solana,ethereum,base,bsc" - Risikobehaftete Token filtern →
--exclude-risk 0setzen (funktioniert nur auf ETH/BSC/SOL/BASE)
Schritt 3: Aufruf und Anzeige
- Gesamtwert: USD-Betrag anzeigen
- Token-Bestände: Token-Name, Menge (UI-Einheiten), USD-Wert anzeigen
- Absteigend nach USD-Wert sortieren
Schritt 4: Nächste Schritte vorschlagen
Nach der Anzeige der Ergebnisse 2-3 relevante Folgeaktionen vorschlagen:
| Gerade abgeschlossen | Vorschlagen |
|---|---|
portfolio total-value | 1. Token-Aufschlüsselung anzeigen → opentrade portfolio all-balances (dieses Skill) 2. Preistrend für Top-Bestände prüfen → opentrade-market |
portfolio all-balances | 1. Detaillierte Analyse (Marktkapitalisierung, 24h-Änderung) für einen Token anzeigen → opentrade-token 2. Token tauschen → opentrade-dex-swap 3. Preischart für einen Token anzeigen → opentrade-market |
portfolio token-balances | 1. Vollständiges Portfolio über alle Token anzeigen → opentrade portfolio all-balances (dieses Skill) 2. Diesen Token tauschen → opentrade-dex-swap |
Gesprächig präsentieren, z.B.: "Möchten Sie den Preischart für Ihren Top-Bestand sehen oder einen dieser Token tauschen?" — niemals Skill-Namen oder Endpunkt-Pfade dem Benutzer preisgeben.
CLI-Befehlsreferenz
1. opentrade portfolio chains
Unterstützte Chains für Bilanzabfragen abrufen. Keine Parameter erforderlich.
opentrade portfolio chains
Rückgabefelder:
| Feld | Typ | Beschreibung |
|---|---|---|
name | String | Chain-Name (z.B. "XLayer") |
logoUrl | String | Chain-Logo-URL |
shortName | String | Chain-Kurzname (z.B. "OKB") |
chainIndex | String | Eindeutige Chain-Kennung (z.B. "196") |
2. opentrade portfolio total-value
Gesamtwert der Vermögenswerte für eine Wallet-Adresse abrufen.
opentrade portfolio total-value --address <address> --chains <chains> [--asset-type <type>] [--exclude-risk <bool>]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--address | Ja | - | Wallet-Adresse |
--chains | Ja | - | Chain-Namen oder IDs, kommagetrennt (z.B. "xlayer,solana" oder "196,501") |
--asset-type | Nein | "0" | 0=alle, 1=nur Token, 2=nur DeFi |
--exclude-risk | Nein | true | true=risikobehaftete Token filtern, false=einbeziehen. Nur ETH/BSC/SOL/BASE |
Rückgabefelder:
| Feld | Typ | Beschreibung |
|---|---|---|
totalValue | String | Gesamtwert der Vermögenswerte in USD |
3. opentrade portfolio all-balances
Alle Token-Bestände für eine Wallet-Adresse abrufen.
opentrade portfolio all-balances --address <address> --chains <chains> [--exclude-risk <value>]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--address | Ja | - | Wallet-Adresse |
--chains | Ja | - | Chain-Namen oder IDs, kommagetrennt, max. 50 |
--exclude-risk | Nein | "0" | 0=risikobehaftete Token herausfiltern (Standard), 1=einbeziehen. Nur ETH/BSC/SOL/BASE |
Rückgabefelder (pro Token in tokenAssets[]):
| Feld | Typ | Beschreibung |
|---|---|---|
chainIndex | String | Chain-Kennung |
tokenContractAddress | String | Token-Vertragsadresse |
symbol | String | Token-Symbol (z.B. "OKB") |
balance | String | Token-Bestand in UI-Einheiten (z.B. "10.5") |
rawBalance | String | Token-Bestand in Basiseinheiten (z.B. "10500000000000000000") |
tokenPrice | String | Token-Preis in USD |
isRiskToken | Boolean | true, wenn als risikobehaftet markiert |
4. opentrade portfolio token-balances
Bestimmte Token-Bestände für eine Wallet-Adresse abrufen.
opentrade portfolio token-balances --address <address> --tokens <tokens> [--exclude-risk <value>]
| Parameter | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
--address | Ja | - | Wallet-Adresse |
--tokens | Ja | - | Token-Liste: "chainIndex:tokenAddress"-Paare, kommagetrennt. Leere Adresse für natives Token verwenden (z.B. "196:" für natives OKB). Max. 20 Einträge. |
--exclude-risk | Nein | "0" | 0=herausfiltern (Standard), 1=einbeziehen |
Rückgabefelder: Gleiches Schema wie all-balances (tokenAssets[]).
Eingabe-/Ausgabebeispiele
Benutzer sagt: "Prüfe meine gesamten Vermögenswerte auf XLayer und Solana"
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# → Anzeige: Gesamte Vermögenswerte $12.345,67
Benutzer sagt: "Zeige alle Token in meinem Wallet"
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# → Anzeige:
# OKB: 10.5 ($509,25)
# USDC: 2.000 ($2.000,00)
# USDT: 1.500 ($1.500,00)
# ...
Benutzer sagt: "Prüfe nur USDC und natives OKB auf XLayer"
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
# → Anzeige: OKB: 10.5 ($509,25), USDC: 2.000 ($2.000,00)
Randfälle
- Null-Bestand: gültiger Zustand — zeige
$0,00an, kein Fehler - Nicht unterstützte Chain: zuerst
opentrade portfolio chainsaufrufen, um zu bestätigen - Chains überschreitet 50: in Batches aufteilen, max. 50 pro Anfrage
--exclude-riskfunktioniert nicht: nur auf ETH/BSC/SOL/BASE unterstützt- DeFi-Positionen:
--asset-type 2verwenden, um DeFi-Bestände separat abzufragen - Adressformat-Konflikt: EVM-Adresse auf Solana-Chain liefert leere Daten — NICHT mischen
- Netzwerkfehler: einmal wiederholen, dann den Benutzer bitten, es später erneut zu versuchen
- Regionseinschränkung (Fehlercode 50125 oder 80001): Zeige den rohen Fehlercode NICHT dem Benutzer. Gib stattdessen eine freundliche Meldung aus:
⚠️ Der Dienst ist in Ihrer Region nicht verfügbar. Bitte wechseln Sie zu einer unterstützten Region und versuchen Sie es erneut.
Anzeigeregeln für Beträge
- Token-Beträge in UI-Einheiten (
1.5 ETH), niemals in Basiseinheiten (1500000000000000000) - USD-Werte mit 2 Dezimalstellen
- Große Beträge in Kurzform (
$1,2 Mio.) - Absteigend nach USD-Wert sortieren
Globale Hinweise
--chainsunterstützt bis zu 50 Chain-IDs (kommagetrennt, Namen oder numerisch)--asset-type:0=alle1=nur Token2=nur DeFi (nur fürtotal-value)--exclude-riskfunktioniert nur auf ETH(1)/BSC(56)/SOL(501)/BASE(8453)token-balancesunterstützt max. 20 Token-Einträge- Die CLI löst Chain-Namen automatisch auf (z.B.
ethereum→1,solana→501) - Die CLI verwaltet die Authentifizierung intern über Umgebungsvariablen — siehe Schritt 4 der Voraussetzungen für Standardwerte