> For the complete documentation index, see [llms.txt](https://cryptoexcel.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cryptoexcel.gitbook.io/documentation/3-ajoutez-et-editez-des-transactions.md). # 3) Ajoutez et éditez des transactions ## **I) Ajouter une transaction manuellement** > *Double-cliquez ou appuyez sur la touche “F” pour afficher la vidéo en plein écran.* {% embed url="" %} Ajout d'une transaction de type “Achat” {% endembed %} * Cliquez sur le bouton “Ajout transaction” pour afficher la fenêtre contextuelle correspondante.
Affichage de la fenêtre "Ajouter une transaction".

Fenêtre “Ajouter une transaction”

### Achat * **Type de transaction** * Cliquez sur le bouton “Achat” (déjà sélectionné par défaut). * **Cryptomonnaie** * Choisissez la cryptomonnaie concernée. * Vous pouvez écrire le nom de la cryptomonnaie ou son symbole dans la barre de recherche. > *Double-cliquez ou appuyez sur la touche “F” pour afficher la vidéo en plein écran.* {% embed url="" %} Choisissez la cryptomonnaie de votre choix. {% endembed %} * **Quantité et Prix** * Insérez ensuite la quantité de tokens achetés, et le prix d'achat (par token). * Vous pouvez choisir la devise avec laquelle vous avez effectué cette transaction. * *Même si vous achetez vos cryptos en dollars ($), cela ne vous empêche pas de visualiser par la suite votre tableau de bord uniquement en euros (€), via le sélecteur de devises (cf* [2) Découverte du tableau de bord](/documentation/2-decouverte-du-tableau-de-bord.md)*).* * **Capital, et case à cocher** * Le capital investi est automatiquement calculé en multipliant les champs "Quantité" et "Prix". * Si la case “Prendre en compte dans les dépôts” est cochée, ce capital s'ajoutera à vos Dépôts, en bas à gauche de votre tableau de bord (cf [2) Découverte du tableau de bord](/documentation/2-decouverte-du-tableau-de-bord.md)).
Case “Prendre en compte dans les dépôts”

Case “Prendre en compte dans les dépôts”

* **Échange (optionnel)** * Indiquez l'exchange ou wallet sur lequel a eu lieu la transaction. * Vous pouvez utiliser la barre de recherche pour trouver plus facilement la valeur désirée. * Si votre exchange ou wallet ne se trouve pas dans la liste, vous pouvez l'ajouter. * Indiquer l'échange permet de remplir le graphe de répartition correspondant. * **Date (optionnel)** * Indiquez la date au format DD/MM/YYYY. * Cliquez sur l'icône en forme de calendrier pour naviguer plus facilement. * **Frais de transaction (optionnel)** * Une fois indiqués, les frais de transaction ont un impact négatif sur la Rentabilité. * **Commentaire (optionnel)** * Vous pouvez ajouter des notes personnelles pour chaque cryptomonnaie. * Ces commentaires s’afficheront dans la section Transactions de votre tableau de bord, lorsque vous survolez le nom de la cryptomonnaie sur la ligne concernée.
Commentaires sur les transactions

Commentaires sur les transactions

* **Valider** * Une fois les champs complétés, cliquez sur le bouton “Valider”. * Félicitations, vous avez inséré votre première transaction ! :tada: * La transaction s'affiche en bas à droite de votre tableau de bord. * S'il s'agit de la première transaction avec cette cryptomonnaie, celle-ci s'ajoutera également dans votre portefeuille.

Ici, le Solana a été ajouté dans les transactions et dans le portefeuille.

Ainsi, toute transaction ajoutée manuellement permet de constituer votre portefeuille.
Les transactions génèrent le portefeuille

Les transactions génèrent le portefeuille.

### Vente * La logique est exactement la même que pour “Achat”, à l'exception que vous devez sélectionner “Vente” en première étape. * Cette fois, la quantité désigne le nombre de tokens vendus, et le prix correspond au prix moyen de vente par token. * Le capital vendu s'ajoute aux Retraits, si vous avez coché la case “Prendre en compte dans les retraits”. ### Swap {% hint style="info" %} Un “swap” (ou contrat d'échange) désigne une conversion entre deux cryptomonnaies. * Puisque la valeur de votre portefeuille reste inchangé, un swap n'a aucun impact sur votre rentabilité, ni sur le montant de vos dépôts et de vos retraits. * Pour cette raison, la case “Prendre en compte dans les dépôts et les retraits” est décochée par défaut. {% endhint %} {% hint style="info" %} Quand effectuer un swap? * Un swap peut être considéré comme la fusion entre 2 transactions : * Vente de la crypto n°1 pour un montant X. * Achat de la crypto n°2 pour le même montant X. * Si, par exemple, vous préférez convertir vos Bitcoins en stablecoins plutôt qu'en euros pour éviter une imposition, vous effectuez alors un swap. * Ainsi, plutôt que de vendre vos cryptos et de revenir en monnaie fiduciaire (euros, dollars, etc), vous sécurisez vos plus-values en les transférant sur un stablecoin (ex: USDC). {% endhint %} **Type de transaction** * En première ligne, cliquez sur le bouton “Swap”. La première partie de l'interface est légèrement différente que pour “Achat” et “Vente”. Elle est composée de 2 sélecteurs (Crypto 1 & 2) et de 4 champs : * Quantité 1 & 2 * Prix 1 & 2
Aperçu du swap

Aperçu du swap

**Sens de la transaction** * (Depuis) Crypto 1 : celle détenue dans votre portefeuille, que vous convertissez. * (Vers) Crypto 2 : celle que vous obtenez après le swap. * Une icône entre les 2 cryptomonnaies permet d'inverser le sens de la transaction. **Mode verrouillé** * Mode verrouillé (par défaut) : * Complétez l'un des 4 champs. * Les 3 autres se remplissent automatiquement, en se basant sur le taux de conversion actuel entre les 2 cryptomonnaies. * Les 2 champs “Capital” sont automatiquement générés, et systématiquement égaux. * Mode déverrouillé : * Écrivez librement les valeurs dans les 4 champs, sans qu'elles ne s'impactent entre elles. * Ce mode est particulièrement utile si vous souhaitez intégrer des transactions effectuées quelques jours plus tôt, où le taux de conversion entre les deux cryptomonnaies a depuis évolué. {% hint style="danger" %} * Dans le mode déverrouillé, veillez à ce que les valeurs des champs “Capital” soient équivalentes (du moins, avec un écart inférieur à 1%). * Faute de quoi, cette transaction provoquera un écart dans le calcul des métriques. {% endhint %} {% hint style="success" %} * Si cette contrainte vous pose problème, vous pouvez décomposer un swap en 2 transactions : * Transaction “Vente” de la Crypto n°1 pour un montant X. * Transaction “Achat” de la Crypto n°2 pour le même montant X. * Dans ce cas, veillez à bien décocher la case “Prise en compte dans les dépôts / retraits” dans les deux transactions, afin que cela n'ait pas d'incidence sur votre rentabilité. {% endhint %}
Mode verrouillé / déverrouillé

Mode verrouillé / déverrouillé

**Valider** * Une fois les champs complétés, cliquez sur le bouton “Valider”. * La transaction s'affiche en bas à droite de votre tableau de bord. * Celle-ci fait apparaître les deux cryptomonnaies impliquées dans le swap, ainsi que le ratio (rapport) entre les deux cryptomonnaies.
Transaction swap

Transaction swap

### Comment indiquer un transfert ? Lorsque vous transférez une crypto d'une plateforme à une autre (ou vers un hardware wallet de type Ledger), créez les transactions suivantes : * Une “Vente” de la crypto depuis l'Échange n°1. * Puis un “Achat” de cette même crypto vers l'Échange n°2. * Si vous le souhaitez, ajoutez les frais de transactions... * ...ou indiquez la nouvelle quantité de tokens (légèrement inférieure), correspondant à la commission du transfert. * Ainsi, la cryptomonnaie associée sera désormais rattachée à l'Échange n°2. {% hint style="success" %} Si vous ne souhaitez pas créer de nouvelles transactions, vous pouvez aussi procéder ainsi : * Ainsi, éditez vos transactions rattachées à la cryptomonnaie concernée et remplacez l'Échange n°1 par l'Échange n°2 (cf [#iii-editer-les-transactions](#iii-editer-les-transactions "mention")). * Vous pouvez également ajouter en commentaires les raisons du transfert, ainsi que la date où le transfert a eu lieu. {% endhint %} ### Et si j'ai beaucoup de transactions à intégrer ? La première configuration de Crypto Excel peut être fastidieuse si vous souhaitez intégrer des dizaines ou des centaines de transactions. Voici comment configurer au plus vite votre tableau de bord : * Toujours avec la méthode manuelle, avec cette astuce : **saisissez *****une seule***** transaction par cryptomonnaie détenue dans votre portefeuille**. * Dans le prix d'achat, indiquez le prix d'achat moyen (pour toutes vos transactions impliquant cette cryptomonnaie). * Cela accélérera l'importation de vos données utilisateur, sans impact sur votre rentabilité. * Exemple : si vous détenez 25 cryptomonnaies et que vous avez réalisé 130 transactions, vous n'aurez que 25 transactions à saisir. * Ajoutez automatiquement vos transactions (cf la section suivante, [#ii-ajouter-des-transactions-automatiquement-via-une-connexion-api-a-un-echange](#ii-ajouter-des-transactions-automatiquement-via-une-connexion-api-a-un-echange "mention")) *** ## **II) Ajouter des transactions automatiquement via une connexion API à un échange** Notre application fournit des connexions aux échanges suivants : * Binance * Coinbase * Bybit * Kraken * Gate.io * Kucoin * Bitfinex {% hint style="info" %} Pour tout autre plateforme non disponible dans la liste, veuillez vous reporter à la section [#i-ajouter-une-transaction-manuellement](#i-ajouter-une-transaction-manuellement "mention"). {% endhint %} ### Première connexion Pour vous connecter à un échange, suivez les étapes ci-dessous : * Cliquez sur le bouton “Connexion API” pour afficher la fenêtre contextuelle “Mes portefeuilles”. * Sélectionnez l'échange de votre choix. * Une page dédiée vous indique les instructions vous permettant de générer une clé API depuis la plateforme concernée. * Une fois que cela est fait, copiez-coller les champs dans la page et cliquez sur “Valider” pour finaliser la connexion. {% hint style="info" %} Les clés sont configurées pour un accès en lecture seule. En d'autres termes, elles ne disposent d'aucune autorisation d'écriture et ne peuvent donc pas déclencher de transfert de fonds. De plus, une fois la clé générée, vous pouvez révoquer son accès à tout moment. {% endhint %} {% hint style="info" %} La clé API (publique) reste visible depuis l'échange, mais la clé secrète (privée) n'est visible qu'**une seule fois**, lors de sa création. Pensez à bien la conserver quelque part, car en cas d'oubli, vous devrez générer une nouvelle clé API. {% endhint %} {% hint style="warning" %} * Si vous recevez un message d'erreur indiquant “**Les clés sont incorrectes**” : * Vérifiez les indications et assurez-vous d'avoir saisi les informations au bon endroit. Afin d'éviter toute erreur de saisie, utilisez les fonctions copier-coller. * Si vous obtenez ce message d'erreur sur Brave, veuillez réessayer sur Google Chrome. {% endhint %} * Un **message de confirmation** s'affiche pour indiquer que l'importation est en cours. Selon le nombre de transactions à traiter, l'opération peut durer jusqu'à une minute.
Synchronisation en cours

Synchronisation en cours

* Une fois la connexion API établie, vos **transactions** et **cryptomonnaies** apparaissent automatiquement dans votre tableau de bord. {% hint style="danger" %} Après avoir connecté une plateforme d'échange, **n'ajoutez plus manuellement de transactions** provenant de cette même plateforme, sous peine de compter les **opérations en double**. {% endhint %} {% hint style="warning" %} **Portée des connexions API** * Les connexions API ne récupèrent que les actifs présents dans les comptes suivants : * **Trading** (Spot) * **Futures** * **Convert** * Par conséquent, les cryptomonnaies placées dans ces comptes ne seront **pas détectées** : * **Lending** * **Staking** * **Earn** {% endhint %} **Suivi des portefeuilles** * Vous pouvez consulter le **montant total détenu** pour chaque échange connecté depuis la fenêtre contextuelle “Mes portefeuilles”.
Montant détenu dans chaque échange synchronisé

Montant détenu dans chaque échange synchronisé

* Vous pouvez supprimer la connexion à un échange à tout moment. * Cette action effacer **l'ensemble des transactions importées**, ainsi que les **soldes associés** dans la section Portefeuille. ### Informations supplémentaires et types de transactions Contrairement aux transactions ajoutées manuellement, la synchronisation aux échanges se fait en deux temps : * D'abord avec les balances (quantités de chaque crypto actuellement détenues) * Puis, avec les transactions.

Lors d'une connexion API, les balances font foi, et les transactions sont générées dans un second temps.

* Si des transactions ne sont pas détectées, Crypto Excel génère automatiquement des transactions **fictives** afin de faire correspondre les soldes entre le portefeuille et les transactions. * Ces transactions sont reconnaissables au libellé “Fictif”. * Elles peuvent englober plusieurs transactions réelles. * Elles n'ont aucune date associée. * Le bouton est de même couleur que le type de transaction“Achat”, “Vente” ou “Swap”. * Elles sont éditables (cf section suivante [#iii-editer-les-transactions](#iii-editer-les-transactions "mention")). * Une fois modifiées, elles reprennent le libellé d'origine “Achat”, “Vente” ou “Swap”.
Transactions fictives

Transactions fictives

{% hint style="info" %} Si certaines informations sont manquantes lors de la première connexion, désolé, ce n'est pas de notre fait : par définition, une API est une interface se greffant à la plateforme et permettant d'échanger des données. Ainsi, l'API remonte les informations que l'exchange veut bien nous communiquer. Plusieurs motifs peuvent expliquer une remontée d'informations partielles : * transactions effectuées il y a plusieurs années * migration de serveurs * réglementation MiCA * etc. Heureusement, une fois un échange connecté, toute nouvelle transaction est remontée sans erreur. {% endhint %} * Enfin, si Crypto Excel détecte des mouvements d'entrée ou de sortie depuis l'échange, il crée une transaction **de mouvement** : * Libellé “Entrée” pour tout mouvement envoyé vers la plateforme. * Libellé “Sortie” pour tout mouvement en sortant.
Transactions de mouvement

Transactions de mouvement

{% hint style="info" %} * Ces transactions n'affichent que la quantité de tokens transférés. * Le prix et le capital restent vides, car ces transactions ne comportent aucune valeur monétaire associée. * Elles n'ont aucun impact sur la rentabilité, ce qui est logique étant donné la nature de cette transaction. Par conséquent, la case “Prise en compte dans les dépôts / retraits” est bien décochée par défaut. {% endhint %} {% hint style="warning" %} * Il est déconseillé d'éditer ces transactions. * Si vous ne souhaitez pas les voir apparaître sur votre tableau de bord, supprimez-les simplement (cf [#iii-editer-les-transactions](#iii-editer-les-transactions "mention")). {% endhint %} *** ## **III) Éditer les transactions** À n'importe quel moment, vous pouvez éditer une transaction en cliquant sur le bouton qui apparaît au début de cette ligne. > *Double-cliquez ou appuyez sur la touche “F” pour afficher la vidéo en plein écran.* {% embed url="" %} Éditer une transaction existante. {% endembed %} ### Modifier une transaction * Dans la fenêtre contextuelle “Éditer la transaction”, modifiez les champs de votre choix. * Puis cliquez sur le bouton “Éditer” pour valider les modifications. ### Supprimer une transaction * Cliquez sur le bouton “Supprimer”. * La transaction sera aussitôt effacée de la liste. {% hint style="info" %} * Si cette transaction provient d'une connexion API, celle-ci restera supprimée et ne sera pas réajoutée lors de la prochaine actualisation. * Si vous avez supprimé cette transaction par erreur, effectuez l'une des deux manipulations suivantes (au choix) : * Réintégrez cette transaction manuellement. * Supprimez la connexion API pour réinitialiser complètement la connexion à cette échange, avant de vous reconnecter une nouvelle fois. {% endhint %} ### Éditer une crypto ayant changé de nom * Il arrive qu'une cryptomonnaie change de nom à la suite d'un hard fork ou d'un rebranding. * Dans ces cas-là, l'API conserve l'ancien nom “A”, tandis qu'une nouvelle cryptomonnaie “B” est créée. * L’inconvénient est que le **prix ne sera plus mis à jour** pour la cryptomonnaie “A”. Voici deux méthodes pour mettre à jour votre tableau de bord. {% hint style="warning" %} Dans les deux cas, soyez attentif au **taux de conversion** entre les deux cryptomonnaies. {% endhint %} * **Méthode n°1** : * Modifiez toutes vos anciennes transactions contenant la cryptomonnaie “A” et remplacez-la par la nouvelle “B”. {% hint style="info" %} Vous pouvez également ajouter un **commentaire**, précisant la date de conversion et le rapport appliqué. {% endhint %} * **Méthode n°2 :** * Créez une transaction “Swap” à la date correspondante pour convertir vos cryptomonnaies “A” en “B”. {% hint style="success" %} * Cette méthode est particulièrement utile si vous préférez éviter de modifier un nombre important de transactions. * De plus, elle reflète mieux la réalité et **préserve l’historique de vos opérations.** {% endhint %} *** N'hésitez pas à poser des questions en cas de besoin. Nous continuerons d'enrichir cette documentation en fonction de vos commentaires.