Portfolio Tracker

Capital Invertido

—

0 posiciones

Valor Actual

—

Basado en precios actuales

Ganancia / Pérdida

—

Invertido este Mes 🟡

—

Rentab. Anualizada (XIRR)

—

Basado en flujos DCA

Posiciones

Ticker	Acciones	P.Medio	P.Actual	Día	Vol	Invertido	Valor	P&L	TIR

Historial de Operaciones

Fecha	Ticker	Acciones	Precio (€)	Coste (€)	P&L Realizado	Estado

Detalle de Cartera

Rentabilidad por periodos y evolucion patrimonial

Capital Invertido

—

Valor Actual

—

P&L Total

—

XIRR Anualizada

—

Rentabilidad por Periodos

Hoy

—

Semana

—

Mes

—

Trimestre

—

YTD

—

1 Ano

—

Patrimonio — Valor vs Capital Invertido

Distribucion de Cartera

⚙️ Parámetros

Años de proyección

Aportación mensual (€)

Vacío = usa tu plan de inversión

Rentabilidad anual esperada (%)

Vacío = usa tu XIRR real

Inflación anual (%)

Mostrar escenarios (±3%)

Cargando simulación con datos reales…

🏠 ¿Qué es Portfolio Tracker?

Portfolio Tracker es tu aplicación personal para seguir tus inversiones de forma cómoda, visual y automática. Piensa en ella como un panel de control que te muestra en todo momento cuánto dinero has invertido, cuánto vale ahora tu cartera y si estás ganando o perdiendo.

La aplicación está diseñada para personas que invierten en ETFs, fondos o acciones usando la estrategia DCA (comprar periódicamente sin intentar adivinar el mejor momento), aunque sirve para cualquier tipo de inversión en bolsa.

🤖

Automática

Los precios se actualizan solos cada 30 minutos. No necesitas hacer nada.

🔔

Te avisa

Alertas automáticas cuando un precio sube o baja demasiado. También por Telegram.

📊

Fácil de entender

Gráficos, colores y porcentajes. Todo pensado para que entiendas tu cartera de un vistazo.

🔒

Privada

Funciona en tu propio ordenador. Tus datos nunca salen de tu equipo.

🤖

IA integrada

Genera prompts para analizar posiciones con Claude o ChatGPT e importa las respuestas automáticamente.

📥

Importación masiva

Importa todo tu historial de operaciones desde un archivo JSON. Migra tu cartera en segundos.

💡

¿Necesitas saber programar? No. La aplicación se maneja completamente desde el navegador web, como si fuera una página web normal. Solo necesitas tener Java instalado y hacer doble clic para arrancarla.

📚 Conceptos clave antes de empezar

Si eres nuevo invirtiendo, aquí tienes las ideas básicas que usa la aplicación:

💼

Posición

Cada inversión que tienes. Por ejemplo, si compraste un ETF del S&P 500, eso es una posición. Tu cartera es el conjunto de todas tus posiciones.

🏷️

Ticker

El código corto que identifica un activo en bolsa. Por ejemplo, VUAA para el Vanguard S&P 500 o IWDA para el iShares World.

🔄

DCA (Dollar Cost Averaging)

Estrategia de invertir cantidades fijas a intervalos regulares (por ejemplo, 200€ al mes). Así compras más cuando está barato y menos cuando está caro, sin intentar adivinar el mercado.

📐

Precio medio

El precio promedio al que has comprado tus participaciones. Si compraste 10 acciones a 50€ y luego 10 a 60€, tu precio medio es 55€.

📈

P&L (Profit & Loss)

Tu ganancia o pérdida. Se calcula como: (Valor actual) − (Lo que invertiste). Si es positivo, estás ganando; si es negativo, estás perdiendo.

✅

P&L Realizado

La ganancia o pérdida que ya has materializado vendiendo acciones. Se calcula como: (Precio venta − Precio medio) × Acciones vendidas. Es dinero real que has ganado o perdido.

🎯

XIRR (Rentabilidad anualizada)

La rentabilidad real de tu inversión teniendo en cuenta cuándo compraste y cuánto. Es como el "interés anual" que estás obteniendo. Un 8% de XIRR significa que ganas un ~8% al año.

🛑

Stop-Loss

Un precio mínimo que defines tú. Si tu inversión cae hasta ese precio, la app te avisa para que consideres vender y limitar pérdidas.

🏆

Take-Profit

Un precio máximo que defines tú. Si tu inversión sube hasta ese precio, la app te avisa para que consideres recoger beneficios.

📈 Panel principal (Dashboard)

Al abrir la aplicación, lo primero que verás es el panel de resumen. Aquí tienes una vista rápida de toda tu cartera:

🔢 Cifras principales (KPIs)

La fila de tarjetas superiores muestra los cinco indicadores más importantes de un vistazo:

Capital Invertido: El dinero total que has puesto de tu bolsillo, junto al número de posiciones activas.
Valor Actual: Lo que valen ahora mismo todas tus inversiones sumadas (en euros), basado en precios de mercado.
Ganancia/Pérdida (P&L): La diferencia entre valor actual e invertido. Verde = Ganancia Rojo = Pérdida. Incluye la variación del día y el P&L realizado de las ventas.
Invertido este Mes: Cuánto has invertido en el mes actual. Si tienes un objetivo mensual configurado, muestra una barra de progreso.
XIRR: Tu rentabilidad anualizada. Es el indicador más fiable de cómo va tu inversión a largo plazo.

📊 Gráficos

Gráfico de tarta (Distribución de Cartera): Muestra qué porcentaje de tu cartera ocupa cada inversión. Te ayuda a ver si tienes todo el dinero concentrado en un solo sitio (que es más arriesgado) o bien repartido.
Gráfico de evolución de precios: Una línea temporal que muestra cómo ha ido cambiando el precio de tus activos. Puedes seleccionar un ticker concreto o ver todos, y cambiar el rango temporal (1D, 1S, 1M, 3M, 6M, 1A, Año en curso, Todo).

📋 Tabla de posiciones

Debajo verás una tabla con cada una de tus inversiones, mostrando el ticker, nombre, número de participaciones, precio medio de compra, precio actual, la variación del día, capital invertido, valor actual, tu ganancia/pérdida y la TIR (rentabilidad anualizada) para esa posición.

Si has realizado ventas parciales, verás un indicador de P&L realizado junto a cada posición, mostrando cuánto has ganado o perdido con las ventas ya ejecutadas.

ℹ️

Los colores son tus amigos: verde significa que vas ganando, rojo que vas perdiendo. Así de simple.

💼 Gestionar tus posiciones

Las posiciones son el corazón de la aplicación. Cada una representa una inversión en tu cartera.

➕ Crear una posición nueva

Escribe el Ticker

El código de bolsa del activo. Por ejemplo: VUAA, IWDA, SXR8.

Ponle un nombre descriptivo

Por ejemplo: "Vanguard S&P 500" o "iShares MSCI World". Es para que tú lo identifiques fácilmente.

Introduce el Yahoo Ticker

Es el código que usa Yahoo Finance para buscar precios. Suele ser parecido al ticker normal pero puede tener un sufijo (ej: VUAA.L para Londres, SXR8.DE para Alemania). Esto permite que los precios se actualicen automáticamente.

Indica las participaciones y precio medio

Cuántas participaciones tienes y a qué precio medio las compraste. Si usas el historial DCA (más abajo), esto se calcula automáticamente.

Asigna un sector (opcional)

Por ejemplo: "Tecnología", "Renta Variable Global", "Mercados Emergentes". Útil para ver la diversificación y para buscar noticias relevantes.

Elige un color (opcional)

Un color para identificar esta posición en los gráficos de tarta y evolución.

✏️ Editar una posición

Puedes modificar el nombre, ticker de Yahoo, sector o color en cualquier momento. Los datos de participaciones y precio medio se actualizan automáticamente cuando registras compras DCA.

🗑️ Eliminar una posición

⚠️

Cuidado: Al borrar una posición se eliminan también todas sus compras DCA asociadas, su historial de precios y su detalle operativo. Esta acción no se puede deshacer.

🔒 Posiciones cerradas

Cuando vendes todas las participaciones de una posición (es decir, sus acciones llegan a 0), esa posición aparece automáticamente en la sección "Posiciones cerradas", debajo de la tabla principal.

📊 ¿Qué información muestran?

Ticker y nombre: Identificación del activo ya vendido.
Operaciones: Número total de compras y ventas realizadas.
Precio medio de compra: El precio promedio al que compraste las acciones.
Precio medio de venta: El precio promedio al que vendiste las acciones.
Total invertido: Cuánto dinero pusiste en total en esa posición.
Total recuperado: Cuánto dinero recuperaste con las ventas.
P&L Realizado: La ganancia o pérdida real, con su porcentaje. ✅ = Ganancia ❌ = Pérdida
Período: Desde la primera compra hasta la última venta.
TIR: La rentabilidad anualizada de esa inversión cerrada.

ℹ️

La sección de posiciones cerradas aparece plegada por defecto y solo se muestra si tienes alguna posición con 0 acciones. Haz clic en la cabecera para expandirla o plegarla. Es un buen historial para revisar tus inversiones pasadas y aprender de ellas.

🔄 Historial de compras y ventas (DCA)

Aquí registras cada compra o venta que haces. La aplicación usa este historial para calcular automáticamente tu precio medio de compra, el número de participaciones, la rentabilidad real y el P&L realizado de las ventas.

📝 Registrar una operación

Cada vez que inviertas dinero o vendas, añade una entrada con:

Tipo: 🟢 COMPRA o 🔴 VENTA. El botón cambia de color según el tipo seleccionado.
Ticker: El activo que compraste o vendiste (debe existir ya como posición).
Nº Acciones: Cuántas participaciones compraste o vendiste.
Precio: El precio unitario en euros. En ventas, se etiqueta como "Precio de venta".
Fecha: Cuándo hiciste la operación.

💡

Recálculo automático: Cada vez que añades, editas o borras una entrada DCA, la aplicación recalcula automáticamente el número total de participaciones y el precio medio de la posición. No necesitas hacer las cuentas tú.

📊 ¿Qué puedo ver en la tabla?

El historial completo de todas las compras y ventas, ordenado por fecha.
El coste total de cada operación (acciones × precio).
El P&L Realizado de cada venta (cuánto ganaste o perdiste respecto a tu precio medio de compra).
El estado de la posición tras la operación (activa o cerrada).
Paginación con botón "Ver más" para historiales largos.

ℹ️

Vista previa: Al rellenar los campos de una nueva operación, la app te muestra en tiempo real el nuevo precio medio resultante antes de confirmar. Así puedes comprobar el impacto antes de guardar.

🎯 Objetivo mensual de inversión (DCA Target)

Puedes configurar un objetivo mensual de inversión. Por ejemplo, si tu plan es invertir 2.000€ al mes, puedes definirlo y la aplicación te mostrará el progreso visual de cuánto llevas invertido ese mes.

📊 ¿Cómo funciona?

Haz clic en la tarjeta "Invertido este Mes" del panel principal.
Se abrirá un pequeño formulario donde puedes introducir tu objetivo mensual en euros.
Al guardar, aparecerá una barra de progreso debajo de la cifra, mostrando el porcentaje completado.
Si superas el objetivo, la tarjeta cambia de estilo para indicar que lo has excedido.
También puedes quitar el objetivo para volver al modo sin barra de progreso.

💡

Consejo: Definir un objetivo mensual te ayuda a mantener la disciplina DCA. La barra de progreso te recuerda visualmente si ya has hecho tus aportaciones del mes.

📥 Importar operaciones (JSON)

La aplicación permite importar masivamente todas tus operaciones desde un archivo JSON. Esto es ideal para migrar tu historial desde un Excel u otra aplicación, o para empezar con datos ya existentes sin tener que añadir cada compra una a una.

📋 ¿Qué hace la importación?

Crea posiciones automáticamente: Si un ticker del JSON no existe en tu cartera, se crea como nueva posición con los datos proporcionados (nombre, yahoo ticker, sector, color).
Registra todas las operaciones: Cada compra y venta del JSON se añade al historial DCA.
Recalcula todo: Las participaciones y precios medios se recalculan automáticamente a partir de las operaciones importadas.

📄 Formato del archivo JSON

El archivo debe ser un array de objetos con estos campos:

Campo	Obligatorio	Descripción	Ejemplo
`ticker`	✅ Sí	Código del activo	"VUAA"
`date`	✅ Sí	Fecha en formato YYYY-MM-DD	"2024-03-15"
`shares`	✅ Sí	Número de participaciones	5.5
`price`	✅ Sí	Precio unitario en euros	82.30
`type`	✅ Sí	Tipo de operación	"BUY" o "SELL"
`name`	❌ Opcional	Nombre del activo	"Vanguard S&P 500"
`yahooTicker`	❌ Opcional	Yahoo Finance ticker	"VUAA.L"
`sector`	❌ Opcional	Sector temático	"Renta Variable USA"
`color`	❌ Opcional	Color en hex	"#4f98a3"

🚀 ¿Cómo importar?

Abre el importador

En la sección "Historial de Operaciones", pulsa el botón "Importar JSON".

Sube tu archivo o pega el JSON

Puedes arrastrar un archivo .json o pegar el contenido directamente en el cuadro de texto.

Revisa y confirma

La app te muestra un resumen previo con el número de operaciones detectadas. Pulsa "Importar" para ejecutar.

Resultado

Tras la importación, verás un resumen con: posiciones creadas, operaciones importadas, advertencias y errores (si los hubo).

⚠️

Importante: La importación no borra datos existentes, solo añade las nuevas operaciones. Si importas las mismas operaciones dos veces, se duplicarán. Verifica tu JSON antes de importar.

⚙️ Detalle operativo por posición

Cada posición puede tener configuración avanzada que te ayuda a gestionar el riesgo y tener un plan claro para cada inversión. Haz clic en el nombre de una posición para abrir su panel de detalle, que tiene varias pestañas:

📑 Pestañas del detalle

Resumen: Estadísticas principales, peso en cartera vs objetivo, nivel de riesgo y estrategia.
Límites: Stop-loss, take-profit, trailing stop, DCA target, alertas de precio. Con indicadores visuales de distancia al precio actual.
Notas: Espacio libre para apuntar tu análisis, motivos de entrada, niveles técnicos, catalizadores pendientes, etc. (hasta 2.000 caracteres).
🤖 IA: Generador de prompts para análisis con inteligencia artificial e importación automática de respuestas.

Parámetro	¿Qué es?	Ejemplo
Stop-Loss	Precio mínimo. Si cae hasta aquí, te avisa. Es tu "límite de pérdida aceptable".	Si compraste a 100€, puedes poner stop-loss en 85€ (aceptas hasta un -15%).
Take-Profit	Precio objetivo. Si sube hasta aquí, te avisa para que consideres vender.	Si compraste a 100€, puedes poner take-profit en 130€ (tu meta es un +30%).
Precio DCA objetivo	El precio al que te gustaría comprar más. Si baja hasta aquí, es "oportunidad de compra".	Quieres comprar más VUAA si baja a 70€.
Trailing Stop (%)	Porcentaje de caída desde tu precio medio que consideras peligroso.	Un trailing stop de 15% te avisa si cae un 15% o más desde tu precio medio.
Alerta Precio Superior	Te avisa si el precio sube por encima de este valor.	Quieres saber si un ETF supera los 120€.
Alerta Precio Inferior	Te avisa si el precio baja por debajo de este valor.	Quieres saber si un ETF cae por debajo de 50€.
Peso objetivo (%)	Qué porcentaje de tu cartera total debería ser esta posición, según tu plan.	Quieres que el S&P 500 sea el 40% de tu cartera. Si se desvía ≥5 puntos, te avisa.
Nivel de riesgo	Tu valoración personal: Bajo 🟢, Medio 🟡 o Alto 🔴.	Un ETF de bonos sería "Bajo", uno de tecnología "Medio-Alto".
Estrategia	Texto libre donde apuntas tu plan para esta inversión.	"DCA mensual 150€. Mantener mínimo 3 años."
Notas	Cualquier otra anotación que quieras guardar.	"Diversifica bien, pero tiene mucho peso en EE.UU."

ℹ️

En la pestaña Límites, debajo de cada campo verás indicadores de distancia que te muestran a qué porcentaje de distancia está el precio actual respecto a cada nivel configurado. Así sabes de un vistazo si estás lejos o cerca de tus límites.

💰 Precios en tiempo real

La aplicación obtiene los precios automáticamente de Yahoo Finance y los convierte a euros. No necesitas hacer nada: se actualizan solos.

⏰ ¿Con qué frecuencia se actualizan?

Cada 10 minutos de forma automática (ciclo ligero: solo precio).
Cada 30 minutos se hace un ciclo extendido (precio + volumen + volumen medio).
También puedes forzar una actualización manual con el botón "Actualizar precios" (icono de refresco).
A medianoche, la app guarda el precio de cierre del día para poder calcular la variación del día siguiente.
Si tienes horarios de mercado configurados, solo se consultan precios cuando el mercado está abierto (ver sección Horarios de mercado).

💱 Conversión de divisas

Muchos ETFs y acciones cotizan en dólares (USD), libras (GBP), francos suizos (CHF), etc. La aplicación convierte automáticamente todos los precios a euros usando tipos de cambio actualizados. Así tú siempre ves el valor real en tu moneda.

📉 Historial de precios

Cada vez que se actualiza un precio, se guarda en el historial. Esto permite:

Ver gráficos de evolución del precio de cada activo o de todos a la vez.
Seleccionar un ticker específico en el desplegable del gráfico.
Consultar la variación a 7 días, 30 días, 90 días, etc.
Ver el precio mínimo y máximo en un rango de tiempo.

ℹ️

Los rangos temporales disponibles para las gráficas son: 1D (1 día), 1S (1 semana), 1M (1 mes), 3M, 6M, 1A (1 año), ActY (Año en curso / YTD) y Todo.

🔔 Sistema de alertas

Las alertas son avisos automáticos que la aplicación genera cuando algo importante ocurre con tus inversiones. No necesitas estar pendiente: la app lo vigila por ti. Se accede pulsando el icono de campana 🔔 en la cabecera.

🚨 Tipos de alertas

Tipo	¿Cuándo salta?	Severidad
🛑 Stop-Loss	El precio ha caído hasta (o por debajo de) tu límite de pérdida.	CRÍTICA si lo alcanza, AVISO si está a menos del 5%.
🎯 Take-Profit	El precio ha subido hasta (o por encima de) tu objetivo de ganancia.	CRÍTICA si lo alcanza, INFO si está cerca.
📉 Trailing Stop	La caída desde tu precio medio supera el porcentaje que configuraste.	AVISO
💰 DCA Target	El precio ha bajado a tu objetivo de compra → ¡Oportunidad de comprar más!	INFO
📈 Alerta Precio ↑	El precio ha superado el umbral superior que configuraste.	AVISO
📉 Alerta Precio ↓	El precio ha caído por debajo del umbral inferior que configuraste.	AVISO
⚖️ Peso desviado	El porcentaje que ocupa esta posición en tu cartera se ha desviado ≥5 puntos del objetivo.	AVISO si ≥5pp, INFO si ≥10pp.

💡

Las alertas que ya has visto se recuerdan y no vuelven a aparecer al recargar la página. Si conectas Telegram, las alertas críticas y de aviso también te llegan al móvil. En la parte inferior del panel de alertas hay una leyenda completa con todos los tipos y severidades.

📊 Métricas y rentabilidad

La aplicación calcula varias métricas para que sepas realmente cómo van tus inversiones.

📈 XIRR — Tu rentabilidad real

El XIRR (Extended Internal Rate of Return) es la mejor forma de medir cómo te va. Tiene en cuenta cuándo y cuánto invertiste en cada momento. Se calcula tanto para cada posición individual como para el total de la cartera.

ℹ️

Ejemplo: Si tu XIRR es del +12,5%, significa que, anualizado, estás obteniendo el equivalente a un 12,5% de interés al año. Para contexto, el mercado mundial históricamente rinde entre un 7-10% anual.

✅ P&L Realizado

Cuando vendes acciones, la app calcula el beneficio o pérdida realizado de cada venta. Se calcula como: (Precio de venta − Precio medio de compra) × Acciones vendidas.

Se muestra en la tarjeta de P&L del dashboard como "P&L Realizado" junto al P&L no realizado.
En la tabla de posiciones, junto a cada posición que ha tenido ventas.
En la tabla de historial DCA, en la columna "P&L Realizado" de cada venta.
En las posiciones cerradas, como el P&L total realizado con porcentaje.

📅 Rentabilidad por periodos

La app te muestra cuánto has ganado o perdido en diferentes marcos de tiempo:

Periodo	¿Qué compara?
Hoy	Variación desde el cierre de ayer
Semana	Variación en los últimos 7 días
Mes	Variación en los últimos 30 días
Trimestre	Variación en los últimos 3 meses
YTD (Año en curso)	Variación desde el 1 de enero del año actual
1 Año	Variación en los últimos 12 meses

💡

Los retornos están ajustados por DCA: si invertiste dinero nuevo durante el periodo, ese dinero no cuenta como "ganancia". Solo cuentan los cambios reales de mercado.

📋 Detalle de cartera

Accede a la pantalla completa de Detalle de Cartera pulsando el botón "Detalle" en la cabecera de la aplicación (icono de gráfico con lupa). Esta vista ofrece un análisis profundo de la evolución de tu patrimonio.

📊 ¿Qué incluye?

KPIs resumidos: Capital invertido, valor actual, P&L total y XIRR anualizada, todo de un vistazo.
Rentabilidad por periodos: Tarjetas clicables para cada periodo (Hoy, Semana, Mes, Trimestre, YTD, 1 Año). Haz clic en una para ver el desglose detallado.
Gráfico de patrimonio: Curva de equity que compara el Valor de mercado vs Capital invertido a lo largo del tiempo, con rangos seleccionables (1M, 3M, 6M, 1A, YTD, Todo).
Distribución de cartera: Gráfico de tarta con los pesos de cada posición.
Evolución de cartera: Gráfico de líneas por ticker y rango temporal.

📈 Historial por periodo (desglose)

Al hacer clic en cualquier tarjeta de periodo (Semana, Mes, etc.), se abre un modal de historial con:

Rentabilidad total del periodo en porcentaje y euros.
Un gráfico de barras mostrando la variación día a día (o semana a semana, según el periodo).
Una tabla detallada con: fecha, valor de mercado, capital invertido, P&L, variación absoluta y porcentual.

ℹ️

La agrupación temporal se adapta automáticamente: para periodos cortos (semana, mes) verás datos diarios; para trimestre y YTD, datos semanales; y para 1 año, datos mensuales. Así la tabla siempre es manejable.

📉 Evolución patrimonial (Snapshots)

Cada día a las 23:55, la aplicación toma una "foto" del valor de tu cartera. Con estas fotos se construyen los gráficos de evolución que te muestran cómo ha crecido (o disminuido) tu patrimonio en el tiempo.

📸 ¿Qué se guarda?

Valor de mercado total: Lo que valen tus inversiones según los precios del día.
Capital invertido total: Cuánto dinero real has puesto de tu bolsillo.

La diferencia entre ambas líneas en el gráfico es tu ganancia o pérdida en ese momento.

📊 Historial por periodo

Puedes ver el detalle agrupado de formas diferentes:

Semana/Mes: Un dato por cada día.
Trimestre/YTD: Un dato por cada semana.
1 Año: Un dato por cada mes.

👁️ Watchlist (Lista de seguimiento)

La watchlist es para activos que NO tienes comprados todavía pero que quieres vigilar. Es como tener una lista de deseos de inversiones que te interesan. Se accede pulsando el icono del ojo 👁️ en la parte inferior derecha de la pantalla.

¿Qué puedes hacer?

Añadir activos con su ticker, ticker de Yahoo, nombre y notas.
Ver la variación diaria, semanal y mensual de cada activo.
Ver el volumen actual vs volumen medio de cada activo.
Actualizar precios manualmente con el botón de refresco.
Añadir notas sobre por qué te interesa ese activo.
Editar o eliminar items de la watchlist.
Configurar alertas por activo (ver más abajo).

🔔 Alertas de watchlist

Cada activo de tu watchlist puede tener alertas personalizadas que se evalúan automáticamente cuando se actualizan los precios. Los tipos de alerta disponibles son:

Tipo	¿Cuándo salta?	Ejemplo
📈 PRICE_ABOVE	El precio actual supera el umbral configurado.	Avisar si AAPL supera los 200 €.
📉 PRICE_BELOW	El precio actual cae por debajo del umbral.	Avisar si un ETF baja de 70 € (oportunidad de compra).
🔥 VOLUME_ABOVE	El volumen actual es X veces mayor que la media.	Avisar si el volumen es 2x la media (posible movimiento fuerte).
🧊 VOLUME_BELOW	El volumen actual es X veces menor que la media.	Avisar si la liquidez cae mucho.

Las alertas tienen un cooldown de 24 horas: una vez disparada, no se repite en las siguientes 24h.
Si tienes Telegram configurado, las alertas de watchlist también se envían al móvil.
Puedes activar/desactivar cada alerta individualmente sin borrarla.

💡

Cuando decidas comprar algo de tu watchlist, puedes crear una posición y empezar a registrar compras DCA. Piensa en la watchlist como tu "sala de espera" de inversiones.

📰 Noticias financieras

La aplicación busca automáticamente noticias recientes relacionadas con tus inversiones usando Google News. Para cada posición de tu cartera, muestra las noticias más relevantes de los últimos 3 días. Se accede pulsando el icono de periódico 📰 en la parte inferior derecha.

🔍 ¿Cómo funciona?

Busca noticias por el ticker, el nombre del activo y el sector.
Filtra automáticamente para mostrar solo noticias financieras relevantes (bolsa, mercados, resultados, etc.).
Muestra la fuente y la fecha de cada noticia, con enlace al artículo original.
Se obtienen hasta 2 noticias por activo.
Puedes actualizar las noticias pulsando el botón de refresco.

ℹ️

Las noticias son orientativas. Antes de tomar cualquier decisión de inversión, es recomendable contrastar la información con varias fuentes.

📄 Exportar informes

La aplicación puede generar un informe completo de tu cartera en formato Markdown. Este informe está diseñado especialmente para que puedas pasárselo a un asistente de IA (como ChatGPT o Claude) y preguntarle sobre tu cartera.

📋 ¿Qué incluye el informe?

Resumen ejecutivo: Valor total, invertido, ganancia/pérdida, XIRR, mejor y peor posición.
Alertas activas: Lista de todas las alertas que están disparadas.
Detalle por posición: Tabla completa con todas las cifras de cada inversión.
Detalle operativo: Stop-loss, take-profit, estrategia, notas de cada posición.
Distribución de cartera: Pesos por posición y por sector.
Historial DCA: Todas tus compras y ventas con fechas y importes.
Análisis de la estrategia DCA: Frecuencia de compra, inversión mensual.
Evolución de precios: Variaciones a 7, 30 y 90 días, mínimos y máximos.
Análisis de riesgo: Concentración (HHI), diversificación, posiciones en pérdidas.
Notas de contexto: Información técnica para el asistente IA.

📥 ¿Cómo exportar?

Descargar archivo: Se descarga un archivo .md con toda la información.
Vista previa: Puedes ver el informe en el navegador antes de descargarlo.

💡

Truco útil: Copia el informe y pégalo en ChatGPT o Claude con una pregunta como: "¿Mi cartera está bien diversificada?" o "¿Debería rebalancear alguna posición?". La IA tendrá todos los datos necesarios para darte una respuesta informada.

🧮 Simuladores financieros

La aplicación incluye 5 simuladores financieros para ayudarte a planificar tu futuro financiero. Se accede desde la página de simuladores (/simuladores.html) o desde el menú de la app.

📈

Proyección de cartera

Proyecta el valor futuro de tu cartera basado en aportaciones mensuales y un rendimiento anual esperado. Te muestra cómo crecerá tu inversión a lo largo del tiempo.

🏠

Simulador hipotecario

Calcula la cuota mensual de una hipoteca, el cuadro de amortización y los intereses totales. Ideal para comparar hipoteca vs inversión.

🏖️

Simulador de retiradas (FIRE)

¿Cuánto puedes retirar al mes de tu cartera y cuánto durará? Este simulador te ayuda a planificar la independencia financiera.

💹

Interés compuesto

Simula el crecimiento de una inversión con aportaciones periódicas y reinversión de beneficios. Visualiza la magia del interés compuesto.

🎲

Simulación Monte Carlo

Ejecuta miles de escenarios aleatorios para estimar la probabilidad de alcanzar tus objetivos. Muestra percentiles (peor caso, esperado, mejor caso).

💡

Consejo: Usa el simulador de proyección con datos reales de tu cartera (tu XIRR actual como rendimiento esperado) para ver una estimación realista de cómo evolucionará tu patrimonio.

🤖 Asistente IA (Análisis por posición)

Cada posición tiene una pestaña "🤖 IA" en su detalle operativo. Esta funcionalidad te ayuda a utilizar inteligencia artificial (Claude, ChatGPT, etc.) para analizar cada inversión y obtener recomendaciones operativas personalizadas.

🧠 ¿Cómo funciona?

Genera el prompt

Pulsa "Generar prompt para Claude". La app recopilará automáticamente todos los datos de la posición (precio actual, precio medio, participaciones, sector, historial DCA, límites actuales, etc.) y creará un prompt optimizado para que la IA te ayude.

Copia y envía a la IA

Pulsa "Copiar" para copiar el prompt al portapapeles. Pégalo en Claude, ChatGPT u otro asistente de IA.

Recibe un JSON con recomendaciones

La IA te devolverá un JSON con propuestas de: stop-loss, take-profit, DCA target, alertas de precio, nivel de riesgo, estrategia y notas de seguimiento.

Importa la respuesta

Pega el JSON en el campo "Importar respuesta de Claude" y pulsa "Importar y rellenar". Se rellenarán automáticamente todos los campos del detalle operativo. Revisa y pulsa Guardar.

💡

Consejo: El prompt generado incluye todos los datos de la posición (precio medio, actual, historial de compras, sector, etc.), por lo que la IA tiene el contexto necesario para darte recomendaciones informadas. Puedes editar los valores importados antes de guardar si quieres ajustarlos.

🎯 Plan de inversión y flujos de caja

La aplicación te permite definir un plan de inversión mensual y gestionar flujos de caja planificados para tener una visión completa de tu estrategia de ahorro e inversión.

💰 Presupuesto mensual

Define cuánto quieres invertir al mes (ej: 2.000 €/mes).
Selecciona si el presupuesto es FIJO (siempre la misma cantidad) o VARIABLE (varía según el mes).
Añade notas sobre tu estrategia de aportación.
En el dashboard, la tarjeta "Invertido este Mes" muestra una barra de progreso con el % completado respecto al objetivo.

📅 Flujos de caja planificados

Registra aportaciones futuras previstas, tanto extraordinarias (bonus anual, herencia, etc.) como recurrentes (ahorro mensual extra). Cada flujo incluye:

Descripción: Qué es el flujo (ej: "Bonus anual", "Ahorro extra verano").
Importe: Cuántos euros prevés.
Fecha esperada: Cuándo esperas recibir o aportar ese dinero.
Tipo: EXTRAORDINARIA o RECURRENTE.
Estado: Pendiente o Ejecutado. Puedes marcar como ejecutado cuando se materialice.

ℹ️

Los flujos de caja planificados se incluyen automáticamente en el informe de exportación para que el asistente de IA pueda tenerlos en cuenta al analizar tu cartera.

🕐 Horarios de mercado

La aplicación puede respetar los horarios de apertura y cierre de cada mercado, evitando consultas innecesarias a Yahoo Finance fuera de horario.

⚙️ ¿Cómo funciona?

Se configuran horarios por sufijo de ticker (ej: .DE para Xetra, .L para Londres, .MC para Madrid).
Cuando el mercado está cerrado, la app mantiene el último precio conocido sin hacer consultas.
Hay una ventana de gracia de 10 minutos tras el cierre para capturar el precio de cierre real.
Si un precio falla en la ventana post-cierre, se reintenta automáticamente hasta 3 veces (1 por minuto).
Los tickers sin sufijo (mercado US) o sin horario configurado se consultan siempre (24/7).
Los fines de semana se consideran cerrados automáticamente.

📋 Ejemplo de configuración

Sufijo	Mercado	Zona horaria	Apertura	Cierre
`.DE`	Xetra (Alemania)	Europe/Berlin	09:00	17:30
`.L`	London Stock Exchange	Europe/London	08:00	16:30
`.MC`	Bolsa de Madrid	Europe/Madrid	09:00	17:30
`null`	US (NYSE/NASDAQ)	America/New_York	09:30	16:00

💡

Consejo: Al hacer un refresh manual de precios (botón de refresco), se ignoran los horarios y se fuerza la consulta de todos los tickers. Los horarios solo afectan a las actualizaciones automáticas.

✈️ Notificaciones por Telegram

Puedes conectar la aplicación a Telegram para recibir alertas directamente en tu móvil, sin necesidad de abrir la aplicación.

📲 ¿Qué recibirás?

Alertas en tiempo real: Cada 30 minutos, si hay alertas de tipo CRÍTICA o AVISO, te llega un mensaje.
Resumen diario: De lunes a viernes a las 18:00 (cierre de mercado europeo), recibes un resumen del estado de la cartera.
Las alertas ya notificadas no se repiten en las siguientes 6 horas.

🔧 ¿Cómo configurar Telegram?

Crea un Bot en Telegram

Abre Telegram, busca @BotFather, escríbele /newbot y sigue las instrucciones. Te dará un token (una clave larga).

Obtén tu Chat ID

Envía un mensaje a tu nuevo bot (ej: "hola"), luego abre en el navegador: https://api.telegram.org/bot{TOKEN}/getUpdates. Busca "chat":{"id":XXXXXXX} — ese número es tu Chat ID.

Configúralo en la app

En el panel de alertas (🔔), abajo hay un botón "Probar Telegram". Si no está configurado, pulsa "Configurar", introduce el Bot Token y el Chat ID. La app enviará automáticamente un mensaje de prueba para verificar que funciona.

⚙️ Opciones adicionales

Enviar mensaje personalizado: Puedes enviar mensajes manuales por Telegram desde la API.
Desactivar: Puedes desactivar Telegram sin borrar la configuración, y reactivarlo cuando quieras.

ℹ️

La configuración de Telegram se guarda en la base de datos, así que sobrevive a reinicios de la aplicación. No necesitas volver a configurarlo cada vez.

🌙 Tema claro / oscuro

La aplicación soporta dos temas visuales: oscuro (por defecto) y claro. Puedes cambiar entre ellos pulsando el icono de luna 🌙 (o sol ☀️) en la esquina superior derecha de la cabecera.

🎨 ¿Cómo funciona?

El tema oscuro es el predeterminado: fondos oscuros con texto claro. Ideal para usar de noche o en entornos con poca luz.
El tema claro usa fondos claros con texto oscuro. Ideal para uso diurno o con mucha luz ambiental.
Tu selección se guarda en el navegador (localStorage), por lo que se recuerda entre sesiones.
El cambio es instantáneo, sin recargar la página.
Todos los gráficos, tablas y paneles se adaptan automáticamente al tema seleccionado.

📋 Registro de actividad

La aplicación lleva un registro interno de todo lo que ocurre: actualizaciones de precios, snapshots, mensajes de Telegram, errores, etc. Es como un "diario" de la aplicación. Se accede pulsando el icono de documento 📄 en la cabecera.

¿Para qué sirve?

Verificar que los precios se están actualizando correctamente.
Ver si hubo algún error al conectar con Yahoo Finance o Telegram.
Consultar cuándo se tomaron las fotos (snapshots) del portfolio.
Seguir la actividad de DCA, alertas, watchlist y sistema.

🔍 Filtros disponibles

Puedes filtrar los registros por categoría usando los botones de la parte superior:

Todo: Todas las entradas sin filtrar.
Precios: Actualizaciones de precios (PRICE).
Telegram: Mensajes enviados por Telegram.
Watchlist: Actualizaciones de la lista de seguimiento.
DCA: Operaciones de compra y venta registradas.
Snapshots: Fotos del portfolio tomadas automáticamente.
Alertas: Alertas generadas y notificadas.
Sistema: Eventos del sistema (arranque, errores, etc.).

💡

Puedes borrar el log completo si se ha acumulado demasiada información. El log se mantiene en memoria, por lo que se reinicia cada vez que la aplicación se reinicia.

📖 Glosario

Términos que encontrarás en la aplicación, explicados de forma sencilla:

Cartera / Portfolio: El conjunto de todas tus inversiones. Tu "colección" de activos financieros.
ETF: Fondo cotizado en bolsa. Puedes comprarlo y venderlo como una acción, pero dentro tiene muchas empresas. Es como comprar un "paquete" de acciones.
Ticker: Código corto que identifica un activo en bolsa (ej: AAPL = Apple, VUAA = Vanguard S&P 500).
DCA: Dollar Cost Averaging. Invertir la misma cantidad regularmente (ej: 200€ al mes) sin intentar adivinar cuándo es el mejor momento.
Precio medio / Avg Price: El promedio ponderado de todos los precios a los que has comprado un activo.
Precio actual: Lo que vale ahora mismo en el mercado, según Yahoo Finance (convertido a euros).
P&L (Profit & Loss): Ganancia o Pérdida no realizada. Se calcula como: (valor actual) − (lo que invertiste). Refleja lo que ganarías/perderías si vendieras ahora.
P&L Realizado: Ganancia o Pérdida materializada por ventas ejecutadas. Se calcula como: (precio venta − precio medio) × acciones vendidas.
XIRR / TIR: Tasa interna de retorno extendida. La rentabilidad anualizada real, teniendo en cuenta fechas y montos exactos de cada inversión.
Stop-Loss: Precio mínimo que defines como "alarma". Si el precio cae a este nivel, recibes aviso para considerar vender.
Take-Profit: Precio máximo que defines como "meta". Si el precio sube a este nivel, recibes aviso para considerar recoger beneficios.
Trailing Stop: Porcentaje de caída que consideras peligroso. Si tu inversión cae ese porcentaje desde tu precio medio, recibes aviso.
Snapshot: "Foto" del valor de tu cartera en un momento concreto. Se guarda cada día para poder ver la evolución.
Allocation / Distribución: Cómo se reparte tu dinero entre las diferentes inversiones (en porcentajes).
HHI (Herfindahl-Hirschman): Número que mide la concentración de tu cartera. <1500 = diversificada, 1500-2500 = concentración moderada, >2500 = muy concentrada.
YTD (Year To Date): "Año hasta la fecha". La variación desde el 1 de enero hasta hoy.
Watchlist: Lista de activos que te interesan pero aún no has comprado. Los vigilas esperando el momento adecuado.
Rebalanceo: Ajustar los pesos de tu cartera para que vuelvan a tu distribución objetivo (por ejemplo, vendiendo lo que ha subido mucho y comprando lo que ha bajado).
Equity Curve: Gráfico de evolución patrimonial que compara el valor de mercado de tu cartera con el capital invertido a lo largo del tiempo.
Posición cerrada: Inversión en la que has vendido todas las participaciones (acciones = 0). Se mueve a la sección de posiciones cerradas con su P&L realizado.

❓ Preguntas frecuentes

¿Necesito conexión a internet?

Sí, para que los precios se actualicen automáticamente (se obtienen de Yahoo Finance) y para las noticias (Google News). Sin internet, la app funciona pero los precios no se actualizarán.

¿Mis datos están seguros?

Tus datos se guardan en un archivo (portfolio.db) en tu propio ordenador. La aplicación no envía tus datos a ningún servidor externo. Solo se conecta a Yahoo Finance para precios, a un servicio de tipos de cambio y opcionalmente a Telegram.

¿La aplicación compra o vende automáticamente?

No. Portfolio Tracker es solo una herramienta de seguimiento y análisis. No tiene acceso a tu broker ni puede ejecutar operaciones. Tú decides qué hacer con la información que te da.

¿Por qué mi precio no coincide con el del broker?

Puede haber pequeñas diferencias por:

El tipo de cambio se actualiza cada 6 horas, puede diferir ligeramente del de tu broker.
Yahoo Finance puede tener un ligero retraso respecto a la cotización en tiempo real.
Tu broker puede aplicar comisiones o spreads que afectan al precio final.

¿Qué pasa si cierro la aplicación?

Tus datos están guardados en la base de datos, no se pierden. Cuando vuelvas a abrir la aplicación, todo estará como lo dejaste. Los precios se actualizarán automáticamente al arrancar.

¿Puedo usar la app desde el móvil?

Sí, siempre que tu ordenador esté encendido y la app en marcha. Abre el navegador del móvil y escribe la dirección http://[IP_DE_TU_PC]:19480/portfoliotracker/. La interfaz se adapta a pantallas pequeñas.

¿Cómo encuentro el Yahoo Ticker de un activo?

Ve a finance.yahoo.com, busca el nombre de tu activo y copia el símbolo que aparece. Normalmente incluye un sufijo del mercado:

.L → Londres (ej: VUAA.L)
.DE → Alemania/Xetra (ej: SXR8.DE)
.AS → Ámsterdam (ej: IWDA.AS)
.MI → Milán (ej: SWDA.MI)
Sin sufijo → EE.UU. (ej: AAPL, VOO)

¿Qué es un buen XIRR?

Depende del tipo de inversión, pero como referencia:

>15% → Excelente
8-15% → Muy bueno (mercado global histórico: ~7-10%)
3-8% → Aceptable
0-3% → Bajo, pero al menos no pierdes
<0% → Estás perdiendo dinero en términos anualizados

Recuerda que el XIRR puede variar mucho en periodos cortos. A largo plazo es cuando más sentido tiene.

¿Puedo registrar ventas?

Sí. Al crear una entrada DCA, selecciona el tipo 🔴 VENTA en lugar de 🟢 COMPRA. Esto restará las participaciones vendidas, ajustará los cálculos y mostrará el P&L realizado de la venta. Si vendes todas las participaciones, la posición pasará a "cerradas".

¿Qué significan los colores de severidad en las alertas?

CRÍTICA (rojo) → Acción recomendada. Un límite importante se ha alcanzado.
AVISO (amarillo) → Presta atención. Algo se acerca a un límite.
INFO (azul) → Informativo. Oportunidad u observación sin urgencia.

¿Cómo importo mi historial de operaciones?

En la sección "Historial de Operaciones", pulsa "Importar JSON". Prepara un archivo JSON con un array de operaciones que incluya al menos: ticker, date, shares, price y type. Las posiciones que no existan se crearán automáticamente. Consulta la sección "Importar operaciones" para más detalle.

¿Cómo funciona el asistente de IA?

Abre el detalle de cualquier posición y ve a la pestaña 🤖 IA. La app genera un prompt con todos los datos de la posición que puedes copiar y enviar a Claude o ChatGPT. La IA te devolverá un JSON con recomendaciones de límites operativos que puedes importar directamente para rellenar el detalle de la posición. Consulta la sección "Asistente IA" para más detalle.

¿Puedo llevarme la app a otro PC?

Sí. El proyecto genera un archivo PortfolioTracker-dist.zip que contiene todo lo necesario:

El JAR ejecutable (PortfolioTracker.jar)
Scripts de arranque (start.bat, start.sh)
Scripts de servicio (install-service.bat, uninstall-service.bat)
La carpeta data/ con tu base de datos y seeds SQL

Solo necesitas Java 21+ instalado en el PC de destino. Descomprime y ejecuta start.bat.

🌐 Cómo acceder y arrancar

🖥️ Arranque rápido

Asegúrate de tener Java 21 o superior

Puedes verificarlo abriendo una terminal y escribiendo java -version. Si no lo tienes, descárgalo de adoptium.net.

Ejecuta la aplicación

Windows: Haz doble clic en start.bat. Se abrirá el navegador automáticamente.
Linux/Mac: Ejecuta ./start.sh en la terminal.

Abre el navegador

Si no se abre automáticamente, ve a: http://localhost:19480/portfoliotracker/

🔧 Instalación como servicio (Windows)

Si quieres que la aplicación arranque automáticamente cada vez que enciendes el ordenador:

Haz clic derecho en install-service.bat → "Ejecutar como administrador".
La aplicación se iniciará automáticamente con Windows.
Para desinstalar, ejecuta uninstall-service.bat como administrador.

💾 Tus datos

Todos tus datos se guardan en el archivo data/portfolio.db. Si quieres hacer una copia de seguridad, simplemente copia ese archivo a un lugar seguro.

📦 Distribución portátil

El proyecto PortfolioTracker-dist.zip que es completamente portátil. Para migrar a otro PC, solo necesitas copiar ese ZIP y tener Java 21+ instalado.

⚠️

Consejo: Haz copias de seguridad periódicas del archivo portfolio.db. Si algo falla o cambias de ordenador, con ese archivo recuperas toda tu información.

📊 Portfolio Tracker — Guía de usuario

Desarrollado por Maximosro

Aplicación personal de seguimiento de inversiones · Spring Boot + SQLite · 100% privada

Versión actualizada — Abril 2026

🎯 Plan de inversión mensual