Ce dont vous avez besoin Un compte sur OKX Un compte sur Cryptotax (voir créer un compte ) Étape 1 : créez une clé API sur OKX Connectez-vous à OKX et ouvrez le menu de votre profil. Choisissez API et…
Ce dont vous avez besoin
- Un compte sur OKX
- Un compte sur Cryptotax (voir créer un compte)
Étape 1 : créez une clé API sur OKX
- Connectez-vous à OKX et ouvrez le menu de votre profil.
- Choisissez API et créez une nouvelle clé API (Create V5 API key).
- Donnez un nom à la clé, par exemple "Cryptotax".
- Choisissez vous-même une passphrase. Vous en aurez besoin dans Cryptotax dans un instant.
- Dans les autorisations, cochez uniquement Read.
- Confirmez avec votre vérification en deux étapes.
Quelles autorisations sont nécessaires
Donnez à la clé uniquement l'autorisation Read. Ne cochez ni Trade ni Withdraw. Cryptotax ne fait que lire et ne peut rien acheter, vendre ni transférer.
La passphrase
OKX demande une passphrase pour chaque clé API. Vous la choisissez vous-même lors de la création de la clé et OKX ne l'affiche plus ensuite. Conservez-la avec la clé API et la clé secrète (Secret key). Vous avez perdu la passphrase ? Il est impossible de la récupérer : créez une nouvelle clé API.
Notez aussi tout de suite la clé API et la clé secrète. OKX n'affiche la clé secrète qu'une seule fois.
La restriction d'IP est facultative
OKX vous permet de limiter la clé à certaines adresses IP. Ce n'est pas obligatoire. Si vous laissez la liste vide, la connexion fonctionne immédiatement. Si vous définissez quand même une liste, l'adresse IP de Cryptotax doit y figurer, sinon OKX refuse la requête. Voir une connexion à une plateforme échoue.
Étape 2 : saisissez la clé sur Cryptotax
- Connectez-vous à Cryptotax et allez dans Mes sources.
- Cliquez sur Ajouter une source, choisissez Plateforme puis OKX.
- Collez votre clé API, votre clé secrète et votre passphrase dans les champs prévus.
- Cliquez sur Connecter OKX.
Vous n'avez pas de région à choisir. Cryptotax teste automatiquement votre clé sur OKX Europe (l'entité pour les utilisateurs belges, my.okx.com), puis sur le site international d'OKX, et retient l'endroit où elle fonctionne.
Étape 3 : synchronisez vos transactions
Après l'enregistrement de la clé, la synchronisation démarre automatiquement. Selon le nombre de transactions, elle prend de quelques secondes à quelques minutes.
Ce que Cryptotax importe depuis OKX
- Compte de financement (funding) : dépôts, retraits, conversions, revenus earn et airdrops, à partir du 1er février 2021.
- Trades (compte de trading) : les 3 derniers mois. OKX ne fournit pas les trades plus anciens via l'API.
Trades plus anciens : importez un CSV
Avez-vous tradé sur OKX il y a plus de 3 mois ? Ces trades manquent alors après la connexion. Complétez-les avec un export :
- Connectez-vous à OKX et ouvrez votre historique de trades (Trading history).
- Exportez la période manquante au format CSV.
- Importez le fichier dans Cryptotax via l'import CSV, comme pour les autres plateformes.
N'exportez que la période antérieure aux 3 derniers mois : le reste arrive déjà par l'API.
Remarques importantes
- Ne connectez votre compte OKX qu'une seule fois.
- Cryptotax prend en charge les clés d'OKX Europe et du site international d'OKX. Une clé d'une autre entité OKX (par exemple OKX US) ne fonctionne pas.
- Les trades effectués via des sous-comptes ne sont pas lus par l'API. Utilisez un export CSV pour ceux-ci.
Résolution des problèmes
- Message sur des identifiants API invalides ou une passphrase incorrecte : vérifiez la clé API, la clé secrète et la passphrase. Faites attention aux espaces superflus et aux champs inversés. Si vous ne connaissez plus la passphrase, créez une nouvelle clé.
- Message indiquant que la clé a aussi des droits de trading ou de retrait : Cryptotax refuse les clés qui peuvent faire plus que lire. Créez une nouvelle clé avec uniquement le droit Read.
- Message sur des autorisations manquantes : vérifiez que la clé a l'autorisation Read.
- IP non autorisée : supprimez la restriction d'IP sur la clé ou ajoutez l'adresse IP de Cryptotax.
- Les trades de plus de 3 mois sont absents : importez l'historique de trades au format CSV, voir ci-dessus.