Connecter Lighter
Lighter se connecte via un portefeuille et n’a pas de liste blanche d’IP. Ce guide explique ce qu’il faut préparer sur Lighter et comment ajouter le compte dans Trade avec un portefeuille ou une clé privée API existante.
Préparer sur la plateforme
Le portefeuille doit avoir effectué un dépôt sur Lighter. Un compte Lighter est ouvert lors du premier dépôt.
Activez le compte de trading unifié dans les paramètres de Lighter. Les comptes de trading simples ne sont pas pris en charge.
Vérifiez le niveau du compte. Un portefeuille au niveau gratuit (Standard) doit passer au niveau Plus pour pouvoir être ajouté ; la fenêtre vous guide lors de l’ajout.
Ajouter avec Connecter le portefeuille ne demande rien d’autre. Pour ajouter avec Saisir la clé API, générez d’abord une clé API sur la page API Keys de Lighter, puis notez sa clé privée et l’index de clé API utilisé. N’activez pas Maker-only lors de la génération : activée, la clé ne peut placer que des ordres maker, et la jambe taker d’une combinaison est rejetée.
Lighter n’a pas de IP allowlist pour les clés API : la fenêtre « Ajouter un compte » n’affiche donc pas d’IP de sortie.
Mode de compte et mode de position
Le seul account mode est « Compte de trading unifié » : les soldes USDC — Spot et perpétuel — servent conjointement de marge. Trade ne change pas le mode de compte à votre place.
Les contrats perpétuels utilisent le one-way mode, sans aucun réglage nécessaire. Le effet de levier des contrats se règle dans la combinaison, et Trade l’applique sur la plateforme.
Saisir dans Trade
Dans Trade, ouvrez « Comptes », choisissez « Ajouter un compte », sélectionnez Lighter, puis choisissez la « Méthode de connexion ». Pour les étapes générales, consultez Connecter une plateforme.
Connecter un portefeuille
Choisissez « Connecter le portefeuille » pour connecter votre portefeuille, puis choisissez « Autoriser et ajouter ».
Confirmez chaque signature dans votre portefeuille selon les indications de la fenêtre. La fenêtre précise ce que signe chaque étape, le nombre de signatures restantes et les frais éventuels d’une étape. Une fois la signature effectuée, Trade sur votre serveur peut passer des ordres et transférer des fonds sur Lighter en votre nom.
Si le portefeuille est au niveau gratuit, la fenêtre vous demande d’abord de passer au niveau Plus et indique le coût de chaque exécution après le changement de niveau. Pour accepter, choisissez « Passer à Plus et continuer » ; cette étape ne nécessite aucune signature. Le niveau s’applique à tout le portefeuille : ses sous-comptes passent également au niveau Plus.
Lorsque la fenêtre propose « Compte de trading », vous pouvez choisir « Compte principal » ou « Sous-compte ». Pour un sous-compte, renseignez « Numéro du sous-compte », visible sur la page des sous-comptes de Lighter.
API manuelle
| Champ | Que saisir |
|---|---|
| Adresse du portefeuille L1 | L’adresse du portefeuille avec lequel vous vous connectez à Lighter |
| Clé privée API | La clé privée obtenue lors de la génération de la clé API. Ne saisissez pas la clé publique |
| Index de clé API | L’indice de la clé API utilisé pour cette clé, de 4 à 254 |
Si la fenêtre indique qu’une signature est encore nécessaire, signez avec ce portefeuille selon les indications.
Les deux méthodes nécessitent également un Nom du compte et au moins un marché Spot ou perpétuel sous Marchés pris en charge.
Questions fréquentes
Message : Lighter ne reconnaît pas cette clé privée API
Vérifiez que Adresse du portefeuille L1, Clé privée API et l’index de clé API correspondent tous à la même clé.
Message : le nombre de clés API de ce compte Lighter a atteint la limite
Supprimez sur Lighter une clé API inutilisée, puis revenez ajouter le compte.
Message : ce portefeuille n’a pas encore de compte ouvert sur la plateforme
Effectuez d’abord un dépôt vers ce portefeuille sur Lighter, puis revenez le connecter.