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

Alterações nos tipos de campos relacionados com a dimensão nos Futuros
Para aumentar a flexibilidade da negociação de futuros e garantir total suporte a ordens de quantidade fracionada, a Gate irá implementar uma atualização faseada nas APIs de contratos perpétuos em USDT. Esta atualização afetará a lógica de análise dos campos relacionados com a quantidade (dimensão) da ordem tanto na REST API como na WebSocket. Solicita-se que avalie e ajuste antecipadamente a lógica da sua estratégia de acordo com o plano faseado, para garantir que a sua negociação permanece inalterada.

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

1. Fase 1: Atualização de compatibilidade do tipo 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 com a 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, é possível realizar 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	os tipos de campos relacionados com a dimensão passam de Integer para String	1. Suporta receção de dados decimais.
X-Gate-Size-Decimal = 0 Ou, não utilizando este campo no cabeçalho Por defeito, este campo não é utilizado.	os tipos de campos relacionados com a dimensão mantêm-se como Integer	1. Não suporta receção de dados decimais. 2. Gestão de precisão - Trunca para zero (para baixo).

• Se o cabeçalho X-Gate-Size-Decimal não for definido, o campo de dimensão continuará a aceitar e devolver o tipo Integer por defeito.

2. Fase 2: Lançamento da capacidade de ordens de quantidade fracionada

1. A capacidade do sistema para ordens de lotes fracionados em contratos perpétuos em USDT está prevista para lançamento a 30 de dezembro de 2025. Nesta fase, apenas as capacidades subjacentes do sistema e o suporte API serão ativados. Não serão abertos contratos para ordens de lotes fracionados nesta altura e as regras de colocação de ordens para os utilizadores permanecerão inalteradas.

2. A partir do final de janeiro de 2026, a funcionalidade de ordens de lotes fracionados será gradualmente disponibilizada nos contratos. Os contratos específicos e os prazos para o lançamento serão anunciados pela plataforma em comunicações posteriores.

3. Para os utilizadores que continuem a utilizar o antigo tipo de campo sem adaptação, poderão surgir os seguintes problemas:

• Anomalias na análise de precisão dos dados de profundidade do contrato.
• Inconsistência de precisão nas ordens.
• Anomalias de precisão nas ordens executadas.

Assim, todos os utilizadores de API são alertados para 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 com margem em USDT e migração obrigatória para tipos de campo String

1. Todos os pares de negociação de contratos irão suportar integralmente a colocação de ordens de lotes fracionados.
2. Numa data especificada, o sistema irá devolver por defeito o tipo String 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 curto período de transição para os utilizadores que ainda não concluíram 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 com a quantidade das ordens irão utilizar uniformemente o tipo String, para garantir precisão e compatibilidade. O tipo Integer legado deixará de ser suportado.
5. A data efetiva específica será anunciada previamente por aviso oficial. Certifique-se de que todas as adaptações estão 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 com a quantidade.

Parâmetro de cabeçalho	Descrição	Observações
X-Gate-Size-Decimal = 1	os tipos de campos relacionados com a dimensão passam de Integer para String	1. Suporta receção de dados decimais.
X-Gate-Size-Decimal = 0 Ou, não utilizando este campo no cabeçalho Por defeito, este campo não é utilizado.	os tipos de campos relacionados com a dimensão mantêm-se como Integer	1. Não suporta receção de dados decimais. 2. Gestão de precisão - Trunca para zero (para baixo).

Recomendação: Os clientes devem adaptar-se prontamente à alteração dos tipos de campo de quantidade de contrato. Assim que o contrato suportar oficialmente a colocação de ordens de quantidade fracionada, 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 dimensão decimal
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

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

1.3 Alterações futuras nos tipos de campo de dimensão

1. Campos relacionados com Rest

Tipo de interface	Endpoint	Campo	Observações
Público	1. Consultar todas as informações dos Futuros GET /futures/settle/contracts 2. Consultar informações de um único Futuro GET /futures/settle/contracts/contract	Dimensão mínima de ordem permitida pelo contrato 'order_size_min' Dimensão máxima de ordem permitida pelo contrato 'order_size_max' Volume histórico acumulado de negociação 'trade_size' Dimensão 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 irá passar de Integer para String . 2. Os clientes devem ajustar o tipo de aceitação para estes campos.
Público	1. Consultar informações de profundidade do mercado de futuros GET /futures/settle/order_book	Dimensão 's'
Público	1. Registos de transações do mercado de futuros GET /futures/settle/trades	Dimensão de negociação 'size'
Público	1. Gráfico K-line do mercado de futuros GET /futures/settle/candlesticks	volume de dimensão (dimensão de contrato) 'v'
Público	1. Estatísticas dos futuros GET /futures/settle/contract_stats	Dimensão de liquidação longa (contratos) 'long_liq_size' Dimensão de liquidação short (contratos) 'short_liq_size' Dimensão total de juros em aberto (contratos) 'open_interest' Proporção de posições long/short dos negociadores de topo 'top_lsr_size' Dimensão longa dos negociadores de topo 'top_long_size' Dimensão short dos negociadores de topo 'top_short_size' Dimensão longa dos tomadores de topo 'long_taker_size' Dimensão short dos tomadores de topo 'short_taker_size'
Público	1. Consultar histórico de ordens de liquidação GET /futures/settle/liq_orders	Dimensão da posição 'size' Preço da ordem de liquidação 'order_size' Dimensão do criador da ordem de liquidação do sistema 'left'
Privado	1. Obter lista de posições do utilizador GET /futures/settle/positions 2. Obter informações de uma posição única 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ções 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	Dimensão da posição 'size'
Privado	1. Colocar ordem de futuros POST /futures/settle/orders 2. Consultar lista de ordens de futuros GET /futures/settle/orders 3. Cancelar todas as ordens com estado 'open' DELETE /futures/settle/orders 4. Consultar lista de ordens de futuros por intervalo de tempo GET /futures/settle/orders_timerange 5. Colocar ordens de futuros em lote POST /futures/settle/batch_orders 6. Consultar detalhes de uma ordem única GET /futures/settle/orders/order_id 7. Cancelar ordem única DELETE /futures/settle/orders/order_id 8. Alterar ordem única PUT /futures/settle/orders/order_id 9. Colocação de ordem de contrato BBO por nível POST /futures/settle/bbo_orders	Quantidade de negociação. 'size' Dimensão de exibição para ordens do iceberg 'iceberg' Quantidade não executada 'left'
Privado	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	Dimensão de negociação 'size' Dimensão das posições encerradas: 'close_size'
Privado	1. Consultar histórico de encerramento de posições GET /futures/settle/position_close	Dimensão máxima de negociação 'max_size' Volume acumulado de posições encerradas 'accum_size'
Privado	1. Consultar histórico de liquidações GET /futures/settle/liquidates	Dimensão da posição 'size' Dimensão pendente da ordem de liquidação 'left'
Privado	1. Consultar informações de ordens ADL de desalavancagem automática GET /futures/settle/auto_deleverages	Dimensão de negociação 'trade_size' Dimensão da posição após ADL 'position_size'
Privado	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 uma ordem automática GET /futures/settle/price_orders/order_id 4. Cancelar ordem automática única DELETE /futures/settle/price_orders/order_id 5. Modificar uma ordem automática única 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	Dimensão executada 'size'	1. Utilizando o campo de cabeçalho X-Gate-Size-Decimal=1 , o tipo dos campos acima irá passar 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	Dimensão total 'total_size'
Público	1. Canal BBO futures.book_ticker	Melhor dimensão de compra 'A' Melhor dimensão de venda 'B'
Público	1. Canal de atualização de profundidade futures.order_book_update	Dimensão pendente do lado da venda 'a.s' Dimensão pendente do lado da compra 'b.s'
Público	1. Canal de profundidade total futures.order_book	Dimensão pendente do lado da venda a.s Dimensão pendente do lado da compra b.s
Público	1. Canal de profundidade V2 futures.obu	[preço, dimensão] 'size' Pode enviar dimensão decimal
Público	1. Canal de candlesticks futures.candlesticks	Volume 'v'
Público	1. Canal de liquidações públicas futures.public_liquidates	Dimensão da ordem de liquidação 'size'
Público	1. Canal de estatísticas de contrato futures.contract_stats	Dimensão de liquidação longa 'long_liq_size' Dimensão de liquidação short 'short_liq_size' Juros em aberto total 'open_interest'
Privado	1. Canal de ordens privadas futures.orders	Dimensão de exibição do iceberg 'iceberg' Dimensão negociável remanescente 'left' Dimensão da ordem 'size'
Privado	1. Canal de negociações privadas futures.usertrades	Dimensão executada 'size'
Privado	1. Canal ADL privado futures.auto_deleverages	Dimensão da posição 'position_size' Dimensão de negociação 'trade_size'
Privado	1. Canal de posições futures.positions	Dimensão da posição 'size'
Privado	1. Canal de ordens por 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	Dimensão negociável remanescente 'left' Dimensão da posição 'size'	1. Utilizando o campo de cabeçalho X-Gate-Size-Decimal=1 , o tipo dos campos acima irá passar de Integer para String . 2. Os clientes devem ajustar o tipo de aceitação para estes campos.
Privado	1. Colocação de ordens futures.order_place 2. Colocação de ordens em lote futures.order_batch_place 3. Cancelamento de ordens futures.order_cancel 4. Cancelamento em lote por ID futures.order_cancel_cp 5. Alteração de ordens futures.order_amend 6. Consultar lista de ordens futures.order_list 7. Consultar detalhes de ordens futures.order_status	Dimensão da ordem 'size' Dimensão negociável remanescente 'left' Quantidade de exibição do iceberg 'iceberg'

1.4 Consulta de informações de futuros que suportam colocação de ordens decimais

1. Definir cabeçalho X-Gate-Size-Decimal=1
2. Solicitar o endpoint de informações de 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 os futuros correspondentes suportam colocação de ordens decimais.

1.5 Informações adicionais

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 da 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,500 criptomoedas de forma segura, rápida e simples na Gate **Atue agora** Inscrever-se e reivindicar 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 Aplicação Gate | Desktop Siga-nos no X (Twitter) para obter mais bónus Junte-se à nossa comunidade no Telegram para discutir temas em destaque Participe na nossa comunidade global para as últimas perspetivas **Transparência e segurança** Consulte a nossa Prova de Reservas 100%