Preguntas frecuentes sobre la API

Última actualización: 13 de enero de 2025

Documentación de la API | Bibliotecas de código abierto de API y ejemplos 

¿Qué son los límites?

Resumen

Existen tres tipos diferentes de límites, todos ellos sujetos a cambios en cualquier momento:

1. Límites estrictos
2. Límites ML o de aprendizaje automático
3. Límites WAF o de firewall de aplicación web

Límites estrictos

• Ponderación de 6000 solicitudes por minuto (ten en cuenta que no es necesariamente lo mismo que 6000 solicitudes)
• 100 órdenes cada 10 segundos
• 200 000 órdenes cada 24 horas

Nuestros límites estrictos están incluidos en el punto final [/api/v3/exchangeInfo].

Límites de aprendizaje automático

El comportamiento de trading se evalúa en comparación con el usuario medio y, si te desvías demasiado, se te aplicará una prohibición durante un tiempo determinado, que puede ser de entre cinco minutos y tres días.

Supongamos que tienes una puntuación de abuso de trading. Tu puntuación aumentará si: 

• Repetidamente subes uno al mejor precio de compra o bajas uno al mejor precio de venta en el libro de órdenes.
• Envías creaciones y cancelaciones de órdenes de forma muy rápida sin ejecutar ninguna operación.
• Tu «tasa de conversión» es baja. La «tasa de conversión» se define como tu número de operaciones dividido por el número total de creaciones y cancelaciones de órdenes durante un periodo de 24 horas (n.º operaciones/[órdenes + cancelaciones]).
• Tu «ponderación» es baja. La «ponderación» se define como el importe total que has operado dividido por el número total de creaciones y cancelaciones de órdenes durante un periodo de 24 horas (importe total de tus operaciones/[órdenes + cancelaciones]).
• En el caso de pares de trading que tienen BNB como base o activo de cotización, tu puntuación de abuso se amplificará.

No se proporcionará más información específica que la anterior. Utiliza el método de prueba y error para obtener tu patrón de trading ideal, o debate cuál sería el comportamiento óptimo con otros usuarios de la API.

Límites de firewall de la aplicación web

Aunque no proporcionamos detalles exactos sobre nuestras reglas WAG, si te aparece un error HTTP 403, significa que has infringido una regla. Lo más probable es que sea el resultado de un exceso de solicitudes en un periodo de cinco minutos. Sin embargo, si envías una solicitud que puede percibirse como maliciosa, también podría resultar en una prohibición de mayor duración.

Si supero los límites, ¿se me restringirá por cuenta, clave API o dirección IP?

En el caso de los límites estrictos, exceder el límite de ponderación total de solicitudes por minuto (actualmente 6000) supondrá la prohibición de la IP. Los límites de órdenes (actualmente 10 veces cada 10 segundos y 200 000 veces cada 24 horas) dependerán de la cuenta. Si has superado el límite de órdenes, tampoco podrás crear nuevas órdenes en la página web (o en nuestras otras aplicaciones).

En el caso de los límites de aprendizaje automático, se aplicarán restricciones a las cuentas. Si apareces restringido por el sistema ML, puedes consultar el motivo y la duración de la restricción utilizando el punto de conexión [/sapi/v1/account/status] (indicado en la documentación de nuestra API).

Las limitaciones del firewall de aplicación web solo se aplicarán a la IP. Por lo general, una prohibición WAF tendrá una duración de cinco minutos. Sin embargo, si el servidor ha interpretado la solicitud del usuario como maliciosa, este periodo podría prolongarse.

Me restringieron por superar los límites, pero corregí mi código. ¿Me quitarán antes la prohibición?

No. Tendrás que esperar a que termine la prohibición.

¿Por qué, mientras utilizaba la API, me apareció un error HTTP 403?

Significa que has infringido las reglas del WAF (firewall de la aplicación web), probablemente al violar un límite de velocidad o al enviar una solicitud maliciosa (como se indica en la sección de límites de este documento). Normalmente, estas prohibiciones duran cinco minutos.

¿Por qué mis conexiones de WebSocket se están cayendo o desconectando?

Cada tres minutos, las conexiones de WebSocket activas recibirán un ping. Si no contestas con un ping correctamente encuadrado, se cerrará tu conexión.

En lo que respecta a los flujos de datos de los usuarios, si no se recibe una señal para mantener activa la conexión cada 60 minutos, la clave de escucha caducará. Esto también aparece detallado en la documentación de nuestra API.

Estoy usando un servicio o envoltura de terceros y no funciona. ¿Podrían ayudarme?

Lamentablemente, no admitimos herramientas o servicios de terceros. Ponte en contacto con atención al cliente o con los desarrolladores para obtener más ayuda.

Además, introducir tu/s clave/s secreta/s o tu/s clave/s API de Binance en la plataforma de un tercero constituye un riesgo de seguridad. Utiliza estos servicios a tu propia discreción.

Ten en cuenta que también evitamos ofrecer asistencia de programación general.

Aunque no he hecho ningún cambio, de repente estoy teniendo errores. ¿Qué ha pasado?

Lamentablemente, no podemos ofrecerte asistencia para los problemas relacionados con tu implementación personal. Si estás utilizando una herramienta o envoltura de un tercero, ponte en contacto con su equipo de asistencia o desarrollo para obtener más ayuda.

Necesito acceder a mi clave secreta, pero me aparece "***". ¿Cómo puedo recuperarla? 

Por motivos de seguridad, las claves secretas solo son visibles en el momento en que se crea la clave API. Posteriormente, quedará oculta. Si la has perdido o no la has guardado, tendrás que crear una nueva clave API y utilizar esa nueva clave con una nueva clave secreta.

¿Puedo aumentar mis límites o el ancho de banda/streaming dedicado?

Lamentablemente, en estos momentos esta opción no está disponible. Deberías poder trabajar sin problema con las limitaciones proporcionadas.

Mi clave API ha desaparecido.

Si una clave API ha «desaparecido», solo hay dos explicaciones posibles:

• No has estado activo recientemente y utilizaste la API antes del 7 de marzo de 2018, en cuyo caso es posible que tu/s clave/s API se hayan eliminado para garantizar la seguridad de tu cuenta.
• Si has deshabilitado tu cuenta, ya que supone la eliminación de todas las claves API activas.

Sin embargo, no deberías tener ningún problema para crear una clave API nueva.

Me aparece el mensaje: "Error - 1021 (Mensaje: la marca de fecha/hora para esta solicitud está fuera de la recvWindow)". ¿Cómo puedo solucionarlo?

Normalmente, este error solo se produce si la hora del servidor y la hora de tu sistema no están sincronizadas. En ese caso, es posible que tengas sincronizar el reloj de tu sistema, pero el proceso varía en función del sistema operativo.

En Windows, a tu entera discreción, puedes utilizar una herramienta como el "Reloj atómico". Los usuarios de Linux y Mac pueden intentar sincronizar con "ntpdate" a través de la línea de comandos.

Si el problema persiste, puede que esté relacionado con la latencia (un problema de red). Si es así, prueba a ajustar tu recvWindow.

¿Puedo solicitar nuevas funcionalidades API?

Si no ves la funcionalidad que estás solicitando en nuestra documentación, debes asumir que no la ofrecemos. Si te gustaría sugerirnos una función, no dudes en abrir un ticket de asistencia y lo estudiaremos.

Creo que hay un problema con la API. ¿Cómo debo notificarlo?

Si crees que hay un problema con el sistema y no con tu implementación, cuando contactes con nosotros desde nuestro foro para desarrolladores, proporciónanos pruebas que respalden tu reclamación y lo investigaremos. Ten en cuenta que no aceptamos mensajes vagos como reclamaciones legítimas.