CLI de Portfólio Wallet OpenTrade
4 comandos para cadeias suportadas, valor total da carteira, todos os saldos de tokens e saldos de tokens específicos.
Verificações Pré-voo
Toda vez antes de executar qualquer comando opentrade, siga estas etapas em ordem. Não exiba a saída de comandos de rotina para o usuário; apenas forneça uma breve atualização de status ao instalar, atualizar ou lidar com uma falha.
-
Confirmar instalação: Execute
which opentrade. Se não for encontrado, instale:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | shSe o script de instalação falhar, peça ao usuário para instalar manualmente seguindo as instruções em: https://github.com/6551Team/openskills
-
Verificar atualizações: Leia
~/.opentrade/last_checke compare com o timestamp atual:cached_ts=$(cat ~/.opentrade/last_check 2>/dev/null || true) now=$(date +%s)- Se
cached_tsnão estiver vazio e(now - cached_ts) < 43200(12 horas), pule a atualização e prossiga. - Caso contrário (arquivo ausente ou mais antigo que 12 horas), execute o instalador para verificar atualizações:
Se uma versão mais recente for instalada, informe o usuário e sugira atualizar seus skills opentrade em https://github.com/6551Team/openskills para obter os recursos mais recentes.curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh
- Se
-
Se qualquer comando
opentradefalhar com um erro inesperado durante esta sessão, tente reinstalar antes de desistir:curl -sSL https://raw.githubusercontent.com/6551Team/openskills/main/skills/opentrade/install.sh | sh -
Encontre ou crie um arquivo .env na raiz do projeto para substituir as credenciais de API padrão. Carregue-o antes de realizar operações opentrade.
OPEN_TOKEN=seu_token_aquiObtenha seu token de API em: https://6551.io/mcp
Aviso de segurança: Nunca commite .env no git (adicione ao .gitignore) e nunca exponha credenciais em logs, capturas de tela ou mensagens de chat.
Descoberta de Roteador
IMPORTANTE: Se o usuário não especificou um roteador de trading, você DEVE primeiro descobrir os roteadores disponíveis:
opentrade trade routers
Formato da resposta:
{
"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:
- Extraia
tradereapida resposta - OBRIGATÓRIO: TODOS os comandos
opentradesubsequentes nesta sessão DEVEM incluir as flags--trader <trader>e--api <api> - Exemplo:
opentrade portfolio balance 0x... --chain ethereum --trader okx --api v1 - Fallback padrão: Se a API retornar nenhum dado ou estiver vazia, use
--trader okx --api v1
Roteamento de Skills
- Para preços de tokens / K-lines → use
opentrade-market - Para pesquisa de tokens / metadados → use
opentrade-token - Para execução de swap → use
opentrade-dex-swap - Para transmissão de transações → use
opentrade-gateway
Início Rápido
# Obter cadeias suportadas para consultas de saldo
opentrade portfolio chains
# Obter valor total de ativos na XLayer e Solana
opentrade portfolio total-value --address 0xSuaCarteira --chains "xlayer,solana"
# Obter todos os saldos de tokens
opentrade portfolio all-balances --address 0xSuaCarteira --chains "xlayer,solana,ethereum"
# Verificar tokens específicos (OKB nativo + USDC na XLayer)
opentrade portfolio token-balances --address 0xSuaCarteira --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
Suporte a Nomes de Cadeia
A CLI aceita nomes de cadeia legíveis por humanos e os resolve automaticamente.
| Cadeia | Nome | chainIndex |
|---|---|---|
| XLayer | xlayer | 196 |
| Solana | solana | 501 |
| Ethereum | ethereum | 1 |
| Base | base | 8453 |
| BSC | bsc | 56 |
| Arbitrum | arbitrum | 42161 |
| Polygon | polygon | 137 |
Nota sobre formato de endereço: Endereços EVM (0x...) funcionam em Ethereum/BSC/Polygon/Arbitrum/Base, etc. Endereços Solana (Base58) e endereços Bitcoin (UTXO) têm formatos diferentes. NÃO misture formatos entre tipos de cadeia.
Índice de Comandos
| # | Comando | Descrição |
|---|---|---|
| 1 | opentrade portfolio chains | Obter cadeias suportadas para consultas de saldo |
| 2 | opentrade portfolio total-value --address ... --chains ... | Obter valor total de ativos para uma carteira |
| 3 | opentrade portfolio all-balances --address ... --chains ... | Obter todos os saldos de tokens para uma carteira |
| 4 | opentrade portfolio token-balances --address ... --tokens ... | Obter saldos de tokens específicos |
Fluxos de Trabalho Entre Skills
Este skill é frequentemente usado antes de um swap (para verificar saldo suficiente) ou como ponto de entrada do portfólio.
Fluxo de Trabalho A: Verificação de Saldo Pré-Swap
Usuário: "Troque 1 SOL por BONK"
1. opentrade-token opentrade token search BONK --chains solana → obter tokenContractAddress
↓ tokenContractAddress
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains solana
→ verificar saldo SOL >= 1
↓ campo balance (unidades de UI) → converter para unidades mínimas para swap
3. opentrade-dex-swap opentrade swap quote --from 11111111111111111111111111111111 --to <endereço_BONK> --amount 1000000000 --chain solana
4. opentrade-dex-swap opentrade swap swap --from ... --to <endereço_BONK> --amount 1000000000 --chain solana --wallet <addr>
Transferência de dados:
tokenContractAddressda pesquisa de token → alimenta o swap--from/--tobalancedo portfólio está em unidades de UI; o swap precisa de unidades mínimas → multiplique por10^decimal- Se saldo < valor necessário → informe o usuário, NÃO prossiga para o swap
Fluxo de Trabalho B: Visão Geral do Portfólio + Análise
Usuário: "Mostre meu portfólio"
1. opentrade-portfolio opentrade portfolio total-value --address <addr> --chains "xlayer,solana,ethereum"
→ valor total em USD
2. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ detalhamento por token
↓ principais participações por valor em USD
3. opentrade-token opentrade token price-info <address> --chain <chain> → enriquecer com variação de 24h, capitalização de mercado
4. opentrade-market opentrade market kline <address> --chain <chain> → gráficos de preço para tokens de interesse
Fluxo de Trabalho C: Vender Tokens com Baixo Desempenho
1. opentrade-portfolio opentrade portfolio all-balances --address <addr> --chains "xlayer,solana,ethereum"
→ listar todas as participações
↓ tokenContractAddress + chainIndex para cada um
2. opentrade-token opentrade token price-info <address> --chain <chain> → obter priceChange24H por token
3. Filtrar por variação negativa → usuário confirma quais vender
4. opentrade-dex-swap opentrade swap quote → opentrade swap swap → executar venda
Conversão chave: balance (unidades de UI) × 10^decimal = amount (unidades mínimas) para swap.
Fluxo de Operação
Etapa 1: Identificar Intenção
- Verificar ativos totais →
opentrade portfolio total-value - Visualizar todas as participações de tokens →
opentrade portfolio all-balances - Verificar saldo de token específico →
opentrade portfolio token-balances - Não sabe quais cadeias são suportadas →
opentrade portfolio chainsprimeiro
Etapa 2: Coletar Parâmetros
- Endereço de carteira ausente → pergunte ao usuário
- Cadeias alvo ausentes → recomende XLayer (
--chains xlayer, baixo gás, confirmação rápida) como padrão, depois pergunte qual cadeia o usuário prefere. Conjunto comum:"xlayer,solana,ethereum,base,bsc" - Precisa filtrar tokens de risco → defina
--exclude-risk 0(funciona apenas em ETH/BSC/SOL/BASE)
Etapa 3: Chamar e Exibir
- Valor total: exiba o valor em USD
- Saldos de tokens: mostre nome do token, quantidade (unidades de UI), valor em USD
- Ordene por valor em USD decrescente
Etapa 4: Sugerir Próximos Passos
Após exibir os resultados, sugira 2-3 ações de acompanhamento relevantes:
| Acabou de concluir | Sugerir |
|---|---|
portfolio total-value | 1. Visualizar detalhamento por token → opentrade portfolio all-balances (este skill) 2. Verificar tendência de preço das principais participações → opentrade-market |
portfolio all-balances | 1. Visualizar análises detalhadas (capitalização de mercado, variação 24h) para um token → opentrade-token 2. Trocar um token → opentrade-dex-swap 3. Visualizar gráfico de preço para um token → opentrade-market |
portfolio token-balances | 1. Visualizar portfólio completo em todos os tokens → opentrade portfolio all-balances (este skill) 2. Trocar este token → opentrade-dex-swap |
Apresente de forma conversacional, por exemplo: "Gostaria de ver o gráfico de preço da sua principal participação ou trocar algum desses tokens?" — nunca exponha nomes de skills ou caminhos de endpoint ao usuário.
Referência de Comando CLI
1. opentrade portfolio chains
Obter cadeias suportadas para consultas de saldo. Nenhum parâmetro necessário.
opentrade portfolio chains
Campos de retorno:
| Campo | Tipo | Descrição |
|---|---|---|
name | String | Nome da cadeia (ex.: "XLayer") |
logoUrl | String | URL do logotipo da cadeia |
shortName | String | Nome curto da cadeia (ex.: "OKB") |
chainIndex | String | Identificador único da cadeia (ex.: "196") |
2. opentrade portfolio total-value
Obter valor total de ativos para um endereço de carteira.
opentrade portfolio total-value --address <endereço> --chains <cadeias> [--asset-type <tipo>] [--exclude-risk <bool>]
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
--address | Sim | - | Endereço da carteira |
--chains | Sim | - | Nomes ou IDs de cadeia, separados por vírgula (ex.: "xlayer,solana" ou "196,501") |
--asset-type | Não | "0" | 0=todos, 1=apenas tokens, 2=apenas DeFi |
--exclude-risk | Não | true | true=filtrar tokens de risco, false=incluir. Apenas ETH/BSC/SOL/BASE |
Campos de retorno:
| Campo | Tipo | Descrição |
|---|---|---|
totalValue | String | Valor total de ativos em USD |
3. opentrade portfolio all-balances
Obter todos os saldos de tokens para um endereço de carteira.
opentrade portfolio all-balances --address <endereço> --chains <cadeias> [--exclude-risk <valor>]
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
--address | Sim | - | Endereço da carteira |
--chains | Sim | - | Nomes ou IDs de cadeia, separados por vírgula, máximo 50 |
--exclude-risk | Não | "0" | 0=filtrar tokens de risco (padrão), 1=incluir. Apenas ETH/BSC/SOL/BASE |
Campos de retorno (por token em tokenAssets[]):
| Campo | Tipo | Descrição |
|---|---|---|
chainIndex | String | Identificador da cadeia |
tokenContractAddress | String | Endereço do contrato do token |
symbol | String | Símbolo do token (ex.: "OKB") |
balance | String | Saldo do token em unidades de UI (ex.: "10.5") |
rawBalance | String | Saldo do token em unidades base (ex.: "10500000000000000000") |
tokenPrice | String | Preço do token em USD |
isRiskToken | Boolean | true se sinalizado como de risco |
4. opentrade portfolio token-balances
Obter saldos de tokens específicos para um endereço de carteira.
opentrade portfolio token-balances --address <endereço> --tokens <tokens> [--exclude-risk <valor>]
| Parâmetro | Obrigatório | Padrão | Descrição |
|---|---|---|---|
--address | Sim | - | Endereço da carteira |
--tokens | Sim | - | Lista de tokens: pares "chainIndex:tokenAddress", separados por vírgula. Use endereço vazio para token nativo (ex.: "196:" para OKB nativo). Máximo 20 itens. |
--exclude-risk | Não | "0" | 0=filtrar (padrão), 1=incluir |
Campos de retorno: Mesmo esquema de all-balances (tokenAssets[]).
Exemplos de Entrada / Saída
Usuário diz: "Verifique meus ativos totais da carteira na XLayer e Solana"
opentrade portfolio total-value --address 0xSuaCarteira --chains "xlayer,solana"
# → Exibir: Ativos totais $12.345,67
Usuário diz: "Mostre todos os tokens na minha carteira"
opentrade portfolio all-balances --address 0xSuaCarteira --chains "xlayer,solana,ethereum"
# → Exibir:
# OKB: 10.5 ($509.25)
# USDC: 2.000 ($2.000,00)
# USDT: 1.500 ($1.500,00)
# ...
Usuário diz: "Verifique apenas saldos de USDC e OKB nativo na XLayer"
opentrade portfolio token-balances --address 0xSuaCarteira --tokens "196:,196:0x74b7f16337b8972027f6196a17a631ac6de26d22"
# → Exibir: OKB: 10.5 ($509.25), USDC: 2.000 ($2.000,00)
Casos de Borda
- Saldo zero: estado válido — exiba
$0,00, não um erro - Cadeia não suportada: chame
opentrade portfolio chainsprimeiro para confirmar - cadeias excede 50: divida em lotes, máximo 50 por requisição
--exclude-risknão funcionando: suportado apenas em ETH/BSC/SOL/BASE- Posições DeFi: use
--asset-type 2para consultar participações DeFi separadamente - Incompatibilidade de formato de endereço: endereço EVM na cadeia Solana retornará dados vazios — NÃO misture
- Erro de rede: tente novamente uma vez, depois solicite ao usuário que tente novamente mais tarde
- Restrição de região (código de erro 50125 ou 80001): NÃO mostre o código de erro bruto ao usuário. Em vez disso, exiba uma mensagem amigável:
⚠️ O serviço não está disponível na sua região. Mude para uma região suportada e tente novamente.
Regras de Exibição de Quantidade
- Quantidades de tokens em unidades de UI (
1,5 ETH), nunca em unidades base (1500000000000000000) - Valores em USD com 2 casas decimais
- Grandes quantidades em notação abreviada (
$1.2M) - Ordene por valor em USD decrescente
Notas Globais
--chainssuporta até 50 IDs de cadeia (separados por vírgula, nomes ou numéricos)--asset-type:0=todos1=apenas tokens2=apenas DeFi (apenas paratotal-value)--exclude-riskfunciona apenas em ETH(1)/BSC(56)/SOL(501)/BASE(8453)token-balancessuporta no máximo 20 entradas de token- A CLI resolve nomes de cadeia automaticamente (ex.:
ethereum→1,solana→501) - A CLI lida com autenticação internamente por meio de variáveis de ambiente — consulte a Etapa 4 dos Pré-requisitos para valores padrão