Visão Geral e Otimização do Portfólio
Exiba um painel completo de portfólio DeFi que agrega saldos de tokens, posições em staking, posições em vaults Troves, staking líquido Endur (LST), posições de empréstimo, ordens DCA e saldos confidenciais do Tongo Cash — tudo com valores em USD. Rebalanceie o portfólio para uma alocação-alvo por meio de swaps em lote automatizados.
Pré-requisitos
- Sessão ativa necessária.
- Para rebalanceamento: saldos de tokens suficientes + gás para transações de swap em lote.
Regras
- Use
portfoliocomo o PRIMEIRO comando quando o usuário perguntar "o que eu tenho?" ou quiser uma avaliação geral. - O comando
portfolioé somente leitura — ele nunca modifica nenhum estado on-chain. - Os preços em USD são obtidos do SDK StarkZap e podem apresentar pequenas variações.
- Para
portfolio-rebalance, SEMPRE use--simulateprimeiro para visualizar o plano antes de executar. - As alocações-alvo devem somar 100%. Se não somarem, informe o usuário e peça para ajustá-las.
- Após o rebalanceamento, execute
portfolionovamente para confirmar a nova alocação.
Comandos
Painel do Portfólio
npx starkfi@latest portfolio [--json]
Rebalanceamento do Portfólio
# Rebalancear para alocação-alvo
npx starkfi@latest portfolio-rebalance --target "<alocação>" [--slippage <n>] [--simulate] [--json]
Parâmetros
portfolio
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
--json | flag | Saída em JSON | Não |
portfolio-rebalance
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
--target | string | Alocação-alvo (ex.: "50 ETH, 30 USDC, 20 STRK") | Sim |
--slippage | número | Tolerância de slippage % (padrão: 1) | Não |
--simulate | flag | Visualizar plano sem executar | Não |
--json | flag | Saída em JSON | Não |
Formato da alocação-alvo: Pares <porcentagem> <token> separados por vírgula que somam 100.
Seções do Painel
O portfólio exibe sete seções:
- Saldos de Tokens — STRK, ETH e todos os tokens ERC-20 com saldos não zero e seus valores em USD.
- Posições em Staking — Stakes ativos em todos os validadores/pools com recompensas pendentes. Mostra valores em processo de retirada e datas de cooldown quando intenções de saída estão ativas.
- Posições de Empréstimo — Posições ativas do Vesu V2: valores fornecidos e emprestados com detalhes do pool.
- Ordens DCA — Ordens de swap recorrentes de Dollar-Cost Averaging ativas.
- Saldo Confidencial Tongo — Saldos privados ativos e pendentes no Tongo Cash.
- Posições em Vaults Troves — Depósitos ativos em estratégias de yield DeFi da Troves com valor atual e APY.
- Posições LST — Participações em xSTRK do staking líquido Endur com valor atual em STRK e rendimento acumulado.
Exemplos
Usuário: "Mostre meu portfólio"
npx starkfi@latest portfolio
Usuário: "Qual é meu valor total na Starknet?"
npx starkfi@latest portfolio
Usuário: "Obtenha meu portfólio como JSON para análise"
npx starkfi@latest portfolio --json
Usuário: "Rebalanceie para 50% ETH, 30% USDC, 20% STRK"
# 1. Visualizar alocação atual
npx starkfi@latest portfolio
# 2. Visualizar o plano de rebalanceamento
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --simulate
# 3. Executar após confirmação do usuário
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK"
npx starkfi@latest tx-status <hash>
# 4. Verificar a nova alocação
npx starkfi@latest portfolio
Usuário: "Quero 60% ETH e 40% STRK"
npx starkfi@latest portfolio-rebalance --target "60 ETH, 40 STRK" --simulate
Usuário: "Otimize meu portfólio com 2% de slippage"
npx starkfi@latest portfolio-rebalance --target "50 ETH, 30 USDC, 20 STRK" --slippage 2
Tratamento de Erros
| Erro | Ação |
|---|---|
Não autenticado | Execute a skill authenticate-wallet primeiro. |
Falha parcial | Algumas seções podem mostrar erros enquanto outras funcionam. O portfólio usa agregação tolerante a falhas. |
Erro de rede | Tente novamente uma vez. Use config para definir um RPC personalizado. |
Alocação inválida | Garanta que as porcentagens-alvo somem 100 e que os símbolos dos tokens sejam válidos. |
Rebalanceamento falhou | Verifique os saldos e garanta que os tokens tenham liquidez suficiente nos provedores compatíveis. |
Saldo insuficiente | Não há tokens suficientes para executar swaps — verifique balance primeiro. |
Skills Relacionadas
- Use
balancepara uma visão focada apenas nos saldos de tokens. - Use
stakingstake-statuspara posições detalhadas de staking. - Use
lendinglend-statuspara posições detalhadas de empréstimo. - Use
lendinglend-monitorpara monitorar fatores de saúde em todas as posições de empréstimo. - Use
dcadca-listpara visualizar ordens DCA ativas. - Use
trovestroves-positionpara posições detalhadas em vaults. - Use
lstlst-positionpara posições detalhadas de staking líquido. - Use
tradese você precisar trocar um único par de tokens (não rebalanceamento completo).