CLI de Cartera de OpenTrade Wallet Portfolio
4 comandos para cadenas compatibles, valor total de la cartera, todos los saldos de tokens y saldos de tokens específicos.
Verificaciones Previas
Cada vez antes de ejecutar cualquier comando opentrade, sigue siempre estos pasos en orden. No muestres la salida de comandos rutinarios al usuario; solo proporciona una breve actualización de estado al instalar, actualizar o manejar un fallo.
-
Confirmar instalación: Ejecuta
which opentrade. Si no se encuentra, instálalo:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | shSi el script de instalación falla, pide al usuario que instale manualmente siguiendo las instrucciones en: https://github.com/6551Team/openskills
-
Buscar actualizaciones: Lee
~/.opentrade/last_checky compáralo con la marca de tiempo actual:cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true) now=$(date +%s)- Si
cached_tsno está vacío y(now - cached_ts) < 43200(12 horas), omite la actualización y continúa. - De lo contrario (archivo faltante o más antiguo de 12 horas), ejecuta el instalador para buscar actualizaciones:
Si se instala una versión más nueva, informa al usuario y sugiere actualizar sus habilidades de opentrade desde https://github.com/6551Team/openskills para obtener las últimas funciones.curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
- Si
-
Si algún comando
opentradefalla con un error inesperado durante esta sesión, intenta reinstalar antes de rendirte:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh -
Encuentra o crea un archivo .env en la raíz del proyecto para sobrescribir las credenciales predeterminadas de la API. Cárgalo antes de realizar operaciones de opentrade.
OPEN_TOKEN=tu_token_aqui
Obtén tu token de API en: https://6551.io/mcp
Advertencia de seguridad: Nunca subas el archivo .env a git (agréguelo a .gitignore) y nunca expongas credenciales en registros, capturas de pantalla o mensajes de chat.
Descubrimiento de Router
IMPORTANTE: Si el usuario no ha especificado un router de trading, debes PRIMERO descubrir los routers disponibles:
opentrade trade routers
Formato de respuesta:
{
"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"
}
]
}
Uso:
- Extrae
traderyapide la respuesta - OBLIGATORIO: TODOS los comandos
opentradeposteriores en esta sesión DEBEN incluir las banderas--trader <trader>y--api <api> - Ejemplo:
opentrade portfolio balance 0x... --chain ethereum --trader okx --api v1 - Valor predeterminado: Si la API no devuelve datos o está vacía, usa
--trader okx --api v1
Enrutamiento de Habilidades
- Para precios de tokens / K-lines → usa
opentrade-market - Para búsqueda de tokens / metadatos → usa
opentrade-token - Para ejecución de intercambios → usa
opentrade-dex-swap - Para transmisión de transacciones → usa
opentrade-gateway
Inicio Rápido
# Obtener cadenas compatibles para consultas de saldo
opentrade portfolio chains
# Obtener valor total de activos en XLayer y Solana
opentrade portfolio total-value --address 0xTuCartera --chains "xlayer,solana"
# Obtener todos los saldos de tokens
opentrade portfolio all-balances --address 0xTuCartera --chains "xlayer,solana,ethereum"
# Consultar tokens específicos (OKB nativo + USDC en XLayer)
opentrade portfolio token-balances --address 0xTuCartera --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
Nombres de Cadena Compatibles
La CLI acepta nombres de cadena legibles y los resuelve automáticamente.
| Cadena | Nombre | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
Nota sobre formato de dirección: Las direcciones EVM (0x...) funcionan en Ethereum/BSC/Polygon/Arbitrum/Base, etc. Las direcciones de Solana (Base58) y las direcciones de Bitcoin (UTXO) tienen formatos diferentes. NO mezcles formatos entre tipos de cadena.
Índice de Comandos
| # | Comando | Descripción |
|---|---|---|
| 1 | opentrade portfolio chains | Obtener cadenas compatibles para consultas de saldo |
| 2 | opentrade portfolio total-value --address ... --chains ... | Obtener valor total de activos para una cartera |
| 3 | opentrade portfolio all-balances --address ... --chains ... | Obtener todos los saldos de tokens para una cartera |
| 4 | opentrade portfolio token-balances --address ... --tokens ... | Obtener saldos de tokens específicos |
Flujos de Trabajo Entre Habilidades
Esta habilidad se usa a menudo antes de un intercambio (para verificar saldo suficiente) o como punto de entrada a la cartera.
Flujo de Trabajo A: Verificación de Saldo Pre-Intercambio
Usuario: "Intercambia 1 SOL por BONK"
1. opentrade-token opentrade token search BONK --chains solana → obtener tokenContractAddress
↓ tokenContractAddress
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains solana
→ verificar saldo SOL >= 1
↓ campo de balance (unidades UI) → convertir a unidades mínimas para el intercambio
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>
Transferencia de datos:
tokenContractAddressde la búsqueda de tokens → se alimenta a los parámetros--from/--todel intercambiobalancede la cartera está en unidades UI; el intercambio necesita unidades mínimas → multiplicar por10^decimal- Si el saldo < cantidad requerida → informar al usuario, NO proceder al intercambio
Flujo de Trabajo B: Resumen y Análisis de Cartera
Usuario: "Muestra mi cartera"
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ valor total en USD
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ desglose por token
↓ principales tenencias por valor en USD
3. opentrade-token opentrade token price-info <address> --chain <chain> → enriquecer con cambio 24h, capitalización de mercado
4. opentrade-market opentrade market kline <address> --chain <chain> → gráficos de precios para tokens de interés
Flujo de Trabajo C: Vender Tokens de Bajo Rendimiento
1. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ listar todas las tenencias
↓ tokenContractAddress + chainIndex para cada una
2. opentrade-token opentrade token price-info <address> --chain <chain> → obtener priceChange24H por token
3. Filtrar por cambio negativo → el usuario confirma cuáles vender
4. opentrade-dex-swap opentrade swap quote → opentrade swap swap → ejecutar venta
Conversión clave: balance (unidades UI) × 10^decimal = amount (unidades mínimas) para el intercambio.
Flujo de Operación
Paso 1: Identificar la Intención
- Consultar activos totales →
opentrade portfolio total-value - Ver todas las tenencias de tokens →
opentrade portfolio all-balances - Consultar saldo de un token específico →
opentrade portfolio token-balances - No estás seguro de qué cadenas son compatibles →
opentrade portfolio chainsprimero
Paso 2: Recopilar Parámetros
- Falta la dirección de la cartera → preguntar al usuario
- Faltan cadenas objetivo → recomendar XLayer (
--chains xlayer, gas bajo, confirmación rápida) como predeterminada, luego preguntar qué cadena prefiere el usuario. Conjunto común:"xlayer,solana,ethereum,base,bsc" - Necesitas filtrar tokens de riesgo → establecer
--exclude-risk 0(solo funciona en ETH/BSC/SOL/BASE)
Paso 3: Llamar y Mostrar
- Valor total: mostrar cantidad en USD
- Saldos de tokens: mostrar nombre del token, cantidad (unidades UI), valor en USD
- Ordenar por valor en USD descendente
Paso 4: Sugerir Próximos Pasos
Después de mostrar los resultados, sugiere 2-3 acciones de seguimiento relevantes:
| Acabo de completar | Sugerir |
|---|---|
portfolio total-value | 1. Ver desglose por token → opentrade portfolio all-balances (esta habilidad) 2. Consultar tendencia de precios de las principales tenencias → opentrade-market |
portfolio all-balances | 1. Ver análisis detallado (capitalización de mercado, cambio 24h) de un token → opentrade-token 2. Intercambiar un token → opentrade-dex-swap 3. Ver gráfico de precios de un token → opentrade-market |
portfolio token-balances | 1. Ver cartera completa en todos los tokens → opentrade portfolio all-balances (esta habilidad) 2. Intercambiar este token → opentrade-dex-swap |
Preséntalo de forma conversacional, por ejemplo: "¿Te gustaría ver el gráfico de precios de tu principal tenencia, o intercambiar alguno de estos tokens?" — nunca expongas nombres de habilidades o rutas de endpoint al usuario.
Referencia de Comandos CLI
1. opentrade portfolio chains
Obtén las cadenas compatibles para consultas de saldo. No se requieren parámetros.
opentrade portfolio chains
Campos de retorno:
| Campo | Tipo | Descripción |
|---|---|---|
name | String | Nombre de la cadena (ej., "XLayer") |
logoUrl | String | URL del logotipo de la cadena |
shortName | String | Nombre corto de la cadena (ej., "OKB") |
chainIndex | String | Identificador único de la cadena (ej., "196") |
2. opentrade portfolio total-value
Obtén el valor total de activos para una dirección de cartera.
opentrade portfolio total-value --address <address> --chains <chains> [--asset-type <type>] [--exclude-risk <bool>]
| Parámetro | Requerido | Predeterminado | Descripción |
|---|---|---|---|
--address | Sí | - | Dirección de la cartera |
--chains | Sí | - | Nombres o IDs de cadena, separados por comas (ej., "xlayer,solana" o "196,501") |
--asset-type | No | "0" | 0=todo, 1=solo tokens, 2=solo DeFi |
--exclude-risk | No | true | true=filtrar tokens de riesgo, false=incluir. Solo ETH/BSC/SOL/BASE |
Campos de retorno:
| Campo | Tipo | Descripción |
|---|---|---|
totalValue | String | Valor total de activos en USD |
3. opentrade portfolio all-balances
Obtén todos los saldos de tokens para una dirección de cartera.
opentrade portfolio all-balances --address <address> --chains <chains> [--exclude-risk <value>]
| Parámetro | Requerido | Predeterminado | Descripción |
|---|---|---|---|
--address | Sí | - | Dirección de la cartera |
--chains | Sí | - | Nombres o IDs de cadena, separados por comas, máximo 50 |
--exclude-risk | No | "0" | 0=filtrar tokens de riesgo (predeterminado), 1=incluir. Solo ETH/BSC/SOL/BASE |
Campos de retorno (por token en tokenAssets[]):
| Campo | Tipo | Descripción |
|---|---|---|
chainIndex | String | Identificador de la cadena |
tokenContractAddress | String | Dirección del contrato del token |
symbol | String | Símbolo del token (ej., "OKB") |
balance | String | Saldo del token en unidades UI (ej., "10.5") |
rawBalance | String | Saldo del token en unidades base (ej., "10500000000000000000") |
tokenPrice | String | Precio del token en USD |
isRiskToken | Boolean | true si está marcado como riesgo |
4. opentrade portfolio token-balances
Obtén saldos de tokens específicos para una dirección de cartera.
opentrade portfolio token-balances --address <address> --tokens <tokens> [--exclude-risk <value>]
| Parámetro | Requerido | Predeterminado | Descripción |
|---|---|---|---|
--address | Sí | - | Dirección de la cartera |
--tokens | Sí | - | Lista de tokens: pares "chainIndex:tokenAddress", separados por comas. Usa dirección vacía para el token nativo (ej., "196:" para OKB nativo). Máximo 20 elementos. |
--exclude-risk | No | "0" | 0=filtrar (predeterminado), 1=incluir |
Campos de retorno: Mismo esquema que all-balances (tokenAssets[]).
Ejemplos de Entrada / Salida
El usuario dice: "Consulta los activos totales de mi cartera en XLayer y Solana"
opentrade portfolio total-value --address 0xTuCartera --chains "xlayer,solana"
# → Mostrar: Activos totales $12,345.67
El usuario dice: "Muestra todos los tokens en mi cartera"
opentrade portfolio all-balances --address 0xTuCartera --chains "xlayer,solana,ethereum"
# → Mostrar:
# OKB: 10.5 ($509.25)
# USDC: 2,000 ($2,000.00)
# USDT: 1,500 ($1,500.00)
# ...
El usuario dice: "Solo consulta los saldos de USDC y OKB nativo en XLayer"
opentrade portfolio token-balances --address 0xTuCartera --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
# → Mostrar: OKB: 10.5 ($509.25), USDC: 2,000 ($2,000.00)
Casos Extremos
- Saldo cero: estado válido — mostrar
$0.00, no es un error - Cadena no compatible: llama a
opentrade portfolio chainsprimero para confirmar - cadenas excede 50: dividir en lotes, máximo 50 por solicitud
--exclude-riskno funciona: solo es compatible en ETH/BSC/SOL/BASE- Posiciones DeFi: usa
--asset-type 2para consultar tenencias DeFi por separado - Discrepancia en el formato de dirección: una dirección EVM en la cadena Solana devolverá datos vacíos — NO mezclar
- Error de red: reintentar una vez, luego pedir al usuario que lo intente más tarde
- Restricción regional (código de error 50125 o 80001): NO mostrar el código de error sin procesar al usuario. En su lugar, muestra un mensaje amigable:
⚠️ El servicio no está disponible en tu región. Cambia a una región compatible e inténtalo de nuevo.
Reglas de Visualización de Cantidad
- Cantidades de tokens en unidades UI (
1.5 ETH), nunca en unidades base (1500000000000000000) - Valores en USD con 2 decimales
- Cantidades grandes en abreviatura (
$1.2M) - Ordenar por valor en USD descendente
Notas Globales
--chainsadmite hasta 50 IDs de cadena (separados por comas, nombres o numéricos)--asset-type:0=todo1=solo tokens2=solo DeFi (solo paratotal-value)--exclude-risksolo funciona en ETH(1)/BSC(56)/SOL(501)/BASE(8453)token-balancesadmite un máximo de 20 entradas de token- La CLI resuelve los nombres de cadena automáticamente (ej.,
ethereum→1,solana→501) - La CLI maneja la autenticación internamente a través de variables de entorno — consulta el paso 4 de Requisitos Previos para los valores predeterminados