Sincroniza tu banco con Ghostfolio: saldos automáticos de la UE y el Reino Unido
Ghostfolio es un panel precioso y autoalojable para controlar tu patrimonio neto y tus inversiones. Pero hay un hueco: las cuentas bancarias y de efectivo son manuales. Escribes un saldo y lo actualizas a mano cada vez que te acuerdas. Si tienes cuentas de ahorro y corrientes junto a tu cartera, tu patrimonio neto siempre está un poco desactualizado.
Esta guía lo soluciona. Con open-banking.io y un pequeño puente de código abierto, puedes llevar tus saldos bancarios reales de la UE y el Reino Unido a Ghostfolio automáticamente, desde más de 2.600 bancos, sin certificado PSD2/eIDAS y con cifrado zero-knowledge, de modo que tus datos de transacciones se descifran localmente con una clave que solo tú tienes.
Funciona por completo junto a Ghostfolio a través de su API pública: sin ningún cambio en el núcleo de Ghostfolio. El responsable de Ghostfolio propuso exactamente este enfoque en la discusión #7308, y esta es la herramienta que lo implementa.
Lo que necesitarás
- Una instancia de Ghostfolio en funcionamiento (autoalojada o ghostfol.io).
- Una cuenta de open-banking.io con al menos un banco conectado. Los precios empiezan en torno a 3 €/mes y bajan a medida que crece la base de usuarios.
- Node.js 20+ (o Docker).
Cómo funciona
open-banking.io ──(balances, decrypted locally)──► sync bridge ──(POST /api/v1/account-balance)──► Ghostfolio
open-banking.io está cifrado de extremo a extremo: el servicio solo almacena texto cifrado que no puede leer. El puente descifra tus saldos en tu propia máquina con la clave privada de tu paquete de credenciales y luego los escribe en Ghostfolio a través de su API pública documentada, exactamente igual que lo haría un usuario con un Security Token. Ni tu clave ni tu texto sin cifrar salen nunca de tu máquina.
Paso 1 — Conecta tu banco y exporta tus credenciales
En la aplicación de open-banking.io, conecta tu banco o bancos y luego exporta tu credentials.json (contiene tu API key y tu clave de cifrado). Mantén este archivo en privado: es la llave de tus datos.
Paso 2 — Consigue tu Security Token de Ghostfolio
En Ghostfolio, abre Settings y copia tu Security Token. Es lo que usa el puente para autenticarse en la API de Ghostfolio.
Paso 3 — Instala el puente
git clone https://github.com/open-banking-io/ghostfolio-openbanking-sync
cd ghostfolio-openbanking-sync
npm install
npm run build
¿Prefieres Docker? Salta a Automatiza con Docker más abajo.
Paso 4 — Configura
Crea un config.json:
{
"ghostfolio": {
"host": "https://your-ghostfolio-host",
"securityToken": "your-security-token"
},
"openBanking": { "credentials": "./credentials.json" },
"accounts": []
}
Paso 5 — Descubre tus cuentas
Ejecuta --list para ver tus cuentas de open-banking.io y tus cuentas de Ghostfolio una al lado de la otra:
node dist/cli.js --config config.json --list
Obtendrás algo así:
open-banking.io accounts:
id=ob-abc123 Drift (…4927) 828.13 EUR [ITBD]
Ghostfolio accounts:
id=gf-def456 Checking 0 EUR
Añade una asignación por cada cuenta al array "accounts" de tu configuración:
{ "openBankingId": "ob-abc123", "ghostfolioAccountId": "gf-def456" }
¿Todavía no tienes cuentas en Ghostfolio? Deja que la herramienta cree una por cada cuenta bancaria automáticamente:
node dist/cli.js --config config.json --create
Imprime las líneas de asignación para que las pegues de vuelta en tu configuración.
Paso 6 — Sincroniza
Haz primero una vista previa (no se escribe nada):
node dist/cli.js --config config.json --dry-run
Luego ejecútalo de verdad:
node dist/cli.js --config config.json
- Drift (…4927): set 828.13 EUR [ITBD @ 2026-07-18] → gf-def456
Done: 1 balance snapshot(s) written to Ghostfolio.
Tu cuenta de efectivo en Ghostfolio ahora refleja el saldo real de tu banco. Añade --refresh para pedir a open-banking.io que primero traiga datos frescos del banco.
El puente prefiere los saldos contabilizados (CLBD/ITBD) frente a los disponibles, de modo que Ghostfolio refleja el dinero ya liquidado. Puedes anular esto por cuenta con "balanceType": "ITAV".
Automatiza con Docker o cron
Mantén los saldos actualizados automáticamente. Con cron en el host:
0 6 * * * cd /opt/gf-sync && node dist/cli.js --config config.json --refresh >> sync.log 2>&1
O con Docker Compose (sincroniza cada 24 h):
mkdir -p data && cp config.example.json data/config.json # then edit it
docker compose -f docker-compose.example.yml up -d
Hay una imagen precompilada publicada en ghcr.io/open-banking-io/ghostfolio-openbanking-sync.
La privacidad, en un párrafo
Tus datos bancarios se sellan en un sobre por campo (ECDH-P256 → HKDF-SHA256 → AES-256-GCM) que solo tu clave privada puede abrir. open-banking.io guarda el texto cifrado; el puente descifra en tu máquina; Ghostfolio recibe solo los números que decides sincronizar (los saldos). La herramienta tiene licencia MIT y es de código abierto: lee cada línea en github.com/open-banking-io/ghostfolio-openbanking-sync.
Por qué open-banking.io
- Más de 2.600 bancos de la UE y el Reino Unido, incluida la larga cola que los agregadores como Plaid se saltan.
- Sin certificados. Sin licencia PSD2, sin eIDAS QWAC. Te conectas con un archivo de credenciales y punto.
- Zero-knowledge. El servicio no puede leer tus transacciones; solo tú puedes.
- Desde unos 3 €/mes, con precios pensados para particulares y quienes autoalojan, no para empresas.