Seguimiento de Cartera de Criptomonedas
Resumen
Rastree tenencias de criptomonedas con valoraciones en tiempo real de CoinGecko, análisis de asignación, seguimiento de pérdidas y ganancias, y alertas de riesgo de concentración.
Requisitos Previos
- Python 3.8+ instalado
- Dependencias:
pip install requests - Conectividad a Internet para acceder a la API de CoinGecko
- Un archivo JSON de cartera con sus tenencias (consulte
references/implementation.mdpara el formato)
Instrucciones
-
Evalúe la intención del usuario - determine 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érdidas y ganancias, indicadores de riesgo
- Exportación: JSON o CSV para herramientas externas
-
Ejecute el rastreador de cartera con las opciones adecuadas:
# Resumen rápido de la 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érdidas y ganancias y asignaciones python ${CLAUDE_SKILL_DIR}/scripts/portfolio_tracker.py --portfolio holdings.json --detailed -
Exporte 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 -
Presente los resultados al usuario:
- Muestre el valor total de la cartera de forma destacada
- Destaque los cambios en 24h y 7d
- Explique los porcentajes de asignación
- Señale 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 CRYPTO Actualizado: 2026-01-14 15:30 # 2026 - marca de tiempo del 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 Asig 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 | Verifique que la ruta del archivo exista |
| JSON inválido | Archivo mal formado | Valide la sintaxis JSON |
| Moneda no encontrada | Símbolo desconocido | Verifique la ortografía del símbolo, use símbolos estándar |
| Límite de API excedido | Demasiadas solicitudes | Espere y reintente, use almacenamiento en caché |
Consulte ${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 detallado 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