Crypto Bubbles API: de unde curg datele cu adevărat și cum îți construiești propriul board

Onest din prima clipă

Crypto Bubbles are un API public?

Să începem cu motivul pentru care ajung aici majoritatea oamenilor. Site-ul oficial cryptobubbles.net nu promovează un API public, documentat, pentru dezvoltatori. Nu există acolo un portal de dezvoltatori, un tarif per cerere sau o documentație de endpoint-uri. Crypto Bubbles e un produs de consum — o vizualizare pentru peste o mie de monede, reîmprospătată automat, disponibilă în browser și în aplicații mobile (așa îl prezintă propriul site) — nu un depozit angro de date.

O scriem răspicat, pentru că pe internet circulă destule ghiduri care sugerează contrariul sau — mai rău — se dau drept „API-ul oficial Crypto Bubbles” cu chei de vânzare. Tratează asemenea oferte ca pe fișierele APK false de pe forumuri: cineva încearcă să-ți vândă ceva ce producătorul nu oferă. Regula din ghidul nostru de descărcare a aplicației e valabilă și aici — sursa adevărului despre produsul oficial este exclusiv cryptobubbles.net.

Și acum vestea bună: ca să-ți construiești propriul tablou cu bule, nu ai nevoie deloc de API-ul unei aplicații anume. Bulele sunt doar un mod de a desena date pe care piața le publică oricum. Ai nevoie de patru cifre per monedă și de patruzeci de linii de cod. Restul acestei pagini e dedicat exact acestui lucru.

Cum obțin datele aplicațiile cu bule: un lanț în trei verigi

Orice vizualizare a pieței — de la bule la heatmap-urile despre care scriem în ghidul despre harta pieței — stă pe același lanț de aprovizionare:

• Veriga 1: exchange-urile. Sursa primară a oricărui preț e registrul de ordine al unui exchange anume. Aici se încheie tranzacțiile, iar prețul „bitcoinului” e în realitate zeci de prețuri de pe zeci de piețe, care diferă cu fracțiuni de procent.
• Veriga 2: agregatoarele. Serviciile de date adună cotațiile din sute de exchange-uri, le mediază (de obicei ponderat cu volumul), adaugă oferta în circulație și expun metrici gata calculate: capitalizarea, clasamentul, variațiile procentuale în intervale de timp standard.
• Veriga 3: aplicațiile. Vizualizările precum tabloul cu bule descarcă de la agregatoare JSON normalizat și transformă cifrele în geometrie și culoare. Toată „magia” se întâmplă în browserul utilizatorului.

Această împărțire are o consecință practică pentru proiectul tău: te poți conecta la oricare verigă. Agregatorul îți dă comoditate — un singur endpoint, mii de monede, capitalizări gata calculate. Exchange-ul îți dă prospețime — date direct din registru, fără intermediar și fără întârzierile medierii, dar numai pentru perechile listate pe acea piață. Proiectele mature combină adesea ambele surse: agregatorul pentru clasament și capitalizare, exchange-ul pentru prețuri în timp real.

Atelier

Mini-tutorial: propriul tablou cu bule într-o singură seară

Mai jos, un schelet în JavaScript — pseudocod simplificat intenționat, de completat cu adresa API-ului ales. Logica are trei etape: descarcă tickerele, transformă capitalizarea în rază și variația procentuală în culoare, desenează.

// 1. Descarcă datele (REST, reîmprospătare la 60 s)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // cheia API în header, niciodată în cod
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // taie monedele moarte
}

// 2. Scalare: raza ~ rădăcina pătrată a capitalizării
//    (ochiul compară SUPRAFEȚELE cercurilor, nu razele!)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. Culoare: verde pentru creștere, roșu pentru scădere,
//    saturația crește cu valoarea absolută a variației
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // saturație maximă de la ±15%
  return changePct >= 0
    ? `rgba(34, 197, 94, ${0.35 + 0.65 * sat})`
    : `rgba(239, 68, 68, ${0.35 + 0.65 * sat})`;
}

// 4. Desenare: canvas + o simulare simplă de respingere
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);

Două indicații dincolo de schelet. Prima, fizica așezării: ca bulele să nu se suprapună, folosește o simulare de forțe gata făcută — în biblioteca d3 e modulul d3-force cu coliziuni (forceCollide), pe canvas pur ajunge o buclă care respinge cercurile care se intersectează. A doua, rădăcina pătrată din funcția razei nu e un moft: suprafața cercului crește cu pătratul razei, deci scalarea liniară a razei ar face ca o monedă de 100 de ori mai mare să ocupe de 10 000 de ori mai mult ecran. Jumătate dintre tablourile „de amatori” de pe internet fac exact această greșeală și mint vizual despre proporțiile pieței — iar proporțiile sunt tot miezul acestei vizualizări, despre care scriem pe larg în ghidul despre ce este Crypto Bubbles.

Cum alegi un API de date: șase criterii

Criteriu	Ce să întrebi	La ce să fii atent
Acoperirea pieței	Câte monede și exchange-uri cuprinde? Calculează capitalizări?	„10 000 de monede” include uneori tokeni morți, fără volum
WebSocket	Există flux live și la ce se referă (tick-uri, tranzacții, registru)?	Unele planuri oferă WS doar de la pragul plătit în sus
Limite de cereri	Câte cereri pe minut/lună în planul tău?	Limitele calculate per endpoint pot surprinde la mijlocul lunii
Preț	Costul planului la traficul tău real, nu la cel de azi	Salturile de preț între praguri sunt uneori de câteva ori
Date istorice	Cât de departe în urmă merg lumânările și cu ce rezoluție?	Planurile gratuite dau adesea doar zile, nu ani
Stabilitate și SLA	Pagină de status, istoricul avariilor, garanții de disponibilitate	Lipsa unei pagini publice de status e un răspuns în sine

O observație separată despre API-urile de exchange ca sursă de sine stătătoare: dacă proiectul tău ține de trading — backtesting, bot, monitorizarea propriilor ordine — API-ul exchange-ului nu e atât o alternativă, cât o necesitate, pentru că doar el îți dă registrul de ordine, istoricul tranzacțiilor și posibilitatea de a plasa ordine. Documentațiile exchange-urilor mature oferă REST și WebSocket, sandbox-uri de testare și biblioteci client în limbajele populare. E și cea mai scurtă cale de a confrunta teoria de pe această pagină cu un flux de date adevărat.

Informațiile despre funcțiile aplicației oficiale Crypto Bubbles (gama de monede, platformele, frecvența reîmprospătării) sunt preluate de pe cryptobubbles.net (situația: iulie 2026).