Anúncio da Gate sobre Mudança do Tipo de Campo de Quantidade de Ordem nos Contratos Perpétuos USDT e Plano de Implementação de Novas Funcionalidades

Alterações aos Tipos de Campos Relacionados ao Tamanho dos Futuros
Para aumentar a flexibilidade da negociação de futuros e suportar plenamente ordens com quantidades fracionárias, a Gate irá implementar uma atualização faseada das APIs de contratos perpétuos em USDT. Esta atualização afetará a lógica de análise dos campos relacionados à quantidade (tamanho) das ordens, tanto na REST API como no WebSocket. Recomendamos que avalie e ajuste antecipadamente a lógica da sua estratégia de acordo com o plano faseado, para garantir que as suas negociações não sejam afetadas.

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 a 9 de Dezembro de 2025)

• Foram concluídos os ajustes na estrutura de dados subjacente.
• O tipo de dados dos campos relacionados à quantidade do contrato foi alterado de Integer para String.
• O sistema encontra-se atualmente em modo de compatibilidade. Ao incluir o campo X-Gate-Size-Decimal no cabeçalho do pedido, é 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 passam de Integer para String	1. Suporta receção de dados decimais.
X-Gate-Size-Decimal = 0 Ou, não utilizar este campo de cabeçalho Por predefinição, este campo não é utilizado.	Tipos de campos relacionados ao tamanho mantêm-se como Integer	1. Não suporta receção de dados decimais. 2. Tratamento de precisão - Trunca para zero (em baixo).

• Caso o cabeçalho X-Gate-Size-Decimal não seja definido, o campo size continuará a aceitar e devolver o tipo Integer por predefinição.

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

1. A capacidade do sistema para ordens de lotes fracionários em contratos perpétuos em USDT está prevista para lançamento a 30 de Dezembro de 2025. Nesta fase, apenas as capacidades do sistema subjacente e o suporte API serão ativados. Não serão abertos contratos para ordens de lotes fracionários nesta fase, mantendo-se inalteradas as regras de colocação de ordens para os utilizadores.
2. A partir do final de Janeiro de 2026, a funcionalidade de ordens de lotes fracionários será gradualmente disponibilizada nos contratos. Os contratos específicos e o cronograma de implementação serão comunicados pela plataforma em avisos subsequentes.
3. Para os utilizadores que continuem a utilizar o tipo de campo antigo sem adaptação, poderão ocorrer os seguintes problemas:

• Análise de precisão anómala nos dados de profundidade do contrato.
• Precisão inconsistente nas ordens.
• Precisão anómala nas ordens executadas.

Assim, todos os utilizadores de API devem concluir a adaptação dos tipos de campo até ao final de Janeiro de 2026, sempre que possível.

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

1. Todos os pares de negociação de contratos suportarão plenamente a colocação de ordens de lotes fracionários.
2. Num momento a definir, o sistema passará a devolver, por defeito, o tipo String e ajustará o valor predefinido do cabeçalho (X-Gate-Size-Decimal), alterando o comportamento de análise predefinido de 0 para 1, proporcionando um curto período de transição para os utilizadores que ainda não tenham concluído 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 a 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 deixará de ser suportado.
5. A data de entrada em vigor será anunciada previamente através de aviso oficial. Solicitamos que todas as adaptações sejam concluídas antecipadamente.

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

1. Tanto as APIs REST como 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 passam de Integer para String	1. Suporta receção de dados decimais.
X-Gate-Size-Decimal = 0 Ou, não utilizar este campo de cabeçalho Por predefinição, este campo não é utilizado.	Tipos de campos relacionados ao tamanho mantêm-se como Integer	1. Não suporta receção de dados decimais. 2. Tratamento de precisão - Trunca para zero (em baixo).

Recomendação: Os clientes devem adaptar-se prontamente à alteração dos tipos de campo de quantidade do contrato. Assim que o contrato suportar oficialmente ordens de quantidade fracionária, poderão experimentar e utilizar rapidamente esta funcionalidade.

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

Rest

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

Websocket

# Definir cabeçalhos do pedido
# Ativar tamanho decimal
headers['X-Gate-Size-Decimal'] = '1'

1.3 Alterações Futuras aos Tipos de Campo de Tamanho

1. Campos Relacionados com 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ção 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 de 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 para estes campos.
Pública	1. Consultar informação de profundidade do mercado de futuros GET /futures/settle/order_book	Tamanho 's'
Pública	1. Registos de transaçõ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 longa (contratos) 'long_liq_size' Tamanho de liquidação curta (contratos) 'short_liq_size' Tamanho total de juros em aberto (contratos) 'open_interest' Rácio de posição longa/curta dos negociadores de topo 'top_lsr_size' Tamanho longo dos negociadores de topo 'top_long_size' Tamanho curto dos negociadores de topo 'top_short_size' Tamanho longo dos tomadores de topo 'long_taker_size' Tamanho curto dos tomadores de topo '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 do criador de ordem de liquidação do sistema 'left'
Privada	1. Obter lista de posições do utilizador GET /futures/settle/positions 2. Obter informação 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. Alterar modo de margem da posição POST /futures/settle/positions/cross_mode 6. Alternar entre modos de margem cruzada e isolada em modo de cobertura 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ção de posição em modo de cobertura GET /futures/settle/dual_comp/positions/contract 10. Atualizar margem da posição em modo de cobertura POST /futures/settle/dual_comp/positions/contract/margin 11. Atualizar alavancagem da posição em modo de cobertura POST /futures/settle/dual_comp/positions/contract/leverage 12. Atualizar limite de risco da posição em modo de cobertura POST /futures/settle/dual_comp/positions/contract/risk_limit	Tamanho da Posição 'size'
Privada	1. Colocar ordem de futuros POST /futures/settle/orders 2. Consultar lista de ordens de futuros GET /futures/settle/orders 1. Cancelar todas as ordens com estado 'open' DELETE /futures/settle/orders 2. Consultar lista de ordens de futuros por intervalo de tempo GET /futures/settle/orders_timerange 3. Colocar 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. Colocação de ordem BBO por níveis POST /futures/settle/bbo_orders	Quantidade de negociação. 'size' Tamanho de exibição para ordens iceberg 'iceberg' Quantidade não executada 'left'
Privada	1. Consultar registos pessoais de negociação GET /futures/settle/my_trades 2. Consultar registos 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 encerramento 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ção de ordens ADL de desalavancagem automática GET /futures/settle/auto_deleverages	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 com Websocket

Tipo de Canal	Canal	Campos	Observações
Público	1. Canal de Negociações Públicas futures.trades	Tamanho Executado '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 para estes campos.
Público	1. Canal de Ticker futures.tickers	Tamanho Total 'total_size'
Público	1. Canal BBO futures.book_ticker	Melhor Tamanho de Licitação '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 Licitação '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 Licitação b.s
Público	1. Canal de Profundidade V2 futures.obu	[preço,tamanho] 'size' Pode enviar tamanho decimal
Público	1. Canal de Candlesticks 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 Longa 'long_liq_size' Tamanho de Liquidação Curta 'short_liq_size' Juros em Aberto Total 'open_interest'
Privado	1. Canal de Ordens Privadas futures.orders	Tamanho de Exibição Iceberg 'iceberg' Tamanho Negociável Restante 'left' Tamanho da Ordem 'size'
Privado	1. Canal de Negociações Privadas futures.usertrades	Tamanho Executado 'size'
Privado	1. Canal Privado ADL 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 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 para estes campos.
Privado	1. Colocação de Ordem futures.order_place 2. Colocação 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. Consultar Lista de Ordens futures.order_list 7. Consultar Detalhes da Ordem futures.order_status	Tamanho da Ordem 'size' Tamanho Negociável Restante 'left' Quantidade de Exibição Iceberg 'iceberg'

1.4 Consulta de Informação de Futuros com Suporte a Ordens Decimais

1. Definir Cabeçalho X-Gate-Size-Decimal=1
2. Solicitar o endpoint de Informação do Contrato

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

3. Campo devolvido order_size_min: Se o valor for decimal, indica que o futuro correspondente suporta colocação de ordens decimais.

1.5 Informação Adicional

Registo de Atualizações da API: https://www.gate.com/pt/docs/developers/apiv4/en/#changelog
Para quaisquer questões, contacte o suporte técnico de API ou consulte a documentação da API. Agradecemos o seu apoio e compreensão.

Equipa Gate 18 de Dezembro de 2025 **Gateway para Criptomoedas** Negocie mais de 4,400 criptomoedas de forma segura, rápida e simples na Gate **Aja Agora** Inscreva-se e reivindique até 10 000 $ em recompensas de boas-vindas Convide amigos e ganhe uma comissão de 40 % **Mantenha-se Ligado** Visite o site oficial da Gate Descarregue a App Gate | Desktop Siga-nos no X (Twitter) para obter mais bónus Junte-se à nossa comunidade no Telegram para debater temas atuais Participe na nossa comunidade global para as últimas novidades **Transparência & Segurança** Consulte a nossa Prova de Reservas 100 %