Integración domótica Ghostfolio, gratuita y de código abierto

Patrimonio, rentabilidad y cuentas de su cartera Ghostfolio en Gladys.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Lleve sus inversiones a Gladys: el patrimonio, la rentabilidad del día, del año y desde el inicio, la distribución por clase de activo y el valor de cada cuenta, leídos de su propio Ghostfolio, el software libre de gestión de patrimonio.

La integración solo lee: nunca escribe en Ghostfolio, nunca crea una operación. Habla directamente con su Ghostfolio en su red, con el token de seguridad de su usuario. Sin afiliación con Ghostfolio.

Lo que obtiene

• Un dispositivo cartera: patrimonio total (efectivo incluido), valor de las posiciones, importe invertido, y la variación del día, desde el 1 de enero y desde el inicio, en importe y en porcentaje, con su historial.
• Un dispositivo por cuenta (bróker, banco, monedero cripto…): su valor, su efectivo y su parte de la cartera.
• Un widget de panel: las cifras de la cartera, la distribución por clase de activo y las cuentas añadidas.
• Un disparador de escena: el patrimonio, o la rentabilidad total, alcanza un máximo histórico.
• Una acción de escena: leer la cartera, en una frase para enviar por mensaje o leer en voz alta.
• Una variación del día por encima de ±N % pasa por el disparador estándar de dispositivo de Gladys (vea los ejemplos de escenas).

Todos los importes están en la moneda base de su usuario de Ghostfolio: Ghostfolio convierte las demás monedas.

Requisitos

• Gladys Assistant 5.1 o posterior.
• Un Ghostfolio reciente (probado con la 3.88.0), autoalojado y accesible desde el equipo de Gladys (misma red, VPN o dirección pública).
• El token de seguridad de su usuario de Ghostfolio.

Configuración

Encontrar el token de seguridad

El token de seguridad es el que usa para iniciar sesión en Ghostfolio: Ghostfolio lo muestra una sola vez, al crear la cuenta. Si no lo guardó, abra Mi Ghostfolio → Ajustes y genere uno nuevo (el antiguo deja entonces de funcionar, también para iniciar sesión). Una cuenta creada con inicio de sesión de Google u OpenID también puede generar uno allí.

Ajustes

En Gladys, abra Integraciones → Ghostfolio → Configuración:

• Dirección de Ghostfolio: la dirección con la que abre Ghostfolio, por ejemplo http://192.168.1.20:3333. Sin http://, se añade.
• Token de seguridad: el token anterior. Gladys lo guarda; la integración nunca lo escribe en sus registros.
• Aceptar un certificado autofirmado: solo para una dirección https cuyo certificado haya creado usted mismo.
• Intervalo de actualización: de 5 a 60 minutos, 15 por defecto. Ghostfolio actualiza sus cotizaciones por sí mismo.
• Idioma de los textos: los nombres de las funciones (dados al añadir un dispositivo) y las frases enviadas a las escenas. Francés por defecto.

Guarde y luego Probar la conexión: el mensaje indica el patrimonio, el número de cuentas y la moneda base. Abra la pestaña Descubrir y añada la cartera y las cuentas que desee: solo se siguen los dispositivos añadidos.

Dispositivos

Cartera (llamada «Ghostfolio»):

Función	Qué es
Patrimonio total	Valor de las posiciones más el efectivo de las cuentas
Valor	Valor de las posiciones
Invertido	Importe invertido (compras menos ventas)
Variación del día / Variación del día (%)	Rentabilidad neta del día, comisiones y efecto divisa incluidos
Variación desde el 1 de enero (y %)	Rentabilidad neta desde el 1 de enero
Rentabilidad total (y %)	Rentabilidad neta desde la primera operación

Cuenta (con el nombre de Ghostfolio): Valor (posiciones y efectivo de la cuenta), Efectivo y Parte de la cartera en porcentaje.

Las variaciones y la rentabilidad son las que Ghostfolio muestra con el efecto divisa; «Invertido» es la inversión total de Ghostfolio. Renombrar una cuenta en Ghostfolio conserva su dispositivo.

Widget de panel

Añada el widget Resumen de Ghostfolio a un panel: patrimonio, invertido, variación del día, del año y desde el inicio (en verde una ganancia, en rojo una pérdida), luego la parte de cada clase de activo (acciones, renta fija, liquidez…) y las cuentas añadidas con su valor y su parte. El pie indica la hora de la última lectura.

Disparadores de escena

Ghostfolio: máximo histórico, con la medida a seguir:

• Patrimonio total: el patrimonio supera su máximo. Una aportación también cuenta.
• Rentabilidad total (%): la rentabilidad total supera su máximo; las aportaciones no la mueven.

El máximo procede del gráfico de Ghostfolio en la primera lectura de la cartera y luego sigue cada nuevo récord. El evento se dispara como mucho una vez al día por medida, dure lo que dure la subida. Variables: el nuevo máximo, el anterior, la unidad (código de moneda o %) y una frase lista para usar.

Acciones de escena

Ghostfolio: leer la cartera responde con una frase, por ejemplo «Cartera: 5629,83 €. Hoy +20,68 € (+0,54 %), desde el 1 de enero +6,15 %, desde el inicio +23,90 %.» Salidas: la frase, el patrimonio, la variación del día (importe y porcentaje), la variación del año y la rentabilidad total en porcentaje. Ghostfolio se vuelve a leer cuando la última lectura es más antigua que el intervalo de actualización.

Ejemplos de escenas

• Resumen diario: cada tarde a las 18 h, «Ghostfolio: leer la cartera» y luego enviar la frase por Telegram.
• Gran movimiento: disparador «Cambio de estado del dispositivo» en la función Variación del día (%) de la cartera, por encima de 3 (y una segunda escena por debajo de -3), con «Ejecutar solo cuando se supere el umbral»: una notificación cuando los mercados se mueven.
• Celebrarlo: «Ghostfolio: máximo histórico» en la rentabilidad total, luego una luz en verde y la frase leída en voz alta.

Privacidad y datos

• La integración lee api/v1/user, api/v2/portfolio/performance (periodos 1d, ytd y max), api/v1/portfolio/details y api/v1/account. Solo inicia sesión con el token de seguridad (api/v1/auth/anonymous) y nunca escribe en Ghostfolio.
• Los registros nunca contienen un importe, un nombre de cuenta, el token ni la dirección del servidor, ni siquiera en nivel debug.
• En /data, la integración guarda el identificador del usuario de Ghostfolio, los dos máximos y el día del último evento, para que un reinicio no dispare nada dos veces.
• Sus valores quedan entre Gladys y su Ghostfolio: ningún servicio de terceros.

Solución de problemas

• «Ghostfolio rechaza el token de seguridad»: el token se renovó o se copió mal. Genere uno nuevo en Mi Ghostfolio → Ajustes y péguelo de nuevo.
• «Ghostfolio no responde»: compruebe la dirección desde el equipo de Gladys (curl http://…/api/v1/health debe responder {"status":"OK"}). Se conservan los últimos valores.
• «Esta dirección no responde como la API de Ghostfolio»: la dirección lleva a otra cosa (una página de proxy, otro puerto).
• Las cifras no se mueven: Ghostfolio actualiza sus cotizaciones por sí mismo; compruebe su propia página. La variación del día se queda en 0 con los mercados cerrados.
• Más detalles: configure LOG_LEVEL=debug en la integración y lea sus registros.

Límites

• Solo lectura; un único usuario de Ghostfolio (el del token). La nube de Ghostfolio (ghostfol.io) debería funcionar con su dirección, pero no se ha probado.
• Las cifras siguen la actualización de cotizaciones y la caché de Ghostfolio: a veces unos minutos de retraso.
• El gráfico de Ghostfolio se muestrea en periodos largos: un máximo entre dos puntos puede escapar a la primerísima lectura.
• Desarrollada y probada con un Ghostfolio 3.88.0 real en Docker, con cuentas y activos ficticios, aún no en una instalación de Gladys con una cartera real: sus comentarios son bienvenidos.
• Sin afiliación con Ghostfolio.

Parámetros de configuración

Estos son los parámetros que Ghostfolio te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Conexión con Ghostfolio	section	No	Pegue abajo la dirección de su Ghostfolio y el token de seguridad de su usuario (el que usa para iniciar sesión; Mi Ghostfolio → Ajustes puede generar uno nuevo). Después añada la cartera y las cuentas que desee en la pestaña Descubrir.
Dirección de Ghostfolio	string	Sí	La dirección con la que abre Ghostfolio, accesible desde Gladys.
Token de seguridad	secret	Sí	Solo sirve para leer: la integración nunca escribe en Ghostfolio. Guardado por Gladys, nunca escrito en los registros.
Aceptar un certificado autofirmado	boolean	No	Solo para una dirección https cuyo certificado haya creado usted mismo.
Intervalo de actualización	select	No	Frecuencia de lectura de Ghostfolio. Actualiza sus cotizaciones por sí mismo: 15 minutos bastan.
Idioma de los textos	select	No	Nombres de las funciones (al crearlas) y textos enviados a las escenas.

Cómo instalar Ghostfolio en Gladys

1. En Gladys, abre Integraciones: Ghostfolio aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-ghostfolio:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-ghostfolio.

Ghostfolio requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas

Ghostfolio es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

• Explorar todas las integraciones, nativas y de la comunidad
• Crear y publicar tu propia integración externa
• Código fuente en GitHub — fuente de esta documentación

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂