Anuncios Anuncio de Gate sobre los cambios en el tipo de campo de cantidad de órdenes en Contratos Perpetuos USDT y plan de implementación de nuevas funciones

Anuncio de Gate sobre los cambios en el tipo de campo de cantidad de órdenes en Contratos Perpetuos USDT y plan de implementación de nuevas funciones

2025-12-18 11:53:58 UTC 25081 Leído

[//]:content-type-MARKDOWN-DONOT-DELETE
**Cambios en los tipos de campos relacionados con el tamaño en Futuros**
Para mejorar la flexibilidad del trading de futuros y admitir plenamente órdenes de cantidad fraccionaria, Gate implementará una actualización por fases en las API de contratos perpetuos USDT. Esta actualización afectará la lógica de análisis de los campos relacionados con la cantidad de la orden (tamaño) tanto en la REST API como en WebSocket. Le rogamos que evalúe y ajuste con antelación la lógica de su estrategia conforme al plan por fases para garantizar que su operativa no se vea afectada.

### 1.1 Resumen del plan de actualización (Dividido en 3 fases)

**1. Fase 1: Actualización de compatibilidad de tipos de campo (Lanzada el 9 de diciembre de 2025)**

- Se han completado los ajustes en la estructura de datos subyacente.
- Se modificó el tipo de datos de los campos relacionados con la cantidad del contrato, pasando de Integer a String.
- El sistema se encuentra actualmente en modo de compatibilidad. Al incluir el campo X-Gate-Size-Decimal en la cabecera de la solicitud, se logra el procesamiento de compatibilidad para el campo de cantidad de lotes del contrato.

* Si no se establece la cabecera X-Gate-Size-Decimal, el campo size seguirá aceptando y devolviendo el tipo Integer por defecto.

**2. Fase 2: Lanzamiento de la capacidad de órdenes de cantidad fraccionaria**

1. La capacidad del sistema para la realización de órdenes de lotes fraccionarios en contratos perpetuos USDT está programada para lanzarse el 30 de diciembre de 2025. Durante esta fase, solo se habilitarán las capacidades del sistema subyacente y el soporte en la API. No se habilitarán contratos para la operativa real de lotes fraccionarios en este momento, y las reglas de colocación de órdenes para los usuarios no cambiarán.

2. A partir de finales de enero de 2026, la funcionalidad de órdenes de lotes fraccionarios se implementará gradualmente en los contratos. Los contratos específicos y el calendario de implementación serán anunciados por la plataforma en avisos posteriores.

3. Para los usuarios que sigan utilizando el tipo de campo antiguo sin adaptación, pueden surgir los siguientes problemas:
* Análisis anómalo de la precisión en los datos de profundidad de contratos.
* Precisión inconsistente en las órdenes.
* Precisión anómala en las órdenes ejecutadas.

***Por tanto, se recuerda a todos los usuarios de API que completen la adaptación de los tipos de campo antes de que finalice enero de 2026.***

**3. Fase 3: Habilitación total para todos los contratos perpetuos USDT-M y migración obligatoria a tipos de campo String**

1. Todos los pares de trading de contratos admitirán plenamente la colocación de órdenes de lotes fraccionarios.
2. En un momento especificado, el sistema devolverá por defecto el tipo String y ajustará el valor predeterminado de la cabecera (X-Gate-Size-Decimal), cambiando el comportamiento de análisis predeterminado de 0 a 1 para proporcionar un breve periodo de transición a los usuarios que aún no hayan completado la adaptación.
3. Tras el periodo de transición, el campo de cabecera X-Gate-Size-Decimal quedará oficialmente obsoleto y su configuración dejará de tener efecto.
4. Todos los campos relacionados con la cantidad de órdenes utilizarán de forma uniforme el tipo String para garantizar la precisión y compatibilidad. El tipo Integer heredado dejará de estar soportado.
5. La fecha de entrada en vigor específica se anunciará con antelación mediante aviso oficial. Por favor, asegúrese de completar todas las adaptaciones antes de esa fecha.

### 1.2 Explicación detallada de la actualización de la Fase 1

1. Tanto las API REST como WebSocket han incorporado un nuevo campo de cabecera, X-Gate-Size-Decimal, para controlar la precisión de los campos relacionados con la cantidad.

Recomendación: Los clientes deben adaptar cuanto antes los tipos de campo de cantidad de contrato. Una vez que el contrato admita oficialmente órdenes de cantidad fraccionaria, podrán experimentar y utilizar esta funcionalidad rápidamente.

2. Ejemplo de referencia para establecer la cabecera

Rest

```
# Establecer cabeceras de solicitud 
headers = 
{ 
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# Habilitar tamaño decimal
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

```

Websocket

```
# Establecer cabeceras de solicitud
# Habilitar tamaño decimal
headers['X-Gate-Size-Decimal'] = '1'
```

### 1.3 Cambios futuros en los tipos de campo de tamaño

**1. Campos relacionados con REST**

| Tipo de interfaz | Endpoint | Campo | Observaciones |
| :--- | :--- | :--- | :--- |
| Pública | 1. Consultar toda la información de futuros GET /futures/settle/contracts 2. Consultar información de un futuro GET /futures/settle/contracts/contract | Tamaño mínimo de orden permitido por el contrato 'order_size_min' Tamaño máximo de orden permitido por el contrato 'order_size_max' Volumen histórico acumulado de trading 'trade_size' Tamaño total actual de posición larga 'position_size' | 1. Usando el campo de cabecera X-Gate-Size-Decimal=1 , el tipo de los campos anteriores pasará de Integer a String . 2. Los clientes deben ajustar el tipo de aceptación para estos campos. |
| Pública | 1. Consultar información de profundidad de mercado de futuros GET /futures/settle/order_book | Tamaño 's' | |
| Pública | 1. Registros de operaciones de mercado de futuros GET /futures/settle/trades | Tamaño de la operación 'size' | |
| Pública | 1. Gráfico de velas del mercado de futuros GET /futures/settle/candlesticks | volumen de tamaño (tamaño del contrato) 'v' | |
| Pública | 1. Estadísticas de futuros GET /futures/settle/contract_stats | Tamaño de liquidación larga (contratos) 'long_liq_size' Tamaño de liquidación corta (contratos) 'short_liq_size' Tamaño total de interés abierto (contratos) 'open_interest' Ratio de posición larga/corta de trader top 'top_lsr_size' Tamaño largo de trader top 'top_long_size' Tamaño corto de trader top 'top_short_size' Tamaño largo de taker top 'long_taker_size' Tamaño corto de taker top 'short_taker_size' | |
| Pública | 1. Consultar historial de órdenes de liquidación GET /futures/settle/liq_orders | Tamaño de posición 'size' Precio de orden de liquidación 'order_size' Tamaño de maker de orden de liquidación del sistema 'left' | |
| Privada | 1. Obtener lista de posiciones de usuario GET /futures/settle/positions 2. Obtener información de una posición GET /futures/settle/positions/contract 3. Actualizar margen de posición POST /futures/settle/positions/contract/margin 4. Actualizar apalancamiento de posición POST /futures/settle/positions/contract/leverage 5. Cambiar modo de margen de posición POST /futures/settle/positions/cross_mode 6. Cambiar entre modos de margen cruzado y aislado en modo cobertura POST /futures/settle/dual_comp/positions/cross_mode 7. Actualizar límite de riesgo de posición POST /futures/settle/positions/contract/risk_limit 8. Establecer modo de posición POST /futures/settle/dual_mode 9. Obtener información de posición en modo cobertura GET /futures/settle/dual_comp/positions/contract 10. Actualizar margen de posición en modo cobertura POST /futures/settle/dual_comp/positions/contract/margin 11. Actualizar apalancamiento de posición en modo cobertura POST /futures/settle/dual_comp/positions/contract/leverage 12. Actualizar límite de riesgo de posición en modo cobertura POST /futures/settle/dual_comp/positions/contract/risk_limit | Tamaño de posición 'size' | |
| Privada | 1. Colocar orden de futuros POST /futures/settle/orders 2. Consultar lista de órdenes de futuros GET /futures/settle/orders 3. Cancelar todas las órdenes con estado 'open' DELETE /futures/settle/orders 4. Consultar lista de órdenes de futuros por rango de tiempo GET /futures/settle/orders_timerange 5. Colocar órdenes de futuros por lotes POST /futures/settle/batch_orders 6. Consultar detalles de una orden GET /futures/settle/orders/order_id 7. Cancelar una orden DELETE /futures/settle/orders/order_id 8. Modificar una orden PUT /futures/settle/orders/order_id 9. Colocación de órdenes BBO por niveles POST /futures/settle/bbo_orders | Cantidad de la operación. 'size' Tamaño de visualización para órdenes iceberg 'iceberg' Cantidad no ejecutada 'left' | |
| Privada | 1. Consultar registros personales de trading GET /futures/settle/my_trades 2. Consultar registros personales de trading por rango de tiempo GET /futures/settle/my_trades_timerange | Tamaño de la operación 'size' Tamaño de posiciones cerradas: 'close_size' | |
| Privada | 1. Consultar historial de cierre de posiciones GET /futures/settle/position_close | Tamaño máximo de operación 'max_size' Volumen acumulado de posiciones cerradas 'accum_size' | |
| Privada | 1. Consultar historial de liquidaciones GET /futures/settle/liquidates | Tamaño de posición 'size' Tamaño pendiente de orden de liquidación 'left' | |
| Privada | 1. Consultar información de órdenes ADL de desapalancamiento automático GET /futures/settle/auto_deleverges | Tamaño de la operación 'trade_size' Tamaño de posición tras ADL 'position_size' | |
| Privada | 1. Consultar lista de órdenes automáticas GET /futures/settle/price_orders 2. Cancelar todas las órdenes automáticas DELETE /futures/settle/price_orders 3. Consultar detalles de una orden automática GET /futures/settle/price_orders/order_id 4. Cancelar una orden automática DELETE /futures/settle/price_orders/order_id 5. Modificar una orden automática PUT /futures/settle/price_orders/order_id | Nuevo campo: 'amount' (tipo string). | 1. Nuevo campo: amount (tipo string). 2. El campo original size (int ) y el nuevo campo amount (string) serán compatibles. |

**2. Campos relacionados con WebSocket**

| Tipo de canal | Canal | Campos | Observaciones |
| :--- | :--- | :--- | :--- |
| Público | 1. Canal de operaciones públicas futures.trades | Tamaño ejecutado 'size' | 1. Usando el campo de cabecera X-Gate-Size-Decimal=1 , el tipo de los campos anteriores pasará de Integer a String . 2. Los clientes deben ajustar el tipo de aceptación para estos campos. |
| Público | 1. Canal de ticker futures.tickers | Tamaño total 'total_size' | |
| Público | 1. Canal BBO futures.book_ticker | Mejor tamaño de compra 'A' Mejor tamaño de venta 'B' | |
| Público | 1. Canal de actualización de profundidad futures.order_book_update | Tamaño pendiente en el lado vendedor 'a.s' Tamaño pendiente en el lado comprador 'b.s' | |
| Público | 1. Canal de profundidad completa futures.order_book | Tamaño pendiente en el lado vendedor a.s Tamaño pendiente en el lado comprador b.s | |
| Público | 1. Canal Depth V2 futures.obu | [precio, tamaño] 'size' Puede enviar tamaño decimal | |
| Público | 1. Canal de velas futures.candlesticks | Volumen 'v' | |
| Público | 1. Canal público de liquidaciones futures.public_liquidates | Tamaño de orden de liquidación 'size' | |
| Público | 1. Canal de estadísticas de contratos futures.contract_stats | Tamaño de liquidación larga 'long_liq_size' Tamaño de liquidación corta 'short_liq_size' Interés abierto total 'open_interest' | |
| Privado | 1. Canal de órdenes privadas futures.orders | Tamaño de visualización de iceberg 'iceberg' Cantidad restante operable 'left' Tamaño de la orden 'size' | |
| Privado | 1. Canal de operaciones privadas futures.usertrades | Tamaño ejecutado 'size' | |
| Privado | 1. Canal privado ADL futures.auto_deleverages | Tamaño de posición 'position_size' Tamaño de la operación 'trade_size' | |
| Privado | 1. Canal de posiciones futures.positions | Tamaño de posición 'size' | |
| Privado | 1. Canal de órdenes con activador de precio futures.autoorders | Nuevo campo: 'amount' (tipo string). | 1. Nuevo campo: amount (tipo string). 2. El campo original size ( tipo Integer) y el nuevo campo amount (String) serán compatibles. |
| Privado | 1. Canal de órdenes de liquidación futures.liquidates | Cantidad restante operable 'left' Tamaño de posición 'size' | 1. Usando el campo de cabecera X-Gate-Size-Decimal=1 , el tipo de los campos anteriores pasará de Integer a String . 2. Los clientes deben ajustar el tipo de aceptación para estos campos. |
| Privado | 1. Colocación de órdenes futures.order_place 2. Colocación de órdenes por lotes futures.order_batch_place 3. Cancelación de órdenes futures.order_cancel 4. Cancelación por lotes por ID futures.order_cancel_cp 5. Modificación de órdenes futures.order_amend 6. Consultar lista de órdenes futures.order_list 7. Consultar detalles de la orden futures.order_status | Tamaño de la orden 'size' Cantidad restante operable 'left' Cantidad de visualización de iceberg 'iceberg' | |

### 1.4 Consulta de información de futuros con soporte para órdenes decimales

1. Establezca la cabecera X-Gate-Size-Decimal=1
2. Realice la solicitud al endpoint de información de contratos

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

3. Campo de respuesta order_size_min: Si el valor es decimal, indica que el futuro correspondiente admite órdenes decimales.

### 1.5 Información adicional

Registro de actualizaciones de la API: https://www.gate.com/es/docs/developers/apiv4/en/#changelog
Para cualquier consulta, contacte con el soporte técnico de la API o consulte la documentación de la API. Gracias por su apoyo y comprensión.

<sp>
Equipo de Gate
18 de diciembre de 2025
<sp>
**Gateway to Crypto**
Opere de forma segura, rápida y sencilla más de %Amount_of_Currency% criptomonedas en Gate
**Actúe ahora**
<a href="https://www.gate.com/es/signup" target="_blank">Regístrese</a> y obtenga hasta 10 000 $ en recompensas de bienvenida
<a href="https://www.gate.com/es/referral" target="_blank">Invite a sus amigos</a> y gane una comisión del 40 %
**Manténgase informado**
<a href="https://www.gate.com/es/" target="_blank">Visite el sitio web oficial de Gate</a>
<a href="https://www.gate.com/es/mobileapp?ch=ann48788" target="_blank">Descargue la app de Gate | Escritorio</a>
<a href="https://x.com/Gate" rel="nofollow noopener noreferrer" target="_blank">Síganos en X (Twitter)</a> para obtener más bonificaciones
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Únase a nuestra comunidad en Telegram</a> para debatir temas de actualidad
<a href="https://www.gate.com/es/community" target="_blank">Participe en nuestra comunidad global</a> para conocer las últimas novedades
**Transparencia y seguridad**
<a href="https://www.gate.com/es/proof-of-reserves" target="_blank">Consulte nuestra prueba de reservas al 100 %</a>

Nota：Esta es una traducción automática o humana del texto original en inglés, por lo que puede haber imprecisiones en la traducción. Haga clic aquí para ver el texto original en inglés.

Cambio y periodo de inicio y fin del gráfico

Color de subida/bajada

Paga con

Anuncio de Gate sobre los cambios en el tipo de campo de cantidad de órdenes en Contratos Perpetuos USDT y plan de implementación de nuevas funciones

Anuncio de Gate sobre los cambios en el tipo de campo de cantidad de órdenes en Contratos Perpetuos USDT y plan de implementación de nuevas funciones

Seleccionar idioma y región

Selecciona tu región

Monedas fiduciarias