Seguimiento de Carteras
Una herramienta de línea de comandos para el seguimiento de carteras de acciones y criptomonedas con precios en tiempo real, ganancias/pérdidas (P&L) y seguimiento de dividendos.
Cuándo usar esta habilidad
Utiliza esta habilidad cuando necesites:
- Realizar un seguimiento local de tus tenencias en acciones y criptomonedas
- Obtener precios en tiempo real y P&L
- Hacer seguimiento de rendimientos de dividendos, Yield on Cost (YOC) e ingresos proyectados
- Consultar próximas fechas ex-dividendo
- Gestionar múltiples carteras
- Exportar datos de cartera a CSV
Herramientas
Esta habilidad proporciona las siguientes capacidades:
1. Listar tenencias
Muestra todas las tenencias con valores actuales y P&L.
Comando:
npx tsx portfolio.ts list
2. Agregar tenencia
Agrega una nueva tenencia de acción o criptomoneda.
Comando:
npx tsx portfolio.ts add <símbolo> <cantidad> <precio> <nombre> [tipo]
Ejemplos:
npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto
3. Vender tenencia
Vende participaciones utilizando el método de base de costo FIFO (First-In-First-Out).
Comando:
npx tsx portfolio.ts sell <símbolo> <cantidad> <precio> [fecha]
Ejemplos:
npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000
4. Historial de transacciones
Ver el historial de ventas de todas las tenencias o de un símbolo específico.
Comando:
npx tsx portfolio.ts history [símbolo]
Ejemplos:
npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL
5. Resumen de P&L
Muestra tanto las ganancias/pérdidas realizadas como las no realizadas.
Comando:
npx tsx portfolio.ts pnl
6. Seguimiento de dividendos
Ver información detallada de dividendos para tenencias de acciones, incluyendo rendimiento, Yield on Cost (YOC) e ingresos anuales proyectados.
Comando:
npx tsx portfolio.ts dividends
7. Resumen de dividendos
Muestra el resumen de dividendos a nivel de cartera: ingreso total proyectado, rendimiento promedio ponderado y Yield on Cost.
Comando:
npx tsx portfolio.ts dividend-summary
La salida incluye:
- Ingreso anual total proyectado
- Estimaciones de ingresos mensuales/trimestrales
- Rendimiento promedio ponderado en todas las tenencias
- Yield on Cost de la cartera
- Cantidad de acciones que pagan dividendos
8. Calendario de dividendos
Consulta las próximas fechas ex-dividendo de tus tenencias.
Comando:
npx tsx portfolio.ts calendar [días]
Ejemplos:
npx tsx portfolio.ts calendar # Próximos 30 días
npx tsx portfolio.ts calendar 60 # Próximos 60 días
9. Listar con dividendos
El comando list obtiene automáticamente datos de dividendos. Usa la bandera --no-dividends para omitirlos.
Comandos:
npx tsx portfolio.ts list # Con información de dividendos
npx tsx portfolio.ts list --no-dividends # Omitir dividendos
10. Eliminar tenencia
Elimina una tenencia por símbolo.
Comando:
npx tsx portfolio.ts remove <símbolo>
11. Valor de cartera
Muestra el valor total de la cartera y P&L.
Comando:
npx tsx portfolio.ts value
12. Gestionar carteras
Lista, cambia o crea carteras.
Comandos:
npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "Nombre de Cartera"
npx tsx portfolio.ts create "Nueva Cartera"
Consejo: Después de ejecutar npm link, puedes usar el comando más corto portfolio en lugar de npx tsx portfolio.ts.
Instalación
Primero, instala las dependencias requeridas:
npm install
Esto instalará todos los paquetes necesarios, incluyendo el runtime de TypeScript (tsx), Next.js, React y otras dependencias listadas en package.json.
Opcional: Vincula la CLI globalmente para un acceso más sencillo:
npm link
Después de vincular, puedes usar portfolio <comando> en lugar de npx tsx portfolio.ts <comando>.
Scripts de NPM
npm run dev # Iniciar interfaz web (opcional)
npm run build # Compilar para producción
Interfaz Web (Opcional)
También puedes ejecutar una interfaz web opcional con soporte completo para seguimiento de dividendos:
npm run dev
Luego abre http://localhost:3000
Características de la interfaz web:
- Seguimiento del valor de la cartera y P&L en tiempo real
- Tarjetas de resumen de dividendos (ingreso anual, rendimiento ponderado, YOC, próximas fechas)
- Tabla detallada de desglose de dividendos por acción
- Calendario visual de próximas fechas ex-dividendo
- Gráfico circular interactivo para la asignación de la cartera
Almacenamiento de datos
Los datos de la cartera se almacenan localmente en data/portfolio.json. El archivo de datos se crea automáticamente en la primera ejecución con una cartera vacía.
Características
- Precios de acciones en tiempo real a través de la API de Yahoo Finance
- Precios de criptomonedas en tiempo real a través de la API de CoinGecko
- Soporte para múltiples carteras
- Seguimiento de P&L por tenencia
- Seguimiento de dividendos (rendimiento, YOC, ingresos proyectados, fechas ex-dividendo)
- CLI e interfaz web opcional