Comment connecter votre clé API OKX et corriger l’erreur 50119

Votre clé API OKX peut être valide et pourtant renvoyer « La clé API n’existe pas. » Si une clé EEA atteint l’API mondiale au lieu de l’infrastructure d’OKX Europe, recréer la clé ne résoudra pas le problème. Je vais vous montrer comment connecter votre clé API OKX, choisir la bonne région de compte et diagnostiquer l’erreur avant de modifier vos identifiants.

La vérification décisive porte sur la combinaison des identifiants et du point de terminaison régional. Une clé correctement copiée, envoyée au mauvais hôte régional, peut échouer avant même que ses autorisations entrent en jeu.

Une clé API OKX valide peut échouer au mauvais point de terminaison régional

Face à un échec de connexion, il est tentant de générer une nouvelle clé, de la coller à nouveau et d’essayer davantage d’autorisations. Cette approche traite chaque échec d’authentification comme un problème d’identifiants.

La structure régionale d’OKX rend cette hypothèse peu fiable.

OKX Europe Limited est une entité distincte, réglementée dans le cadre de MiCA et agréée par la MFSA de Malte. Les comptes EEA sont hébergés sur my.okx.com, et leurs clés API ne sont valides que sur l’infrastructure API d’OKX Europe.

Envoyez une clé EEA parfaitement valide à l’API mondiale www.okx.com, et la réponse peut être 50119 : « La clé API n’existe pas. » La clé existe, mais la requête a atteint le mauvais point de terminaison régional.

Les comptes US disposent de leur propre hôte régional, us.okx.com. Leurs connexions doivent elles aussi utiliser l’infrastructure régionale correspondante.

Les comptes OKX brésiliens utilisent la plateforme mondiale et la même API : sélectionnez donc Global. Une présence sur un marché local n’implique pas automatiquement une région API distincte.

Je commence le diagnostic ici, car modifier une phrase secrète ou élargir les autorisations ne peut pas corriger une incohérence de région. La requête doit atteindre l’infrastructure qui reconnaît la clé.

Comment créer une clé API OKX avec les autorisations nécessaires

Une connexion doit disposer des accès suffisants pour accomplir la tâche prévue. Accorder des autorisations supplémentaires pour faire disparaître une erreur est une mauvaise méthode de diagnostic.

Pour consulter votre portefeuille, utilisez Read. Ajoutez Trade uniquement si vous comptez utiliser des bots qui passent des ordres.

N’activez jamais Withdrawal pour cette connexion.

Configuration de la clé API OKX étape par étape

1. Ouvrez la gestion des API dans votre compte OKX.

Connectez-vous au compte que vous souhaitez associer et accédez à son espace de gestion des API. Déterminez si ce compte relève de Global, EEA ou US avant de créer la clé.

1. Créez une clé API dédiée à cette connexion.

Donnez-lui un nom reconnaissable pour pouvoir identifier sa fonction lors d’un examen ultérieur des accès. Une clé dédiée facilite aussi la modification ou la révocation des accès de cette connexion indépendamment des autres.

1. Définissez la phrase secrète API lors de la création.

Il s’agit d’une phrase secrète que vous choisissez pour la clé API. Ce n’est pas le mot de passe de votre compte OKX, et vous en aurez besoin en plus de la clé API et de sa clé secrète pour vous connecter.

1. Activez Read pour consulter votre portefeuille.

Si votre objectif est de consulter les informations de votre portefeuille, commencez par l’accès Read. Une connexion destinée uniquement à la consultation n’a pas besoin d’autorisation de trading.

1. Ajoutez Trade uniquement pour les bots qui doivent passer des ordres.

L’autorisation Trade permet d’effectuer des opérations de trading. Activez-la délibérément à cette fin, pas pour tenter de résoudre une erreur d’authentification.

1. Laissez Withdrawal désactivé.

La consultation du portefeuille et le passage d’ordres par des bots ne nécessitent pas d’autorisation de retrait. Ne l’accordez pas pour terminer cette configuration. Gardez à l’esprit que désactiver les retraits n’empêche pas les pertes de trading : une clé disposant de l’autorisation Trade peut toujours passer des ordres entraînant des pertes. Limitez donc les fonds détenus sur le compte auquel une connexion de trading peut accéder.

1. Associez la clé aux adresses IP de la connexion lorsqu’elles sont disponibles.

Utilisez les adresses IP indiquées par le service qui effectue les requêtes API. Maintenez cette configuration en accord avec la connexion que vous utilisez réellement.

1. Conservez la clé API, la clé secrète et la phrase secrète en lieu sûr.

Traitez-les comme des identifiants d’accès. Lorsque vous les saisissez dans le formulaire de connexion, vérifiez que chaque valeur est complète et appartient à la même clé API.

La création de la clé ne constitue qu’une partie de la configuration. La connexion qui la reçoit doit aussi savoir quel hôte régional utiliser.

Pourquoi la liste blanche d’adresses IP compte

L’association à des adresses IP limite les endroits depuis lesquels une clé peut être utilisée. Elle compte aussi pour le cycle de vie de la clé : OKX peut supprimer les clés API inactives qui ne sont associées à aucune adresse IP. Une clé que vous avez créée puis laissée inutilisée peut donc ne plus exister lorsque vous souhaitez la réutiliser.

Ne supposez pas qu’une clé reste active simplement parce que vous avez encore ses identifiants enregistrés. Vérifiez son statut dans la gestion des API d’OKX.

Un autre problème de configuration mérite votre attention : une clé active peut rejeter une requête lorsque l’adresse IP de l’émetteur ne figure pas dans sa liste blanche. Cela produit une erreur spécifique à l’IP, qui doit vous orienter vers les paramètres IP plutôt que vers la création d’une nouvelle clé.

Pourquoi OKX indique « La clé API n’existe pas » alors que la clé est valide

La formulation semble catégorique. Sa portée diagnostique est plus limitée qu’il n’y paraît.

Pour un compte EEA, l’erreur 50119 peut signifier que le point de terminaison mondial ne reconnaît pas une clé valide sur l’infrastructure d’OKX Europe. Si un guide de connexion ne vous demande jamais de quelle entité relève votre compte, il ne peut pas faire apparaître ce cas.

La séparation régionale est documentée, ce n’est pas une théorie sur les identifiants

La FAQ de l’API OKX EEA documente le contexte régional de my.okx.com et la validité des clés limitée à l’EEA. Des signalements publics dans Freqtrade, CCXT et Hummingbot corroborent également le cas d’utilisateurs EEA recevant « La clé API n’existe pas » lorsque leur intégration utilise l’hôte mondial.

Ces signalements justifient de vérifier le point de terminaison régional. Ils n’établissent pas que chaque occurrence a la même cause.

Ma conclusion diagnostique est simple : vérifiez la région du compte avant de remplacer une clé qu’OKX indique toujours comme active. Si un connecteur suppose que tous les comptes utilisent l’API mondiale, créer des clés à répétition ne change rien à cette hypothèse.

Les autres causes de l’erreur 50119 restent à vérifier

Une incohérence de région n’est pas la seule explication. La même erreur peut aussi concerner :

• Une clé de trading de démonstration utilisée dans le mauvais environnement. Confirmez que les identifiants correspondent à l’environnement attendu par la connexion.
• Une clé supprimée automatiquement. Vérifiez si la clé existe toujours dans la gestion des API d’OKX.
• Un collage tronqué. Assurez-vous que la clé API a été saisie dans son intégralité.
• Une clé réellement inconnue. Confirmez que les identifiants proviennent du compte prévu.

Je vérifierais ces possibilités l’une après l’autre plutôt que de tout modifier en même temps. Si vous remplacez simultanément les identifiants, les autorisations, l’environnement et la région, la réussite d’une nouvelle tentative vous apprend très peu sur ce qui posait problème.

La question utile est : ce point de terminaison reconnaît-il cette clé active pour ce compte et cet environnement ?

Décodez le code d’erreur OKX avant de réessayer

Un échec de connexion est un symptôme. Le code d’erreur OKX est l’indice le plus utile.

La documentation publique des codes d’erreur de l’API OKX distingue une clé inconnue d’une phrase secrète incorrecte, d’une signature invalide et d’une restriction IP. Chaque erreur pointe vers une partie différente de la connexion.

Code d’erreur	Signification	Points à vérifier
50119	La clé API n’existe pas	Région du compte et hôte régional ; environnement de démonstration ou environnement prévu ; éventuelle suppression de la clé ; intégralité de la clé collée
50105	Phrase secrète API incorrecte	Utilisez la phrase secrète définie lors de la création de cette clé API, pas le mot de passe du compte
50113	Signature invalide	Vérifiez la clé secrète API et l’implémentation de la signature des requêtes dans l’intégration
50110	L’adresse IP de la requête ne figure pas dans la liste blanche	Vérifiez si l’adresse IP de l’émetteur figure dans la configuration des adresses IP autorisées pour la clé

Erreur 50105 : vérifiez la phrase secrète API

La phrase secrète API est un identifiant distinct. Saisir votre mot de passe de connexion OKX dans ce champ ne convient pas.

Vérifiez également que la phrase secrète correspond à la même clé que la clé API et la clé secrète. En mélangeant des identifiants issus de différentes tentatives de création, vous pouvez vous retrouver avec des valeurs qui semblent plausibles individuellement, mais qui ne vont pas ensemble.

Erreur 50113 : examinez la signature des requêtes

Une signature invalide pointe vers la signature d’authentification de la requête. Vérifiez la clé secrète API et, si vous maintenez l’intégration, son implémentation de la signature.

Si vous utilisez un formulaire de connexion, consultez l’assistance ou la documentation technique du connecteur pour examiner la signature des requêtes. Activer Trade ou Withdrawal ne corrige pas une signature invalide.

Erreur 50110 : examinez la liste blanche d’adresses IP

Cette erreur vous oriente vers la configuration des adresses IP autorisées. Vérifiez l’adresse IP utilisée par le service qui effectue la requête, puis comparez-la à la liste blanche de la clé.

Réessayer aveuglément la même requête laisse l’incohérence intacte. Corrigez le paramètre concerné avant de tester à nouveau.

Comment connecter OKX à Anny

Mon formulaire de connexion comprend un sélecteur Région du compte avec les options Global, EEA et US. Ce choix garantit que la clé est vérifiée auprès de l’hôte régional approprié.

Voici la procédure de connexion :

1. Ouvrez le formulaire d’ajout d’une plateforme d’échange et choisissez OKX.

Préparez votre clé API, votre clé secrète et votre phrase secrète API.

1. Sélectionnez la région de votre compte.

Choisissez EEA pour un compte OKX Europe, US pour un compte OKX US ou Global pour un compte sur la plateforme mondiale. Les comptes brésiliens doivent sélectionner Global.

1. Saisissez les identifiants correspondants.

Collez la clé API et la clé secrète dans leur intégralité, puis saisissez la phrase secrète définie lors de la création de la clé.

1. Confirmez que les autorisations correspondent à votre objectif.

Utilisez Read pour consulter votre portefeuille. Ajoutez Trade uniquement pour les bots et laissez Withdrawal désactivé.

1. Vérifiez la connexion.

Si elle échoue, utilisez le code d’erreur renvoyé pour choisir la prochaine vérification. Pour 50119, revérifiez la région avant de créer une autre clé.

Connecter OKX à Anny

Sélectionner une région est une exigence d’authentification, pas une préférence d’affichage. Ce choix détermine où les identifiants sont vérifiés.

Comment utiliser la documentation de l’API OKX pour le diagnostic

Si vous vous connectez via un formulaire existant, le sélecteur de région et le tableau des erreurs sont les points de départ pratiques. Si vous maintenez une intégration, lisez les consignes régionales en parallèle de la documentation sur l’authentification.

Les sections pertinentes de la documentation de l’API OKX répondent à des questions différentes :

• Consignes relatives aux API régionales : quelle infrastructure doit recevoir les requêtes de ce compte ?
• Consignes d’authentification : quels identifiants sont requis et comment les requêtes doivent-elles être signées ?
• Référence des codes d’erreur : quelle partie de la requête soumise a été rejetée ?

Une implémentation correcte de la signature peut tout de même envoyer une requête au mauvais hôte régional. Un hôte régional correct peut tout de même rejeter une phrase secrète incorrecte.

Je sépare ces vérifications, car elles conduisent à des corrections différentes. Une connexion réussie exige que le point de terminaison, les identifiants, l’environnement, les autorisations et la configuration IP concordent.

Questions fréquentes sur les connexions à l’API OKX

Une clé API OKX expire-t-elle ?

Ne supposez pas qu’une clé API reste disponible indéfiniment. OKX peut supprimer les clés inactives qui ne sont associées à aucune adresse IP : vérifiez donc la gestion des API si des identifiants précédemment enregistrés cessent de fonctionner.

Associez la clé aux adresses IP indiquées pour la connexion lorsqu’elles sont disponibles, et vérifiez qu’elle est toujours active avant d’examiner sa phrase secrète ou ses autorisations.

Pourquoi ma clé API OKX valide est-elle signalée comme inexistante ?

Une clé valide peut renvoyer 50119 lorsqu’elle est envoyée au mauvais point de terminaison régional. En particulier, une clé EEA doit être utilisée sur l’infrastructure d’OKX Europe ; l’envoyer à l’API mondiale www.okx.com peut produire « La clé API n’existe pas ».

Vérifiez également une éventuelle incohérence avec l’environnement de démonstration, une suppression automatique de la clé ou un collage incomplet.

De quelles autorisations un bot de trading OKX a-t-il besoin ?

Utilisez Read pour consulter votre portefeuille et ajoutez Trade lorsque le bot doit passer des ordres. N’activez jamais Withdrawal pour cette connexion.

Des autorisations supplémentaires ne résolvent ni une incohérence de région, ni une phrase secrète incorrecte, ni une signature invalide, ni une erreur de liste blanche d’adresses IP.

La phrase secrète API OKX est-elle identique à mon mot de passe ?

Non. La phrase secrète API est définie lorsque vous créez la clé API et elle est distincte du mot de passe de votre compte OKX.

Saisissez la phrase secrète associée à cette clé précise.

Quelle région un compte OKX brésilien doit-il sélectionner ?

Sélectionnez Global. OKX Brazil fonctionne sur la plateforme mondiale et utilise la même API.

Dois-je créer une nouvelle clé chaque fois que la connexion échoue ?

Non. Lisez d’abord le code d’erreur et vérifiez le paramètre qu’il désigne.

Pour 50119, confirmez l’hôte régional, l’environnement, le statut actif de la clé et l’intégralité de la valeur collée. Une nouvelle clé ne réparera pas une connexion qui continue de l’envoyer au mauvais point de terminaison régional.

La prochaine action utile est un diagnostic, pas une nouvelle tentative identique. Commencez par la région, lisez le code et modifiez le paramètre désigné par les éléments du diagnostic.

Cet article est à visée pédagogique et ne constitue pas un conseil financier. Performances passées ≠ résultats futurs. Anny est une plateforme d’analyse alimentée par l’IA, pas un conseiller en investissement enregistré.