Conectar Interactive Brokers a Hivault, y qué no puede hacer esa conexión

Si operás en Interactive Brokers, Hivault puede traer el valor de tu cuenta solo, todos los días, con el detalle de cada posición. Así funciona y así se arma.

Qué es un Flex Query y por qué se usa eso

IBKR tiene una función llamada Flex Web Service: vos definís un reporte en el portal de IBKR —qué datos querés— y él te da un identificador y un token para pedirlo desde afuera. Nada más.

Esto importa: el vínculo es de solo lectura, y de un solo reporte. No es tu usuario y contraseña, no es una sesión de tu cuenta, y no existe forma de que desde ahí se mande una orden. Ni para comprar, ni para vender, ni para transferir un dólar. Si el token se filtrara, lo que alguien podría hacer es leer ese reporte. Es poco agradable, pero no puede tocarte la plata.

Cómo se arma

En el portal de IBKR, en Performance & Reports → Flex Queries, se crea una consulta nueva de tipo Activity con dos secciones: Open Positions y Change in NAV. Después, en Flex Web Service, se genera el token.

En Hivault, dentro de la inversión, vas a Conectar con Interactive Brokers y pegás los dos datos: el Query ID y el token.

Un detalle que cuesta encontrar: conviene marcar la opción de separar por día en la consulta. Sin eso, el reporte trae una sola foto; con eso, trae la serie, y es lo que permite después ver la evolución de cada instrumento por separado en vez de una línea recta.

Cada cuánto se actualiza

Una vez por día, y solo en días de mercado. Hay dos motivos para no ir más seguido. El primero es que IBKR publica el cierre, no el precio al minuto: pedir cada hora te trae el mismo dato. El segundo es que el reporte lo genera IBKR cuando se lo pide, y mientras lo está armando contesta "todavía no está listo" — hay que esperarlo, no insistir.

Así que si entrás un lunes temprano y el último valor es del viernes, está bien: es el último cierre que existe. Hivault te lo dice con esas palabras en vez de decirte "actualizado" cuando no actualizó nada.

Qué trae y qué no

Trae el valor de la cuenta, cada posición con su cantidad, precio y valor de mercado, y la moneda de cada una.

No trae los dividendos, por ahora. Si tenés ETF irlandeses de acumulación —los UCITS típicos, tipo VUAA o CNDX— no hay nada que mostrar: el dividendo se reinvierte adentro del fondo y ya está contado en el precio. Si tenés papeles que pagan dividendo en efectivo, eso es una sección aparte del reporte y está en la lista de cosas por hacer.

Si falla

El error más común es que el token caducó: IBKR les pone fecha de vencimiento y hay que regenerarlo. El segundo más común es que la consulta no tiene las secciones necesarias, y ahí el reporte llega vacío.

Hivault distingue los dos casos de un tercero que no es un error: que el reporte todavía se esté generando. Ese no marca la conexión como fallada, porque no falló nada — solo hay que volver más tarde.

Preguntas frecuentes

¿Hivault puede operar en mi cuenta de IBKR?

No, y no es una decisión de configuración: el Flex Web Service es un servicio de lectura de reportes. No existe una orden de compra o de venta que se pueda mandar por ahí.

¿Sirve con otros brokers?

Hoy la conexión automática es solo con Interactive Brokers. Con cualquier otro podés cargar el valor a mano cuando quieras, y la inversión funciona igual — también la medición de riesgo y retorno, que solo necesita la serie de valores.

¿El token se guarda en texto plano?

No. Se guarda cifrado, igual que los montos, las notas y los nombres de cuentas.