Cuando utilizas la API de Binance para trading cuantitativo o análisis de datos, es fundamental conocer los límites de frecuencia de solicitudes. Si los superas, tu IP será bloqueada temporalmente, lo que afectará tus operaciones normales.
Si aún no tienes una cuenta en Binance, primero Registrarse en Binance y crea tu API Key. También puedes gestionar la API desde el móvil; te recomendamos Descargar la APP de Binance.
Reglas básicas del límite de frecuencia
La API de Binance tiene dos tipos principales de límites de frecuencia:
Límite de peso de solicitudes: cada endpoint de la API tiene un valor de peso diferente. Las interfaces comunes tienen un peso de 1, mientras que las consultas complejas pueden tener un peso de 5 o 10. El peso total por minuto no puede superar el límite (generalmente 1200).
Límite de frecuencia de órdenes: existe un máximo de órdenes por segundo y por día. Máximo 10 órdenes por segundo y 200,000 órdenes por día.
Las distintas combinaciones de endpoints y permisos pueden tener límites diferentes; consulta siempre la documentación oficial de la API para los valores exactos.
Cómo saber cuánto has consumido
En los encabezados de respuesta (Response Header) de cada solicitud a la API se incluye la información del peso utilizado actualmente. Presta atención a los siguientes campos:
X-MBX-USED-WEIGHT-1M: peso utilizado en el último minuto.
X-MBX-ORDER-COUNT-1S: número de órdenes en el último segundo.
X-MBX-ORDER-COUNT-1D: número total de órdenes del día.
Monitorea estos valores en tu programa y reduce la velocidad de forma proactiva cuando te acerques al límite.
¿Qué pasa si superas el límite?
Si superas el límite de peso de solicitudes, recibirás un código de error HTTP 429 y tu IP será bloqueada temporalmente, generalmente durante unos minutos. Durante el bloqueo, todas las solicitudes serán rechazadas.
Si la infracción es grave o activas el límite con frecuencia, el tiempo de bloqueo puede ser mayor, incluso de varias horas.
Cómo evitar superar el límite
Diseña una frecuencia de solicitudes razonable: no hagas solicitudes de datos de mercado en un bucle infinito; establece intervalos de tiempo adecuados.
Usa WebSocket en lugar de polling: suscríbete a los datos de mercado en tiempo real mediante WebSocket, lo cual no consume peso de solicitudes.
Procesamiento por lotes: algunas operaciones admiten interfaces de lotes, como la colocación de órdenes en lote, que permite enviar múltiples órdenes en una sola solicitud.
Caché de datos: los datos que no necesitan actualización en tiempo real pueden almacenarse en caché local para reducir solicitudes repetidas.
¿Cómo desbloquear tu IP si fue bloqueada?
Los bloqueos de corta duración se levantan automáticamente; solo espera unos minutos e inténtalo de nuevo. Si el bloqueo es prolongado, puedes contactar al equipo de soporte de la API de Binance para resolverlo.
Para evitar afectar tus operaciones, se recomienda implementar una lógica de reintentos en tu programa que, al recibir un error 429, espere automáticamente un tiempo antes de volver a intentarlo.