Resumen:
Este artículo responde a las preguntas más frecuentes sobre el uso de la API de Bitvavo, incluidas las operaciones de trading, los retiros, las conexiones WebSocket y los límites de tasa. Aquí encontrarás explicaciones, detalles de uso y enlaces a la documentación de la API para obtener más información.
Introducción
La API de Bitvavo te permite operar, gestionar tus saldos y automatizar tu cuenta mediante acceso programático. A continuación, encontrarás las respuestas a las preguntas más comunes sobre la API, organizadas por tema.
Trading
¿Las solicitudes de orden y cancelación mediante WebSocket son más rápidas que las llamadas REST?
Sí. Según nuestras mediciones, las solicitudes WebSocket (WS) son más rápidas que las llamadas REST en la mayoría de los casos.
¿Por qué mi bot de trading a veces muestra un error de “valor mínimo”?
Los valores mínimos de transacción pueden generar errores ocasionales. Para conocer el monto mínimo de orden más reciente, utiliza el endpoint (punto de conexión) GET /markets y revisa los parámetros minOrder. Ten en cuenta que puede haber un pequeño retraso porque las comisiones de trading se cobran una vez completadas las operaciones.
¿Se puede aumentar el límite de tasa de mi clave API?
Sí. Si necesitas un límite de tasa más alto para operar con gran volumen, contacta con nuestro equipo de Soporte e incluye información sobre tu volumen de trading esperado.
¿Existe documentación sobre las respuestas de error para solicitudes REST o WebSocket?
Sí. Consulta la documentación de la API para obtener información completa sobre los códigos de error.
¿Puedo recibir notificaciones de mantenimiento programado a través de la API?
Actualmente no hay ningún endpoint disponible para anuncios de mantenimiento. Para conocer actualizaciones del servicio, visita nuestra página de estado.
¿Se reinicia el valor de nonce durante una sesión WebSocket?
El nonce se reinicia si el motor de emparejamiento (Matching Engine) se reinicia. No debería disminuir durante una sesión, salvo en caso de reinicio.
¿Cómo puedo identificar órdenes rechazadas específicas?
Puedes incluir un requestId en tu solicitud para ayudar a rastrear las órdenes y asociar las respuestas.
¿Puedo modificar el parámetro TimeInForce después de configurarlo?
No. El parámetro TimeInForce está configurado por defecto como “Good Till Cancelled” (GTC) y no puede modificarse una vez creada la orden.
¿Cómo puedo consultar mi saldo en euros?
Usa el endpoint GET /balances con el símbolo EUR. Encontrarás más información en la documentación de la API.
¿Qué representa la marca de tiempo en las operaciones?
La marca de tiempo muestra el momento en que ocurrió la operación, expresado en UTC.
WebSocket
¿La autenticación mejora la recepción de datos de mercado mediante WebSocket?
Sí. Los usuarios autenticados reciben límites de tasa más altos. Consulta la sección de límites de tasa en la documentación de la API para obtener más detalles.
¿La autenticación de conexiones WebSocket ofrece alguna ventaja de velocidad?
No. La autenticación no mejora la velocidad, pero se recomienda para asegurarte de operar dentro de los límites de tasa establecidos.
¿Cuál es la profundidad del libro de órdenes para WebSocket?
Bitvavo proporciona la profundidad completa del libro de órdenes, tal como se recibe del motor de emparejamiento.
¿Las actualizaciones de WebSocket son coherentes entre sesiones?
Sí. Todos los clientes suscritos al mismo mercado reciben actualizaciones idénticas.
¿Las conexiones WebSocket permanecen activas durante un reinicio del motor de emparejamiento?
Sí. Las conexiones WebSocket permanecen activas durante el reinicio del motor de emparejamiento.
¿Qué ocurre si un cliente WebSocket no puede mantener el ritmo de las actualizaciones?
WebSocket funciona sobre TCP, por lo que todos los paquetes se entregan en orden. Sin embargo, si tu búfer se llena, el servidor puede ralentizar el ritmo de los mensajes o desconectarte.
¿Por qué veo errores “Handshake status 429 Too Many Requests” al reconectarme?
Este error suele aparecer cuando los intentos de reconexión se realizan demasiado rápido. Asegúrate de espaciar los intentos y revisa si hay uso compartido de IP, como en conexiones VPN.
¿Está garantizado el orden de los eventos de ejecución y órdenes?
No. El orden no está garantizado debido a la naturaleza concurrente del motor de emparejamiento.
Retiros
¿Se pueden transferir internamente los costos de transacción en euros mediante la API?
No. Las transferencias internas solo están disponibles para activos digitales. Las transacciones en euros se envían a un IBAN externo.
¿Puedo desactivar el bloqueo de retiros para permitir solo transferencias internas?
No. Desactivar el bloqueo de retiros es obligatorio para todos los retiros, sean internos o externos.
¿Cómo configuro una transferencia interna con la API?
Indica la dirección del wallet en el método POST para activos digitales. Consulta la documentación de la API para conocer los parámetros necesarios.
Límites de tasa
¿El peso de una solicitud WebSocket varía según el tipo de suscripción?
No. Cada tipo de suscripción (OrderBook, Ticker, Trades) tiene un peso estándar. Consulta la documentación de la API para conocer los valores exactos.