Annonce Gate concernant l’évolution du type de champ de quantité des ordres sur les contrats USDT Perp et le plan de déploiement des nouvelles fonctionnalités

Modifications des types de champs liés à la taille des contrats Futures
Afin d’améliorer la flexibilité du trading sur contrats à terme et de prendre pleinement en charge les ordres à quantité fractionnaire, Gate procédera à une mise à niveau progressive des API de contrats perpétuels USDT. Cette mise à niveau impactera la logique d’analyse des champs relatifs à la quantité (taille) des ordres dans les API REST et WebSocket. Nous vous invitons à évaluer et à ajuster à l’avance la logique de votre stratégie conformément au plan de transition afin de garantir la continuité de votre activité de trading.

1.1 Aperçu du plan de mise à niveau (divisé en 3 phases)

1. Phase 1 : Mise à niveau de la compatibilité des types de champs (déployée le 9 décembre 2025)

• Ajustements structurels des données sous-jacentes réalisés.
• Modification du type de données des champs liés à la quantité des contrats : passage d’Integer à String.
• Le système est actuellement en mode de compatibilité. En incluant le champ X-Gate-Size-Decimal dans l’en-tête de la requête, le traitement de compatibilité pour le champ de quantité de lot des contrats est assuré.

Paramètre d’en-tête	Description	Remarques
X-Gate-Size-Decimal = 1	Les types de champs liés à la taille passent d’Integer à String	1. Prise en charge des données décimales.
X-Gate-Size-Decimal = 0 Ou, en l’absence de ce champ d’en-tête Par défaut, ce champ n’est pas utilisé.	Les types de champs liés à la taille restent en Integer	1. Ne prend pas en charge les données décimales. 2. Gestion de la précision - Troncature vers zéro (à la baisse).

• Si l’en-tête X-Gate-Size-Decimal n’est pas défini, le champ size continuera par défaut à accepter et à retourner le type Integer.

2. Phase 2 : Activation de la capacité de passage d’ordres à quantité fractionnaire

1. La fonctionnalité système permettant le passage d’ordres à lot fractionnaire sur les contrats perpétuels USDT sera activée le 30 décembre 2025. Durant cette phase, seules les capacités système et le support API seront ouverts. Aucun contrat ne sera effectivement disponible pour le passage d’ordres à lot fractionnaire à ce stade, et les règles de placement d’ordres pour les utilisateurs resteront inchangées.

2. À partir de fin janvier 2026, la fonctionnalité de passage d’ordres à lot fractionnaire sera progressivement déployée sur les contrats. Les contrats concernés et le calendrier de déploiement seront communiqués ultérieurement par la plateforme.

3. Les utilisateurs continuant d’utiliser l’ancien type de champ sans adaptation risquent de rencontrer les problèmes suivants :

• Analyse de précision anormale dans les données de profondeur du contrat.
• Précision incohérente des ordres.
• Précision anormale dans les ordres exécutés.

En conséquence, il est recommandé à tous les utilisateurs d’API de finaliser l’adaptation des types de champs avant la fin janvier 2026.

3. Phase 3 : Activation complète sur tous les contrats perpétuels USDT-M et migration obligatoire vers le type String

1. Toutes les paires de trading de contrats prendront en charge le passage d’ordres à lot fractionnaire.
2. À une date précisée, le système retournera par défaut le type String et ajustera la valeur par défaut de l’en-tête (X-Gate-Size-Decimal), passant le comportement d’analyse par défaut de 0 à 1, offrant une courte période de transition aux utilisateurs n’ayant pas encore adapté leur système.
3. À l’issue de la période de transition, le champ d’en-tête X-Gate-Size-Decimal sera officiellement obsolète et sa configuration ne sera plus prise en compte.
4. Tous les champs liés à la quantité des ordres utiliseront uniformément le type String afin de garantir précision et compatibilité. Le type Integer historique ne sera plus pris en charge.
5. La date d’entrée en vigueur sera communiquée à l’avance via une annonce officielle. Veuillez vous assurer que toutes les adaptations nécessaires soient réalisées en amont.

1.2 Explication détaillée de la mise à niveau de la phase 1

1. Les API REST et WebSocket intègrent un nouveau champ d’en-tête, X-Gate-Size-Decimal, permettant de contrôler la précision des champs liés à la quantité.

Paramètre d’en-tête	Description	Remarques
X-Gate-Size-Decimal = 1	Les types de champs liés à la taille passent d’Integer à String	1. Prise en charge des données décimales.
X-Gate-Size-Decimal = 0 Ou, en l’absence de ce champ d’en-tête Par défaut, ce champ n’est pas utilisé.	Les types de champs liés à la taille restent en Integer	1. Ne prend pas en charge les données décimales. 2. Gestion de la précision - Troncature vers zéro (à la baisse).

Recommandation : Les clients sont invités à adapter rapidement le type de champ de quantité des contrats. Dès que les contrats prendront officiellement en charge le passage d’ordres à quantité fractionnaire, ils pourront bénéficier immédiatement de cette fonctionnalité.

2. Exemple de référence pour la configuration de l’en-tête

Rest

# Définir les en-têtes de requête 
headers = 
{ 
'KEY': API_KEY,
'Timestamp': timestamp,
'SIGN': signature,
# Activer la taille décimale
'X-Gate-Size-Decimal': '1',
'Content-Type': 'application/json',
'Accept': 'application/json'
}

Websocket

# Définir les en-têtes de requête
# Activer la taille décimale
headers['X-Gate-Size-Decimal'] = '1'

1.3 Modifications futures des types de champs liés à la taille

1. Champs liés à Rest

Type d’interface	Endpoint	Champ	Remarques
Public	1. Interroger toutes les informations sur les Futures GET /futures/settle/contracts 2. Interroger les informations d’un seul Future GET /futures/settle/contracts/contract	Taille minimale d’ordre autorisée par le contrat 'order_size_min' Taille maximale d’ordre autorisée par le contrat 'order_size_max' Volume cumulé historique de trading 'trade_size' Taille totale actuelle des positions Long 'position_size'	1. Avec le champ d’en-tête X-Gate-Size-Decimal=1 , le type des champs ci-dessus passera de Integer à String . 2. Les clients devront adapter le type d’acceptation pour ces champs.
Public	1. Interroger la profondeur du marché Futures GET /futures/settle/order_book	Taille 's'
Public	1. Historique des transactions du marché Futures GET /futures/settle/trades	Taille de trading 'size'
Public	1. Graphique K-line du marché Futures GET /futures/settle/candlesticks	volume de taille (taille du contrat) 'v'
Public	1. Statistiques Futures GET /futures/settle/contract_stats	Taille de liquidation Long (contrats) 'long_liq_size' Taille de liquidation Short (contrats) 'short_liq_size' Taille totale de l’Open Interest (contrats) 'open_interest' Ratio de position Long/Short des Top Trader 'top_lsr_size' Taille Long des Top Trader 'top_long_size' Taille Short des Top Trader 'top_short_size' Taille Long des Top Taker 'long_taker_size' Taille Short des Top Taker 'short_taker_size'
Public	1. Interroger l’historique des ordres de liquidation GET /futures/settle/liq_orders	Taille de position 'size' Prix de l’ordre de liquidation 'order_size' Taille Maker de l’ordre de liquidation système 'left'
Private	1. Obtenir la liste des positions utilisateur GET /futures/settle/positions 2. Obtenir les informations d’une position GET /futures/settle/positions/contract 3. Mettre à jour la marge de position POST /futures/settle/positions/contract/margin 4. Mettre à jour l’effet de levier de la position POST /futures/settle/positions/contract/leverage 5. Basculer le mode Marge de position POST /futures/settle/positions/cross_mode 6. Basculer entre les modes Croisé et Isolé en Hedge Mode POST /futures/settle/dual_comp/positions/cross_mode 7. Mettre à jour la limite de risque de la position POST /futures/settle/positions/contract/risk_limit 8. Définir le mode de position POST /futures/settle/dual_mode 9. Obtenir les informations de position en Hedge Mode GET /futures/settle/dual_comp/positions/contract 10. Mettre à jour la marge de position en Hedge Mode POST /futures/settle/dual_comp/positions/contract/margin 11. Mettre à jour l’effet de levier de la position en Hedge Mode POST /futures/settle/dual_comp/positions/contract/leverage 12. Mettre à jour la limite de risque de la position en Hedge Mode POST /futures/settle/dual_comp/positions/contract/risk_limit	Taille de position 'size'
Private	1. Passer un ordre Futures POST /futures/settle/orders 2. Interroger la liste des ordres Futures GET /futures/settle/orders 1. Annuler tous les ordres avec statut 'open' DELETE /futures/settle/orders 2. Interroger la liste des ordres Futures par plage de temps GET /futures/settle/orders_timerange 3. Passer des ordres Futures en lot POST /futures/settle/batch_orders 4. Interroger les détails d’un ordre GET /futures/settle/orders/order_id 5. Annuler un ordre DELETE /futures/settle/orders/order_id 6. Modifier un ordre PUT /futures/settle/orders/order_id 7. Placement d’ordre BBO par niveau POST /futures/settle/bbo_orders	Quantité de trading. 'size' Taille affichée pour les ordres iceberg 'iceberg' Quantité non exécutée 'left'
Private	1. Interroger l’historique des transactions personnelles GET /futures/settle/my_trades 2. Interroger l’historique des transactions personnelles par plage de temps GET /futures/settle/my_trades_timerange	Taille de trading 'size' Taille des positions clôturées : 'close_size'
Private	1. Interroger l’historique des clôtures de position GET /futures/settle/position_close	Taille maximale de trading 'max_size' Volume cumulé des positions clôturées 'accum_size'
Private	1. Interroger l’historique des liquidations GET /futures/settle/liquidates	Taille de position 'size' Taille en attente de l’ordre de liquidation 'left'
Private	1. Interroger les informations d’ordre ADL auto-deleveraging GET /futures/settle/auto_deleverages	Taille de trading 'trade_size' Taille de position après ADL 'position_size'
Private	1. Interroger la liste des ordres automatiques GET /futures/settle/price_orders 2. Annuler tous les ordres automatiques DELETE /futures/settle/price_orders 3. Interroger les détails d’un ordre automatique GET /futures/settle/price_orders/order_id 4. Annuler un ordre automatique DELETE /futures/settle/price_orders/order_id 5. Modifier un ordre automatique PUT /futures/settle/price_orders/order_id	Nouveau champ : 'amount' (type string).	1. Nouveau champ : amount (type string). 2. L’ancien champ size (int) et le nouveau champ amount (string) seront compatibles.

2. Champs liés à Websocket

Type de canal	Canal	Champs	Remarques
Public	1. Canal des transactions publiques futures.trades	Taille exécutée 'size'	1. Avec le champ d’en-tête X-Gate-Size-Decimal=1 , le type des champs ci-dessus passera de Integer à String . 2. Les clients devront adapter le type d’acceptation pour ces champs.
Public	1. Canal ticker futures.tickers	Taille totale 'total_size'
Public	1. Canal BBO futures.book_ticker	Taille de la meilleure enchère 'A' Taille de la meilleure offre 'B'
Public	1. Canal de mise à jour de la profondeur futures.order_book_update	Taille en attente côté offre 'a.s' Taille en attente côté enchère 'b.s'
Public	1. Canal de profondeur complète futures.order_book	Taille en attente côté offre a.s Taille en attente côté enchère b.s
Public	1. Canal Depth V2 futures.obu	[prix, taille] 'size' Peut transmettre une taille décimale
Public	1. Canal candlestick futures.candlesticks	Volume 'v'
Public	1. Canal des liquidations publiques futures.public_liquidates	Taille de l’ordre de liquidation 'size'
Public	1. Canal statistiques du contrat futures.contract_stats	Taille de liquidation Long 'long_liq_size' Taille de liquidation Short 'short_liq_size' Open Interest total 'open_interest'
Private	1. Canal des ordres privés futures.orders	Taille affichée iceberg 'iceberg' Taille tradable restante 'left' Taille de l’ordre 'size'
Private	1. Canal des transactions privées futures.usertrades	Taille exécutée 'size'
Private	1. Canal ADL privé futures.auto_deleverages	Taille de position 'position_size' Taille de trading 'trade_size'
Private	1. Canal des positions futures.positions	Taille de position 'size'
Private	1. Canal des ordres déclencheurs de prix futures.autoorders	Nouveau champ : 'amount' (type string).	1. Nouveau champ : amount (type string). 2. L’ancien champ size ( type Integer ) et le nouveau champ amount (String) seront compatibles.
Private	1. Canal des ordres de liquidation futures.liquidates	Taille tradable restante 'left' Taille de position 'size'	1. Avec le champ d’en-tête X-Gate-Size-Decimal=1 , le type des champs ci-dessus passera de Integer à String . 2. Les clients devront adapter le type d’acceptation pour ces champs.
Private	1. Placement d’ordre futures.order_place 2. Placement d’ordres en lot futures.order_batch_place 3. Annulation d’ordre futures.order_cancel 4. Annulation en lot par ID futures.order_cancel_cp 5. Modification d’ordre futures.order_amend 6. Interroger la liste des ordres futures.order_list 7. Interroger les détails d’un ordre futures.order_status	Taille de l’ordre 'size' Taille tradable restante 'left' Quantité affichée iceberg 'iceberg'

1.4 Interrogation des informations sur les Futures prenant en charge le passage d’ordres décimaux

1. Définir l’en-tête X-Gate-Size-Decimal=1
2. Interroger l’endpoint d’informations sur les contrats

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

3. Champ retourné order_size_min : Si la valeur est décimale, cela indique que le contrat Futures concerné prend en charge le passage d’ordres décimaux.

1.5 Informations complémentaires

Journal des mises à jour API : https://www.gate.com/fr/docs/developers/apiv4/en/#changelog
Pour toute question, veuillez contacter le support technique API ou consulter la documentation API. Merci pour votre soutien et votre compréhension

Équipe Gate 18 Décembre 2025 **Gateway to Crypto** Échangez plus de 4,400 cryptomonnaies en toute sécurité, rapidement et facilement sur Gate **Passez à l’action** Inscrivez-vous et recevez jusqu’à 10 000 $ de récompenses de bienvenue Invitez des amis et gagnez une commission de 40 % **Restez connecté** Visitez le site officiel de Gate Téléchargez l’application Gate | Desktop Suivez-nous sur X (Twitter) pour obtenir plus de bonus Rejoignez notre communauté Telegram pour discuter des sujets tendances Participez à notre communauté mondiale pour les dernières analyses **Transparence & Sécurité** Consultez notre preuve de réserves à 100 %