Análisis de Portafolio de Wallet
Objetivo: Proporcionar un análisis conciso de la distribución de activos y una evaluación de riesgos para wallets EVM.
Entradas
wallet_address(obligatorio): Dirección EVM (0x...)
Fuente de Datos
Principal: API de Zerion a través de 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 configurar 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 es inválido: Salir con mensaje de error
Paso 2: Obtener Datos del Portafolio
# Ejecutar el script de Zerion
python3 skills/pubfi-wallet-portfolio-analysis/zerion-portfolio.py <dirección>
Manejar Casos Límite:
- Wallet vacía → Reportar "Wallet vacía"
- Fallo de API → Salir con error, no se puede continuar
- Posiciones de valor cero → Omitir
Paso 3: Categorizar Activos
Agrupar por tipo:
Nativo: 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 el nombre del protocolo de attributes.protocol
2. Identificar el tipo de posición (Préstamo/Staking/LP/etc.)
3. Registrar el valor de la posición y el porcentaje del portafolio
4. Crear una lista de protocolos únicos para la 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
- Auditoría única: +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 un informe estructurado en markdown siguiendo la sección de Formato de Salida a continuación.
Formato de Salida
1) Resumen
Portafolio: 0x...
Valor Total: $X,XXX USD
Cadenas: Ethereum, Arbitrum, Base
2) Distribución de Activos
Desglose de Activos:
• Nativo: $XXX (XX%)
• Stablecoins: $XXX (XX%)
• Posiciones DeFi: $XXX (XX%)
• Otros Tokens: $XXX (XX%)
3) Principales Posiciones
Formato de tabla mostrando todas las posiciones ordenadas por valor:
Protocolo/Wallet | Tipo de Posición | Valor | % Portafolio
----------------|------------------|-------|------------
Wallet Assets | Wallet | $XXX | XX%
Protocolo A | Préstamo | $XXX | XX%
Protocolo B | LP | $XXX | XX%
4) Principales Tenencias (>2% del portafolio)
Formato de tabla:
Cadena | Activo | Tipo | Cantidad | Valor | % Portafolio
-------|--------|------|----------|-------|------------
5) Exposición DeFi
Para cada protocolo con riesgo 🟡 Medio o 🔴 Alto solamente (omitir 🟢 Bajo):
Nombre del Protocolo (Cadena)
• Valor de la Posición: $XXX (XX% del portafolio)
• 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:
- Un párrafo de resumen
- Puntuación de riesgo: Bajo/Medio/Alto
7) Fuentes de Datos
- API de Zerion: Datos del portafolio (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 solo en información procesable
- Sin relleno ni declaraciones genéricas
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% del portafolio
- Señalar cualquier exposición de alto riesgo inmediatamente
- Proporcionar acciones claras si es necesario
Frecuencia de Actualización
- Base de datos de riesgos: Actualizar mensualmente con rekt.news
- Protocolos conocidos: Actualizar a medida que se lancen nuevos protocolos importantes
- Estado de auditoría: Verificar trimestralmente
Última actualización: 2026-02-05