Seguimiento de Cartera Cripto
Resumen
Rastrea tenencias de criptomonedas con valoraciones en tiempo real de CoinGecko, análisis de asignación, seguimiento de P&L y alertas de riesgo de concentración.
Requisitos previos
- Python 3.8+ instalado
- Dependencias:
pip install requests - Conexión a Internet para acceder a la API de CoinGecko
- Un archivo JSON de cartera con tus tenencias (consulta
references/implementation.mdpara el formato)
Instrucciones
-
Evalúa la intención del usuario - determina qué vista de cartera se necesita:
- Verificación rápida: valor total y principales tenencias
- Lista de tenencias: desglose completo de todas las posiciones
- Análisis detallado: asignaciones, P&L, indicadores de riesgo
- Exportación: JSON o CSV para herramientas externas
-
Ejecuta el rastreador de cartera con las opciones adecuadas:
# Resumen rápido de cartera python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json # Desglose completo de tenencias python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings # Análisis detallado con P&L y asignaciones python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed -
Exporta resultados para herramientas de análisis o declaración de impuestos:
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format json --output portfolio_export.json python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output portfolio.csv -
Presenta los resultados al usuario:
- Muestra el valor total de la cartera de forma destacada
- Resalta los cambios en 24h y 7d
- Explica los porcentajes de asignación
- Señala cualquier riesgo de concentración (posiciones > 25% de asignación por defecto)
Salida
Resumen que muestra el valor total, cambios en 24h/7d, asignación por activo y advertencias de concentración para posiciones que superan el umbral:
==============================================================================
RASTREADOR DE CARTERA CRIPTO Actualizado: 2026-01-14 15:30 # 2026 - año actual
==============================================================================
RESUMEN DE CARTERA: Mi Cartera
------------------------------------------------------------------------------
Valor Total: $125,450.00 USD
Cambio 24h: +$2,540.50 (+2.07%)
Cambio 7d: +$8,125.00 (+6.92%)
Tenencias: 8 activos
PRINCIPALES TENENCIAS
------------------------------------------------------------------------------
Moneda Cantidad Precio Valor Asign. 24h
BTC 0.500 $95,000.00 $47,500.00 37.9% +2.5%
ETH 10.000 $3,200.00 $32,000.00 25.5% +1.8%
SOL 100.000 $180.00 $18,000.00 14.4% +4.2%
ADVERTENCIA: BTC (37.9%) supera el umbral del 25%
==============================================================================
Manejo de Errores
| Error | Causa | Solución |
|---|---|---|
| Archivo de cartera no encontrado | Ruta inválida | Verifica que la ruta del archivo exista |
| JSON inválido | Archivo mal formado | Valida la sintaxis JSON |
| Moneda no encontrada | Símbolo desconocido | Revisa la ortografía del símbolo, usa símbolos estándar |
| Límite de API alcanzado | Demasiadas solicitudes | Espera y reintenta, usa almacenamiento en caché |
Consulta ${CLAUDE_SKILL_DIR}/references/errors.md para un manejo completo de errores.
Ejemplos
Flujos de trabajo de seguimiento de cartera desde verificaciones rápidas hasta análisis detallados y exportación:
# Verificación básica de cartera
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio ~/crypto/holdings.json
# Todas las tenencias ordenadas por asignación
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --holdings --sort allocation
# Análisis detallado con umbral personalizado del 15%
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed --threshold 15
# Exportación para software de impuestos
python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --format csv --output tax_export.csv
Recursos
${CLAUDE_SKILL_DIR}/references/implementation.md- Formato de archivo de cartera, opciones de CLI, umbrales de asignación, formato JSON${CLAUDE_SKILL_DIR}/references/errors.md- Manejo completo de errores${CLAUDE_SKILL_DIR}/references/examples.md- Ejemplos de uso detallados- API de CoinGecko: https://www.coingecko.com/en/api
${CLAUDE_SKILL_DIR}/config/settings.yaml- Opciones de configuración