A validação temporal da API de Futuros da Gate é uma funcionalidade de verificação de tempo que a Gate adiciona ao nível do motor de correspondência (ME) das suas API de negociação de contratos. Dois cabeçalhos HTTP funcionam em conjunto para confirmar que um pedido foi enviado dentro de um período definido. O cliente define X-Gate-Client-Send-Us com o respetivo carimbo de data/hora de envio em microssegundos e X-Gate-Timeout-Window-Us com o período máximo de validade, também em microssegundos. Esta atualização aplica-se apenas à arquitetura de negociação Gate 3.0.
O mecanismo aborda um risco concreto na negociação algorítmica: um pedido que permanece numa fila de rede, uma nova tentativa lenta do cliente ou um desvio do relógio pode chegar ao motor de correspondência muito depois do pretendido pelo negociador. Em mercados de negociação de contratos com movimentos rápidos, uma ordem atrasada ao preço errado cria risco de derrapagem e execuções indesejadas. A validação temporal disponibiliza ao cliente uma forma declarativa de indicar "considerar este pedido inválido após N microssegundos", colocando o controlo da caducidade na camada do ME, em vez de depender apenas do momento de transmissão na rede.
As API de negociação de contratos da Gate passam a suportar dois cabeçalhos de pedido para validação temporal ao nível do motor de correspondência (ME): X-Gate-Client-Send-Us e X-Gate-Timeout-Window-Us, ambos em microssegundos.
X-Gate-Client-Send-Us contém o carimbo de data/hora de envio do cliente em microssegundos desde a época Unix. O servidor compara este valor com o seu próprio relógio no momento da receção.
X-Gate-Timeout-Window-Us define o período máximo de validade do pedido em microssegundos. Se o tempo decorrido entre o carimbo de data/hora de envio e a receção pelo servidor exceder este período, o pedido é rejeitado.
Os endpoints REST foram lançados a 16 de novembro de 2026. O suporte da API WebSocket será disponibilizado a 19 de novembro de 2026.
O mecanismo aplica-se apenas à arquitetura de negociação Gate 3.0 para interfaces de negociação de contratos (futuros); atualmente, outras arquiteturas não suportam esta funcionalidade. As etapas de integração são: sincronizar o relógio, calcular o carimbo de data/hora de envio em microssegundos, definir ambos os cabeçalhos e verificar e atualizar a lógica de integração da API de acordo com os nomes de campos mais recentes.
A validação temporal da API de Futuros da Gate consiste num par de cabeçalhos HTTP que permite a um cliente declarar durante quanto tempo um pedido deve permanecer válido. O mecanismo funciona ao nível do transporte antes de o motor de correspondência processar o pedido. O servidor lê ambos os cabeçalhos em cada chamada recebida da API de contratos, calcula a diferença entre o seu próprio momento de receção e o carimbo de data/hora de envio declarado pelo cliente e compara o resultado com o período de tempo limite declarado.
X-Gate-Client-Send-Us contém o carimbo de data/hora, em microssegundos desde a época Unix, do momento em que o cliente enviou o pedido. Um valor de 1794794400123456 corresponde a um ponto específico no tempo ao nível dos microssegundos. A unidade é microssegundos, e não milissegundos ou segundos — um erro de integração comum que resulta em erros de "carimbo de data/hora demasiado antigo" ou "carimbo de data/hora demasiado no futuro".
O cabeçalho indica ao servidor quando o pedido saiu do cliente. Em seguida, o servidor calcula o tempo decorrido subtraindo este valor ao seu próprio carimbo de data/hora de receção. Se o relógio do cliente estiver significativamente dessincronizado em relação ao do servidor, o tempo decorrido calculado estará incorreto, mesmo que a latência da rede tenha sido normal.
X-Gate-Timeout-Window-Us define o período máximo de validade do pedido, em microssegundos. O servidor rejeita qualquer pedido cujo tempo decorrido exceda este período. Um valor de 5000000 corresponde a cinco segundos. Um valor de 500000 corresponde a meio segundo, um período mais restrito adequado à colocação de ordens sensível à latência.
O cabeçalho dá ao cliente controlo explícito sobre o grau de desatualização permitido para um pedido. Um período restrito reduz o risco de execução em condições de mercado desatualizadas. Um período mais alargado tolera a variabilidade da rede e o desvio do relógio, mas permite mais tempo para os preços de mercado variarem entre a intenção do cliente e a execução pelo servidor.
Nos mercados de contratos e futuros, o preço pode variar em milissegundos. Uma ordem destinada a ser executada ao preço atual pode chegar segundos mais tarde, quando o mercado já se alterou. Sem validação temporal, a API não tem forma de saber se o cliente pretendeu o atraso ou se o pedido foi repetido, duplicado ou ficou retido numa fila.
A validação temporal abrange três cenários concretos:
Picos de latência da rede. Um pedido que demora mais tempo do que o esperado a chegar ao servidor pode ser rejeitado antes de o motor de correspondência o processar, evitando execuções a preços que o negociador já não considera aceitáveis.
Desvio do relógio do cliente. Se o relógio do sistema do cliente estiver adiantado ou atrasado em relação ao do servidor, o tempo decorrido calculado será distorcido. O cliente pode detetar esta situação através da resposta de erro e ajustar a sincronização do relógio.
Pedidos repetidos ou duplicados. Um pedido intercetado e repetido após o termo do respetivo período será rejeitado, porque o servidor verifica que o tempo decorrido excede o período declarado. Isto acrescenta uma camada de proteção contra determinados ataques de repetição, para além da autenticação baseada em assinatura.
O anúncio oficial especifica que esta atualização reforça a funcionalidade de verificação de tempo ao nível do motor de correspondência (ME) para pedidos de negociação de contratos. Os utilizadores da arquitetura de negociação Gate 3.0 devem analisar e atualizar a sua lógica de integração da API de acordo com os nomes de campos mais recentes, para garantir o funcionamento correto da funcionalidade de validação temporal.
Antes de definir o cabeçalho de carimbo de data/hora, garantir que o relógio do cliente está sincronizado com uma fonte de hora fiável. Utilizar NTP ou consultar o endpoint da hora do servidor da Gate e registar o desvio entre o relógio local e o servidor. A ressincronização periódica mantém o desvio dentro de limites aceitáveis. A maioria das configurações NTP padrão mantém o desvio abaixo de alguns milissegundos, o que está bem dentro de um período de tempo limite típico de 1–5 segundos.
Ao preparar cada pedido, captar a hora atual em microssegundos desde a época Unix. A maioria das linguagens disponibiliza este valor diretamente:
import time
send_us = int(time.time() * 1_000_000)
const sendUs = Date.now() * 1000;
Escrever este valor no cabeçalho X-Gate-Client-Send-Us.
Escolher um período que corresponda à tolerância à latência da estratégia. Para estratégias de criação de mercado ou scalping que exigem um controlo restrito, 500000 microssegundos (0,5 segundos) é razoável. Para estratégias mais lentas, como negociação em grelha ou reequilíbrio de carteira, 5000000 microssegundos (5 segundos) proporciona maior tolerância.
Escrever este valor no cabeçalho X-Gate-Timeout-Window-Us.
Quando o servidor rejeita um pedido porque o tempo decorrido excede o período, a API devolve uma resposta de erro. O cliente deve:
Não reutilizar os cabeçalhos originais numa nova tentativa. Cada novo pedido deve incluir um carimbo de data/hora e um período atualizados.
Ao longo do tempo, os relógios dos clientes podem desviar-se em relação ao servidor. Agendar sincronizações NTP periódicas ou consultar o endpoint da hora do servidor da Gate e ajustar o desvio. Também é possível adicionar uma verificação de estado simples à consola ou ao painel de monitorização que comunique o desvio entre a hora local e a hora do servidor em cada implementação. Monitorizar a taxa de falhas de validação temporal como um indicador do estado operacional — uma taxa de falhas crescente indica frequentemente desvio do relógio, e não problemas de rede.
Os endpoints REST foram lançados primeiro, a 16 de novembro de 2026. O suporte WebSocket será disponibilizado a 19 de novembro de 2026. Ambos se aplicam apenas à arquitetura de negociação Gate 3.0; atualmente, outras arquiteturas não suportam esta funcionalidade.
Cada pedido HTTP inclui ambos os cabeçalhos de forma independente. O cliente calcula o carimbo de data/hora de envio no momento em que prepara o pedido. Não existe estado de ligação a manter — cada pedido é autónomo.
No WebSocket, a ligação é persistente. O cliente envia uma mensagem através de uma ligação estabelecida. O carimbo de data/hora de envio deve refletir o momento em que a mensagem foi escrita no socket, e não o momento em que a ligação foi estabelecida.
| Aspeto | API REST | API WebSocket |
|---|---|---|
| Data de lançamento | 16 de novembro de 2026 | 19 de novembro de 2026 |
| Modelo de ligação | Sem estado (por pedido) | Persistente (por ligação) |
| Momento do carimbo de data/hora | Na preparação do pedido | Ao escrever a mensagem no socket |
| Âmbito | Apenas negociação de contratos Gate 3.0 | Apenas negociação de contratos Gate 3.0 |
| Nota de integração | Definir ambos os cabeçalhos em cada pedido | Calcular carimbos de data/hora por mensagem, e não por ligação |
A colocação de ordens e a gestão de subscrições por WebSocket beneficiam da mesma funcionalidade de verificação de tempo: um pedido de subscrição desatualizado ou uma mensagem de ordem atrasada está sujeito à mesma validação temporal ao nível do ME.
O erro de integração mais frequente é enviar um carimbo de data/hora em milissegundos ou segundos, em vez de microssegundos. Um carimbo de data/hora em milissegundos é três ordens de grandeza inferior a um carimbo de data/hora em microssegundos. O servidor verá um tempo decorrido que é efetivamente negativo ou que está muito no passado. Multiplicar sempre por 1 000 000 ao partir de segundos ou por 1000 ao partir de milissegundos.
Se o relógio do cliente estiver mais adiantado ou atrasado do que o período de tempo limite em relação ao servidor, todos os pedidos serão rejeitados. A solução é sincronizar o relógio. Se não for possível executar NTP, calcular um desvio a partir do endpoint da hora do servidor da Gate e aplicá-lo antes de gerar o carimbo de data/hora de envio.
Um período de 100000 microssegundos (0,1 segundos) pode ser demasiado restrito para trajetos de rede entre regiões ou para clientes com latência variável. Se ocorrerem rejeições frequentes com um período restrito, alargá-lo gradualmente até a taxa de rejeição atingir um nível aceitável. Para a maioria das estratégias, começar com 1000000 microssegundos (1 segundo).
Um período muito longo, por exemplo, 60000000 microssegundos ou 60 segundos, oferece pouca proteção contra execuções desatualizadas. Num mercado de contratos com movimentos rápidos, um pedido com 60 segundos será quase certamente executado a um preço muito diferente do preço atual de mercado. Ajustar o período à tolerância real à latência da estratégia.
Se algum dos cabeçalhos for omitido, a API pode considerar que o pedido não tem validação temporal. O comportamento depende do endpoint e da respetiva configuração — consultar a documentação oficial da API para o endpoint específico que está a ser chamado. Como prática geral, definir sempre ambos os cabeçalhos em conjunto.
A validação temporal da API de Futuros da Gate adiciona uma funcionalidade de verificação de tempo ao nível do motor de correspondência (ME) das API de negociação de contratos. O cliente envia X-Gate-Client-Send-Us (um carimbo de data/hora em microssegundos do momento em que o pedido foi preparado) e X-Gate-Timeout-Window-Us (o período máximo de validade em microssegundos). Esta atualização aplica-se apenas à arquitetura de negociação Gate 3.0, oferecendo proteção contra execuções atrasadas pela rede, desvio do relógio e pedidos repetidos.
A integração exige quatro passos: sincronizar o relógio, calcular o carimbo de data/hora de envio em microssegundos, definir ambos os cabeçalhos em cada pedido e implementar lógica de nova tentativa que recalcule o carimbo de data/hora. O suporte REST foi lançado a 16 de novembro de 2026, e o WebSocket será disponibilizado a 19 de novembro de 2026, abrangendo as interfaces de negociação de contratos Gate 3.0.
A validação temporal da API de Futuros da Gate é uma funcionalidade de verificação de tempo que a Gate adiciona ao nível do motor de correspondência (ME) das suas API de negociação de contratos. Dois cabeçalhos de pedido — X-Gate-Client-Send-Us e X-Gate-Timeout-Window-Us — funcionam em conjunto para confirmar que um pedido foi enviado dentro de um período definido. A atualização aplica-se apenas à arquitetura de negociação Gate 3.0.
Os preços no mercado de contratos podem mudar em milissegundos. Uma ordem atrasada pode chegar ao motor de correspondência muito depois do pretendido pelo negociador, levando a execuções indesejadas. A validação temporal permite ao cliente indicar de forma declarativa "considerar este pedido inválido após N microssegundos", proporcionando proteção contra atrasos de rede, desvio do relógio e pedidos repetidos.
Os dois cabeçalhos foram concebidos para serem utilizados em conjunto. X-Gate-Client-Send-Us fornece o carimbo de data/hora de envio, e X-Gate-Timeout-Window-Us fornece o período de validade. A omissão de qualquer um deles significa que o servidor não pode efetuar a comparação temporal. Consultar a documentação oficial da API para conhecer os requisitos específicos de cada endpoint.
O comportamento predefinido quando X-Gate-Timeout-Window-Us é omitido depende da configuração do endpoint. A documentação oficial da API da Gate especifica o valor predefinido. Os clientes que necessitam de controlo explícito devem definir sempre o cabeçalho, em vez de depender do valor predefinido.
Ambos os cabeçalhos utilizam microssegundos desde a época Unix. Um segundo equivale a 1000000 microssegundos. Um milissegundo equivale a 1000 microssegundos.
A API devolve um erro que indica que o pedido não passou na validação temporal ao nível do motor de correspondência. O código de erro exato e o formato da mensagem estão documentados na referência oficial de erros da API da Gate. Os clientes devem gerir este erro recalculando o carimbo de data/hora e tentando novamente.
Os clientes existentes que não enviam os novos cabeçalhos continuam a funcionar segundo o comportamento anterior. O anúncio oficial da Gate solicita aos utilizadores da API Gate 3.0 que verifiquem e atualizem a respetiva lógica de integração de acordo com os nomes de campos mais recentes, para garantir o funcionamento correto da funcionalidade de validação temporal.
O mecanismo aplica-se apenas à arquitetura de negociação Gate 3.0 para API de negociação de contratos (futuros). O anúncio oficial indica que atualmente outras arquiteturas não suportam esta funcionalidade. A negociação à vista, a carteira e outros grupos de API seguem especificações distintas.
Declaração de exoneração de responsabilidade: O conteúdo acima destina-se apenas a fins informativos e educativos e não constitui aconselhamento financeiro, de investimento ou de negociação. A negociação de futuros e derivados envolve um risco significativo de perda. Consultar a documentação oficial da API da Gate para conhecer as especificações de endpoint, códigos de erro e requisitos de campos mais atualizados.
* As informações não se destinam a ser e não constituem aconselhamento financeiro ou qualquer outra recomendação de qualquer tipo oferecido ou endossado pela Gate.
* Este artigo não pode ser reproduzido, transmitido ou copiado sem fazer referência à Gate. A violação é uma violação da Lei de Direitos de Autor e pode estar sujeita a ações legais.





