Crypto Bubbles API: dari mana data sebenarnya mengalir dan cara membangun board sendiri

Jujur dari awal

Apakah Crypto Bubbles punya API publik?

Mari mulai dari alasan kebanyakan orang mendarat di halaman ini. Situs resmi cryptobubbles.net tidak mengiklankan API publik yang terdokumentasi untuk developer. Tidak ada portal developer di sana, tidak ada daftar harga per permintaan, tidak ada dokumentasi endpoint. Crypto Bubbles adalah produk konsumen — visualisasi untuk lebih dari seribu koin, disegarkan otomatis, tersedia di browser dan aplikasi mobile (begitulah situs resminya memperkenalkannya) — bukan gudang grosir data.

Kami menuliskannya blak-blakan karena di internet beredar cukup banyak tutorial yang menyiratkan sebaliknya, atau — lebih buruk — menyamar sebagai „API resmi Crypto Bubbles” lengkap dengan kunci yang bisa dibeli. Perlakukan tawaran semacam itu seperti APK palsu dari forum: seseorang mencoba menjual sesuatu yang tidak pernah ditawarkan pembuat produknya. Prinsip dari panduan mengunduh aplikasi kami berlaku juga di sini — satu-satunya sumber kebenaran tentang produk resmi adalah cryptobubbles.net.

Sekarang kabar baiknya: untuk membangun papan gelembung sendiri, Anda sama sekali tidak membutuhkan API aplikasi tertentu. Gelembung hanyalah cara menggambar data yang memang sudah dipublikasikan pasar. Yang Anda perlukan hanyalah empat angka per koin dan empat puluh baris kode. Sisa halaman ini kami dedikasikan persis untuk itu.

Bagaimana aplikasi gelembung mendapatkan data: rantai tiga mata rantai

Setiap visualisasi pasar — dari gelembung sampai heatmap yang kami bahas di panduan peta pasar — berdiri di atas rantai pasokan yang sama:

• Mata rantai 1: bursa. Sumber primer setiap harga adalah order book bursa tertentu. Di sanalah transaksi terjadi, dan „harga bitcoin” sesungguhnya adalah puluhan harga dari puluhan lantai perdagangan yang berbeda sepersekian persen satu sama lain.
• Mata rantai 2: agregator. Layanan data mengumpulkan kuotasi dari ratusan bursa, merata-ratakannya (biasanya dengan bobot volume), menambahkan suplai beredar, lalu menyajikan metrik jadi: kapitalisasi, peringkat, perubahan persentase pada jendela waktu standar.
• Mata rantai 3: aplikasi. Visualisasi seperti papan gelembung mengambil JSON yang sudah dinormalkan dari agregator dan mengubah angka menjadi geometri dan warna. Seluruh „sulapnya” terjadi di browser pengguna.

Pembagian ini punya konsekuensi praktis untuk proyek Anda: Anda bisa menyambung di mata rantai mana pun. Agregator memberi kenyamanan — satu endpoint, ribuan koin, kapitalisasi yang sudah dihitung. Bursa memberi kesegaran — data langsung dari order book, tanpa perantara dan tanpa jeda perata-rataan, tetapi hanya untuk pasangan yang tercatat di satu lantai itu. Proyek yang matang sering menggabungkan keduanya: agregator untuk peringkat dan kapitalisasi, bursa untuk harga real-time.

Bengkel kerja

Mini-tutorial: papan gelembung sendiri dalam satu malam

Berikut kerangkanya dalam JavaScript — pseudokode yang sengaja disederhanakan, tinggal dilengkapi alamat API pilihan Anda. Logikanya tiga tahap: ambil ticker, konversi kapitalisasi menjadi radius dan perubahan persentase menjadi warna, lalu gambar.

// 1. Ambil data (REST, penyegaran tiap 60 dtk)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // kunci API di header, jangan pernah di kode
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // buang koin mati
}

// 2. Penskalaan: radius ~ akar kuadrat kapitalisasi
//    (mata membandingkan LUAS lingkaran, bukan radius!)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. Warna: hijau untuk kenaikan, merah untuk penurunan,
//    saturasi naik mengikuti nilai absolut perubahan
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // saturasi penuh mulai ±15%
  return changePct >= 0
    ? `rgba(34, 197, 94, ${0.35 + 0.65 * sat})`
    : `rgba(239, 68, 68, ${0.35 + 0.65 * sat})`;
}

// 4. Menggambar: canvas + simulasi tolak-menolak sederhana
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);

Dua petunjuk di luar kerangka di atas. Pertama, fisika penempatan: agar gelembung tidak saling menumpuk, gunakan simulasi gaya yang sudah jadi — di pustaka d3 ada modul d3-force dengan deteksi tabrakan (forceCollide); di canvas murni, cukup loop yang mendorong menjauh lingkaran-lingkaran yang berpotongan. Kedua, akar kuadrat pada fungsi radius bukan gaya-gayaan: luas lingkaran tumbuh sebanding kuadrat radius, sehingga penskalaan radius secara linear akan membuat koin yang 100 kali lebih besar memakan 10.000 kali lebih banyak layar. Separuh papan „amatiran” di internet melakukan persis kesalahan ini dan berbohong secara visual tentang proporsi pasar — padahal proporsi adalah inti dari visualisasi ini, sebagaimana kami bahas lebih dalam di panduan tentang apa itu Crypto Bubbles.

Cara memilih API data: enam kriteria

Kriteria	Apa yang perlu ditanyakan	Apa yang perlu diwaspadai
Cakupan pasar	Berapa banyak koin dan bursa yang dicakup? Apakah kapitalisasi ikut dihitung?	„10.000 koin” kadang dihitung termasuk token mati tanpa volume
WebSocket	Adakah stream langsung dan apa isinya (tick, transaksi, order book)?	Sebagian paket baru menawarkan WS mulai dari tingkatan berbayar
Batas permintaan	Berapa permintaan per menit/bulan di paket Anda?	Limit yang dihitung per endpoint bisa mengejutkan di tengah bulan
Harga	Biaya paket pada trafik riil Anda nanti, bukan trafik hari ini	Lonjakan harga antar-tingkatan bisa berlipat-lipat
Data historis	Seberapa jauh ke belakang candle tersedia dan dengan resolusi apa?	Paket gratis sering hanya memberi hitungan hari, bukan tahun
Stabilitas dan SLA	Halaman status, riwayat gangguan, jaminan ketersediaan	Tidak adanya halaman status publik sudah merupakan jawaban tersendiri

Catatan tersendiri soal API bursa sebagai sumber kelas satu: jika proyek Anda menyangkut trading — backtesting, bot, pemantau order sendiri — API bursa bukan sekadar alternatif melainkan keharusan, karena hanya ia yang memberi Anda order book, riwayat transaksi, dan akses untuk memasang order. Dokumentasi bursa yang matang menawarkan REST dan WebSocket, sandbox untuk uji coba, serta pustaka klien dalam bahasa-bahasa populer. Itu juga jalan terpendek untuk membenturkan teori dari halaman ini dengan aliran data sungguhan.

Informasi tentang fitur aplikasi resmi Crypto Bubbles (cakupan koin, platform, frekuensi penyegaran) kami kutip dari cryptobubbles.net (per Juli 2026).