Comment vérifier les autorisations des clés API sur Bybit

Comprendre les niveaux d'autorisation des clés API

1. Bybit classe les autorisations API en trois niveaux distincts : lecture seule, échange et retrait.

2. L'accès en lecture seule permet de récupérer les données de marché, les soldes des comptes, l'historique des commandes et les informations de position sans modifier aucun état.

3. L'autorisation de négociation permet de passer, d'annuler et de modifier des ordres sur les marchés au comptant, sur marge et dérivés.

4. L'autorisation de retrait donne la possibilité d'initier des transferts de fonds depuis le compte Bybit — un privilège qui nécessite une activation manuelle explicite et une vérification de sécurité supplémentaire.

5. Chaque niveau d'autorisation est attribué lors de la création de la clé API et ne peut pas être modifié rétroactivement sans générer une nouvelle paire de clés.

Localisation de votre tableau de bord de clé API

1. Connectez-vous à votre compte Bybit à l'aide d'informations d'identification vérifiées et complétez l'authentification 2FA.

2. Accédez au menu utilisateur en haut à droite et sélectionnez « Gestion des API » dans la section « Centre de sécurité ».

3. Le tableau de bord affiche toutes les clés API actives avec leurs étiquettes associées, les horodatages de création et l'état de liaison IP.

4. Cliquez sur le bouton « Détails » à côté de n'importe quelle clé pour révéler sa configuration complète, y compris les indicateurs d'autorisation et les adresses IP sur liste blanche.

5. Les clés marquées comme « Testnet uniquement » apparaissent séparément et sont isolées des opérations du réseau principal de par leur conception.

Vérification des indicateurs d'autorisation via la réponse API

1. Envoyez une requête GET au point de terminaison /user/info à l'aide de votre clé API et de votre signature secrète.

2. Incluez les en-têtes requis : X-BAPI-API-KEY , X-BAPI-SIGN , X-BAPI-TIMESTAMP et X-BAPI-RECV-WINDOW .

3. Une réponse réussie renvoie un objet JSON contenant un champ d'autorisations répertoriant les fonctionnalités activées sous forme de valeurs booléennes.

4. Si la réponse inclut 'withdraw': true , la clé a le pouvoir de retrait — cette valeur doit rester false sauf si cela est explicitement requis.

5. Tout indicateur d'autorisation manquant ou incohérent suggère une mauvaise configuration ou une initialisation incomplète de la clé.

Interpréter les restrictions d'autorisation dans la pratique

1. Une clé API avec uniquement des autorisations de lecture renverra HTTP 403 lors d'une tentative de POST sur /order/create .

2. Tenter d'appeler /asset/withdraw avec une clé de non-retrait déclenche le code d'erreur 10004 et le message descriptif « Aucune autorisation de retrait ».

3. Les points de terminaison de trading appliquent une validation stricte : la soumission d'un ordre avec des paramètres de levier sur une clé dépourvue d'autorisation de produits dérivés génère l'erreur 11001 .

4. Modifications du comportement de limitation du débit en fonction de la portée de l'autorisation : les clés de trading sont soumises à des quotas basés sur le poids plus stricts que les clés en lecture seule.

5. Les clés liées à l'IP échouent silencieusement si les demandes proviennent de l'extérieur de la plage d'adresses enregistrées, quel que soit le niveau d'autorisation.

Foire aux questions

Q : Puis-je rétrograder l'autorisation d'une clé API après sa création ? Non. Bybit ne prend pas en charge la modification des autorisations sur les clés existantes. Vous devez désactiver la clé actuelle et en générer une nouvelle avec les paramètres souhaités.

Q : Pourquoi ma clé API affiche-t-elle « Trading : false » même si je l'ai sélectionnée lors de la configuration ? Cela se produit lorsque la clé a été créée avant d'activer le trading de contrats à terme ou de produits dérivés dans les paramètres de votre compte. Activez d’abord ces modules, puis régénérez la clé.

Q : Existe-t-il un moyen de vérifier les points de terminaison auxquels ma clé a réussi à accéder ? Oui. Bybit enregistre tous les appels d'API authentifiés dans l'onglet « Historique d'activité de l'API » de l'interface de gestion des API, affichant l'horodatage, le point de terminaison et le code de réponse.

Q : Que se passe-t-il si je lie une clé API à une adresse IP et que je change ultérieurement de réseau ? Les requêtes provenant d'adresses IP non répertoriées reçoivent HTTP 401 avec le code d'erreur 10002 . Vous devez mettre à jour la liste blanche IP ou désactiver la liaison pour restaurer la fonctionnalité.