Anúncio da Gate sobre mudanças no tipo de campo de quantidade de ordens em contratos perpétuos USDT e plano de implementação de funcionalidades

Mudanças nos Tipos de Campos Relacionados ao Tamanho em Futuros
Para aprimorar a flexibilidade das negociações de futuros e oferecer suporte total a ordens com quantidades fracionárias, a Gate implementará uma atualização gradual nas APIs de contratos perpétuos em USDT. Essa atualização afetará a lógica de análise dos campos relacionados à quantidade (tamanho) das ordens tanto nas APIs REST quanto WebSocket. Por favor, avalie e ajuste antecipadamente a lógica de suas estratégias conforme o plano de transição para garantir que suas negociações não sejam impactadas.

1.1 Visão geral do plano de atualização (dividido em 3 fases)

1. Fase 1: Atualização de Compatibilidade dos Tipos de Campo (Lançada em 9 de dezembro de 2025)

Ajustes concluídos na estrutura de dados subjacente.
Alteração do tipo de dado dos campos relacionados à quantidade do contrato de Integer para String.
O sistema está atualmente em modo de compatibilidade. Ao incluir o campo X-Gate-Size-Decimal no cabeçalho da requisição, é realizado o processamento de compatibilidade para o campo de quantidade de lotes do contrato.

Parâmetro de Cabeçalho	Descrição	Observações
X-Gate-Size-Decimal = 1	tipos de campos relacionados ao tamanho mudam de Integer para String	1. Suporta recebimento de dados decimais.
X-Gate-Size-Decimal = 0 Ou, não utilizando esse campo no cabeçalho Por padrão, esse campo não é utilizado.	tipos de campos relacionados ao tamanho permanecem como Integer	1. Não suporta recebimento de dados decimais. 2. Tratamento de precisão - Trunca para zero (para baixo).

Caso o cabeçalho X-Gate-Size-Decimal não seja definido, o campo size continuará aceitando e retornando o tipo Integer por padrão.

2. Fase 2: Lançamento da Capacidade de Ordens com Quantidades Fracionárias

A capacidade do sistema para ordens fracionárias em contratos perpétuos em USDT está prevista para lançamento em 30 de dezembro de 2025. Nesta fase, apenas as funcionalidades de sistema e suporte via API serão habilitadas. Nenhum contrato estará disponível para ordens fracionárias neste momento, e as regras práticas de envio de ordens para os usuários permanecerão inalteradas.
A partir do final de janeiro de 2026, a funcionalidade de ordens fracionárias será gradualmente liberada para os contratos. Os contratos específicos e o cronograma de implementação serão anunciados pela plataforma em comunicados posteriores.
Para usuários que permanecerem utilizando o tipo de campo antigo sem adaptação, poderão ocorrer as seguintes situações:

Análise anormal de precisão nos dados de profundidade do contrato.
Inconsistência na precisão das ordens.
Precisão anormal em ordens executadas.

Portanto, todos os usuários de API devem concluir a adaptação dos tipos de campo até o final de janeiro de 2026, sempre que possível.

3. Fase 3: Ativação Total para Todos os Contratos Perpétuos em USDT e Migração Obrigatória para o Tipo de Campo String

Todos os pares de negociação de contratos passarão a suportar integralmente ordens com lotes fracionários.
Em momento a ser definido, o sistema passará a retornar o tipo String por padrão e ajustará o valor padrão do cabeçalho (X-Gate-Size-Decimal), alterando o comportamento padrão de análise de 0 para 1, proporcionando um breve período de transição para usuários que ainda não completaram a adaptação.
Após o período de transição, o campo de cabeçalho X-Gate-Size-Decimal será oficialmente descontinuado e sua configuração não terá mais efeito.
Todos os campos relacionados à quantidade de ordens passarão a utilizar exclusivamente o tipo String para garantir precisão e compatibilidade. O tipo Integer legado não será mais suportado.
A data de vigência será anunciada previamente por meio de comunicado oficial. Assegure-se de concluir todas as adaptações antecipadamente.

1.2 Explicação Detalhada da Atualização da Fase 1

As APIs REST e WebSocket introduziram um novo campo de cabeçalho, X-Gate-Size-Decimal, para controlar a precisão dos campos relacionados à quantidade.

Parâmetro de Cabeçalho	Descrição	Observações
X-Gate-Size-Decimal = 1	tipos de campos relacionados ao tamanho mudam de Integer para String	1. Suporta recebimento de dados decimais.
X-Gate-Size-Decimal = 0 Ou, não utilizando esse campo no cabeçalho Por padrão, esse campo não é utilizado.	tipos de campos relacionados ao tamanho permanecem como Integer	1. Não suporta recebimento de dados decimais. 2. Tratamento de precisão - Trunca para zero (para baixo).

Recomendação: Os clientes devem adaptar-se prontamente à mudança dos tipos de campo de quantidade dos contratos. Assim que o contrato suportar oficialmente ordens com quantidades fracionárias, poderão experimentar e utilizar essa funcionalidade rapidamente.

Exemplo de Referência para Definição do Cabeçalho

Rest

# Definir cabeçalhos da requisição 
headers = 
{ 
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# Habilitar tamanho decimal
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

# Definir cabeçalhos da requisição
# Habilitar tamanho decimal
headers['X-Gate-Size-Decimal'] = '1'

1.3 Mudanças Futuras nos Tipos de Campo de Tamanho

1. Campos Relacionados ao Rest

Tipo de Interface	Endpoint	Campo	Observações
Pública	1. Consultar todas as informações de futuros GET /futures/settle/contracts 2. Consultar informações de um único futuro GET /futures/settle/contracts/contract	Tamanho mínimo de ordem permitido pelo contrato 'order_size_min' Tamanho máximo de ordem permitido pelo contrato 'order_size_max' Volume histórico acumulado de negociação 'trade_size' Tamanho total atual de posição long 'position_size'	1. Utilizando o campo de cabeçalho X-Gate-Size-Decimal=1 , o tipo dos campos acima mudará de Integer para String . 2. Os clientes devem ajustar o tipo de aceitação desses campos.
Pública	1. Consultar informações de profundidade de mercado de futuros GET /futures/settle/order_book	Tamanho 's'
Pública	1. Registros de negociações de mercado de futuros GET /futures/settle/trades	Tamanho da negociação 'size'
Pública	1. Gráfico K-line do mercado de futuros GET /futures/settle/candlesticks	volume size (tamanho do contrato) 'v'
Pública	1. Estatísticas de futuros GET /futures/settle/contract_stats	Tamanho de liquidação long (contratos) 'long_liq_size' Tamanho de liquidação short (contratos) 'short_liq_size' Tamanho total de juros em aberto (contratos) 'open_interest' Proporção de posição long/short dos Top Traders 'top_lsr_size' Tamanho long dos Top Traders 'top_long_size' Tamanho short dos Top Traders 'top_short_size' Tamanho long dos Top Takers 'long_taker_size' Tamanho short dos Top Takers 'short_taker_size'
Pública	1. Consultar histórico de ordens de liquidação GET /futures/settle/liq_orders	Tamanho da posição 'size' Preço da ordem de liquidação 'order_size' Tamanho de maker de ordem de liquidação do sistema 'left'
Privada	1. Obter lista de posições do usuário GET /futures/settle/positions 2. Obter informações de uma posição GET /futures/settle/positions/contract 3. Atualizar margem da posição POST /futures/settle/positions/contract/margin 4. Atualizar alavancagem da posição POST /futures/settle/positions/contract/leverage 5. Alternar modo de margem da posição POST /futures/settle/positions/cross_mode 6. Alternar entre modos de margem cruzada e isolada no Modo Hedge POST /futures/settle/dual_comp/positions/cross_mode 7. Atualizar limite de risco da posição POST /futures/settle/positions/contract/risk_limit 8. Definir modo de posição POST /futures/settle/dual_mode 9. Obter informações de posição no Modo Hedge GET /futures/settle/dual_comp/positions/contract 10. Atualizar margem da posição no Modo Hedge POST /futures/settle/dual_comp/positions/contract/margin 11. Atualizar alavancagem da posição no Modo Hedge POST /futures/settle/dual_comp/positions/contract/leverage 12. Atualizar limite de risco da posição no Modo Hedge POST /futures/settle/dual_comp/positions/contract/risk_limit	Tamanho da posição 'size'
Privada	1. Enviar ordem de futuros POST /futures/settle/orders 2. Consultar lista de ordens de futuros GET /futures/settle/orders 3. Cancelar todas as ordens com status 'open' DELETE /futures/settle/orders 4. Consultar lista de ordens de futuros por intervalo de tempo GET /futures/settle/orders_timerange 5. Enviar ordens em lote POST /futures/settle/batch_orders 6. Consultar detalhes de uma ordem GET /futures/settle/orders/order_id 7. Cancelar ordem individual DELETE /futures/settle/orders/order_id 8. Alterar ordem individual PUT /futures/settle/orders/order_id 9. Envio de ordem de contrato BBO por nível POST /futures/settle/bbo_orders	Quantidade negociada. 'size' Tamanho exibido para ordens iceberg 'iceberg' Quantidade não preenchida 'left'
Privada	1. Consultar registros pessoais de negociação GET /futures/settle/my_trades 2. Consultar registros pessoais de negociação por intervalo de tempo GET /futures/settle/my_trades_timerange	Tamanho da negociação 'size' Tamanho das posições fechadas: 'close_size'
Privada	1. Consultar histórico de fechamento de posições GET /futures/settle/position_close	Tamanho máximo de negociação 'max_size' Volume acumulado de posições fechadas 'accum_size'
Privada	1. Consultar histórico de liquidações GET /futures/settle/liquidates	Tamanho da posição 'size' Tamanho pendente da ordem de liquidação 'left'
Privada	1. Consultar informações de ordem ADL de desalavancagem automática GET /futures/settle/auto_deleverges	Tamanho negociado 'trade_size' Tamanho da posição após ADL 'position_size'
Privada	1. Consultar lista de ordens automáticas GET /futures/settle/price_orders 2. Cancelar todas as ordens automáticas DELETE /futures/settle/price_orders 3. Consultar detalhes de ordem automática GET /futures/settle/price_orders/order_id 4. Cancelar ordem automática individual DELETE /futures/settle/price_orders/order_id 5. Modificar ordem automática individual PUT /futures/settle/price_orders/order_id	Novo campo: 'amount' (tipo string).	1. Novo campo: amount (tipo string). 2. O campo original size (int ) e o novo campo amount (string) serão compatíveis.

2. Campos Relacionados ao WebSocket

Tipo de Canal	Canal	Campos	Observações
Público	1. Canal de Negociações Públicas futures.trades	Tamanho preenchido 'size'	1. Utilizando o campo de cabeçalho X-Gate-Size-Decimal=1 , o tipo dos campos acima mudará de Integer para String . 2. Os clientes devem ajustar o tipo de aceitação desses campos.
Público	1. Canal de Ticker futures.tickers	Tamanho total 'total_size'
Público	1. Canal BBO futures.book_ticker	Melhor tamanho de lance 'A' Melhor tamanho de oferta 'B'
Público	1. Canal de Atualização de Profundidade futures.order_book_update	Tamanho pendente do lado de oferta 'a.s' Tamanho pendente do lado de lance 'b.s'
Público	1. Canal de Profundidade Completa futures.order_book	Tamanho pendente do lado de oferta a.s Tamanho pendente do lado de lance b.s
Público	1. Canal Depth V2 futures.obu	[preço, tamanho] 'size' Pode enviar tamanho decimal
Público	1. Canal de Candlestick futures.candlesticks	Volume 'v'
Público	1. Canal Público de Liquidações futures.public_liquidates	Tamanho da ordem de liquidação 'size'
Público	1. Canal de Estatísticas de Contratos futures.contract_stats	Tamanho de liquidação long 'long_liq_size' Tamanho de liquidação short 'short_liq_size' Juros em aberto total 'open_interest'
Privado	1. Canal de Ordens Privadas futures.orders	Tamanho exibido da ordem iceberg 'iceberg' Tamanho restante negociável 'left' Tamanho da ordem 'size'
Privado	1. Canal de Negociações Privadas futures.usertrades	Tamanho preenchido 'size'
Privado	1. Canal Privado de ADL futures.auto_deleverges	Tamanho da posição 'position_size' Tamanho negociado 'trade_size'
Privado	1. Canal de Posições futures.positions	Tamanho da posição 'size'
Privado	1. Canal de Ordens por Preço futures.autoorders	Novo campo: 'amount' (tipo string).	1. Novo campo: amount (tipo string). 2. O campo original size ( tipo Integer ) e o novo campo amount (String) serão compatíveis.
Privado	1. Canal de Ordens de Liquidação futures.liquidates	Tamanho restante negociável 'left' Tamanho da posição 'size'	1. Utilizando o campo de cabeçalho X-Gate-Size-Decimal=1 , o tipo dos campos acima mudará de Integer para String . 2. Os clientes devem ajustar o tipo de aceitação desses campos.
Privado	1. Envio de Ordem futures.order_place 2. Envio de Ordens em Lote futures.order_batch_place 3. Cancelamento de Ordem futures.order_cancel 4. Cancelamento em Lote por ID futures.order_cancel_cp 5. Alteração de Ordem futures.order_amend 6. Consulta de Lista de Ordens futures.order_list 7. Consulta de Detalhes de Ordem futures.order_status	Tamanho da ordem 'size' Tamanho restante negociável 'left' Quantidade exibida da ordem iceberg 'iceberg'

1.4 Consulta de Informações de Futuros com Suporte a Ordens Decimais

Definir o cabeçalho X-Gate-Size-Decimal=1
Realizar a requisição para o endpoint de informações do contrato

curl --location 'https://api.gateio.ws/api/v4/futures/usdt/contracts' \ 
--header 'X-Gate-Size-Decimal: 1'

Campo retornado order_size_min: Se o valor for decimal, indica que o respectivo futuro suporta ordens com tamanho decimal.

1.5 Informações Adicionais

Log de Atualizações da API: https://www.gate.com/pt-br/docs/developers/apiv4/en/#changelog
Em caso de dúvidas, entre em contato com o suporte técnico de API ou consulte a documentação da API. Agradecemos seu apoio e compreensão.

Equipe Gate 18 de dezembro de 2025 **Gateway para Cripto** Negocie com segurança, rapidez e facilidade mais de 4,500 criptomoedas na Gate **Aja Agora** Inscreva-se e receba até US$ 10.000 em recompensas de boas-vindas Convide amigos e ganhe 40% de comissão **Mantenha-se Conectado** Visite o site oficial da Gate Baixe o App Gate | Desktop Siga-nos no X (Twitter) para obter mais bônus Participe da nossa comunidade no Telegram para debater temas em alta Interaja com nossa comunidade global para as últimas novidades **Transparência & Segurança** Confira nossa Prova de Reservas 100%