Suivre les cours crypto de CoinGecko dans Google Sheets

1. Définissez vos besoins de suivi des cours avant de créer la feuille

Pour savoir comment suivre les cours des cryptomonnaies dans Google Sheets, commencez par rédiger une courte spécification, plutôt que de vous lancer directement dans les formules. Indiquez les cryptomonnaies à suivre, les devises de cotation, la fréquence d’actualisation et si vous avez besoin du cours actuel, de données historiques ou des deux. Une feuille destinée à suivre le BTC et l’ETH en USD n’a pas le même objectif qu’une feuille qui consigne un portefeuille diversifié en EUR et en GBP.

Gardez une première version simple. Par exemple, suivez trois cryptomonnaies dans une seule devise et actualisez les données toutes les heures. N’ajoutez d’autres lignes ou devises qu’après avoir vérifié que les résultats correspondent aux données affichées par CoinGecko. Le nombre de requêtes nécessaires et les options d’actualisation disponibles dépendent de la méthode d’accès choisie et des conditions de votre compte : vérifiez les limites en vigueur avant de définir un calendrier.

Déterminez ce que signifie le terme « cours » dans votre feuille. Un cours actuel est une valeur à un instant donné, et non un prix d’exécution garanti. Si vous comptez le comparer à une transaction, consignez l’horodatage du cours et ne considérez pas comme actuel un résultat différé ou mis en cache.

2. Choisissez une méthode d’accès à l’API adaptée à votre configuration

Il existe trois méthodes courantes pour connecter l’API CoinGecko à Google Sheets : un module complémentaire pour Sheets, un petit script Apps Script ou un connecteur tiers. Un module complémentaire est souvent la solution la plus rapide pour les personnes peu à l’aise avec la technique. Un script vous donne davantage de contrôle sur le format des requêtes et le stockage des données. Un connecteur peut éviter d’avoir à coder, mais il ajoute un service à vérifier si l’actualisation cesse de fonctionner.

Avant de choisir, comparez les méthodes d’authentification, les quotas de requêtes et les besoins de maintenance. Vérifiez si la méthode nécessite une clé API, où celle-ci sera stockée, quelle fréquence d’actualisation elle permet et si ses limites correspondent au nombre prévu de cryptomonnaies et de devises. Les options d’accès à l’API CoinGecko et leurs conditions peuvent évoluer : consultez la documentation pour connaître les exigences en vigueur.

Si vous utilisez Apps Script, ouvrez l’éditeur de scripts du tableur et créez une fonction qui envoie une requête à CoinGecko, analyse la réponse et inscrit les champs souhaités dans une feuille. Un script simple est plus facile à dépanner s’il n’a qu’une seule tâche et affiche clairement les erreurs. Ne stockez pas une clé API privée dans une cellule accessible à toutes les personnes autorisées à consulter le tableur.

Si vous comparez encore les outils, le guide sur les critères d’une bonne plateforme d’échange de cryptomonnaies porte sur une autre décision : le choix d’une plateforme de trading plutôt que d’une source de données. Distinguer ces deux choix permet d’éviter de confondre un flux API avec un compte sur une plateforme d’échange.

3. Créez une table de correspondance entre cryptomonnaies et devises

Utilisez les identifiants CoinGecko des cryptomonnaies dans vos requêtes, et non uniquement leurs symboles boursiers. Plusieurs projets sans lien entre eux peuvent partager le même symbole, tandis qu’un identifiant permet à l’API de rechercher un actif précis. Créez un onglet « Correspondance » avec les colonnes suivantes : nom à afficher, identifiant CoinGecko, symbole et devise cible.

Les deux premières lignes illustrent le type d’identifiant à enregistrer. Vérifiez chaque identifiant sur CoinGecko avant de vous y fier. Le symbole est utile pour les libellés, mais ne doit pas remplacer l’identifiant dans une requête. C’est particulièrement important si votre portefeuille comprend un petit jeton dont le symbole ressemble à celui d’un autre projet.

Utilisez un format uniforme pour les codes de devise, par exemple `usd` ou `eur` en minuscules, si c’est le format attendu par le point de terminaison choisi. Une règle de validation dans Google Sheets peut limiter la colonne des devises aux seules devises prises en charge par votre configuration. Cette vérification simple évite qu’une faute de frappe comme `usdd` soit transmise à l’API.

4. Récupérez les cours actuels dans une table de données bien organisée

Conservez les données brutes de l’API dans un onglet distinct de celui qui sert à consulter les cours. Un onglet « Brutes » peut contenir la réponse ou les dernières valeurs importées ; un onglet « Cours » peut afficher le nom de la cryptomonnaie, son symbole, la devise, le cours et l’horodatage. Cette séparation facilite les changements de mise en forme sans risquer de casser la logique des requêtes.

Une requête classique pour obtenir les cours actuels transmet à l’API des cours de CoinGecko les identifiants sélectionnés et la devise de cotation. L’URL exacte, les paramètres, la méthode d’authentification et les champs renvoyés dépendent du produit API et de la méthode d’accès : consultez la documentation de CoinGecko pour connaître les détails du point de terminaison. Dans le tableau obtenu, associez chaque valeur à l’identifiant correspondant plutôt que de supposer que l’ordre des résultats correspondra toujours à celui des lignes saisies.

Par exemple, votre tableau de présentation pourrait afficher « Bitcoin | BTC | USD | cours | mis à jour le ». Formatez la colonne des cours en nombre avec un niveau de précision adapté, mais conservez suffisamment de décimales pour les actifs suivis. L’arrondi de la valeur affichée relève de la présentation ; arrondir la valeur stockée peut fausser les calculs ultérieurs.

Pour importer les cours crypto dans Google Sheets avec l’API CoinGecko, commencez par une seule cryptomonnaie et une seule devise, puis vérifiez que l’identifiant, la devise et le cours renvoyés correspondent à la source. Une fois cette étape validée, étoffez la table de correspondance et testez chaque nouvelle ligne. C’est moins spectaculaire que de créer un grand tableau de bord, mais cela permet de repérer rapidement les identifiants incorrects.

Utilisez des formules pour effectuer des calculs, pas pour masquer des données manquantes. Si une requête échoue, affichez un indicateur clair comme « Erreur de requête » ou laissez une erreur visible, au lieu d’afficher zéro comme si l’actif n’avait plus aucune valeur. Un zéro peut fausser les totaux du portefeuille et entraîner des décisions sans rapport avec le marché.

5. Planifiez les actualisations et gérez les limites de requêtes

L’actualisation automatique n’est utile que si elle s’exécute à une fréquence autorisée par votre accès à l’API. Les options d’actualisation des modules complémentaires, les déclencheurs Apps Script et les calendriers des connecteurs ne fonctionnent pas de la même manière. Avant de choisir un intervalle, vérifiez les quotas et les règles d’actualisation en vigueur pour la méthode choisie : les limites exactes peuvent varier selon l’offre et évoluer.

Commencez par un calendrier raisonnable et une requête simple. Si vous suivez cinq actifs, évitez d’envoyer une requête distincte pour chaque cellule lorsqu’une seule requête peut renvoyer les valeurs nécessaires. Réduire le nombre d’appels peut faciliter la maintenance du tableur, mais vérifiez que le point de terminaison accepte les identifiants et les devises transmis ensemble.

Prévoyez les incidents. L’API peut renvoyer une erreur, un service peut être indisponible ou un quota peut être atteint. Affichez le dernier horodatage de mise à jour réussie et ne remplacez pas des données valides par une réponse vide, sauf si vous souhaitez les effacer. Un cours obsolète reste obsolète : signalez-le au lieu de le présenter comme actuel.

Les déclencheurs Apps Script peuvent s’exécuter selon un calendrier, mais ils sont soumis aux limites d’exécution et aux exigences d’autorisation de Google. Après la configuration, vérifiez l’état du déclencheur et consultez le journal d’exécution si les actualisations s’interrompent. Les limites de Google et celles de CoinGecko sont distinctes : respecter les unes ne garantit pas que l’autre acceptera chaque requête.

6. Ajoutez des horodatages et conservez des relevés de cours

Un tableau qui remplace le cours d’hier par celui d’aujourd’hui ne permet pas de voir les changements. Ajoutez un onglet « Historique » qui stocke une ligne par cryptomonnaie et par actualisation, avec des colonnes pour l’horodatage, l’identifiant, la devise et le cours. Ajoutez chaque réponse valide sur une nouvelle ligne au lieu de remplacer l’enregistrement précédent.

Par exemple, une ligne de relevé pourrait se présenter ainsi : « 2026-11-12 10:00 | bitcoin | usd | [valeur renvoyée] ». Utilisez l’heure réelle indiquée par votre connexion ou votre script, et précisez s’il s’agit de l’heure UTC ou locale. Le cours affiché doit être associé à l’horodatage de la même actualisation, et non à l’heure de la dernière ouverture du tableur.

Définissez une politique de conservation avant que l’onglet d’historique ne devienne trop volumineux. Selon l’objectif et le quota de requêtes, vous pouvez conserver un relevé quotidien pour un suivi personnel à long terme ou des relevés plus fréquents pour une surveillance à court terme. Ne partez pas du principe que l’API fournit des données historiques simplement parce que votre tableur a accumulé des relevés : il s’agit de sources de données distinctes.

Avec des lignes datées, vous pouvez calculer l’évolution entre deux observations enregistrées, à condition que l’identifiant de la cryptomonnaie et la devise de cotation soient identiques. Comparer une ligne BTC/USD à une ligne BTC/EUR mêle effet de change et variation du cours : identifiez clairement les séries avant de les représenter sous forme de graphique.

7. Vérifiez les résultats et entretenez la connexion

Effectuez quelques vérifications avant de vous fier à un tableau de bord. Confirmez que l’identifiant de la cryptomonnaie est correct, que la devise indiquée correspond à celle de la requête, que le cours renvoyé est bien numérique et que l’horodatage correspond à cette actualisation. Comparez ensuite un résultat avec le site de CoinGecko, en gardant à l’esprit que les deux affichages peuvent être actualisés à des moments différents.

Pendant les tests, laissez les réponses d’erreur visibles. Une requête échouée peut révéler une clé invalide, un paramètre mal formé, un problème de quota ou une panne temporaire du service. Notez le message et l’heure de l’erreur ; modifier plusieurs paramètres à la fois rend la cause plus difficile à cerner. Si la même erreur se répète, consultez la documentation du point de terminaison et les conditions de votre offre d’accès.

Indiquez qui est responsable du script ou du connecteur, où sont stockés les identifiants et quels onglets peuvent être modifiés sans risque. Si quelqu’un renomme une colonne attendue par le script, la connexion peut cesser de fonctionner même si CoinGecko n’a rien changé. Protéger les onglets de correspondance et de données brutes contre les modifications accidentelles peut éviter ce type de problème.

Revoyez votre configuration lorsque CoinGecko modifie les conditions de l’API, l’authentification, les points de terminaison disponibles ou les quotas, et vérifiez les informations à jour avant de modifier un tableur en production. Après chaque changement, un test sur une seule cryptomonnaie suffit généralement à repérer un paramètre incorrect avant qu’il n’affecte toutes les lignes. Conservez ce test dans le classeur afin que la personne suivante puisse le répéter.