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

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.

Parámetro de cabecera	Descripción	Observaciones
X-Gate-Size-Decimal = 1	los tipos de campos relacionados con el tamaño pasan de Integer a String	1. Admite la recepción de datos decimales.
X-Gate-Size-Decimal = 0 O no utilizar este campo de cabecera Por defecto, este campo no se utiliza.	los tipos de campos relacionados con el tamaño permanecen como Integer	1. No admite la 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 de cantidad fraccionaria

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

Todos los pares de trading de contratos admitirán plenamente la colocación de órdenes de lotes fraccionarios.
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.
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.
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.
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

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.

Parámetro de cabecera	Descripción	Observaciones
X-Gate-Size-Decimal = 1	los tipos de campos relacionados con el tamaño pasan de Integer a String	1. Admite la recepción de datos decimales.
X-Gate-Size-Decimal = 0 O no utilizar este campo de cabecera Por defecto, este campo no se utiliza.	los tipos de campos relacionados con el tamaño permanecen como Integer	1. No admite la 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 de cantidad fraccionaria, podrán experimentar y utilizar esta funcionalidad rápidamente.

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

Establezca la cabecera X-Gate-Size-Decimal=1
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'

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.

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