Anúncio da Gate sobre Mudanças no Tipo de Campo de Quantidade de Ordem dos Contratos Perpétuos USDT e Plano de Implementação de Novos Recursos

Mudanças nos Tipos de Campos Relacionados ao Tamanho em Futuros
Para aumentar a flexibilidade das negociações de futuros e oferecer suporte total a ordens com quantidades fracionárias, a Gate realizará uma atualização gradual nas APIs de contratos perpétuos USDT. Esta atualização afetará a lógica de análise dos campos relacionados à quantidade (tamanho) das ordens tanto na REST API quanto no WebSocket. Solicitamos que avalie e ajuste antecipadamente a lógica de sua estratégia conforme o plano de fases para garantir que suas operaçõ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 Campos (Lançada em 9 de Dezembro de 2025)

• Ajustes concluídos na estrutura de dados subjacente.
• Modificação do tipo de dados dos campos relacionados à quantidade de contratos 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 compatível 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 este campo no cabeçalho Por padrão, este 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 de tamanho continuará aceitando e retornando o tipo Integer por padrão.

2. Fase 2: Lançamento da Capacidade de Ordens com Quantidade Fracionária

1. A capacidade do sistema para ordens fracionárias em contratos perpétuos USDT está prevista para lançamento em 30 de Dezembro de 2025. Nesta fase, apenas as capacidades do sistema subjacente e o suporte via API serão habilitados. Nenhum contrato será efetivamente aberto para ordens fracionárias neste momento, e as regras de envio de ordens para os usuários permanecerão inalteradas.

2. A partir do final de Janeiro de 2026, a funcionalidade de ordens fracionárias será gradualmente disponibilizada para os contratos. Os contratos específicos e o cronograma de implementação serão divulgados pela plataforma em comunicados posteriores.

3. Para usuários que ainda utilizam o tipo de campo antigo sem adaptação, poderão ocorrer as seguintes situações:

• Análise incorreta 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 campos até o final de Janeiro de 2026, sempre que possível.

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

1. Todos os pares de negociação de contratos passarão a suportar integralmente o envio de ordens com lotes fracionários.
2. Em data a ser definida, 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 de análise padrão de 0 para 1, proporcionando um breve período de transição para usuários que ainda não realizaram a adaptação.
3. Após o período de transição, o campo de cabeçalho X-Gate-Size-Decimal será oficialmente descontinuado, e sua configuração deixará de ter efeito.
4. Todos os campos relacionados à quantidade de ordens passarão a utilizar exclusivamente o tipo String, garantindo precisão e compatibilidade. O tipo Integer legado não será mais suportado.
5. A data específica de efetivação será anunciada previamente por meio de comunicado oficial. Certifique-se de concluir todas as adaptações antes desse prazo.

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

1. Tanto as APIs REST quanto 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 este campo no cabeçalho Por padrão, este 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 nos tipos de campos de quantidade de contratos. Assim que o contrato passar a suportar oficialmente ordens com quantidade fracionária, poderão utilizar essa funcionalidade de forma ágil.

2. 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 Campos de Tamanho

1. Campos Relacionados à 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 futuro individual 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 da posição longa '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 do mercado de futuros GET /futures/settle/order_book	Tamanho 's'
Pública	1. Registros de negociações no 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 de tamanho (tamanho do contrato) 'v'
Pública	1. Estatísticas de futuros GET /futures/settle/contract_stats	Tamanho de liquidação longa (contratos) 'long_liq_size' Tamanho de liquidação short (contratos) 'short_liq_size' Tamanho total de juros em aberto (contratos) 'open_interest' Razão de posição long/short do Top Trader 'top_lsr_size' Tamanho long do Top Trader 'top_long_size' Tamanho short do Top Trader 'top_short_size' Tamanho long do Top Taker 'long_taker_size' Tamanho short do Top Taker '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 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 posição individual 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 de 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 de Hedge GET /futures/settle/dual_comp/positions/contract 10. Atualizar margem da posição no Modo de Hedge POST /futures/settle/dual_comp/positions/contract/margin 11. Atualizar alavancagem da posição no Modo de Hedge POST /futures/settle/dual_comp/positions/contract/leverage 12. Atualizar limite de risco da posição no Modo de 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 1. Cancelar todas as ordens com status 'open' DELETE /futures/settle/orders 2. Consultar lista de ordens de futuros por intervalo de tempo GET /futures/settle/orders_timerange 3. Enviar ordens de futuros em lote POST /futures/settle/batch_orders 4. Consultar detalhes de ordem individual GET /futures/settle/orders/order_id 5. Cancelar ordem individual DELETE /futures/settle/orders/order_id 6. Alterar ordem individual PUT /futures/settle/orders/order_id 7. Envio de ordem de contrato BBO por nível POST /futures/settle/bbo_orders	Quantidade negociada. 'size' Tamanho exibido para ordem 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 de 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 ordens ADL de desalavancagem automática GET /futures/settle/auto_deleverges	Tamanho da negociação '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 individual GET /futures/settle/price_orders/order_id 4. Cancelar ordem automática individual DELETE /futures/settle/price_orders/order_id 5. Alterar 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 de Liquidações Públicas futures.public_liquidates	Tamanho da ordem de liquidação 'size'
Público	1. Canal de Estatísticas de Contrato 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 negociável restante 'left' Tamanho da ordem 'size'
Privado	1. Canal de Negociações Privadas futures.usertrades	Tamanho preenchido 'size'
Privado	1. Canal de ADL Privado futures.auto_deleverages	Tamanho da posição 'position_size' Tamanho da negociação 'trade_size'
Privado	1. Canal de Posições futures.positions	Tamanho da posição 'size'
Privado	1. Canal de Ordens de Disparo de 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 negociável restante '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 negociável restante 'left' Quantidade exibida da ordem iceberg 'iceberg'

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

1. Defina o cabeçalho X-Gate-Size-Decimal=1
2. Solicite o endpoint de informações do contrato

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

3. Campo retornado order_size_min: Se o valor for decimal, indica que o futuro correspondente suporta envio de ordens decimais.

1.5 Informações Adicionais

Log de Atualizações da API: https://www.gate.com/pt-br/docs/developers/apiv4/en/#changelog
Para 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, agilidade e facilidade mais de 4,400 criptomoedas na Gate **Aja Agora** Inscreva-se e reivindique até US$10.000 em recompensas de boas-vindas Convide amigos e receba 40% de comissão **Fique Conectado** Acesse o site oficial da Gate Baixe o App Gate | Desktop Siga-nos no X (Twitter) para receber mais bônus Participe da nossa comunidade no Telegram e discuta os temas mais quentes Interaja com nossa comunidade global para as últimas novidades **Transparência & Segurança** Confira nossa Prova de Reservas 100%