Annonces Annonce de Gate concernant la modification du type de champ de quantité des ordres sur les contrats perpétuels USDT et le plan de déploiement des nouvelles fonctionnalités

Annonce de Gate concernant la modification du type de champ de quantité des ordres sur les contrats perpétuels USDT et le plan de déploiement des nouvelles fonctionnalités

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

[//]:content-type-MARKDOWN-DONOT-DELETE
**Modifications des types de champs liés à la taille des Futures**
Afin d’améliorer la flexibilité du trading de futures et de prendre en charge pleinement les ordres de quantité fractionnaire, Gate procédera à une mise à niveau progressive des API de contrats perpétuels USDT. Cette mise à niveau affectera la logique de traitement des champs liés à la quantité (taille) des ordres dans les API REST et WebSocket. Veuillez évaluer et ajuster à l’avance la logique de votre stratégie conformément au plan de migration afin d’assurer 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 (lancée le 9 décembre 2025)**

- Ajustements terminés de la structure de données sous-jacente.
- Modification du type de données des champs liés à la quantité de contrat, passant 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 de contrat est assuré.

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

**2. Phase 2 : Mise en service de la capacité d’ordre de quantité fractionnaire**

1. La capacité du système pour le placement d’ordres de lots fractionnaires sur les contrats perpétuels USDT est prévue pour le 30 décembre 2025. Durant cette phase, seules les capacités système sous-jacentes et le support API seront activés. Aucun contrat ne sera ouvert à ce stade pour le placement d’ordres de lots fractionnaires et les règles de placement d’ordres pour les utilisateurs resteront inchangées.

2. À partir de fin janvier 2026, la fonctionnalité de placement d’ordres de lots fractionnaires sera progressivement déployée sur les contrats. Les contrats concernés et le calendrier de déploiement seront annoncés ultérieurement par la plateforme.

3. Pour les utilisateurs utilisant encore l’ancien type de champ sans adaptation, les problèmes suivants peuvent survenir :
* Analyse de précision anormale dans les données de profondeur de contrat.
* Précision d’ordre incohérente.
* Précision anormale dans les ordres exécutés.

***Par conséquent, il est rappelé à tous les utilisateurs d’API de procéder à l’adaptation des types de champs d’ici fin janvier 2026.***

**3. Phase 3 : Activation complète pour tous les contrats perpétuels USDT-M et migration obligatoire vers les types de champs String**

1. Toutes les paires de trading de contrats prendront en charge le placement d’ordres de lots fractionnaires.
2. À une date spécifié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), basculant le comportement de traitement par défaut de 0 à 1 pour offrir une courte période de transition aux utilisateurs n’ayant pas encore effectué l’adaptation.
3. Après 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é d’ordre utiliseront uniformément le type String afin d’assurer précision et compatibilité. Le type Integer hérité ne sera plus pris en charge.
5. La date d’entrée en vigueur spécifique sera annoncée à l’avance via une communication officielle. Veuillez vous assurer que toutes les adaptations sont effectuées avant cette échéance.

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

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

Recommandation : Les clients doivent adapter rapidement le type de champ de quantité de contrat. Dès que le contrat prendra officiellement en charge le placement d’ordres de quantité fractionnaire, ils pourront profiter rapidement 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 de taille

**1. Champs liés à Rest**

| Type d’interface | Endpoint | Champ | Remarques |
| :--- | :--- | :--- | :--- |
| Public | 1. Rechercher toutes les informations sur les Futures GET /futures/settle/contracts 2. Rechercher une information sur un 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 de position long 'position_size' | 1. En utilisant le champ d’en-tête X-Gate-Size-Decimal=1 , le type des champs ci-dessus passera de Integer à String . 2. Les clients doivent adapter le type d’acceptation de ces champs. |
| Public | 1. Rechercher des informations de profondeur de marché Futures GET /futures/settle/order_book | Taille 's' | |
| Public | 1. Enregistrements de transactions de marché Futures GET /futures/settle/trades | Taille de trading 'size' | |
| Public | 1. Graphique K-line de marché Futures GET /futures/settle/candlesticks | volume size (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 d’intérêt ouvert (contrats) 'open_interest' Ratio de position long/short Top Trader 'top_lsr_size' Taille long Top Trader 'top_long_size' Taille short Top Trader 'top_short_size' Taille long Top Taker 'long_taker_size' Taille short Top Taker 'short_taker_size' | |
| Public | 1. Rechercher l’historique des ordres de liquidation GET /futures/settle/liq_orders | Taille de position 'size' Prix de l’ordre de liquidation 'order_size' Taille du maker d’ordre de liquidation système 'left' | |
| Privé | 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 position POST /futures/settle/positions/contract/leverage 5. Basculer le mode de marge de position POST /futures/settle/positions/cross_mode 6. Basculer entre les modes de marge croisée et isolée en mode Hedge POST /futures/settle/dual_comp/positions/cross_mode 7. Mettre à jour la limite de risque de 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 mode Hedge GET /futures/settle/dual_comp/positions/contract 10. Mettre à jour la marge de position en mode Hedge POST /futures/settle/dual_comp/positions/contract/margin 11. Mettre à jour l’effet de levier de position en mode Hedge POST /futures/settle/dual_comp/positions/contract/leverage 12. Mettre à jour la limite de risque de position en mode Hedge POST /futures/settle/dual_comp/positions/contract/risk_limit | Taille de position 'size' | |
| Privé | 1. Placer un ordre Futures POST /futures/settle/orders 2. Rechercher la liste des ordres Futures GET /futures/settle/orders 3. Annuler tous les ordres avec statut 'open' DELETE /futures/settle/orders 4. Rechercher la liste des ordres Futures par intervalle de temps GET /futures/settle/orders_timerange 5. Placer des ordres Futures en lot POST /futures/settle/batch_orders 6. Rechercher les détails d’un ordre GET /futures/settle/orders/order_id 7. Annuler un ordre DELETE /futures/settle/orders/order_id 8. Modifier un ordre PUT /futures/settle/orders/order_id 9. Placement d’ordre BBO par niveau de contrat POST /futures/settle/bbo_orders | Quantité de trading. 'size' Taille d’affichage des ordres iceberg 'iceberg' Quantité non exécutée 'left' | |
| Privé | 1. Rechercher les enregistrements de trading personnels GET /futures/settle/my_trades 2. Rechercher les enregistrements de trading personnels par intervalle de temps GET /futures/settle/my_trades_timerange | Taille de trading 'size' Taille des positions fermées : 'close_size' | |
| Privé | 1. Rechercher l’historique des fermetures de position GET /futures/settle/position_close | Taille maximale de trading 'max_size' Volume cumulé de positions fermées 'accum_size' | |
| Privé | 1. Rechercher l’historique de liquidation GET /futures/settle/liquidates | Taille de position 'size' Taille en attente de l’ordre de liquidation 'left' | |
| Privé | 1. Rechercher les informations d’ordre ADL désendettement automatique GET /futures/settle/auto_deleverges | Taille de trading 'trade_size' Taille de position après ADL 'position_size' | |
| Privé | 1. Rechercher la liste des ordres automatiques GET /futures/settle/price_orders 2. Annuler tous les ordres automatiques DELETE /futures/settle/price_orders 3. Rechercher 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. Le champ d’origine size (int ) et le nouveau champ amount (string) seront compatibles. |

**2. Champs liés à Websocket**

| Type de canal | Canal | Champs | Remarques |
| :--- | :--- | :--- | :--- |
| Public | 1. Canal de transactions publiques futures.trades | Taille exécutée 'size' | 1. En utilisant le champ d’en-tête X-Gate-Size-Decimal=1 , le type des champs ci-dessus passera de Integer à String . 2. Les clients doivent adapter le type d’acceptation de ces champs. |
| Public | 1. Canal ticker futures.tickers | Taille totale 'total_size' | |
| Public | 1. Canal BBO futures.book_ticker | Taille de la meilleure demande 'A' Taille de la meilleure offre 'B' | |
| Public | 1. Canal de mise à jour de profondeur futures.order_book_update | Taille en attente côté offre 'a.s' Taille en attente côté demande '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é demande b.s | |
| Public | 1. Canal Depth V2 futures.obu | [price,size] 'size' Peut pousser une taille décimale | |
| Public | 1. Canal de chandeliers futures.candlesticks | Volume 'v' | |
| Public | 1. Canal de liquidations publiques futures.public_liquidates | Taille de l’ordre de liquidation 'size' | |
| Public | 1. Canal de statistiques de contrat futures.contract_stats | Taille de liquidation long 'long_liq_size' Taille de liquidation short 'short_liq_size' Intérêt ouvert total 'open_interest' | |
| Privé | 1. Canal d’ordres privés futures.orders | Taille d’affichage iceberg 'iceberg' Taille tradable restante 'left' Taille de l’ordre 'size' | |
| Privé | 1. Canal de trades privés futures.usertrades | Taille exécutée 'size' | |
| Privé | 1. Canal ADL privé futures.auto_deleverages | Taille de position 'position_size' Taille de trading 'trade_size' | |
| Privé | 1. Canal des positions futures.positions | Taille de position 'size' | |
| Privé | 1. Canal des ordres à déclenchement de prix futures.autoorders | Nouveau champ : 'amount' (type string). | 1. Nouveau champ : amount (type string). 2. Le champ d’origine size ( type Integer ) et le nouveau champ amount (String) seront compatibles. |
| Privé | 1. Canal des ordres de liquidation futures.liquidates | Taille tradable restante 'left' Taille de position 'size' | 1. En utilisant le champ d’en-tête X-Gate-Size-Decimal=1 , le type des champs ci-dessus passera de Integer à String . 2. Les clients doivent adapter le type d’acceptation de ces champs. |
| Privé | 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. Rechercher la liste des ordres futures.order_list 7. Rechercher les détails d’un ordre futures.order_status | Taille de l’ordre 'size' Taille tradable restante 'left' Quantité d’affichage iceberg 'iceberg' | |

### 1.4 Recherche d’informations sur les Futures prenant en charge le placement d’ordres décimaux

1.Définir l’en-tête X-Gate-Size-Decimal=1
2.Appeler l’endpoint d’information sur le contrat

```
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 un nombre décimal, cela indique que le Future correspondant prend en charge le placement 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

<sp>
Équipe Gate
18 décembre 2025
<sp>
**Gateway to Crypto**
Tradez plus de %Amount_of_Currency% cryptomonnaies en toute sécurité, rapidement et facilement sur Gate
**Agir dès maintenant**
<a href="https://www.gate.com/fr/signup" target="_blank">S'inscrire</a> et récupérer jusqu'à 10 000 $ de récompenses de bienvenue
<a href="https://www.gate.com/fr/referral" target="_blank">Inviter des amis</a> et gagner une commission de 40 %
**Restez connecté**
<a href="https://www.gate.com/fr/" target="_blank">Visiter le site officiel de Gate</a>
<a href="https://www.gate.com/fr/mobileapp?ch=ann48788" target="_blank">Télécharger l'App Gate | Desktop</a>
<a href="https://x.com/Gate" rel="nofollow noopener noreferrer" target="_blank">Suivez-nous sur X (Twitter)</a> pour obtenir plus de bonus
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Rejoindre notre communauté Telegram</a> pour discuter des sujets tendances
<a href="https://www.gate.com/fr/community" target="_blank">Échanger avec notre communauté mondiale</a> pour les dernières analyses
**Transparence & Sécurité**
<a href="https://www.gate.com/fr/proof-of-reserves" target="_blank">Consulter notre preuve de réserves 100 %</a>

Remarque：Il s'agit d'une traduction du texte initial anglais par une machine ou un humain, il peut donc y avoir des inexactitudes dans la traduction. Cliquez ici pour consulter le texte original en anglais.

Variation & période de référence du graphique

Couleur de hausse/de baisse

Payer avec

Annonce de Gate concernant la modification du type de champ de quantité des ordres sur les contrats perpétuels USDT et le plan de déploiement des nouvelles fonctionnalités

Annonce de Gate concernant la modification du type de champ de quantité des ordres sur les contrats perpétuels USDT et le plan de déploiement des nouvelles fonctionnalités

Sélectionner la langue et la région

Sélectionnez votre région

Monnaies fiat