Comment extraire l’historique de transactions de la plateforme CoinEx
Si vous utilisez CoinEx et que vous devez exporter votre historique pour le transmettre à votre spécialiste colvence et calculer votre imposition crypto, ce guide vous explique quoi télécharger et comment.
Nous couvrons deux méthodes : le téléchargement manuel des fichiers CSV et la connexion par une API en lecture seule.
Important : pour une revue fiscale complète, l’idéal est de fournir les CSV et l’API en lecture seule. Le CSV apporte l’historique tel que CoinEx l’exporte, et l’API permet de vérifier les données et les soldes.
Pourquoi votre historique CoinEx est indispensable
Pour calculer correctement les plus-values et moins-values de votre déclaration, il faut reconstituer toutes vos opérations :
- la date de chaque achat, vente, conversion ou échange
- la quantité de cryptos reçue et remise
- la valeur de marché au moment de l’opération
- les frais payés
- les dépôts, retraits et transferts entre comptes
CoinEx opère comme une plateforme internationale. Si vous y détenez des cryptos, il convient de l’examiner comme une plateforme étrangère au regard du Modelo 721, surtout si la valeur cumulée sur des plateformes étrangères dépasse 50 000 € au 31 décembre.
Fichiers nécessaires
Pour une extraction complète, à la manière de Koinly, vous devez télécharger ces fichiers depuis CoinEx :
| Fichier | Chemin dans CoinEx | Quand il est utile |
|---|---|---|
| Deposit Records | Assets > Spot > Deposit Records | Toujours |
| Withdrawal Records | Assets > Spot > Withdrawal Records | Toujours |
| Spot history | Assets > History > Spot Trades | Si vous avez acheté ou vendu sur le spot |
| Margin history | Assets > History > Margin | Si vous avez utilisé le margin trading |
| Futures history | Assets > History > Futures | Si vous avez utilisé les futures |
Important : la plage de dates doit couvrir tout votre historique sur CoinEx, pas seulement l’année à déclarer. S’il manque une année antérieure, le calcul FIFO risque d’être incomplet.
CoinEx propose aussi un export fiscal général depuis Assets > History > Export Data, qui génère un ZIP contenant des CSV pour le Spot, la Marge, les Futures et le Compte financier. C’est utile en appui, mais pour la réconciliation fiscale il vaut mieux télécharger également les fichiers spécifiques de dépôts, de retraits et d’opérations.
Méthode 1 : export CSV
Étape 1 : se connecter à CoinEx
- Ouvrez votre navigateur et rendez-vous sur coinex.com
- Connectez-vous à votre compte
- Validez la vérification de sécurité si CoinEx la demande
Étape 2 : exporter les dépôts
- En haut à droite, sélectionnez « Assets »
- Dans le menu latéral gauche, sous Overview, ouvrez Spot
- Sélectionnez « Deposit Records »
- Choisissez une plage de dates couvrant tout votre historique sur CoinEx
- Cliquez sur « Export » et enregistrez le fichier
Étape 3 : exporter les retraits
Répétez la même opération pour les retraits :
- Allez dans Assets > Spot
- Ouvrez « Withdrawal Records »
- Sélectionnez la même plage de dates complète
- Cliquez sur « Export »
- Enregistrez le fichier sans l’ouvrir ni le modifier
Étape 4 : exporter l’historique spot
- En haut à droite, ouvrez « Assets »
- Dans le menu déroulant, choisissez « History »
- CoinEx vous conduit à l’historique. Par défaut, vous arrivez généralement dans la section Spot Trades
- Sélectionnez une plage de dates couvrant tout votre historique
- Cliquez sur « Export »
- Enregistrez le CSV généré
Étape 5 : exporter margin et futures si vous les avez utilisés
Si vous avez opéré sur marge ou sur futures, l’historique spot ne suffit pas.
- Depuis Assets > History, utilisez le menu latéral gauche
- Changez le type d’historique pour Margin ou Margin History
- Sélectionnez la plage complète et exportez le fichier
- Répétez l’opération pour Futures ou Futures History
À noter : si vous n’avez jamais utilisé la marge ni les futures, inutile de générer des fichiers vides. En cas de doute, vérifiez les deux sections au cas où d’anciens mouvements y figureraient.
Étape 6 : l’export fiscal général de CoinEx
En guise de vérification supplémentaire, CoinEx permet d’exporter des données fiscales depuis Assets > History > Export Data.
Sur cet écran, vous pouvez sélectionner :
- Time Range : tout votre historique
- Account Type : tous les comptes disponibles
- Asset Type : tous les actifs
- Exporter le fichier
Une fois l’export généré, CoinEx vous prévient par e-mail et par message dans la plateforme. Téléchargez le ZIP et envoyez-le avec les CSV précédents si votre spécialiste le demande.
Important : n’ouvrez pas et ne modifiez pas les CSV avant de nous les transmettre. Les ouvrir dans Excel peut altérer les dates, les décimales ou les symboles.
Limites à connaître
| Limite | Détail |
|---|---|
| Enregistrements disponibles | CoinEx conserve jusqu’aux 50 000 entrées les plus récentes dans l’historique exportable |
| Exports mensuels | 6 exports par mois civil au maximum |
| Validité du lien | Le lien de téléchargement reste valable 7 jours |
| Fichiers nécessaires | Dépôts, retraits, spot, margin et futures se téléchargent séparément si vous avez utilisé ces sections |
| Export fiscal général | Le ZIP officiel de CoinEx sépare Spot, Marge, Futures et Compte financier |
| Comptes sans activité | Ils peuvent générer des CSV vides |
| CoinSet / LP | Les opérations CoinSet ou de liquidité peuvent exiger une reconstitution manuelle si le fichier n’indique pas le nombre de parts |
Planifiez vos exports avant de les demander, surtout si vous avez plusieurs années d’activité ou un grand nombre d’opérations.
Méthode 2 : connexion par API
L’API en lecture seule permet de consulter les informations de compte et d’opérations sans accorder le moindre droit d’opérer ni de retirer des fonds.
Étape 1 : accéder à API Management
- Connectez-vous sur coinex.com
- En haut à droite, sélectionnez « Account » ou l’icône de votre compte
- Dans le menu déroulant, ouvrez « API Management »
Étape 2 : créer une nouvelle API
- Cliquez sur « Create API »
- Donnez-lui un nom reconnaissable, par exemple « colvence »
- Saisissez votre code TOTP ou le code de vérification demandé par CoinEx
- Confirmez la création
Sécurité : n’activez pas les droits de trading ni de retrait. Pour une revue fiscale, la lecture seule nous suffit.
Étape 3 : copier les clés
Une fois l’API créée par CoinEx, copiez en lieu sûr :
- l’API Key ou Access ID
- l’API Secret ou Secret Key
Transmettez ces identifiants à votre spécialiste colvence par le canal sécurisé qu’il vous indiquera.
À noter : une clé API fraîchement créée peut mettre quelques minutes à devenir active. Si une erreur apparaît juste après la création, patientez et réessayez.
Limites de l’API de CoinEx
L’API ne fournit pas toujours l’intégralité de l’historique fiscal. D’après les limitations que Koinly indique pour CoinEx, certaines opérations peuvent ne pas être importées parce que CoinEx ne les transmet pas par API :
- les instant swaps
- les airdrops
- les commissions de parrainage
Si vous avez eu l’un de ces mouvements, prévenez votre spécialiste afin qu’il les ajoute à la main avec les documents disponibles.
Captures des soldes
Outre le CSV et l’API, des captures des soldes peuvent être nécessaires si vos fonds sont répartis entre plusieurs comptes ou sous-comptes :
- Compte Spot
- Compte de Marge
- Compte de Futures
- Compte financier / Earn
- AMM ou toute autre section avec du solde
- Sous-comptes, si vous en utilisez
Faites des captures où les montants, les devises et la date apparaissent clairement. Cela facilite l’examen du patrimoine, des soldes de clôture et des éventuelles obligations liées au Modelo 721.
Questions fréquentes
CoinEx permet-elle d’exporter tout l’historique ?
CoinEx autorise des exports depuis plusieurs sections, mais son export fiscal général affiche une limite de 50 000 entrées les plus récentes. Si votre compte dépasse ce volume, prévenez votre spécialiste afin d’envisager des exports par sections, des plages partielles ou une demande au support de CoinEx.
Combien de fois puis-je exporter des données ?
CoinEx autorise jusqu’à 6 exports par mois civil. Une fois la limite atteinte, il faut attendre le mois suivant.
Combien de temps dure le lien de téléchargement ?
Le lien de téléchargement reste valable 7 jours. Téléchargez le ZIP dès que CoinEx vous prévient.
Me faut-il le CSV ou l’API ?
Chaque fois que c’est possible, fournissez les deux. Le CSV conserve l’export officiel tel que téléchargé, et l’API permet de recouper les informations automatiquement.
Quels fichiers ne doivent surtout pas manquer ?
Au minimum, téléchargez les Deposit Records, les Withdrawal Records et l’historique spot. Si vous avez utilisé la marge ou les futures, ajoutez aussi le margin history et le futures history.
Une API en lecture seule peut-elle déplacer des fonds ?
Non. Une API configurée en lecture seule permet de consulter des données, mais pas d’opérer ni de retirer des cryptos.
Et les instant swaps, airdrops ou parrainages ?
Koinly indique que l’API de CoinEx ne fournit ni instant swaps, ni airdrops, ni commissions de parrainage. Si vous avez eu ces mouvements, il faudra les ajouter à la main à partir de relevés, de captures ou de vos propres registres.
Que faire si j’ai des opérations CoinSet ou de liquidité ?
Si le fichier n’indique pas le nombre de parts, ces opérations peuvent ne pas s’importer correctement et devront être reconstituées à la main. Envoyez-nous toute capture ou tout relevé CoinEx supplémentaire pour que nous puissions les examiner.
CoinEx est-elle une plateforme étrangère pour le Modelo 721 ?
En pratique, CoinEx doit être examinée comme une plateforme étrangère. Si, au 31 décembre, vous dépassez 50 000 € cumulés sur des plateformes étrangères, vérifiez si vous êtes tenu de déposer le Modelo 721.
Récapitulatif
| Étape | Action |
|---|---|
| 1 | Aller sur coinex.com et se connecter |
| 2 | Ouvrir Assets > Spot > Deposit Records et exporter tout l’historique |
| 3 | Répéter dans Assets > Spot > Withdrawal Records |
| 4 | Aller dans Assets > History et exporter le spot history |
| 5 | Si vous avez utilisé la marge ou les futures, exporter aussi le margin history et le futures history |
| 6 | En option, télécharger le ZIP fiscal depuis History > Export Data |
| 7 | Créer une API en lecture seule depuis Account > API Management si votre spécialiste la demande |
| 8 | Envoyer les CSV, l’API et les captures des soldes sans modifier les fichiers |
Besoin d’aide avec votre historique CoinEx ?
Chez colvence, nous vous aidons à obtenir votre historique CoinEx — en vous guidant pas à pas si vous bloquez —, nous le traitons, nous calculons toutes les plus-values et moins-values selon la méthode FIFO et nous préparons votre déclaration.
Contactez-nous et nous nous occupons du reste.
Víctor Lázaro
Conseiller fiscal, colvence.com
