La validación temporal de futuros de la API de Gate es una capacidad de verificación de tiempo que Gate incorpora en el lado del motor de emparejamiento (ME) de sus API de negociación de contratos. Dos encabezados HTTP funcionan conjuntamente para confirmar que una solicitud se envió dentro de un periodo definido. El cliente establece X-Gate-Client-Send-Us con la marca de tiempo de envío en microsegundos y X-Gate-Timeout-Window-Us con el periodo máximo de validez, también en microsegundos. Esta actualización se aplica únicamente a la arquitectura de negociación Gate 3.0.
El mecanismo aborda un riesgo concreto en la negociación algorítmica: una solicitud que permanece en una cola de red, un reintento lento del cliente o una desviación del reloj pueden llegar al motor de emparejamiento mucho después de lo previsto por el trader. En los mercados dinámicos de negociación de contratos, una orden retrasada a un precio incorrecto genera riesgo de deslizamiento y ejecuciones no deseadas. La validación temporal permite al cliente indicar de forma declarativa: "considera esta solicitud no válida después de N microsegundos", situando el control de vencimiento en la capa del ME en lugar de depender únicamente de la sincronización de la red.
Las API de negociación de contratos de Gate ahora admiten dos encabezados de solicitud para la validación temporal en el lado del motor de emparejamiento (ME): X-Gate-Client-Send-Us y X-Gate-Timeout-Window-Us, ambos en microsegundos.
X-Gate-Client-Send-Us contiene la marca de tiempo de envío del cliente en microsegundos desde la época Unix. El servidor compara este valor con su propio reloj al recibir la solicitud.
X-Gate-Timeout-Window-Us define el periodo máximo de validez de la solicitud en microsegundos. Si el tiempo transcurrido entre la marca de tiempo de envío y la recepción por el servidor supera este periodo, la solicitud se rechaza.
Los endpoints REST se lanzaron el 16 de noviembre de 2026. La compatibilidad con la API de WebSocket llegará el 19 de noviembre de 2026.
El mecanismo se aplica únicamente a la arquitectura de negociación Gate 3.0 para interfaces de negociación de contratos (futuros). Actualmente, otras arquitecturas no admiten esta función. Los pasos de integración son: sincronizar el reloj, calcular la marca de tiempo de envío en microsegundos, establecer ambos encabezados y comprobar y actualizar la lógica de integración de la API según los nombres de campo más recientes.
La validación temporal de futuros de la API de Gate es un par de encabezados HTTP que permiten a un cliente declarar durante cuánto tiempo debe seguir siendo válida una solicitud. El mecanismo funciona en el nivel de transporte antes de que el motor de emparejamiento procese la solicitud. El servidor lee ambos encabezados en cada llamada entrante a la API de contratos, calcula la diferencia entre su propia hora de recepción y la marca de tiempo de envío declarada por el cliente, y compara el resultado con el periodo de espera declarado.
X-Gate-Client-Send-Us contiene la marca de tiempo, en microsegundos desde la época Unix, del momento en que el cliente envió la solicitud. Un valor de 1794794400123456 corresponde a un momento específico con precisión de microsegundos. La unidad son microsegundos, no milisegundos ni segundos, un error de integración habitual que produce errores de "marca de tiempo demasiado antigua" o "marca de tiempo demasiado lejana en el futuro".
El encabezado indica al servidor cuándo salió la solicitud del cliente. A continuación, el servidor calcula el tiempo transcurrido restando este valor de su propia marca de tiempo de recepción. Si el reloj del cliente está significativamente desincronizado respecto al servidor, el tiempo transcurrido calculado será incorrecto aunque la latencia de red haya sido normal.
X-Gate-Timeout-Window-Us define el periodo máximo de validez de la solicitud en microsegundos. El servidor rechaza cualquier solicitud cuyo tiempo transcurrido supere este periodo. Un valor de 5000000 corresponde a cinco segundos. Un valor de 500000 corresponde a medio segundo, un periodo más estricto adecuado para la colocación de órdenes sensible a la latencia.
El encabezado proporciona al cliente un control explícito sobre cuánto tiempo puede permanecer desactualizada una solicitud. Un periodo estricto reduce el riesgo de ejecutar en condiciones de mercado desactualizadas. Un periodo más amplio tolera la variabilidad de la red y la desviación del reloj, pero permite más tiempo para que los precios de mercado se muevan entre la intención del cliente y la ejecución del servidor.
En los mercados de contratos y futuros, el precio puede cambiar en milisegundos. Una orden destinada a ejecutarse al precio actual puede llegar segundos después, cuando el mercado ya ha cambiado. Sin validación temporal, la API no tiene forma de saber si el cliente pretendía el retraso o si la solicitud fue reproducida, duplicada o quedó bloqueada en una cola.
La validación temporal aborda tres situaciones concretas:
Picos de latencia de red. Una solicitud que tarda más de lo esperado en llegar al servidor puede rechazarse antes de que el motor de emparejamiento la procese, evitando ejecuciones a precios que el trader ya no considera aceptables.
Desviación del reloj del cliente. Si el reloj del sistema del cliente está adelantado o atrasado respecto al servidor, el tiempo transcurrido calculado se distorsionará. El cliente puede detectarlo mediante la respuesta de error y ajustar la sincronización de su reloj.
Solicitudes reproducidas o duplicadas. Una solicitud interceptada y reproducida después de que haya vencido su periodo se rechazará porque el servidor detectará que el tiempo transcurrido supera el periodo declarado. Esto añade una capa de protección frente a determinados ataques de repetición, además de la autenticación basada en firmas.
El anuncio oficial especifica que esta actualización refuerza la capacidad de verificación de tiempo en el lado del motor de emparejamiento (ME) para solicitudes de negociación de contratos. Los usuarios de la arquitectura de negociación Gate 3.0 deben revisar y actualizar la lógica de integración de su API según los nombres de campo más recientes para garantizar que la función de validación temporal funcione correctamente.
Antes de establecer el encabezado de marca de tiempo, asegúrate de que el reloj de tu cliente esté sincronizado con una fuente de tiempo fiable. Utiliza NTP o consulta el endpoint de hora del servidor de Gate y registra el desfase entre tu reloj local y el servidor. La resincronización periódica mantiene la desviación dentro de límites aceptables. La mayoría de las configuraciones NTP estándar mantienen la desviación por debajo de unos pocos milisegundos, lo que se encuentra ampliamente dentro de un periodo de espera típico de 1–5 segundos.
Al preparar cada solicitud, registra la hora actual en microsegundos desde la época Unix. La mayoría de los lenguajes proporcionan esta información directamente:
import time
send_us = int(time.time() * 1_000_000)
const sendUs = Date.now() * 1000;
Escribe este valor en el encabezado X-Gate-Client-Send-Us.
Elige un periodo que se ajuste a la tolerancia de latencia de tu estrategia. Para estrategias de creación de mercado o scalping que requieren un control estricto, 500000 microsegundos (0,5 segundos) es razonable. Para estrategias más lentas, como la negociación en cuadrícula o el reequilibrio de cartera, 5000000 microsegundos (5 segundos) ofrece mayor tolerancia.
Escribe este valor en el encabezado X-Gate-Timeout-Window-Us.
Cuando el servidor rechaza una solicitud porque el tiempo transcurrido supera el periodo, la API devuelve una respuesta de error. Tu cliente debe:
No reutilices los encabezados originales en un reintento. Cada nueva solicitud debe incluir una marca de tiempo y un periodo nuevos.
Con el tiempo, los relojes de los clientes pueden desviarse respecto al servidor. Programa sincronizaciones NTP periódicas o consulta el endpoint de hora del servidor de Gate y ajusta tu desfase. También puedes añadir una comprobación de estado ligera a tu consola o panel de supervisión que informe del desfase entre la hora local y la hora del servidor en cada implementación. Supervisa la tasa de fallos de validación temporal como señal de estado operativo, ya que una tasa de fallos creciente suele indicar una desviación del reloj y no problemas de red.
Los endpoints REST se lanzaron primero el 16 de noviembre de 2026. La compatibilidad con WebSocket llegará el 19 de noviembre de 2026. Ambos se aplican únicamente a la arquitectura de negociación Gate 3.0. Actualmente, otras arquitecturas no admiten esta función.
Cada solicitud HTTP incluye ambos encabezados de forma independiente. El cliente calcula la marca de tiempo de envío en el momento de preparar la solicitud. No hay estado de conexión que mantener, cada solicitud es autónoma.
En WebSocket, la conexión es persistente. El cliente envía un mensaje a través de una conexión establecida. La marca de tiempo de envío debe reflejar el momento en que el mensaje se escribió en el socket, no el momento en que se estableció la conexión.
| Aspecto | API REST | API de WebSocket |
|---|---|---|
| Fecha de lanzamiento | 16 de noviembre de 2026 | 19 de noviembre de 2026 |
| Modelo de conexión | Sin estado (por solicitud) | Persistente (por conexión) |
| Momento de la marca de tiempo | Al preparar la solicitud | Al escribir el mensaje en el socket |
| Alcance | Solo negociación de contratos de Gate 3.0 | Solo negociación de contratos de Gate 3.0 |
| Nota de integración | Establece ambos encabezados en cada solicitud | Calcula las marcas de tiempo por mensaje, no por conexión |
La colocación de órdenes y la gestión de suscripciones mediante WebSocket se benefician de la misma capacidad de verificación de tiempo: una solicitud de suscripción desactualizada o un mensaje de orden retrasado están sujetos a la misma validación temporal en el lado del ME.
El error de integración más frecuente es enviar una marca de tiempo en milisegundos o segundos en lugar de microsegundos. Una marca de tiempo en milisegundos es tres órdenes de magnitud menor que una marca de tiempo en microsegundos. El servidor detectará un tiempo transcurrido que, en la práctica, será negativo o estará muy en el pasado. Multiplica siempre por 1 000 000 si partes de segundos o por 1 000 si partes de milisegundos.
Si el reloj de tu cliente está adelantado o atrasado respecto al servidor por más tiempo que el periodo de espera, todas las solicitudes se rechazarán. La solución es sincronizar el reloj. Si no puedes ejecutar NTP, calcula un desfase a partir del endpoint de hora del servidor de Gate y aplícalo antes de generar la marca de tiempo de envío.
Un periodo de 100000 microsegundos (0,1 segundos) puede ser demasiado estricto para rutas de red entre regiones o para clientes con latencia variable. Si observas rechazos frecuentes con un periodo estricto, amplíalo gradualmente hasta que la tasa de rechazos se reduzca a un nivel aceptable. Para la mayoría de las estrategias, comienza con 1000000 microsegundos (1 segundo).
Un periodo muy amplio, por ejemplo, 60000000 microsegundos o 60 segundos, proporciona poca protección frente a ejecuciones desactualizadas. En un mercado de contratos dinámico, una solicitud con 60 segundos de antigüedad casi con toda seguridad se ejecutará a un precio muy alejado del mercado actual. Ajusta el periodo a la tolerancia real de latencia de tu estrategia.
Si omites cualquiera de los encabezados, la API puede tratar la solicitud como si no tuviera validación temporal. El comportamiento depende del endpoint y de su configuración. Consulta la documentación oficial de la API para el endpoint específico que estés utilizando. Como práctica general, establece siempre ambos encabezados conjuntamente.
La validación temporal de futuros de la API de Gate añade una capacidad de verificación de tiempo en el lado del motor de emparejamiento (ME) de las API de negociación de contratos. El cliente envía X-Gate-Client-Send-Us (una marca de tiempo en microsegundos del momento en que se preparó la solicitud) y X-Gate-Timeout-Window-Us (el periodo máximo de validez en microsegundos). Esta actualización se aplica únicamente a la arquitectura de negociación Gate 3.0 y protege frente a ejecuciones retrasadas por la red, desviación del reloj y solicitudes reproducidas.
La integración requiere cuatro pasos: sincronizar el reloj, calcular la marca de tiempo de envío en microsegundos, establecer ambos encabezados en cada solicitud e implementar una lógica de reintento que vuelva a calcular la marca de tiempo. La compatibilidad con REST se lanzó el 16 de noviembre de 2026 y WebSocket llegará el 19 de noviembre de 2026, cubriendo las interfaces de negociación de contratos de Gate 3.0.
La validación temporal de futuros de la API de Gate es una capacidad de verificación de tiempo que Gate incorpora en el lado del motor de emparejamiento (ME) de sus API de negociación de contratos. Dos encabezados de solicitud, X-Gate-Client-Send-Us y X-Gate-Timeout-Window-Us, funcionan conjuntamente para confirmar que una solicitud se envió dentro de un periodo definido. La actualización se aplica únicamente a la arquitectura de negociación Gate 3.0.
Los precios del mercado de contratos pueden cambiar en milisegundos. Una orden retrasada puede llegar al motor de emparejamiento mucho después de lo previsto por el trader, lo que provoca ejecuciones no deseadas. La validación temporal permite al cliente indicar de forma declarativa: "considera esta solicitud no válida después de N microsegundos", protegiendo frente a retrasos de red, desviación del reloj y solicitudes reproducidas.
Los dos encabezados están diseñados para utilizarse conjuntamente. X-Gate-Client-Send-Us proporciona la marca de tiempo de envío y X-Gate-Timeout-Window-Us proporciona el periodo de validez. Omitir cualquiera de ellos significa que el servidor no puede realizar la comparación temporal. Consulta los requisitos específicos de cada endpoint en la documentación oficial de la API.
El comportamiento predeterminado cuando se omite X-Gate-Timeout-Window-Us depende de la configuración del endpoint. La documentación oficial de la API de Gate especifica el valor predeterminado. Los clientes que necesiten un control explícito deben establecer siempre el encabezado en lugar de depender del valor predeterminado.
Ambos encabezados utilizan microsegundos desde la época Unix. Un segundo equivale a 1000000 microsegundos. Un milisegundo equivale a 1000 microsegundos.
La API devuelve un error que indica que la solicitud no superó la validación temporal en el lado del motor de emparejamiento. El código de error exacto y el formato del mensaje están documentados en la referencia oficial de errores de la API de Gate. Los clientes deben gestionar este error recalculando la marca de tiempo y volviendo a intentarlo.
Los clientes existentes que no envían los nuevos encabezados siguen funcionando con el comportamiento anterior. El anuncio oficial de Gate solicita a los usuarios de la API Gate 3.0 que revisen y actualicen su lógica de integración según los nombres de campo más recientes para garantizar que la función de validación temporal funcione correctamente.
El mecanismo se aplica únicamente a las API de negociación de contratos (futuros) de la arquitectura de negociación Gate 3.0. El anuncio oficial indica que actualmente otras arquitecturas no admiten esta función. La negociación al contado, la cartera y otros grupos de API siguen especificaciones independientes.
Descargo de responsabilidad: El contenido anterior se proporciona únicamente con fines informativos y educativos y no constituye asesoramiento financiero, de inversión ni de negociación. La negociación de futuros y derivados implica un riesgo significativo de pérdida. Consulta la documentación oficial de la API de Gate para obtener las especificaciones de endpoint, los códigos de error y los requisitos de campo más actualizados.
* La información no pretende ser ni constituye un consejo financiero ni ninguna otra recomendación de ningún tipo ofrecida o respaldada por Gate.
* Este artículo no se puede reproducir, transmitir ni copiar sin hacer referencia a Gate. La contravención es una infracción de la Ley de derechos de autor y puede estar sujeta a acciones legales.





