Análise de Portfólio de Carteira
Objetivo: Fornecer análise concisa da distribuição de ativos e avaliação de risco para carteiras EVM.
Entradas
wallet_address(obrigatório): Endereço EVM (0x...)
Fonte de Dados
Principal: API Zerion via zerion-portfolio.py
# Obter todos os ativos
python3 zerion-portfolio.py <endereço>
# Obter apenas posições DeFi
python3 zerion-portfolio.py <endereço> --only-defi
Ambiente: ZERION_API_KEY deve estar definida. Caso contrário, obtenha sua chave de API em: https://www.zerion.io/api
Fluxo de Execução
Passo 1: Validar Entrada
1. Verificar formato do endereço: 0x + 40 caracteres hexadecimais
2. Se formato inválido: Sair com mensagem de erro
Passo 2: Buscar Dados do Portfólio
# Executar script de portfólio Zerion
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <endereço>
Tratar Casos Extremos:
- Carteira vazia → Relatar "Carteira vazia"
- Falha na API → Sair com erro, não é possível prosseguir
- Posições com valor zero → Ignorar
Passo 3: Categorizar Ativos
Agrupar por tipo:
Nativos: ETH, MATIC, BNB, etc.
Stablecoins: USDC, USDT, DAI, USDS
Posições DeFi: Possui atributo protocol + position_type != 'wallet'
Outros Tokens: Todo o restante
Rastrear valor total por categoria para percentuais de distribuição
Passo 4: Identificar Protocolos DeFi
Para cada posição DeFi:
1. Extrair nome do protocolo de attributes.protocol
2. Identificar tipo de posição (Empréstimo/Staking/LP/etc.)
3. Registrar valor da posição e percentual do portfólio
4. Criar lista de protocolos únicos para avaliação de risco
Passo 5: Avaliação de Risco (Apenas Protocolos DeFi)
Para cada protocolo identificado:
A. Buscar Dados do Protocolo (em paralelo):
- API DefiLlama: curl "https://api.llama.fi/protocol/{slug}"
- Extrair TVL, chains, informações de auditoria, categoria
B. Verificar Explorações Recentes:
- Pesquisar rekt.news pelo nome do protocolo
- Filtrar últimos 90 dias
- Registrar quaisquer incidentes
C. Calcular Pontuação de Risco:
Risco = Base + Eventos + Auditoria + Tendência TVL
Fatores:
- Sem auditoria: +5
- Exploração recente (90 dias): +5
- Queda de TVL >50% (30 dias): +3
- Queda de TVL 20-50%: +2
- Novo protocolo (<6 meses): +2
- Auditoria única: +1
- Múltiplas auditorias: -2
- Testado em batalha (>1 ano): -1
D. Atribuir Nível de Risco:
- Pontuação > 7: 🔴 Alto Risco
- Pontuação 4-7: 🟡 Risco Médio
- Pontuação < 4: 🟢 Baixo Risco
E. Tratamento de Erros:
- DefiLlama falha: Marcar TVL como "N/D", continuar
- Rekt.news indisponível: Marcar explorações como "Desconhecido"
Protocolos Conhecidos como Seguros (automático 🟢):
- Aave V2/V3, Uniswap V2/V3, Compound V2/V3
- Lido, Curve, MakerDAO/Sky
Passo 6: Gerar Relatório
Gerar relatório em markdown estruturado seguindo a seção de Formato de Saída abaixo.
Formato de Saída
1) Resumo
Portfólio: 0x...
Valor Total: $X.XXX USD
Chains: Ethereum, Arbitrum, Base
2) Distribuição de Ativos
Detalhamento de Ativos:
• Nativos: $XXX (XX%)
• Stablecoins: $XXX (XX%)
• Posições DeFi: $XXX (XX%)
• Outros Tokens: $XXX (XX%)
3) Principais Posições
Tabela com todas as posições ordenadas por valor:
Protocolo/Carteira | Tipo de Posição | Valor | % Portfólio
-------------------|-----------------|-------|------------
Ativos da Carteira | Carteira | $XXX | XX%
Protocolo A | Empréstimo | $XXX | XX%
Protocolo B | LP | $XXX | XX%
4) Principais Holdings (>2% do portfólio)
Tabela:
Chain | Ativo | Tipo | Quantidade | Valor | % Portfólio
------|-------|------|------------|-------|------------
5) Exposição DeFi
Para cada protocolo com risco 🟡 Médio ou 🔴 Alto apenas (pular 🟢 Baixo risco):
Nome do Protocolo (Chain)
• Valor da Posição: $XXX (XX% do portfólio)
• Tipo de Posição: Empréstimo/Staking/LP/etc.
• Risco: 🟡/🔴
• TVL: $XXX (DefiLlama)
• Auditoria: Sim/Não (nomes dos auditores)
• Problemas Recentes: Nenhum / [descrever]
Se todos os protocolos forem de baixo risco, exibir: "Todas as posições DeFi estão em protocolos de baixo risco (🟢)"
6) Resumo de Risco
Alta Prioridade:
- Listar quaisquer posições de 🔴 alto risco com ações recomendadas
Média Prioridade:
- Listar quaisquer posições de 🟡 risco médio com considerações
Avaliação Geral:
- Um parágrafo de resumo
- Pontuação de risco: Baixo/Médio/Alto
7) Fontes de Dados
- API Zerion: Dados do portfólio (timestamp)
- DefiLlama: TVL e informações do protocolo
- Rekt.news: Incidentes de segurança
- [Outras fontes utilizadas]
Padrões de Qualidade
Concisão:
- Relatório total: 200-400 palavras (excluindo tabelas)
- Foco apenas em insights acionáveis
- Sem enchimentos ou declarações genéricas
Precisão:
- Todos os dados devem ter timestamps
- Todos os valores devem vir de chamadas de API reais
- Avaliações de risco devem citar evidências específicas
Utilidade:
- Destacar posições >5% do portfólio
- Sinalizar qualquer exposição de alto risco imediatamente
- Fornecer próximas ações claras, se necessário
Frequência de Atualização
- Base de riscos: Atualizar mensalmente com rekt.news
- Protocolos conhecidos: Atualizar conforme novos protocolos importantes forem lançados
- Status de auditoria: Verificar trimestralmente
Última atualização: 2026-02-05