Anuncio de Gate sobre cambios en el tipo de campo de cantidad de orden en el contrato perpetuo USDT y plan de implementación de nuevas funciones

Cambios en los tipos de campo relacionados con el tamaño en Futuros
Para mejorar la flexibilidad del trading de futuros y ofrecer soporte completo a las órdenes con cantidad fraccionaria, Gate implementará una actualización por fases en las APIs de contratos perpetuos USDT. Esta actualización afectará a la lógica de análisis de los campos relacionados con la cantidad (tamaño) de las órdenes tanto en la REST API como en WebSocket. Se recomienda evaluar y ajustar la lógica de sus estrategias con antelación según el 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 ha modificado 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. Incluyendo 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.

Parámetro de cabecera	Descripción	Observaciones
X-Gate-Size-Decimal = 1	Los tipos de campo relacionados con el tamaño pasan de Integer a String	1. Soporta recepción de datos decimales.
X-Gate-Size-Decimal = 0 O, si no se utiliza este campo de cabecera Por defecto, este campo no se utiliza.	Los tipos de campo relacionados con el tamaño permanecen como Integer	1. No soporta recepción de datos decimales. 2. Gestión de precisión: trunca hacia cero (a la baja).

• 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 con cantidad fraccionaria

1. La capacidad del sistema para órdenes con lotes fraccionarios en los contratos perpetuos USDT está prevista para el 30 de diciembre de 2025. Durante esta fase, solo se habilitarán las capacidades subyacentes del sistema y el soporte en la API. No se habilitarán contratos de forma práctica para órdenes con lotes fraccionarios en este momento, y las reglas reales de colocación de órdenes para los usuarios no cambiarán.

2. A partir de finales de enero de 2026, la funcionalidad de órdenes con lotes fraccionarios se implementará gradualmente en los contratos. Los contratos específicos y los plazos de despliegue se anunciarán en comunicados posteriores de la plataforma.

3. Para los usuarios que sigan utilizando el tipo de campo antiguo sin adaptación, pueden producirse los siguientes problemas:

• Análisis anómalo de la precisión en los datos de profundidad de contrato.
• 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 finalizar enero de 2026.

3. Fase 3: Activación total para todos los contratos perpetuos con margen en USDT 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 con lotes fraccionarios.
2. En un momento determinado, el sistema devolverá por defecto el tipo String y ajustará el valor por defecto de la cabecera (X-Gate-Size-Decimal), cambiando el comportamiento de análisis por defecto de 0 a 1 para ofrecer un breve periodo de transición a los usuarios que no hayan completado la adaptación.
3. Tras el periodo de transición, la cabecera X-Gate-Size-Decimal quedará oficialmente obsoleta y su configuración dejará de tener efecto.
4. Todos los campos relacionados con la cantidad de órdenes utilizarán de forma unificada el tipo String, garantizando precisión y compatibilidad. El tipo Integer dejará de estar soportado.
5. La fecha de entrada en vigor concreta se anunciará previamente mediante aviso oficial. Por favor, asegúrese de completar todas las adaptaciones con antelación.

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

1. Tanto las APIs 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.

Parámetro de cabecera	Descripción	Observaciones
X-Gate-Size-Decimal = 1	Los tipos de campo relacionados con el tamaño pasan de Integer a String	1. Soporta recepción de datos decimales.
X-Gate-Size-Decimal = 0 O, si no se utiliza este campo de cabecera Por defecto, este campo no se utiliza.	Los tipos de campo relacionados con el tamaño permanecen como Integer	1. No soporta recepción de datos decimales. 2. Gestión de precisión: trunca hacia cero (a la baja).

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

2. Ejemplo de referencia para la configuración de la cabecera

Rest

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

# Configurar 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 acumulado histórico de trading 'trade_size' Tamaño total actual de la posición larga 'position_size'	1. Usando la cabecera X-Gate-Size-Decimal=1 , el tipo de los campos anteriores cambiará de Integer a String . 2. Los clientes deben ajustar el tipo de aceptación para estos campos.
Pública	1. Consultar profundidad de mercado de futuros GET /futures/settle/order_book	Size 's'
Pública	1. Registros de operaciones de mercado de futuros GET /futures/settle/trades	Tamaño de operación 'size'
Pública	1. Gráfico K-line de mercado de futuros GET /futures/settle/candlesticks	volumen de size (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 posiciones largas/cortas de trader top 'top_lsr_size' Tamaño de posición larga de trader top 'top_long_size' Tamaño de posición corta de trader top 'top_short_size' Tamaño de posición larga de taker top 'long_taker_size' Tamaño de posición corta de taker top 'short_taker_size'
Pública	1. Consultar historial de órdenes de liquidación GET /futures/settle/liq_orders	Tamaño de la posición 'size' Precio de la orden de liquidación 'order_size' Tamaño de maker de la 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 la 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 la posición 'size'
Privada	1. Realizar orden de futuros POST /futures/settle/orders 2. Consultar lista de órdenes de futuros GET /futures/settle/orders 1. Cancelar todas las órdenes con estado 'open' DELETE /futures/settle/orders 2. Consultar lista de órdenes de futuros por rango de tiempo GET /futures/settle/orders_timerange 3. Realizar órdenes de futuros por lotes POST /futures/settle/batch_orders 4. Consultar detalles de una orden GET /futures/settle/orders/order_id 5. Cancelar una orden DELETE /futures/settle/orders/order_id 6. Modificar una orden PUT /futures/settle/orders/order_id 7. Realizar orden BBO por niveles POST /futures/settle/bbo_orders	Cantidad de trading. '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 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 la posición 'size' Tamaño pendiente de orden de liquidación 'left'
Privada	1. Consultar información de órdenes ADL desapalancamiento automático GET /futures/settle/auto_deleverages	Tamaño de 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 la cabecera X-Gate-Size-Decimal=1 , el tipo de los campos anteriores cambiará de Integer a String . 2. Los clientes deben ajustar el tipo de aceptación para estos campos.
Público	1. Canal ticker futures.tickers	Tamaño total 'total_size'
Público	1. Canal BBO futures.book_ticker	Mejor tamaño de oferta 'A' Mejor tamaño de demanda 'B'
Público	1. Canal de actualización de profundidad futures.order_book_update	Tamaño pendiente lado oferta 'a.s' Tamaño pendiente lado demanda 'b.s'
Público	1. Canal de profundidad completa futures.order_book	Tamaño pendiente lado oferta a.s Tamaño pendiente lado demanda 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 de liquidaciones públicas 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' Tamaño restante operable 'left' Tamaño de la orden 'size'
Privado	1. Canal de operaciones privadas futures.usertrades	Tamaño ejecutado 'size'
Privado	1. Canal ADL privado futures.auto_deleverages	Tamaño de posición 'position_size' Tamaño de operación 'trade_size'
Privado	1. Canal de posiciones futures.positions	Tamaño de posición 'size'
Privado	1. Canal de órdenes automáticas 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	Tamaño restante operable 'left' Tamaño de posición 'size'	1. Usando la cabecera X-Gate-Size-Decimal=1 , el tipo de los campos anteriores cambiará de Integer a String . 2. Los clientes deben ajustar el tipo de aceptación para estos campos.
Privado	1. Realización de órdenes futures.order_place 2. Realizació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. Consulta de lista de órdenes futures.order_list 7. Consulta de detalles de orden futures.order_status	Tamaño de la orden 'size' Tamaño restante operable 'left' Cantidad de visualización de iceberg 'iceberg'

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

1. Establecer la cabecera X-Gate-Size-Decimal=1
2. Realizar 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, significa que el futuro correspondiente admite órdenes con tamaño decimal.

1.5 Información adicional

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

Equipo de Gate 18 de diciembre de 2025 **Gateway to Crypto** Opere con más de 4,400 criptomonedas de forma segura, rápida y sencilla en Gate **Actúe ahora** Regístrese y reclame hasta 10 000 $ en recompensas de bienvenida Invite a sus amigos y obtenga una comisión del 40 % **Manténgase conectado** Visite la web oficial de Gate Descargue la aplicación de Gate | Escritorio Síganos en X (Twitter) para recibir más bonificaciones Únase a nuestra comunidad en Telegram para debatir sobre temas de actualidad Participe en nuestra comunidad global para acceder a las últimas novedades **Transparencia y seguridad** Consulte nuestra prueba de reservas 100 %