Cuando un broker publica una cuota para su API, el problema difícil no es encontrar la cifra. Es decidir qué carga de trabajo recibe la siguiente solicitud cuando el flujo de órdenes, las consultas de cuentas y un cliente que se vuelve a conectar compiten por capacidad. Un límite aplicado solo en el perímetro puede proteger un servicio y, aun así, permitir que una cuenta muy activa prive de recursos a todas las demás tareas de una conexión compartida.
Diseñe los controles en función de la prioridad de las cargas de trabajo y del comportamiento ante fallos, no solo de una cifra de solicitudes por segundo. Una instantánea de datos de mercado puede esperar. Una cancelación de una orden durante un mercado volátil no puede tratarse como una consulta rutinaria del saldo.
Elija un modelo de límites que se ajuste al tráfico
Ventanas fijas y ventanas móviles
Un contador de ventana fija es sencillo: permite, por ejemplo, 60 llamadas por minuto y luego reinicia el contador al comenzar el minuto siguiente. Es barato de implementar, pero un cliente puede consumir casi toda su cuota justo antes del reinicio y repetirlo justo después. El pico resultante puede acercarse al doble de la tasa nominal por minuto.
Un contador de ventana móvil suaviza ese efecto de límite al contar las solicitudes del intervalo anterior. Ofrece una protección más predecible, a costa de más estado y procesamiento. Un registro deslizante es preciso, pero puede resultar costoso con un volumen elevado; una aproximación con un contador deslizante suele ofrecer un equilibrio útil.
Buckets de tokens y buckets con fuga
Un bucket de tokens suele ser más adecuado cuando una API necesita permitir picos breves y mantener bajo control la tasa sostenida. Los tokens se recargan a una tasa determinada y cada solicitud consume uno o más. Un bucket con 20 tokens que se recarga a 10 por segundo permite un pico inicial de 20 y luego se estabiliza cerca de 10 solicitudes por segundo.
En cambio, un bucket con fuga procesa el trabajo en cola a una tasa estable. Esto lo hace útil para suavizar tareas no urgentes, como recuperar extractos o consultar datos históricos.
Es menos adecuado como único control de entrada de órdenes: una cola que crece durante un pico puede convertir una limitación temporal en instrucciones de trading obsoletas. Establezca la caducidad de la cola y rechace el trabajo que ya no sea útil.
Coloque los controles en el límite adecuado
La dosificación en el cliente protege la capacidad compartida
Los límites del servidor siguen siendo necesarios, pero un planificador en el cliente puede evitar respuestas 429 innecesarias y proteger la cuota compartida de un broker. Mantenga presupuestos separados para la entrada de órdenes, las consultas de cuentas, las instantáneas de datos de mercado y las consultas históricas. Dentro de cada presupuesto, utilice prioridades ponderadas: las cancelaciones y las acciones que reducen el riesgo deberían tener prioridad, por lo general, sobre las nuevas órdenes, mientras que las actualizaciones repetitivas de cuentas pueden aplazarse o agruparse.
Divida las cuotas según las dimensiones que la API aplique realmente. Estas pueden incluir cuenta, clave de API, dirección IP, endpoint o una combinación de ellas. Un único limitador global en un gateway multiusuario es sencillo, pero puede permitir que el tráfico de una firma consuma la capacidad destinada a otras. Los controles por cuenta mejoran la equidad, aunque añaden estado y requieren gestionar cuidadosamente los casos en que los clientes utilizan varias claves para la misma cuenta.
Los límites del gateway añaden una salvaguarda fiable
Un gateway es un lugar práctico para aplicar límites compartidos, establecer presupuestos por cliente y devolver encabezados coherentes sobre los límites de solicitudes. También introduce un posible punto de fallo.
Si el almacén de estado del limitador deja de estar disponible, decida expresamente entre fallar de forma cerrada, lo que rechaza el tráfico, y fallar de forma abierta, lo que conlleva el riesgo de sobrecargar los servicios posteriores. En las API de órdenes, la elección debería reflejar los controles de riesgo y la política del broker para el modo degradado, en lugar de un valor predeterminado genérico del gateway.
Las cifras siguientes son rangos de planificación habituales para patrones comunes de API de brokers minoristas, no cuotas universales ni promesas de un proveedor. Los límites publicados varían según el producto, el nivel de cuenta y el endpoint. Confirme las condiciones reales, incluido si cuentan las solicitudes fallidas.
| Carga de trabajo | Rango sostenido habitual | Rango habitual de picos o concurrencia | Control que conviene considerar |
|---|---|---|---|
| Entrada y modificación de órdenes | 2-10 solicitudes por segundo por cuenta | 5-20 solicitudes en un pico breve | Reserve capacidad para cancelaciones y acciones que reducen el riesgo |
| Consultas de cuentas y posiciones | 5-20 solicitudes por segundo por clave o cuenta | 10-50 solicitudes en un pico breve | Use una caché breve y agrupe las consultas duplicadas |
| Instantáneas de datos de mercado | 1-10 solicitudes por segundo por clave o cuenta | 1-5 solicitudes simultáneas por cliente | Para actualizaciones frecuentes, prefiera suscripciones de streaming |
| Historial e informes | 1-5 solicitudes por segundo por cliente | 1-3 solicitudes simultáneas | Encole, pagine y programe fuera de las horas punta |
Haga que el backoff sea seguro para las solicitudes de trading
Una respuesta 429 es una señal para dosificar las solicitudes, no una invitación a reintentarlas todas a la vez. Respete el encabezado Retry-After cuando esté presente y consulte también los encabezados de cuota restante o de reinicio que proporcione la API.
Si el servidor no ofrece indicaciones, use backoff exponencial con jitter completo: elija un retraso aleatorio entre cero y el límite actual, y luego aumente ese límite después de cada fallo. Un retraso inicial habitual es de 100-500 milisegundos, con un límite de 5-30 segundos y un presupuesto reducido de tres a cinco intentos para las operaciones de lectura.
Los reintentos necesitan reglas distintas para cada tipo de solicitud:
- Reintente las consultas idempotentes tras una respuesta 429 o 5xx transitoria, dentro de un plazo y un número de intentos limitados.
- No vuelva a enviar una orden a ciegas después de un tiempo de espera agotado. Es posible que el broker la haya aceptado aunque se haya perdido la confirmación. Use una clave de idempotencia o consulte el estado de la orden antes de decidir si la vuelve a enviar.
- Si se restablece la conexión durante el envío de una orden, marque el resultado como desconocido y reconcilie el estado de la orden con el broker. Tratar la incertidumbre como un rechazo puede crear una exposición duplicada.
- Deje de reintentar si el cliente ha cancelado la intención, ha cambiado la sesión de mercado o la orden ya no es válida.
El jitter es importante cuando muchos procesos comparten un límite. Sin él, todos pueden reactivarse al mismo tiempo en el límite de reinicio y recrear el pico que activó la limitación. Un disyuntor puede detener las llamadas repetidas a un endpoint que falla, pero no debería bloquear vías independientes, como las cancelaciones, si utilizan un servicio o una cuota separados.
Mida la equidad además del rendimiento
Registre las respuestas de limitación por endpoint, cuenta y cliente, junto con la profundidad de la cola, la antigüedad de las solicitudes, el número de reintentos y el tiempo hasta la confirmación. Una tasa media baja de respuestas 429 puede ocultar un problema concentrado: una cuenta puede sufrir limitaciones continuas mientras el tráfico agregado se mantiene dentro de la cuota. Siga la espera en cola p95 y p99, no solo la latencia media, y active alertas cuando una cola prioritaria se acerque a su límite de caducidad.
Las pruebas de carga deberían incluir el agotamiento de cuotas, reconexiones sincronizadas, respuestas lentas y confirmaciones ambiguas de órdenes. Compruebe si el pico de un cliente afecta a otro, si sigue disponible la capacidad reservada para cancelaciones y si el estado del limitador sobrevive al reinicio de un gateway.
En despliegues multinodo, compruebe si los límites son locales a cada región o si se coordinan globalmente. Los buckets locales independientes pueden multiplicar la cuota efectiva tras una conmutación por error.
Para los equipos de infraestructura que comparan las decisiones de diseño de plataformas y API, la cobertura de Trading Technology sobre infraestructura de trading ofrece un contexto operativo más amplio. La decisión de implementación sigue dependiendo del modelo de cuotas real del broker, del coste de retrasar cada tipo de solicitud y de la vía de recuperación cuando las confirmaciones son inciertas. ¿Qué carga de trabajo protegería primero su equipo si todos los clientes alcanzaran su límite durante un pico del mercado?
Preguntas frecuentes
¿Cuál es un límite inicial razonable para una API de broker?
No existe una cuota universal, y la entrada de órdenes, las consultas de cuentas y las consultas históricas no deberían compartir un único presupuesto indiferenciado. Los rangos de planificación habituales pueden ayudar con el dimensionamiento inicial, pero prevalecen los límites publicados por el broker y las reglas específicas de cada endpoint.
¿Cómo debería responder un cliente de trading a un HTTP 429?
Use el encabezado Retry-After o la información de reinicio cuando estén disponibles y aplique después un backoff limitado con jitter. Reintente de forma selectiva las consultas seguras y evite volver a enviar una orden hasta conocer su estado.
¿Deberían tener las cancelaciones de órdenes un límite de solicitudes separado?
Cuando la arquitectura de la API lo permita, reserve capacidad para cancelaciones y otras acciones que reducen el riesgo. Un límite compartido puede permitir que las consultas o las nuevas órdenes consuman la cuota necesaria para reducir la exposición.
¿Es mejor un bucket de tokens que un limitador de ventana fija?
Un bucket de tokens permite controlar con mayor claridad el tamaño de los picos y la tasa sostenida, por lo que resulta útil para muchas cargas de trabajo de API de brokers. Las ventanas fijas son más sencillas, pero pueden permitir picos concentrados alrededor del reinicio de los contadores.
Plataformas · Software · Proveedores · Mercados