Crypto Bubbles API: de onde os dados fluem de verdade e como montar seu próprio board

Honestidade desde a porta

O Crypto Bubbles tem API pública?

Comecemos pelo motivo que traz a maioria das pessoas até aqui. O site oficial cryptobubbles.net não anuncia uma API pública e documentada para desenvolvedores. Não existe lá um portal de desenvolvedor, tabela de preços por requisição nem documentação de endpoints. O Crypto Bubbles é um produto de consumo — uma visualização com mais de mil moedas, atualizada automaticamente, disponível no navegador e em aplicativos móveis (é assim que o próprio site o apresenta) — e não um atacadista de dados.

Escrevemos isso com todas as letras porque circulam pela internet vários tutoriais sugerindo o contrário ou — pior — se passando por uma “API oficial do Crypto Bubbles” com chaves à venda. Trate essas ofertas como os APKs falsos de fórum: alguém está tentando te vender algo que o fabricante não oferece. A regra do nosso guia de download do aplicativo vale aqui também — a fonte da verdade sobre o produto oficial é exclusivamente cryptobubbles.net.

E agora a boa notícia: para montar o seu próprio painel de bolhas, você não precisa da API de nenhum aplicativo específico. As bolhas são só um jeito de desenhar dados que o mercado publica de qualquer forma. Você precisa de quatro números por moeda e de quarenta linhas de código. O resto desta página é dedicado exatamente a isso.

Como os apps de bolhas conseguem os dados: uma cadeia de três elos

Toda visualização de mercado — das bolhas aos heatmaps, sobre os quais falamos no guia do mapa do mercado — se apoia na mesma cadeia de suprimentos:

• Elo 1: as exchanges. A fonte primária de qualquer preço é o livro de ofertas de uma exchange concreta. É ali que as transações acontecem, e o preço “do bitcoin” é, na prática, dezenas de preços de dezenas de pregões, com diferenças de frações de por cento entre si.
• Elo 2: os agregadores. Os serviços de dados coletam as cotações de centenas de exchanges, calculam a média (geralmente ponderada pelo volume), acrescentam o supply em circulação e publicam métricas prontas: market cap, ranking, variações percentuais nas janelas de tempo padrão.
• Elo 3: os aplicativos. Visualizações como o painel de bolhas baixam dos agregadores um JSON normalizado e convertem números em geometria e cor. Toda a “mágica” acontece no navegador do usuário.

Essa divisão tem uma consequência prática para o seu projeto: você pode se plugar em qualquer elo. O agregador te dá comodidade — um endpoint, milhares de moedas, market caps já calculados. A exchange te dá frescor — dados direto do livro de ofertas, sem intermediário e sem o atraso da média, mas apenas para os pares negociados naquele pregão. Projetos maduros costumam combinar as duas fontes: o agregador para ranking e market cap, a exchange para preços em tempo real.

Oficina

Minitutorial: seu próprio painel de bolhas em uma noite

Abaixo, um esqueleto em JavaScript — pseudocódigo propositalmente simplificado, a completar com o endereço da API escolhida. A lógica tem três etapas: buscar os tickers, converter market cap em raio e variação percentual em cor, desenhar.

// 1. Busque os dados (REST, atualização a cada 60 s)
async function fetchCoins() {
  const res = await fetch(API_URL + '/tickers?limit=100'); // chave de API no header, nunca no código
  const coins = await res.json();
  return coins.filter(c => c.volume24h > 1_000_000); // corte as moedas mortas
}

// 2. Escala: raio ~ raiz quadrada do market cap
//    (o olho compara as ÁREAS dos círculos, não os raios!)
function radius(cap, maxCap) {
  const R_MAX = 90, R_MIN = 6;
  return Math.max(R_MIN, R_MAX * Math.sqrt(cap / maxCap));
}

// 3. Cor: verde para alta, vermelho para queda,
//    a saturação cresce com o valor absoluto da variação
function color(changePct) {
  const sat = Math.min(Math.abs(changePct) / 15, 1); // saturação total a 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. Desenho: canvas + uma simulação simples de repulsão
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);

Duas dicas que vão além do esqueleto. Primeira, a física de posicionamento: para que as bolhas não se sobreponham, use uma simulação de forças pronta — na biblioteca d3, é o módulo d3-force com colisões (forceCollide); em canvas puro, basta um loop que repele os círculos que se cruzam. Segunda, a raiz quadrada na função do raio não é frescura: a área do círculo cresce com o quadrado do raio, então escalar o raio linearmente faria uma moeda 100 vezes maior ocupar 10.000 vezes mais tela. Metade dos painéis “amadores” da internet comete exatamente esse erro e mente visualmente sobre as proporções do mercado — e as proporções são toda a essência dessa visualização, como detalhamos no guia sobre o que é o Crypto Bubbles.

Como escolher uma API de dados: seis critérios

Critério	O que perguntar	Com o que tomar cuidado
Cobertura de mercado	Quantas moedas e exchanges cobre? Calcula market caps?	“10.000 moedas” às vezes inclui tokens mortos, sem volume
WebSocket	Existe stream ao vivo e do que ele trata (ticks, transações, livro)?	Alguns planos só oferecem WS a partir da faixa paga
Limites de requisições	Quantas requisições por minuto/mês no seu plano?	Limites contados por endpoint podem surpreender no meio do mês
Preço	Custo do plano com o seu tráfego real, não com o de hoje	Os saltos de preço entre faixas chegam a ser de várias vezes
Dados históricos	Até onde os candles voltam no tempo e com que resolução?	Planos gratuitos costumam dar apenas dias, não anos
Estabilidade e SLA	Status page, histórico de incidentes, garantias de disponibilidade	Não ter status page público já é uma resposta por si só

Uma observação à parte sobre as APIs de exchange como fonte de pleno direito: se o seu projeto envolve negociação — backtesting, bot, monitor das suas próprias ordens —, a API da exchange não é tanto uma alternativa quanto uma necessidade, porque só ela te dá o livro de ofertas, o histórico de transações e o envio de ordens. As documentações das exchanges maduras oferecem REST e WebSocket, sandboxes para testes e bibliotecas cliente nas linguagens populares. É também o caminho mais curto para confrontar a teoria desta página com um fluxo de dados de verdade.

As informações sobre os recursos do aplicativo oficial Crypto Bubbles (cobertura de moedas, plataformas, frequência de atualização) citamos a partir de cryptobubbles.net (situação em julho de 2026).