Crypto Bubbles API: skąd naprawdę płyną dane i jak zbudować własny board

Uczciwie od progu

Czy Crypto Bubbles ma publiczne API?

Zacznijmy od tego, po co większość ludzi tu trafia. Oficjalna strona cryptobubbles.net nie reklamuje publicznego, udokumentowanego API dla deweloperów. Nie ma tam portalu deweloperskiego, cennika zapytań ani dokumentacji endpointów. Crypto Bubbles to produkt konsumencki — wizualizacja dla ponad tysiąca monet, odświeżana automatycznie, dostępna w przeglądarce i aplikacjach mobilnych (tak przedstawia go własna witryna) — a nie hurtownia danych.

Piszemy to wprost, bo w sieci krąży sporo poradników sugerujących coś przeciwnego albo — gorzej — podszywających się pod „oficjalne API Crypto Bubbles” z kluczami do kupienia. Traktuj takie oferty jak fałszywe APK z forów: ktoś próbuje sprzedać ci coś, czego producent nie oferuje. Zasada z naszego przewodnika po pobieraniu aplikacji obowiązuje i tutaj — źródłem prawdy o oficjalnym produkcie jest wyłącznie cryptobubbles.net.

I teraz dobra wiadomość: do zbudowania własnej planszy bąbelków w ogóle nie potrzebujesz API konkretnej aplikacji. Bąbelki to tylko sposób rysowania danych, które rynek i tak publikuje. Potrzebujesz czterech liczb na monetę i czterdziestu linijek kodu. Resztę tej strony poświęcamy właśnie temu.

Jak aplikacje bąbelkowe zdobywają dane: łańcuch w trzech ogniwach

Każda wizualizacja rynku — od bąbelków po heatmapy, o których piszemy w przewodniku po mapie rynku — stoi na tym samym łańcuchu dostaw:

• Ogniwo 1: giełdy. Pierwotnym źródłem każdej ceny jest arkusz zleceń konkretnej giełdy. To tu zawierane są transakcje, a cena „bitcoina” to w rzeczywistości dziesiątki cen z dziesiątek parkietów, różniących się o ułamki procenta.
• Ogniwo 2: agregatory. Serwisy danych zbierają notowania z setek giełd, uśredniają je (zwykle ważąc wolumenem), doliczają podaż w obiegu i wystawiają gotowe metryki: kapitalizację, ranking, zmiany procentowe w standardowych oknach czasowych.
• Ogniwo 3: aplikacje. Wizualizacje takie jak plansza bąbelkowa pobierają z agregatorów znormalizowany JSON i zamieniają liczby na geometrię i kolor. Cała „magia” dzieje się w przeglądarce użytkownika.

Ten podział ma praktyczną konsekwencję dla twojego projektu: możesz podpiąć się na dowolnym ogniwie. Agregator da ci wygodę — jeden endpoint, tysiące monet, policzone kapitalizacje. Giełda da ci świeżość — dane prosto z arkusza, bez pośrednika i bez opóźnień uśredniania, za to tylko dla par notowanych na tym jednym parkiecie. Dojrzałe projekty często łączą oba źródła: agregator do rankingu i kapitalizacji, giełdę do cen w czasie rzeczywistym.

Warsztat

Mini-tutorial: własna plansza bąbelków w jeden wieczór

Poniżej szkielet w JavaScripcie — celowo uproszczony pseudokod, do uzupełnienia adresem wybranego API. Logika jest trzyetapowa: pobierz tickery, przelicz kapitalizację na promień, zmianę procentową na kolor, narysuj.

// 1. Pobierz dane (REST, odświeżanie co 60 s)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // klucz API w nagłówku, nigdy w kodzie
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // odetnij martwe monety
}

// 2. Skalowanie: promień ~ pierwiastek z kapitalizacji
//    (oko porównuje POWIERZCHNIE kół, nie promienie!)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. Kolor: zielony dla wzrostu, czerwony dla spadku,
//    nasycenie rośnie z wartością bezwzględną zmiany
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // pełne nasycenie od ±15%
  return changePct >= 0
    ? `rgba(34, 197, 94, ${0.35 + 0.65 * sat})`
    : `rgba(239, 68, 68, ${0.35 + 0.65 * sat})`;
}

// 4. Rysowanie: canvas + prosta symulacja odpychania
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);

Dwie wskazówki wykraczające poza szkielet. Po pierwsze, fizyka rozmieszczania: żeby bąbelki się nie nakładały, użyj gotowej symulacji sił — w bibliotece d3 to moduł d3-force z kolizjami (forceCollide), na czystym canvasie wystarczy pętla odpychająca przecinające się okręgi. Po drugie, pierwiastek w funkcji promienia to nie fanaberia: powierzchnia koła rośnie z kwadratem promienia, więc liniowe skalowanie promienia sprawiłoby, że moneta 100 razy większa zajmie 10 000 razy więcej ekranu. Połowa „amatorskich” plansz w sieci popełnia dokładnie ten błąd i wizualnie kłamie o proporcjach rynku — a proporcje to całe sedno tej wizualizacji, o czym szerzej w przewodniku o tym, czym jest Crypto Bubbles.

Jak wybrać API danych: sześć kryteriów

Kryterium	O co pytać	Na co uważać
Pokrycie rynku	Ile monet i giełd obejmuje? Czy liczy kapitalizacje?	„10 000 monet” bywa liczone z martwymi tokenami bez wolumenu
WebSocket	Czy jest strumień na żywo i czego dotyczy (ticki, transakcje, arkusz)?	Część planów oferuje WS tylko od progu płatnego
Limity zapytań	Ile żądań na minutę/miesiąc w twoim planie?	Limity liczone per endpoint potrafią zaskoczyć w środku miesiąca
Cena	Koszt planu przy twoim realnym ruchu, nie przy dzisiejszym	Skoki cen między progami bywają kilkukrotne
Dane historyczne	Jak daleko wstecz sięgają świece i z jaką rozdzielczością?	Darmowe plany często dają tylko dni, nie lata
Stabilność i SLA	Status page, historia awarii, gwarancje dostępności	Brak publicznego status page'a to odpowiedź sama w sobie

Osobna uwaga o API giełdowych jako pełnoprawnym źródle: jeżeli twój projekt dotyczy handlu — backtesting, bot, monitor własnych zleceń — API giełdy jest nie tyle alternatywą, co koniecznością, bo tylko ono da ci arkusz zleceń, historię transakcji i dostęp do składania zleceń. Dokumentacje dojrzałych giełd oferują REST i WebSocket, sandboxy do testów i biblioteki klienckie w popularnych językach. To także najkrótsza droga, by zderzyć teorię z tej strony z prawdziwym strumieniem danych.

Informacje o funkcjach oficjalnej aplikacji Crypto Bubbles (zakres monet, platformy, częstotliwość odświeżania) podajemy za cryptobubbles.net (stan: lipiec 2026).