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é.
| 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, sans utilisation 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 Integer |
1. Ne prend pas en charge les données décimales.
2. Gestion de la précision – Troncature vers zéro (vers le bas). |
- 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
-
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.
-
À 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.
-
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
- Toutes les paires de trading de contrats prendront en charge le placement d’ordres de lots fractionnaires.
- À 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.
- 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.
- 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.
- 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é.
| 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, sans utilisation 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 Integer |
1. Ne prend pas en charge les données décimales.
2. Gestion de la précision – Troncature vers zéro (vers le bas). |
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
Équipe Gate
18 décembre 2025
**Gateway to Crypto**
Tradez plus de 4,500 cryptomonnaies en toute sécurité, rapidement et facilement sur Gate
**Agir dès maintenant**
S'inscrire et récupérer jusqu'à 10 000 $ de récompenses de bienvenue
Inviter des amis et gagner une commission de 40 %
**Restez connecté**
Visiter le site officiel de Gate
Télécharger l'App Gate | Desktop
Suivez-nous sur X (Twitter) pour obtenir plus de bonus
Rejoindre notre communauté Telegram pour discuter des sujets tendances
Échanger avec notre communauté mondiale pour les dernières analyses
**Transparence & Sécurité**
Consulter notre preuve de réserves 100 %
