A las 16:42 del viernes, un responsable de operaciones mira un panel que lleva en rojo casi toda la semana. Los acuses de recibo de las órdenes llegan tarde, los paneles de datos de mercado tienen brechas y la tasa de errores de la API ha superado el 8 %.
Se puede acceder al broker. Los propios clientes de la firma están realizando demasiadas llamadas a la vez.
Este incidente compuesto es típico de un diseño con credenciales compartidas bajo carga, no es un informe de los resultados de una firma concreta. Cuatro servicios utilizan la misma clave de API del broker: una aplicación web, un monitor de posiciones, un exportador de histórico y un proceso de conciliación.
Al abrir el mercado, cada uno reintenta las solicitudes en cuanto recibe HTTP 429. En lugar de dejar que disminuya la tasa de solicitudes, los reintentos mantienen agotado el límite compartido.
El panel del viernes: un límite compartido por cuatro servicios
Reconstruya el presupuesto real
La revisión del incidente empieza con la documentación de cuotas y los encabezados de respuesta del broker, no con un cambio en el tiempo de espera del cliente. Supongamos que la cuenta tiene una asignación documentada de 1,200 solicitudes por minuto y una capacidad de ráfaga de unas 80 solicitudes. Son cifras ilustrativas. Los proveedores pueden aplicar cuotas distintas según la cuenta, la credencial, el endpoint, el nivel de producto o la dirección IP, y pueden cambiarlas sin modificar el límite principal anunciado.
A las 09:30, los cuatro servicios generan unas 280 solicitudes en tres segundos. La capa web aporta actualizaciones de cotizaciones y posiciones; el exportador de histórico ejecuta un trabajo de recuperación; el monitor consulta cuentas que no han cambiado; y el proceso de conciliación realiza sus llamadas programadas. Un depósito de ráfaga con una capacidad de 80 puede agotarse rápidamente, aunque el total del minuto quepa en la asignación documentada. Los reintentos inmediatos repetidos añaden tráfico precisamente cuando escasea la capacidad.
Antes de ajustar la configuración, recopile lo siguiente durante al menos una sesión de alta actividad:
- Recuento de solicitudes por credencial, endpoint, servicio y código de respuesta.
- Respuestas 429, valores de Retry-After y encabezados de límite de solicitudes o de reset cuando se proporcionen.
- Concurrencia de solicitudes, latencia, tiempos de espera y antigüedad del trabajo en cola.
- Si varias instancias de la aplicación comparten la misma cuota o utilizan limitadores locales independientes.
Use un reloj monotónico para los intervalos locales, registre la hora de reset del broker cuando esté disponible y sincronice los relojes de los hosts. Un 429 sin encabezado de reset también aporta información. Regístrelo junto con la solicitud que lo provocó y el tráfico total de la credencial. Quienes siguen la cobertura de infraestructura de trading reconocerán el punto operativo más amplio: los límites de los endpoints forman parte de la planificación de capacidad, no son un detalle de gestión de excepciones.
Separe el volumen de llamadas de la demanda de los usuarios
Que un usuario abra una página de posiciones no significa que se necesite una llamada REST nueva por cada fila. La aplicación puede mostrar una instantánea reciente, suscribirse a actualizaciones en streaming cuando la API lo permita o agrupar varios instrumentos en una sola solicitud. Sin embargo, reducir las llamadas indiscriminadamente puede dejar obsoletos los controles de riesgo. Decida qué datos pueden tener retraso y cuánto, y haga visible ese compromiso para los servicios posteriores.
La tabla muestra rangos habituales del mercado para la planificación, no derechos garantizados. Importan la unidad y el alcance: una asignación por clave compartida entre réplicas no es una asignación por proceso.
| Operación de API | Rango habitual | Alcance o restricción común |
|---|---|---|
| Cotizaciones o instantáneas REST | 30-600 solicitudes por minuto | Por clave o cuenta, a veces con un depósito de ráfaga de 5-30 llamadas |
| Barras históricas o transacciones | 10-120 solicitudes por minuto | A menudo por debajo de los límites de cotizaciones, con 2-10 trabajos simultáneos |
| Envío, cancelación o modificación de órdenes | 5-30 solicitudes por segundo | Puede dividirse por operación, cuenta o sesión de trading |
| Suscripciones de streaming | 100-1,000 símbolos por conexión | El número de conexiones y los cambios de suscripción pueden tener límites independientes |
Estos rangos varían mucho según el broker, el acceso al mercado y el nivel comercial. Confirme si la cuota cuenta las llamadas fallidas, si cada elemento de una solicitud agrupada cuenta por separado y si las acciones de órdenes tienen un límite independiente de control de riesgo. No deduzca la capacidad de streaming a partir de una cuota REST.
Construya un regulador en el cliente antes de añadir reintentos
Use un único programador por credencial
Que cada proceso tenga su propio limitador es un modo de fallo habitual. Cuatro réplicas configuradas cada una para 20 solicitudes por segundo pueden enviar 80 solicitudes por segundo con una sola credencial compartida. Coloque el presupuesto en un punto común a todos los emisores: una pasarela de API central, un depósito de tokens distribuido o un único trabajador de cola para cada credencial y clase de endpoint.
Un depósito de tokens resulta útil cuando el broker permite ráfagas breves además de una tasa sostenida. Establezca una tasa de recarga por debajo del límite documentado y reserve algo de capacidad para llamadas operativas. Para un nominal de 1,200 solicitudes por minuto, un presupuesto sostenido inicial podría ser de 15-18 por segundo, en vez del máximo teórico de 20. Una capacidad de ráfaga de 30-50 solicitudes deja margen para una acción legítima del usuario sin permitir que un trabajo por lotes consuma todo el presupuesto de la cuenta.
Separe las colas según las consecuencias y la vigencia de los datos. Los envíos y las cancelaciones de órdenes, así como las acciones que reducen el riesgo, no deberían quedar detrás de una carga histórica. Las cotizaciones y las posiciones pueden tener objetivos de vigencia distintos. Un diseño habitual podría fijar un objetivo de cola de 100-300 ms para acciones interactivas de órdenes, de 1-3 segundos para actualizaciones rutinarias de posiciones y de segundos o minutos para trabajos con datos históricos. Son puntos de partida para las pruebas, no niveles de servicio universales.
Establezca límites explícitos para las colas. Una cola sin límite convierte un incidente de límite de solicitudes en trabajo retrasado que llega cuando ya no resulta útil. Cuando la cola esté llena, agrupe lecturas duplicadas, descarte actualizaciones obsoletas, pause los trabajos por lotes o devuelva una respuesta clara de servicio degradado. No descarte una orden en silencio.
Haga que los reintentos sean seguros
Ante un 429, respete Retry-After si está presente. Si la respuesta proporciona una hora de reset, programe el reintento en función de ella con una pequeña variación aleatoria para que todos los trabajadores no se activen a la vez. Si no hay ninguno de esos encabezados, use backoff exponencial con jitter completo. Una secuencia inicial práctica consiste en una demora aleatoria de 0-250 ms, luego 0-500 ms y después 0-1 segundo, con un máximo de 5-10 segundos. Añada un presupuesto pequeño de reintentos, como tres intentos para una lectura, en lugar de reintentar indefinidamente.
Clasifique las llamadas antes de reintentarlas:
- Reintente las lecturas idempotentes tras una demora limitada, siempre que se cumpla el plazo de vigencia de los datos requerido por quien las solicita.
- Use una clave de idempotencia para los envíos de órdenes si la API lo admite.
- Si una solicitud de orden agota el tiempo de espera después del envío, consulte el estado de la orden antes de volver a enviarla. El servidor podría haberla aceptado aunque se haya perdido el acuse de recibo.
- No reintente errores de validación ni fallos de permisos como si fueran errores de capacidad.
El backoff controla la presión, pero no resuelve la ambigüedad del estado de una orden. La capa de gestión de órdenes necesita una máquina de estados que pueda representar los estados enviada, confirmada, rechazada, con tiempo de espera agotado y pendiente de conciliación.
Es aquí donde una política de reintentos se cruza con el riesgo de trading. Un GET duplicado de datos de mercado desperdicia capacidad; una orden duplicada puede generar exposición.
El backoff debe distinguir entre demora y recuperación
Un 429 indica que el emisor superó un límite. No indica si toda la API está fallando, si hay restricciones en un endpoint concreto o si una cuota por minuto se restablecerá pronto. Haga un seguimiento de la limitación por endpoint y credencial, y compárela con los errores 5xx, los tiempos de espera de red y la latencia. Estas señales requieren respuestas diferentes.
Cuando aumente la limitación, reduzca primero el tráfico opcional. Pause las exportaciones de histórico, ralentice las consultas de fondo a las cuentas y sirva valores en caché dentro de su antigüedad permitida. Reserve capacidad para las consultas del estado de las órdenes y las acciones que reducen el riesgo. Si el broker proporciona límites independientes para las órdenes y los datos de mercado, aplique presupuestos separados. Si utiliza un único fondo compartido, reserve una fracción para las órdenes y contraste la asignación real con los encabezados observados y la documentación de soporte.
La recuperación requiere una reactivación gradual, no un reinicio simultáneo. Tras el periodo de reset, libere el trabajo en cola al presupuesto normal y auméntelo con cautela si la tasa de 429 sigue siendo baja.
Un disyuntor puede impedir que un endpoint con fallos reciba más llamadas, pero no debería bloquear otras clases de endpoints sin pruebas de que comparten el mismo fallo. Genere alertas sobre la antigüedad de la cola y la duración de los datos obsoletos, además del porcentaje bruto de errores. Una tasa de 429 del 0.2 % puede seguir siendo importante si afecta a todos los acuses de recibo de órdenes en la apertura.
Pruebe el diseño con un perfil de carga que se parezca al sistema real: actualizaciones programadas, picos de actividad de usuarios, reconexiones tras una interrupción de red y el inicio simultáneo de un trabajo por lotes. Incluya respuestas del broker con y sin encabezados de límite de solicitudes.
Compruebe que las réplicas independientes comparten el presupuesto, que los reinicios no vuelven a llenar un depósito de ráfaga local y que un tiempo de espera agotado en una orden no provoca un duplicado a ciegas. El recurso sobre tecnología de brokers ofrece un contexto útil, pero los límites vinculantes deben proceder del proveedor de la API y de las mediciones de la propia firma.
Demuestre la política bajo carga y después establezca reglas de parada
Antes del despliegue, defina cómo debe ser una política de limitación saludable. Por ejemplo, una firma podría aspirar a mantener el uso sostenido por debajo del 80-90 % de la asignación observada, mantener la latencia interactiva de la cola por debajo de su objetivo de servicio y evitar que el trabajo en segundo plano retrase las operaciones de órdenes. Elija los umbrales a partir de la cuota real del broker y los controles de riesgo de la firma, no de una plantilla genérica de panel.
Ejecute una prueba controlada con entre 1.2-1.5 veces el tráfico máximo previsto, en un entorno seguro o una cuenta autorizada. Verifique que las lecturas excedentes quedan en cola o se descartan, que las acciones de órdenes conservan la capacidad reservada y que la recuperación no genera una segunda ráfaga. Revise estas medidas operativas después de cada lanzamiento:
- Tasa de 429 y tasa total de solicitudes, desglosadas por endpoint, credencial y servicio.
- Profundidad de la cola, antigüedad del elemento más antiguo, lecturas descartadas o agrupadas y número de reintentos.
- Latencia de los acuses de recibo de órdenes, envíos sin resolver y comprobaciones de órdenes duplicadas.
- Vigencia de los datos de cotizaciones, posiciones y estado de la cuenta durante la operación degradada.
Asigne un responsable de los cambios de cuota y documente la vía de escalado del proveedor. Si la firma necesita más capacidad, pregunte si el proveedor puede aumentar el límite, separar las credenciales por carga de trabajo o ofrecer una alternativa de streaming o por lotes. Añadir claves para eludir un límite compartido de cuenta puede infringir las condiciones y dificultar el análisis de incidentes. Considere el aumento de cuota como una opción, no como sustituto de un modelo de tráfico.
Deje de hacer lo siguiente:
- Reintentar de inmediato cada 429.
- Dar a cada réplica una copia independiente de la misma cuota.
- Poner las recuperaciones de datos históricos en la misma cola que las acciones de órdenes.
- Volver a enviar órdenes cuyo tiempo de espera se haya agotado sin comprobar su estado.
Preguntas frecuentes
¿Qué debe hacer un cliente de una API de trading después de recibir HTTP 429?
Debe respetar el encabezado Retry-After o de reset del proveedor y, si la respuesta no indica cuándo reintentar, hacerlo con jitter. Limite los intentos y reduzca el tráfico opcional mientras la credencial esté restringida.
¿Deben compartirse los límites de solicitudes de la API del broker entre las réplicas de una aplicación?
Sí, si el broker aplica la cuota a una clave, cuenta o IP compartida. Use un programador central o un limitador distribuido para mantener el tráfico combinado dentro de un único presupuesto.
¿Es seguro reintentar una solicitud de orden cuyo tiempo de espera se ha agotado?
No, no a ciegas. El broker podría haber aceptado la orden aunque se haya perdido el acuse de recibo; por eso, consulte primero el estado de la orden o utilice una clave de idempotencia compatible antes de volver a enviarla.
Plataformas · Software · Proveedores · Mercados