Pour les développeurs · Données de marché

Crypto Bubbles API : d'où coulent vraiment les données et comment construire votre propre board

Réponse courte à la question la plus fréquente : l'application officielle n'annonce aucune API publique. La réponse longue est plus intéressante — car toute la chaîne de données dont se nourrissent les applications à bulles est publiquement accessible, et vous pouvez en tirer votre propre tableau en une soirée. Nous vous montrons comment : du choix de la source à REST contre WebSocket, jusqu'au code qui dessine les bulles.

Schéma du flux de données : plateformes d'échange de cryptomonnaies, agrégateurs, API et interface à bulles

Honnêtes dès l'entrée

Crypto Bubbles a-t-il une API publique ?

Commençons par la raison pour laquelle la plupart des gens atterrissent ici. Le site officiel cryptobubbles.net n'annonce aucune API publique et documentée pour les développeurs. Pas de portail développeur, pas de grille tarifaire de requêtes, pas de documentation d'endpoints. Crypto Bubbles est un produit grand public — une visualisation couvrant plus d'un millier de coins, rafraîchie automatiquement, disponible dans le navigateur et en applications mobiles (c'est ainsi que son propre site le présente) — et non un entrepôt de données.

Nous l'écrivons noir sur blanc, parce que le web regorge de tutoriels qui suggèrent le contraire ou — pire — se font passer pour « l'API officielle de Crypto Bubbles » avec des clés à vendre. Traitez ces offres comme les faux APK des forums : quelqu'un essaie de vous vendre ce que l'éditeur ne propose pas. La règle de notre guide de téléchargement de l'application vaut aussi ici — la seule source de vérité sur le produit officiel est cryptobubbles.net.

Et maintenant la bonne nouvelle : pour construire votre propre tableau de bulles, vous n'avez besoin de l'API d'aucune application en particulier. Les bulles ne sont qu'une manière de dessiner des données que le marché publie de toute façon. Il vous faut quatre chiffres par coin et une quarantaine de lignes de code. C'est précisément à cela que nous consacrons le reste de cette page.

Comment les applications à bulles obtiennent leurs données : une chaîne à trois maillons

Toute visualisation de marché — des bulles aux heatmaps, dont nous parlons dans le guide de la carte du marché — repose sur la même chaîne d'approvisionnement :

  • Maillon 1 : les plateformes d'échange. La source primaire de chaque prix est le carnet d'ordres d'une plateforme précise. C'est là que les transactions se concluent, et le prix « du bitcoin » est en réalité des dizaines de prix issus de dizaines de places de marché, qui divergent de fractions de pour cent.
  • Maillon 2 : les agrégateurs. Les services de données collectent les cotations de centaines de plateformes, les moyennent (généralement en pondérant par le volume), y ajoutent l'offre en circulation et exposent des métriques prêtes à l'emploi : capitalisation, classement, variations en pourcentage sur des fenêtres de temps standard.
  • Maillon 3 : les applications. Les visualisations comme le tableau à bulles récupèrent chez les agrégateurs un JSON normalisé et transforment les chiffres en géométrie et en couleur. Toute la « magie » se joue dans le navigateur de l'utilisateur.

Ce découpage a une conséquence pratique pour votre projet : vous pouvez vous brancher sur n'importe quel maillon. L'agrégateur vous offre le confort — un seul endpoint, des milliers de coins, des capitalisations déjà calculées. La plateforme d'échange vous offre la fraîcheur — des données tout droit sorties du carnet, sans intermédiaire ni délai de moyennage, mais uniquement pour les paires cotées sur cette seule place. Les projets matures combinent souvent les deux : l'agrégateur pour le classement et la capitalisation, la plateforme pour les prix en temps réel.

Architecture

REST ou WebSocket : deux façons de boire au même robinet

Toute API de marché sérieuse sert ses données de deux manières, et le choix entre elles est la première décision d'architecture de votre projet.

REST fonctionne en question-réponse : vous envoyez une requête HTTP, vous recevez un JSON, fin de la conversation. Avantages : la simplicité, un débogage facile (la réponse se consulte dans le navigateur), du cache gratuit. Inconvénients : chaque mise à jour est une nouvelle requête, et les limites de débit (rate limits) des plans gratuits sont parfois serrées — typiquement de quelques à quelques dizaines de requêtes par minute. Pour un tableau de bulles rafraîchi toutes les 30 à 60 secondes, c'est amplement suffisant ; au passage, l'application officielle Crypto Bubbles rafraîchit elle aussi ses données toutes les quelques dizaines de secondes, comme l'indique son site.

WebSocket, c'est une ligne ouverte : vous établissez une seule connexion et le serveur vous pousse lui-même chaque changement — nouveau tick de prix, nouvelle transaction, mise à jour du carnet. Avantages : des latences en millisecondes au lieu de secondes, et aucun quota gaspillé à demander « est-ce que quelque chose a changé ? ». Inconvénients : vous devez gérer les ruptures de connexion, la resouscription, la mise en file des messages — le code devient plus sérieux. WebSocket est indispensable en trading algorithmique et pour les tickers en direct ; pour visualiser « l'état du marché », c'est souvent un canon pour tuer un moineau.

Règle pratique : commencez par REST. Ne passez au WebSocket que le jour où vous savez dire ce qu'un délai de 30 secondes casse concrètement chez vous. Si vous ne savez pas — il ne casse rien.

Les quatre champs avec lesquels on dessine des bulles

Décomposons le tableau en données. Pour dessiner une vue à bulles digne de ce nom, il vous faut exactement quatre champs par coin :

  • Le symbole (BTC, ETH…) — l'étiquette de la bulle.
  • La capitalisation boursière — elle pilote la taille. C'est elle, et non le prix unitaire, qui traduit l'échelle d'un projet ; pourquoi cette différence est fondamentale, nous l'expliquons à propos du calculateur CoinCompare.
  • La variation en pourcentage sur la fenêtre choisie (heure, jour, semaine…) — elle pilote la couleur et sa saturation.
  • Le volume sur 24 h — il ne dessine rien directement, mais permet de filtrer les coins « morts » dont le prix bouge sur trois transactions par jour.

Tout ce qui dépasse cet ensemble — classement, offre, ATH, liens — relève de la fiche du coin, pas du tableau lui-même. Notez qu'on parle de quelques centaines d'octets par coin : mille coins, c'est une seule réponse JSON de la taille d'une petite photo. Voilà pourquoi les tableaux de bulles restent fluides même sur des téléphones modestes.

Atelier

Mini-tutoriel : votre propre tableau de bulles en une soirée

Voici un squelette en JavaScript — du pseudocode volontairement simplifié, à compléter avec l'adresse de l'API de votre choix. La logique tient en trois temps : récupérer les tickers, convertir la capitalisation en rayon et la variation en couleur, dessiner.

// 1. Récupérer les données (REST, rafraîchissement toutes les 60 s)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // clé API dans l'en-tête, jamais dans le code
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // écarter les coins morts
}

// 2. Mise à l'échelle : rayon ~ racine carrée de la capitalisation
//    (l'œil compare les SURFACES des cercles, pas les rayons !)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. Couleur : vert pour la hausse, rouge pour la baisse,
//    la saturation croît avec la valeur absolue de la variation
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // saturation pleine à partir de ±15 %
  return changePct >= 0
    ? `rgba(34, 197, 94, ${0.35 + 0.65 * sat})`
    : `rgba(239, 68, 68, ${0.35 + 0.65 * sat})`;
}

// 4. Dessin : canvas + simulation de répulsion simple
setInterval(async () => {
  const coins = await fetchCoins();
  const maxCap = Math.max(...coins.map(c => c.marketCap));
  draw(coins.map(c => ({
    label: c.symbol,
    r: radius(c.marketCap, maxCap),
    fill: color(c.change24h)
  })));
}, 60_000);

Deux conseils qui dépassent le squelette. Premièrement, la physique du placement : pour que les bulles ne se chevauchent pas, utilisez une simulation de forces toute faite — dans la bibliothèque d3, c'est le module d3-force avec collisions (forceCollide) ; en canvas pur, une boucle qui repousse les cercles qui se croisent suffit. Deuxièmement, la racine carrée dans la fonction de rayon n'est pas une coquetterie : la surface d'un cercle croît avec le carré du rayon, donc une mise à l'échelle linéaire ferait qu'un coin 100 fois plus gros occuperait 10 000 fois plus d'écran. La moitié des tableaux « amateurs » qui traînent sur le web commettent exactement cette erreur et mentent visuellement sur les proportions du marché — or les proportions sont tout l'intérêt de cette visualisation, comme nous le détaillons dans le guide qu'est-ce que Crypto Bubbles.

Comment choisir une API de données : six critères

CritèreQuoi demanderÀ quoi faire attention
Couverture du marchéCombien de coins et de plateformes ? Les capitalisations sont-elles calculées ?« 10 000 coins » inclut parfois des tokens morts sans volume
WebSocketY a-t-il un flux en direct et que couvre-t-il (ticks, transactions, carnet) ?Certains plans ne proposent le WS qu'à partir du palier payant
Limites de requêtesCombien de requêtes par minute/mois dans votre plan ?Les limites comptées par endpoint peuvent surprendre en plein mois
PrixLe coût du plan à votre trafic réel, pas à celui d'aujourd'huiLes sauts de prix entre paliers sont parfois de plusieurs multiples
Données historiquesJusqu'où remontent les bougies et avec quelle résolution ?Les plans gratuits offrent souvent des jours, pas des années
Stabilité et SLAPage de statut, historique des pannes, garanties de disponibilitéL'absence de page de statut publique est une réponse en soi

Une remarque à part sur les API d'échange comme source à part entière : si votre projet touche au trading — backtesting, bot, suivi de vos propres ordres — l'API d'une plateforme n'est pas tant une alternative qu'une nécessité, car elle seule vous donne le carnet d'ordres, l'historique des transactions et la possibilité de passer des ordres. Les documentations des plateformes matures offrent REST et WebSocket, des sandbox de test et des bibliothèques clientes dans les langages populaires. C'est aussi le chemin le plus court pour confronter la théorie de cette page à un vrai flux de données.

Les informations sur les fonctionnalités de l'application officielle Crypto Bubbles (couverture de coins, plateformes, fréquence de rafraîchissement) sont citées d'après cryptobubbles.net (état : juillet 2026).

Sécurité

Clés API : cours accéléré pour ne pas incendier votre compte

Section écrite du point de vue d'un auditeur qui a vu trop de dépôts avec des clés dans l'historique des commits. Une clé API pour des données publiques, c'est un détail — au pire, quelqu'un consomme votre quota de requêtes. Une clé API liée à un compte d'échange, c'est une tout autre catégorie : entre de mauvaises mains, elle peut vider le compte. Les règles :

  • Ne commitez jamais vos clés. Gardez-les dans des variables d'environnement ou un gestionnaire de secrets ; le fichier .env dans le .gitignore dès le premier jour. Une clé qui a fini une fois dans l'historique du dépôt est à considérer comme grillée : régénérez-en une — supprimer le fichier ne l'efface pas de l'historique.
  • Des permissions minimales. Pour lire des données, une clé read-only suffit. N'activez le droit de trading que pour les bots qui tradent réellement, et le droit de retrait — idéalement jamais. Aucun bot d'analyse n'a besoin de pouvoir retirer des fonds.
  • Une liste d'IP autorisées. Les API matures permettent de restreindre une clé à des adresses précises. Une clé fuitée mais épinglée à l'IP de votre serveur est inutilisable pour un voleur.
  • Rotation et hygiène. Une clé distincte par projet, revue et suppression des clés inutilisées chaque trimestre, rotation immédiate au moindre soupçon de fuite. Cela sonne bureaucratique, prend dix minutes et sauve des comptes.

Avertissement : les bots et « outils à signaux » qui réclament une clé avec droit de retrait sont un vecteur de vol standard. Un outil d'analyse légitime n'a jamais besoin de telles permissions — la demande met fin à la conversation.

Le résumé le plus court de cette page

  • L'application officielle Crypto Bubbles n'annonce pas d'API publique — fuyez les offres de « clés officielles ».
  • Les données suivent la chaîne plateformes → agrégateurs → applications ; votre projet peut se brancher sur n'importe quel maillon.
  • REST suffit pour un tableau rafraîchi chaque minute ; ne prenez le WebSocket que quand la latence fait vraiment mal.
  • Pour dessiner des bulles, il suffit du symbole, de la capitalisation, de la variation en pourcentage et du volume — plus un rayon proportionnel à la racine carrée.
  • Clés API : hors du dépôt, permissions minimales, épinglées à une IP, en rotation régulière.

FAQ

Questions fréquentes sur la crypto bubbles API et les données de marché

Crypto Bubbles propose-t-il une API publique ?

Le site officiel cryptobubbles.net n'annonce aucune API publique et documentée pour les développeurs — l'application est un produit grand public, pas un fournisseur de données. Si vous voulez construire votre propre visualisation, tournez-vous vers les API des agrégateurs de données de marché ou directement vers les API des plateformes d'échange.

REST ou WebSocket — que choisir pour les données de marché ?

REST pour les données que vous rafraîchissez toutes les quelques dizaines de secondes (capitalisations, classements, variations en pourcentage) — c'est plus simple et plus facile à déboguer. WebSocket pour le flux de transactions et de ticks de prix en temps réel, quand chaque seconde compte. Un tableau de bulles tourne très bien sur du REST.

Quels champs de données faut-il pour dessiner des bulles ?

Le minimum, c'est quatre champs par coin : le symbole, la capitalisation boursière, la variation en pourcentage sur la fenêtre de temps choisie et le volume. La capitalisation pilote le rayon de la bulle, la variation en pourcentage la couleur, et le volume sert à filtrer les coins morts.

Pourquoi le rayon d'une bulle est-il proportionnel à la racine carrée de la capitalisation ?

Parce que l'œil compare les surfaces des cercles, pas les rayons. La surface croît avec le carré du rayon : pour qu'un coin dix fois plus gros occupe dix fois plus de surface, le rayon doit croître comme la racine carrée de la capitalisation. Une mise à l'échelle linéaire du rayon gonflerait visuellement les grosses monnaies des centaines de fois.

Une API de marché gratuite suffit-elle pour un projet personnel ?

Pour apprendre et pour un dashboard de loisir — en général oui : les plans gratuits des agrégateurs offrent de quelques à quelques dizaines de requêtes par minute, et un tableau rafraîchi toutes les 30 à 60 secondes tient dans ces limites. Pour un produit commercial, il vous faut un plan payant avec SLA, des limites plus élevées et des données historiques.

Comment stocker les clés API en toute sécurité ?

Jamais dans le code ni dans le dépôt — uniquement dans des variables d'environnement ou un gestionnaire de secrets. Accordez aux clés des permissions minimales (lecture seule, sans droit de retrait), activez une liste d'adresses IP autorisées et effectuez une rotation après tout soupçon de fuite. Une clé avec droit de trading se traite comme un mot de passe de compte bancaire.

De la lecture de la doc à la première requête

Le moyen le plus rapide d'apprendre les API de marché, c'est d'envoyer de vraies requêtes. La documentation d'une API d'échange avec REST, WebSockets et clés à permissions restreintes est un bon terrain d'entraînement.