Crypto Bubbles API: waar de data écht vandaan stroomt en hoe je je eigen board bouwt

Eerlijk vanaf de drempel

Heeft Crypto Bubbles een publieke API?

Laten we beginnen met waar de meeste mensen voor komen. De officiële website cryptobubbles.net adverteert geen publieke, gedocumenteerde API voor ontwikkelaars. Er is geen developerportaal, geen prijslijst per verzoek en geen endpoint-documentatie. Crypto Bubbles is een consumentenproduct — een visualisatie van ruim duizend munten, automatisch ververst, beschikbaar in de browser en als mobiele app (zo presenteert de eigen website het) — en geen datawarehouse.

We schrijven dit zo expliciet omdat er online nogal wat handleidingen circuleren die het tegendeel suggereren of — erger — zich voordoen als „de officiële Crypto Bubbles API” met te koop aangeboden keys. Behandel zulke aanbiedingen als de neppe APK's van fora: iemand probeert je iets te verkopen wat de maker niet aanbiedt. De regel uit onze gids over het downloaden van de app geldt ook hier — de enige bron van waarheid over het officiële product is cryptobubbles.net.

En nu het goede nieuws: om je eigen bubbelbord te bouwen heb je de API van een specifieke app helemaal niet nodig. Bubbels zijn slechts een manier om data te tekenen die de markt toch al publiceert. Je hebt vier getallen per munt nodig en veertig regels code. De rest van deze pagina gaat daar precies over.

Hoe bubbel-apps aan hun data komen: een keten met drie schakels

Elke marktvisualisatie — van bubbels tot de heatmaps die we beschrijven in de gids over de marktkaart — staat op dezelfde toeleveringsketen:

• Schakel 1: exchanges. De oerbron van elke prijs is het orderboek van een specifieke exchange. Hier komen de transacties tot stand, en „de prijs van bitcoin” is in werkelijkheid tientallen prijzen op tientallen handelsvloeren, die fracties van een procent van elkaar verschillen.
• Schakel 2: aggregators. Dataplatforms verzamelen noteringen van honderden exchanges, middelen ze uit (meestal gewogen naar volume), voegen het circulerend aanbod toe en leveren kant-en-klare metrics: marktkapitalisatie, ranking, procentuele veranderingen in standaard tijdvensters.
• Schakel 3: apps. Visualisaties zoals het bubbelbord halen genormaliseerde JSON op bij de aggregators en zetten getallen om in geometrie en kleur. Alle „magie” gebeurt in de browser van de gebruiker.

Deze opdeling heeft een praktische consequentie voor jouw project: je kunt op elke schakel aanhaken. Een aggregator geeft je gemak — één endpoint, duizenden munten, uitgerekende marktkapitalisaties. Een exchange geeft je versheid — data rechtstreeks uit het orderboek, zonder tussenpersoon en zonder vertragende middeling, maar alleen voor de paren die op die ene vloer noteren. Volwassen projecten combineren vaak beide bronnen: de aggregator voor ranking en market cap, de exchange voor realtime prijzen.

Werkplaats

Mini-tutorial: je eigen bubbelbord in één avond

Hieronder een skelet in JavaScript — bewust versimpelde pseudocode, zelf aan te vullen met het adres van je gekozen API. De logica bestaat uit drie stappen: haal de tickers op, vertaal marktkapitalisatie naar straal en procentuele verandering naar kleur, en teken.

// 1. Haal de data op (REST, verversen elke 60 s)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // API-key in de header, nooit in de code
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // filter dode munten weg
}

// 2. Schalen: straal ~ wortel van de market cap
//    (het oog vergelijkt OPPERVLAKTEN van cirkels, geen stralen!)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. Kleur: groen bij stijging, rood bij daling,
//    de verzadiging groeit met de absolute waarde van de verandering
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // volle verzadiging vanaf ±15%
  return changePct >= 0
    ? `rgba(34, 197, 94, ${0.35 + 0.65 * sat})`
    : `rgba(239, 68, 68, ${0.35 + 0.65 * sat})`;
}

// 4. Tekenen: canvas + simpele afstotingssimulatie
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);

Twee tips die verder gaan dan het skelet. Ten eerste, de plaatsingsfysica: om te voorkomen dat bubbels elkaar overlappen, gebruik je een kant-en-klare krachtsimulatie — in de d3-bibliotheek is dat de module d3-force met botsingen (forceCollide); op kaal canvas volstaat een lus die elkaar snijdende cirkels uit elkaar duwt. Ten tweede, de wortel in de straalfunctie is geen gril: de oppervlakte van een cirkel groeit met het kwadraat van de straal, dus lineair schalen zou een munt die 100 keer groter is 10.000 keer meer scherm laten innemen. De helft van de „amateurborden” op internet maakt precies deze fout en liegt visueel over de marktverhoudingen — en die verhoudingen zijn nu juist de kern van deze visualisatie, waarover meer in de gids over wat Crypto Bubbles is.

Hoe kies je een data-API: zes criteria

Criterium	Wat je vraagt	Waar je op moet letten
Marktdekking	Hoeveel munten en exchanges worden gedekt? Worden market caps berekend?	„10.000 munten” wordt soms geteld inclusief dode tokens zonder volume
WebSocket	Is er een livestream en wat omvat die (ticks, transacties, orderboek)?	Sommige abonnementen bieden WS pas vanaf de betaalde laag
Rate limits	Hoeveel verzoeken per minuut/maand in jouw plan?	Limieten per endpoint kunnen je midden in de maand verrassen
Prijs	De kosten van het plan bij je reële verkeer, niet dat van vandaag	Prijssprongen tussen de lagen kunnen een veelvoud zijn
Historische data	Hoe ver terug reiken de candles en met welke resolutie?	Gratis plannen geven vaak alleen dagen, geen jaren
Stabiliteit en SLA	Statuspagina, storingshistorie, beschikbaarheidsgaranties	Geen publieke statuspagina is op zichzelf al een antwoord

Nog een aparte opmerking over exchange-API's als volwaardige bron: draait je project om handelen — backtesting, een bot, het monitoren van je eigen orders — dan is de API van een exchange niet zozeer een alternatief als wel een noodzaak, want alleen die geeft je het orderboek, de transactiehistorie en de mogelijkheid om orders te plaatsen. De documentatie van volwassen exchanges biedt REST en WebSocket, sandboxes om te testen en clientbibliotheken in populaire talen. Het is ook de kortste route om de theorie van deze pagina te laten botsen met een echte datastroom.

Informatie over de functies van de officiële Crypto Bubbles-app (aantal munten, platforms, verversingsfrequentie) ontlenen we aan cryptobubbles.net (stand: juli 2026).