Guía de integración
Cómo usar Interactive Brokers con VeloTape
Registra automáticamente tus trades de Interactive Brokers. Configura el auto-sync una vez o importa un CSV cuando necesites actualizar manualmente.
Resumen
VeloTape se conecta a IBKR mediante el Flex Web Service de solo lectura. No necesitas instalar TWS ni gateway — pega el Flex Query ID y el token en Ajustes y sincroniza tus trades.
Importar trades con sincronización del broker
Es una configuración única. Después de conectar, VeloTape importa los trades del rango de fechas de la Flex query y puedes volver a sincronizar cuando quieras.
Los fills del mismo día pueden tardar en aparecer por el procesamiento de IBKR (a menudo en 24 h). Para una actualización inmediata, usa la subida CSV.
Abrir Flex Queries en IBKR
- Log in to the IBKR Client Portal.
- Go to Performance & Reports → Flex Queries.
- Keep this page open — you will create a query and generate a token here.

Generar tu token Flex
- Click the gear icon next to Flex Web Service Configuration.
- Enable Flex Web Service Status and set the activation period (e.g. one year).
- Click Generate a new Flex Token, then Save.
- Copy the token — treat it like a password.
If sync later fails with an auth error, generate a new token in IBKR and update it in VeloTape Settings → Configure.

Crear una Activity Flex Query
- Click the plus icon next to Activity Flex Query.
- Name the query (e.g. VeloTape) and choose Trades under Sections.
- Inside Trades, open Executions and click Select All, then Save.
- Set Period to Last 365 calendar days (or your preferred range).
- Under General Configuration use Date format yyyy-MM-dd, Time format HH:mm:ss, and Date/Time separator as a single space.
- Continue, create the query, confirm with OK, then open the query info (i icon) and copy the Activity Flex Query ID.
Use an Activity Flex Query — legacy Flex queries are no longer supported by IBKR's API.

Conectar en VeloTape
- Open Settings → Accounts in VeloTape.
- Click Add account, choose Interactive Brokers, or use Configure on an existing IBKR account.
- Paste the Flex Query ID and Flex token, then save.
- Click Sync now on the accounts table to import trades.

| Problema | Qué probar |
|---|---|
| GetStatement failed / error genérico de sync | Revisa Query ID y token, desactiva la whitelist de IP en Flex Web Service, espera un minuto y sincroniza de nuevo. |
| SendRequest failed | Query ID incorrecto o token caducado — genera un token nuevo en IBKR y reconecta en Ajustes. |
| Restricción de IP | Desactiva la whitelist de IP en Flex Web Service. VeloTape sincroniza desde servidores en la nube. |
| 0 trades importados | Asegúrate de que la query incluya Trades → Executions y que el rango de fechas cubra tu actividad. |
| Se requiere al menos un trade de día anterior | IBKR puede no devolver actividad del mismo día vía Flex. Sincroniza mañana o usa CSV para los fills de hoy. |
Importar trades subiendo un archivo
Usa exportación CSV cuando necesites trades al instante o prefieras un flujo manual. Crea la Flex query una vez en IBKR y vuelve a ejecutarla cuando quieras datos frescos.
Exportar CSV desde IBKR
- In Client Portal, open Performance & Reports → Flex Queries.
- Create or reuse a Trade Confirmation Flex Query named VeloTape with Executions → Select All.
- For CSV export, set Date format yyyyMMdd, Time format HHmmss, and Date/Time separator to semi-colon.
- Run the query for your date range and download the CSV file.

Subir el archivo a VeloTape
- In VeloTape, open Settings → Accounts → Add account.
- Choose Interactive Brokers and select File upload, or add a manual account first.
- Upload the CSV — executions are grouped into trades automatically.

| Problema | Qué probar |
|---|---|
| Fecha/hora inválida al importar | Recrea la query con Date yyyyMMdd, Time HHmmss, separador punto y coma, exporta y sube de nuevo. |
| Faltan comisiones o tasas | Incluye los campos IB Commission y Taxes en la Flex query cuando estén disponibles. |
Preguntas frecuentes
- ¿VeloTape guarda mi contraseña de IBKR?
- No. El auto-sync usa solo token Flex y Query ID. Las credenciales se cifran en reposo y se usan en el servidor durante la sync.
- ¿Con qué frecuencia debo sincronizar?
- Tras la importación inicial, usa Sincronizar ahora en Ajustes o abre el panel — VeloTape también refresca conexiones obsoletas automáticamente.
- ¿Puedo conectar varias cuentas IBKR?
- Sí. Crea una cuenta de trading en VeloTape por cada cuenta IBKR y vincúlalas con su Flex query.
- ¿VeloTape da asesoramiento de inversión?
- No. VeloTape es solo un diario de trading y herramienta de analítica.