Anúncios 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

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

2025-12-18 11:53:58 UTC 25098 Lido

[//]:content-type-MARKDOWN-DONOT-DELETE
**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.

* 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**

1. 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.

2. 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.

3. 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**

1. Todos os pares de negociação de contratos passarão a suportar integralmente ordens com lotes fracionários.
2. 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.
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 não terá mais efeito.
4. 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.
5. 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

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.

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.

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 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

1. Definir o cabeçalho X-Gate-Size-Decimal=1
2. 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'
```

3. 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.

<sp>
Equipe Gate
18 de dezembro de 2025
<sp>
**Gateway para Cripto**
Negocie com segurança, rapidez e facilidade mais de %Amount_of_Currency% criptomoedas na Gate
**Aja Agora**
<a href="https://www.gate.com/pt-br/signup" target="_blank">Inscreva-se</a> e receba até US$ 10.000 em recompensas de boas-vindas
<a href="https://www.gate.com/pt-br/referral" target="_blank">Convide amigos</a> e ganhe 40% de comissão
**Mantenha-se Conectado**
<a href="https://www.gate.com/pt-br/" target="_blank">Visite o site oficial da Gate</a>
<a href="https://www.gate.com/pt-br/mobileapp?ch=ann48788" target="_blank">Baixe o App Gate | Desktop</a>
<a href="https://x.com/Gate" rel="nofollow noopener noreferrer" target="_blank">Siga-nos no X (Twitter)</a> para obter mais bônus
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Participe da nossa comunidade no Telegram</a> para debater temas em alta
<a href="https://www.gate.com/pt-br/community" target="_blank">Interaja com nossa comunidade global</a> para as últimas novidades
**Transparência & Segurança**
<a href="https://www.gate.com/pt-br/proof-of-reserves" target="_blank">Confira nossa Prova de Reservas 100%</a>

Nota: esta é uma tradução do texto original em inglês por máquina ou humano, portanto, pode haver imprecisões na tradução. Clique aqui para ver o texto original em inglês.

Mudança e Horário de início e término do gráfico

Cor de subida/descida

Pay With

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

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

Selecione o idioma e a região

Selecione sua região

Moedas fiduciárias