Comment connecter Gate.io à ZeroLoss : configuration de la clé API
ZeroLoss trade les futures perpétuels USDT de Gate.io sur votre propre compte Gate.io. Il se connecte via une clé API que vous créez sur Gate.io, et non avec votre mot de passe, et cette clé n'a besoin que de l'autorisation de lire votre compte et de trader des futures. Votre argent reste sur Gate.io en permanence. Ce guide explique comment créer cette clé, la restreindre et la connecter à ZeroLoss. Comptez environ cinq minutes.
Vous voulez voir le bot trader avant de connecter quoi que ce soit ? Le test gratuit de 7 jours en paper trading ne nécessite aucune plateforme.
Avant de commencer
- Un compte Gate.io avec la vérification du compte effectuée, un mot de passe de fonds défini et l'authentification à deux facteurs activée. Gate demande ces trois éléments lors de la création d'une clé.
- Au moins 100 USDT sur votre compte de futures perpétuels USDT. Sur le web : Assets → Futures Account → Transfer, en choisissant USDT comme devise de marge. Dans l'application : l'icône Funds Transfer sur la page futures. Si votre compte utilise le mode Unified Account de Gate, aucun transfert n'est nécessaire.
- Un compte ZeroLoss. Vous pouvez commencer par le test gratuit en paper trading et connecter votre plateforme plus tard.
Étape 1 : créer la clé API sur Gate.io
- Connectez-vous sur le site de Gate.io, survolez l'icône de profil en haut à droite et ouvrez API Management (gestion des API).
- Choisissez de créer une API v4 Key. N'utilisez pas de clé API v2 : elle ne fonctionne qu'en spot.
- Choisissez le type Classic Account pour le trading réel. Les clés Testnet ne fonctionnent que sur le site de test de Gate.
- Donnez un nom à la clé, définissez les autorisations (étape 2) et la liste blanche d'IP (étape 3).
- Acceptez l'avertissement sur les risques, saisissez votre mot de passe de fonds et votre code 2FA, puis confirmez.
- Copiez l'API Key et la Secret Key et conservez-les en lieu sûr.
Étape 2 : choisir les permissions
Gate règle chaque groupe d'autorisations sur désactivé, lecture seule ou lecture-écriture :
- Perpetual contract : lecture-écriture. Cela permet à ZeroLoss de lire votre compte futures et de passer et annuler des ordres.
- Withdrawal : désactivé.
- Wallet : désactivé ou lecture seule. La lecture-écriture sur le portefeuille autorise les transferts de fonds, ce dont ZeroLoss n'a jamais besoin.
- Les contrats spot/marge et à livraison peuvent rester désactivés.
Étape 3 : limiter la clé aux adresses IP de ZeroLoss
Restreindre une clé à quelques adresses IP signifie qu'elle ne fonctionne que depuis ces serveurs, même si quelqu'un l'a copiée. Dans l'application ZeroLoss, ouvrez Connecter un exchange ; l'étape Ajouter nos IP liste les adresses des serveurs de ZeroLoss avec un bouton Tout copier. Collez-les dans le champ de restriction IP sur Gate.io.
Gate accepte jusqu'à 20 adresses IPv4 par clé (pas de plages). C'est plus important qu'il n'y paraît : une clé Gate v4 sans liste blanche d'IP est désactivée après 90 jours, et toute clé inutilisée pendant 90 jours est supprimée. Associer les adresses de ZeroLoss évite le premier problème.
Étape 4 : connecter la clé dans ZeroLoss
- Connectez-vous à ZeroLoss et ouvrez Connecter un exchange.
- Sous 1 · Pick your exchange, choisissez Gate.io.
- Sous 2 · Paste your API key, collez votre clé API et votre clé secrète.
- Cliquez sur Verify & connect. ZeroLoss vérifie la clé et lit votre solde futures. La connexion nécessite au moins 100 USDT sur votre compte futures USDT Gate.io.
Vérifier que la clé est sûre
Ouvrez la page de gestion des API sur Gate.io et examinez la clé que vous avez créée. Elle doit autoriser la lecture et le trading de futures, avec les retraits désactivés. Pour arrêter ZeroLoss à tout moment, supprimez la clé sur Gate.io ; le trading via cette clé s'arrête immédiatement, sans aucune intervention de notre part. Notre guide sur les clés API en trading seul explique pourquoi c'est ce réglage qui compte.
Problèmes fréquents
- La clé a cessé de fonctionner au bout d'environ trois mois : elle n'avait pas de liste blanche d'IP et Gate l'a désactivée après 90 jours. Associez les IP de ZeroLoss, ou créez une nouvelle clé avec celles-ci.
- Rien ne fonctionne avec une clé que vous venez de créer : vérifiez qu'il s'agit d'une clé v4 sur le Classic Account, et non d'une clé v2 ou Testnet.
- « Invalid API Key or Secret » : un caractère a été oublié lors de la copie. Copiez à nouveau les deux ; si la clé secrète n'a pas été enregistrée, supprimez la clé et créez-en une nouvelle.
- « API key missing required permissions » : le trading de futures ou la lecture n'est pas coché sur la clé. Modifiez la clé, ou créez-en une nouvelle avec les deux.
- « API IP restriction issue » : la clé est restreinte, mais pas à toutes les adresses de ZeroLoss. Utilisez Tout copier dans l'application et collez à nouveau la liste complète.
- « Minimum 100 USDT required in Futures wallet » : vos USDT se trouvent sur le compte spot, ou sur le compte futures à marge BTC. Transférez-les vers le compte de futures perpétuels USDT et réessayez.
Le trading de futures crypto comporte un risque élevé de perte, et l'automatisation ne le supprime pas. Les écrans des plateformes changent de temps en temps ; si un menu semble différent, ce sont les noms de permissions ci-dessus qu'il faut chercher. Cette page fournit des informations générales et ne constitue pas un conseil financier. Consultez notre Avertissement sur les risques et la responsabilité.