¿Qué hace Análisis de Cartera de Wallets EVM?
Objetivo: Proporcionar un análisis conciso de la distribución de activos y evaluación de riesgos para wallets EVM.
Entradas
wallet_address(obligatorio): Dirección EVM (0x...)
Fuente de Datos
Principal: API de Zerion mediante zerion-portfolio.py
# Obtener todos los activos
python3 zerion-portfolio.py <dirección>
# Obtener solo posiciones DeFi
python3 zerion-portfolio.py <dirección> --only-defi
Entorno: Se debe establecer ZERION_API_KEY. Si no está configurada, obtén tu clave API en: https://www.zerion.io/api
Flujo de Ejecución
Paso 1: Validar Entrada
1. Verificar formato de dirección: 0x + 40 caracteres hexadecimales
2. Si el formato no es válido: Salir con mensaje de error
Paso 2: Obtener Datos de Cartera
# Ejecutar script de cartera Zerion
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <dirección>
Manejar Casos Extremos:
- Cartera vacía → Reportar "Cartera vacía"
- Fallo de API → Salir con error, no se puede continuar
- Posiciones con valor cero → Omitir
Paso 3: Categorizar Activos
Agrupar por tipo:
Nativos: ETH, MATIC, BNB, etc.
Stablecoins: USDC, USDT, DAI, USDS
Posiciones DeFi: Tiene atributo protocol + position_type != 'wallet'
Otros Tokens: Todo lo demás
Rastrear el valor total por categoría para porcentajes de distribución
Paso 4: Identificar Protocolos DeFi
Para cada posición DeFi:
1. Extraer nombre del protocolo de attributes.protocol
2. Identificar tipo de posición (Préstamo/Staking/LP/etc.)
3. Registrar valor de la posición y porcentaje de la cartera
4. Crear lista de protocolos únicos para evaluación de riesgos
Paso 5: Evaluación de Riesgos (Solo Protocolos DeFi)
Para cada protocolo identificado:
A. Obtener Datos del Protocolo (en paralelo):
- API de DefiLlama: curl "https://api.llama.fi/protocol/{slug}"
- Extraer TVL, cadenas, información de auditoría, categoría
B. Verificar Exploits Recientes:
- Buscar en rekt.news el nombre del protocolo
- Filtrar últimos 90 días
- Registrar cualquier incidente
C. Calcular Puntuación de Riesgo:
Riesgo = Base + Eventos + Auditoría + Tendencia TVL
Factores:
- Sin auditoría: +5
- Exploit reciente (90 días): +5
- Caída de TVL >50% (30 días): +3
- Caída de TVL 20-50%: +2
- Protocolo nuevo (<6 meses): +2
- Una sola auditoría: +1
- Múltiples auditorías: -2
- Probado en batalla (>1 año): -1
D. Asignar Nivel de Riesgo:
- Puntuación > 7: 🔴 Alto Riesgo
- Puntuación 4-7: 🟡 Riesgo Medio
- Puntuación < 4: 🟢 Bajo Riesgo
E. Manejo de Errores:
- DefiLlama falla: Marcar TVL como "N/A", continuar
- Rekt.news no disponible: Marcar exploits como "Desconocido"
Protocolos Seguros Conocidos (🟢 automático):
- Aave V2/V3, Uniswap V2/V3, Compound V2/V3
- Lido, Curve, MakerDAO/Sky
Paso 6: Generar Informe
Generar informe estructurado en markdown siguiendo la sección de Formato de Salida a continuación.
Formato de Salida
1) Resumen
Cartera: 0x...
Valor Total: $X,XXX USD
Cadenas: Ethereum, Arbitrum, Base
2) Distribución de Activos
Desglose de Activos:
• Nativos: $XXX (XX%)
• Stablecoins: $XXX (XX%)
• Posiciones DeFi: $XXX (XX%)
• Otros Tokens: $XXX (XX%)
3) Principales Posiciones
Tabla con todas las posiciones ordenadas por valor:
Protocolo/Cartera | Tipo de Posición | Valor | % Cartera
------------------|------------------|-------|----------
Activos de Cartera | Cartera | $XXX | XX%
Protocolo A | Préstamo | $XXX | XX%
Protocolo B | LP | $XXX | XX%
4) Principales Tenencias (>2% de la cartera)
Formato de tabla:
Cadena | Activo | Tipo | Cantidad | Valor | % Cartera
-------|--------|------|----------|-------|----------
5) Exposición DeFi
Para cada protocolo con riesgo 🟡 Medio o 🔴 Alto únicamente (omitir 🟢 Bajo):
Nombre del Protocolo (Cadena)
• Valor de la Posición: $XXX (XX% de la cartera)
• Tipo de Posición: Préstamo/Staking/LP/etc.
• Riesgo: 🟡/🔴
• TVL: $XXX (DefiLlama)
• Auditoría: Sí/No (nombres de auditores)
• Problemas Recientes: Ninguno / [describir]
Si todos los protocolos son de bajo riesgo, mostrar: "Todas las posiciones DeFi están en protocolos de bajo riesgo (🟢)"
6) Resumen de Riesgos
Alta Prioridad:
- Listar cualquier posición 🔴 de alto riesgo con acciones recomendadas
Prioridad Media:
- Listar cualquier posición 🟡 de riesgo medio con consideraciones
Evaluación General:
- Resumen de un párrafo
- Puntuación de riesgo: Bajo/Medio/Alto
7) Fuentes de Datos
- API de Zerion: Datos de cartera (marca de tiempo)
- DefiLlama: TVL e información del protocolo
- Rekt.news: Incidentes de seguridad
- [Otras fuentes utilizadas]
Estándares de Calidad
Concisión:
- Informe total: 200-400 palabras (excluyendo tablas)
- Enfocarse únicamente en información útil
- Sin contenido genérico o de relleno
Precisión:
- Todos los datos deben tener marcas de tiempo
- Todos los valores deben provenir de llamadas API reales
- Las evaluaciones de riesgo deben citar evidencia específica
Utilidad:
- Destacar posiciones >5% de la cartera
- Señalar cualquier exposición de alto riesgo de inmediato
- Proporcionar próximos pasos claros si es necesario
Frecuencia de Actualización
- Base de datos de riesgos: Actualizar mensualmente con rekt.news
- Protocolos conocidos: Actualizar cuando se lancen nuevos protocolos importantes
- Estado de auditorías: Verificar trimestralmente
Última actualización: 2026-02-05