Preguntas frecuentes sobre la API

2018-06-05 09:38

Documentación API丨Ejemplos oficiales de la API丨Ejemplos no oficiales de la API

¿Qué son los límites?

Resumen

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

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

Límites estrictos:

Ponderación de 1200 solicitudes por minuto (ten en cuenta que no es necesariamente lo mismo que 1200 solicitudes)
50 órdenes cada 10 segundos
160 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 oscila 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 "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]).
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 aplicación web:

Aunque no proporcionamos detalles exactos sobre nuestras reglas WAF, si estás recibiendo un error HTTP 403, es 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 1.200) traerá consigo una prohibición de la IP. Los límites de órdenes (actualmente 50 veces cada 10 segundos y 160.000 veces cada 24 horas) dependerán de la cuenta. Si han superado el límite de órdenes, los usuarios tampoco podrán 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 un usuario aparece restringido por el sistema ML, podrá consultar el motivo y la duración de la restricción utilizando el parámetro [/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 el periodo de 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. ¡Necesito ayuda!

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

1. 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.

2. Si has optado por deshabilitar tu cuenta, esto supondría 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 hay una desincronización entre la hora del servidor y la hora de tu sistema. Puede que necesites sincronizar el reloj de tu sistema. Sin embargo, este 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) y que necesiten 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, proporciona pruebas que apoyen tu reclamación cuando contactes con nosotros en nuestro chat de API de Telegram, y lo investigaremos. Te informamos de que no aceptamos mensajes vagos como reclamaciones legítimas. Además, no es un grupo de asistencia oficial a la programación, es un grupo comunitario para los usuarios de la API de Binance.

Última actualización el 16 de mayo de 2022

Preguntas frecuentes