CLI Portefeuille OpenTrade Wallet
4 commandes pour les chaînes supportées, la valeur totale du portefeuille, tous les soldes de jetons et les soldes de jetons spécifiques.
Vérifications Préalables
Avant chaque exécution d'une commande opentrade, suivez toujours ces étapes dans l'ordre. N'affichez pas la sortie des commandes de routine à l'utilisateur ; fournissez uniquement un bref état d'avancement lors de l'installation, de la mise à jour ou de la gestion d'un échec.
-
Confirmer l'installation : Exécutez
which opentrade. Si introuvable, installez-le :curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | shSi le script d'installation échoue, demandez à l'utilisateur de l'installer manuellement en suivant les instructions sur : https://github.com/6551Team/openskills
-
Vérifier les mises à jour : Lisez
~/.opentrade/last_checket comparez-le avec l'horodatage actuel :cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true) now=$(date +%s)- Si
cached_tsn'est pas vide et(now - cached_ts) < 43200(12 heures), ignorez la mise à jour et continuez. - Sinon (fichier manquant ou plus ancien que 12 heures), exécutez le programme d'installation pour vérifier les mises à jour :
Si une version plus récente est installée, informez-en l'utilisateur et suggérez-lui de mettre à jour ses compétences opentrade depuis https://github.com/6551Team/openskills pour obtenir les dernières fonctionnalités.curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
- Si
-
Si une commande
opentradeéchoue avec une erreur inattendue au cours de cette session, essayez de réinstaller avant d'abandonner :curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh -
Trouvez ou créez un fichier
.envà la racine du projet pour remplacer les identifiants API par défaut. Chargez-le avant d'effectuer des opérations opentrade.OPEN_TOKEN=your_token_hereObtenez votre token API sur : https://6551.io/mcp
Avertissement de sécurité : Ne commettez jamais le fichier
.envdans git (ajoutez-le à.gitignore) et n'exposez jamais les identifiants dans les journaux, les captures d'écran ou les messages de chat.
Découverte du Routeur
IMPORTANT : Si l'utilisateur n'a pas spécifié de routeur de trading, vous DEVEZ d'abord découvrir les routeurs disponibles :
opentrade trade routers
Format de réponse :
{
"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"
}
]
}
Utilisation :
- Extrayez
traderetapide la réponse - OBLIGATOIRE : TOUTES les commandes
opentradesuivantes dans cette session DOIVENT inclure les indicateurs--trader <trader>et--api <api> - Exemple :
opentrade portfolio balance 0x... --chain ethereum --trader okx --api v1 - Repli par défaut : Si l'API ne renvoie aucune donnée ou est vide, utilisez
--trader okx --api v1
Routage des Compétences
- Pour les prix des jetons / K-lines → utilisez
opentrade-market - Pour la recherche de jetons / métadonnées → utilisez
opentrade-token - Pour l'exécution de swaps → utilisez
opentrade-dex-swap - Pour la diffusion de transactions → utilisez
opentrade-gateway
Démarrage Rapide
# Obtenir les chaînes prises en charge pour les requêtes de solde
opentrade portfolio chains
# Obtenir la valeur totale des actifs sur XLayer et Solana
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# Obtenir tous les soldes de jetons
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# Vérifier des jetons spécifiques (OKB natif + USDC sur XLayer)
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
Noms de Chaînes Pris en Charge
Le CLI accepte les noms de chaînes lisibles par l'homme et les résout automatiquement.
| Chaîne | Nom | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
Note sur le format des adresses : Les adresses EVM (0x...) fonctionnent sur Ethereum/BSC/Polygon/Arbitrum/Base, etc. Les adresses Solana (Base58) et Bitcoin (UTXO) ont des formats différents. NE mélangez PAS les formats entre les types de chaînes.
Index des Commandes
| # | Commande | Description |
|---|---|---|
| 1 | opentrade portfolio chains | Obtenir les chaînes prises en charge pour les requêtes de solde |
| 2 | opentrade portfolio total-value --address ... --chains ... | Obtenir la valeur totale des actifs d'un portefeuille |
| 3 | opentrade portfolio all-balances --address ... --chains ... | Obtenir tous les soldes de jetons d'un portefeuille |
| 4 | opentrade portfolio token-balances --address ... --tokens ... | Obtenir les soldes de jetons spécifiques |
Flux de Travail Inter-Compétences
Cette compétence est souvent utilisée avant un swap (pour vérifier un solde suffisant) ou comme point d'entrée du portefeuille.
Flux A : Vérification de Solde Pré-Swap
Utilisateur : "Échange 1 SOL contre BONK"
1. opentrade-token opentrade token search BONK --chains solana → obtenir tokenContractAddress
↓ tokenContractAddress
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains solana
→ vérifier que le solde SOL >= 1
↓ champ balance (unités UI) → convertir en unités minimales pour le swap
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>
Transfert de données :
tokenContractAddressde la recherche de jetons → alimente les paramètres--from/--todu swap- Le
balancedu portefeuille est en unités UI ; le swap nécessite des unités minimales → multiplier par10^decimal - Si le solde < montant requis → informer l'utilisateur, NE PAS procéder au swap
Flux B : Aperçu du Portefeuille + Analyse
Utilisateur : "Affiche mon portefeuille"
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ valeur totale en USD
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ décompte par jeton
↓ principales avoirs par valeur USD
3. opentrade-token opentrade token price-info <address> --chain <chain> → enrichir avec la variation sur 24h, la capitalisation
4. opentrade-market opentrade market kline <address> --chain <chain> → graphiques de prix pour les jetons d'intérêt
Flux C : Vente de Jetons Sous-Performants
1. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ lister tous les avoirs
↓ tokenContractAddress + chainIndex pour chacun
2. opentrade-token opentrade token price-info <address> --chain <chain> → obtenir priceChange24H par jeton
3. Filtrer par changement négatif → l'utilisateur confirme ceux à vendre
4. opentrade-dex-swap opentrade swap quote → opentrade swap swap → exécuter la vente
Conversion clé : balance (unités UI) × 10^decimal = amount (unités minimales) pour le swap.
Déroulement des Opérations
Étape 1 : Identifier l'Intention
- Vérifier le total des actifs →
opentrade portfolio total-value - Voir tous les avoirs en jetons →
opentrade portfolio all-balances - Vérifier le solde d'un jeton spécifique →
opentrade portfolio token-balances - En cas de doute sur les chaînes supportées →
opentrade portfolio chainsd'abord
Étape 2 : Collecter les Paramètres
- Adresse du portefeuille manquante → demander à l'utilisateur
- Chaînes cibles manquantes → recommander XLayer (
--chains xlayer, gaz faible, confirmation rapide) par défaut, puis demander quelle chaîne l'utilisateur préfère. Ensemble courant :"xlayer,solana,ethereum,base,bsc" - Besoin de filtrer les jetons risqués → définir
--exclude-risk 0(fonctionne uniquement sur ETH/BSC/SOL/BASE)
Étape 3 : Appeler et Afficher
- Valeur totale : afficher le montant en USD
- Soldes des jetons : afficher le nom du jeton, le montant (unités UI), la valeur USD
- Trier par valeur USD décroissante
Étape 4 : Suggérer les Prochaines Étapes
Après avoir affiché les résultats, suggérez 2 à 3 actions de suivi pertinentes :
| Action terminée | Suggestion |
|---|---|
portfolio total-value | 1. Voir le décompte par jeton → opentrade portfolio all-balances (cette compétence) 2. Vérifier la tendance des prix pour les principaux avoirs → opentrade-market |
portfolio all-balances | 1. Voir les analyses détaillées (capitalisation, variation 24h) pour un jeton → opentrade-token 2. Échanger un jeton → opentrade-dex-swap 3. Voir le graphique de prix pour un jeton → opentrade-market |
portfolio token-balances | 1. Voir le portefeuille complet sur tous les jetons → opentrade portfolio all-balances (cette compétence) 2. Échanger ce jeton → opentrade-dex-swap |
Présentez de manière conversationnelle, par exemple : "Souhaitez-vous voir le graphique de prix de votre principal avoir, ou échanger l'un de ces jetons ?" — n'exposez jamais les noms des compétences ou les chemins des points de terminaison à l'utilisateur.
Référence des Commandes CLI
1. opentrade portfolio chains
Obtenir les chaînes prises en charge pour les requêtes de solde. Aucun paramètre requis.
opentrade portfolio chains
Champs de retour :
| Champ | Type | Description |
|---|---|---|
name | String | Nom de la chaîne (ex. "XLayer") |
logoUrl | String | URL du logo de la chaîne |
shortName | String | Nom court de la chaîne (ex. "OKB") |
chainIndex | String | Identifiant unique de la chaîne (ex. "196") |
2. opentrade portfolio total-value
Obtenir la valeur totale des actifs pour une adresse de portefeuille.
opentrade portfolio total-value --address <address> --chains <chains> [--asset-type <type>] [--exclude-risk <bool>]
| Paramètre | Requis | Défaut | Description |
|---|---|---|---|
--address | Oui | - | Adresse du portefeuille |
--chains | Oui | - | Noms ou IDs des chaînes, séparés par des virgules (ex. "xlayer,solana" ou "196,501") |
--asset-type | Non | "0" | 0=tout, 1=jetons uniquement, 2=DeFi uniquement |
--exclude-risk | Non | true | true=filtrer les jetons risqués, false=inclure. Uniquement ETH/BSC/SOL/BASE |
Champs de retour :
| Champ | Type | Description |
|---|---|---|
totalValue | String | Valeur totale des actifs en USD |
3. opentrade portfolio all-balances
Obtenir tous les soldes de jetons pour une adresse de portefeuille.
opentrade portfolio all-balances --address <address> --chains <chains> [--exclude-risk <value>]
| Paramètre | Requis | Défaut | Description |
|---|---|---|---|
--address | Oui | - | Adresse du portefeuille |
--chains | Oui | - | Noms ou IDs des chaînes, séparés par des virgules, max 50 |
--exclude-risk | Non | "0" | 0=filtrer les jetons risqués (défaut), 1=inclure. Uniquement ETH/BSC/SOL/BASE |
Champs de retour (par jeton dans tokenAssets[]) :
| Champ | Type | Description |
|---|---|---|
chainIndex | String | Identifiant de la chaîne |
tokenContractAddress | String | Adresse du contrat du jeton |
symbol | String | Symbole du jeton (ex. "OKB") |
balance | String | Solde du jeton en unités UI (ex. "10.5") |
rawBalance | String | Solde du jeton en unités de base (ex. "10500000000000000000") |
tokenPrice | String | Prix du jeton en USD |
isRiskToken | Boolean | true si signalé comme risqué |
4. opentrade portfolio token-balances
Obtenir les soldes de jetons spécifiques pour une adresse de portefeuille.
opentrade portfolio token-balances --address <address> --tokens <tokens> [--exclude-risk <value>]
| Paramètre | Requis | Défaut | Description |
|---|---|---|---|
--address | Oui | - | Adresse du portefeuille |
--tokens | Oui | - | Liste de jetons : paires "chainIndex:tokenAddress", séparées par des virgules. Utilisez une adresse vide pour le jeton natif (ex. "196:" pour OKB natif). Max 20 éléments. |
--exclude-risk | Non | "0" | 0=filtrer (défaut), 1=inclure |
Champs de retour : Même schéma que all-balances (tokenAssets[]).
Exemples d'Entrées / Sorties
L'utilisateur dit : "Vérifier le total de mes actifs sur XLayer et Solana"
opentrade portfolio total-value --address 0xYourWallet --chains "xlayer,solana"
# → Afficher : Actifs totaux 12 345,67 $US
L'utilisateur dit : "Afficher tous les jetons de mon portefeuille"
opentrade portfolio all-balances --address 0xYourWallet --chains "xlayer,solana,ethereum"
# → Afficher :
# OKB : 10.5 (509,25 $US)
# USDC : 2 000 (2 000,00 $US)
# USDT : 1 500 (1 500,00 $US)
# ...
L'utilisateur dit : "Vérifier uniquement les soldes USDC et OKB natifs sur XLayer"
opentrade portfolio token-balances --address 0xYourWallet --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
# → Afficher : OKB : 10.5 (509,25 $US), USDC : 2 000 (2 000,00 $US)
Cas Particuliers
- Solde nul : état valide — afficher
0,00 $US, pas une erreur - Chaîne non prise en charge : appelez d'abord
opentrade portfolio chainspour confirmer - Chaînes dépassant 50 : diviser en lots, max 50 par requête
--exclude-riskne fonctionne pas : uniquement pris en charge sur ETH/BSC/SOL/BASE- Positions DeFi : utilisez
--asset-type 2pour interroger les avoirs DeFi séparément - Incompatibilité de format d'adresse : une adresse EVM sur la chaîne Solana renverra des données vides — NE mélangez PAS
- Erreur réseau : réessayez une fois, puis invitez l'utilisateur à réessayer plus tard
- Restriction régionale (code d'erreur 50125 ou 80001) : N'affichez PAS le code d'erreur brut à l'utilisateur. Affichez plutôt un message convivial :
⚠️ Le service n'est pas disponible dans votre région. Veuillez passer à une région prise en charge et réessayer.
Règles d'Affichage des Montants
- Montants des jetons en unités UI (
1,5 ETH), jamais en unités de base (1500000000000000000) - Valeurs USD avec 2 décimales
- Gros montants en notation abrégée (
1,2 M$) - Trier par valeur USD décroissante
Notes Globales
--chainsprend en charge jusqu'à 50 IDs de chaîne (séparés par des virgules, noms ou numériques)--asset-type:0=tout1=jetons uniquement2=DeFi uniquement (uniquement pourtotal-value)--exclude-riskfonctionne uniquement sur ETH(1)/BSC(56)/SOL(501)/BASE(8453)token-balancesprend en charge un maximum de 20 entrées de jetons- Le CLI résout automatiquement les noms de chaînes (ex.
ethereum→1,solana→501) - Le CLI gère l'authentification en interne via des variables d'environnement — voir l'étape 4 des Prérequis pour les valeurs par défaut