Guía práctica · Bitvavo
Cómo crear una API de Bitvavo para consultar tu cartera
Configura una clave de Bitvavo con permisos de lectura, entiende la diferencia entre saldo e histórico y conecta tus criptomonedas sin habilitar órdenes ni retiradas.
Cuando tienes criptomonedas repartidas entre varias plataformas, entrar en cada una para actualizar tu seguimiento puede resultar poco práctico. Una conexión API permite consultar los datos de Bitvavo desde otra herramienta. Si nunca has creado una clave, lo primero es entender qué acceso concede y cómo limitarlo a lo que necesitas para seguir tu cartera.
Crear las claves desde la web de Bitvavo
- Entra en Bitvavo desde el navegador. La creación de claves se documenta para la web.
- Abre tu nombre de usuario, entra en Settings y selecciona la pestaña API.
- Pulsa Add new API Key y pon un nombre que identifique la herramienta de destino.
- Selecciona solo los permisos de consulta que necesitas y completa la confirmación. Para crear claves, Bitvavo exige tener activada la autenticación de dos factores.
Conserva la API key y el API secret como dos valores distintos. No son la contraseña de tu cuenta ni una dirección de depósito.
Elegir permisos e IP sin bloquear la conexión
| Permiso o control | Para una herramienta de seguimiento |
|---|---|
| Consulta | Activado para leer los saldos y la actividad necesaria. |
| Trading | Desactivado: no necesitas crear ni cancelar órdenes. |
| Retiradas | Desactivado: no necesitas enviar fondos. |
| Restricción por IP | Usa las direcciones de salida que documente la herramienta de destino, si dispone de ellas. |
Una restricción de IP debe corresponder al servidor que hace la consulta. Si la herramienta consulta desde un servidor, introducir la IP de tu ordenador puede impedir la conexión. Comprueba ese dato con el servicio antes de configurar la lista.
No amplíes permisos de trading o retirada para resolver un error de lectura. Verifica primero credenciales, activación y permisos de consulta. Una clave de solo lectura sigue dando acceso a información privada, aunque no permita mover fondos.
Guardar un CSV como alternativa
Si solo quieres obtener un archivo, abre Transaction history → Export en la web. Bitvavo distingue Transaction history, en CSV, de Balance statement, en PDF. El primero recoge actividad; el segundo resume una valoración.
Selecciona el periodo o el histórico completo según lo que necesites.
Si necesitas reconstruir compras y ventas, una foto del saldo final no basta. Tener hoy 0,1 BTC no indica cuánto pagaste, si recibiste transferencias o si vendiste una parte anteriormente.
Distinguir transferencias, operaciones y recompensas
Una entrada de criptomonedas desde tu propia wallet no es automáticamente una compra al precio de llegada. Conserva su origen y, si necesitas el coste de adquisición, busca la operación original en la plataforma donde se adquirieron.
Una recompensa de staking aumenta unidades, mientras que un cambio de precio modifica su valor sin cambiar la cantidad. Ambos pueden hacer crecer el saldo valorado, pero describen hechos diferentes.
Comprueba activo, unidades, divisa del par y comisiones. En una venta, no confundas el importe recibido con el beneficio: el resultado depende también de la adquisición y de los costes. El historial es una fuente de datos, no un informe fiscal completo por sí solo.
Conectar Bitvavo con NodoFinx
- En Patrimonio, elige la conexión de Bitvavo.
- Introduce API key y API secret, con permisos de consulta. Completa el correo de activación si Bitvavo te lo solicita.
- Pulsa Comprobar y continuar y guarda la conexión.
- Revisa cantidades, efectivo, operaciones y alguna recompensa contra tu cuenta de Bitvavo.
La conexión permite recuperar posiciones, valoración, efectivo, operaciones y rendimientos disponibles. No obtiene del proveedor una curva histórica completa de valoración: recuperar operaciones anteriores no equivale a recibir el valor de la cuenta en cada día del pasado.
También puedes importar el CSV del historial completo para compras, ventas, transferencias, staking, airdrops y comisiones. Si combinas archivos y conexión para las mismas fechas, revisa las coincidencias antes de confirmar para no representar dos veces la misma actividad.