APIs Bitcoin &
Guia para Desenvolvedores

O protocolo aberto e a blockchain transparente do Bitcoin fazem dele um dos sistemas financeiros mais amigáveis para desenvolvedores já criados. Se você quer construir uma integração de pagamento, analisar dados on-chain, acompanhar preços do Bitcoin, criar uma aplicação de carteira ou construir na Lightning Network, um rico ecossistema de APIs e bibliotecas está disponível. Este guia mapeia o panorama e ajuda você a escolher as ferramentas certas para seu projeto.

Que Tipos de APIs Bitcoin Existem?

APIs Bitcoin se dividem em quatro categorias principais, cada uma servindo diferentes necessidades de desenvolvimento.

Começando: API do Mempool.space

Mempool.space é o ponto de partida recomendado para a maioria dos desenvolvedores. Fornece acesso gratuito e open-source a dados da blockchain Bitcoin sem necessidade de chave API.

// JavaScript / Node.js
const response = await fetch(
  'https://mempool.space/api/v1/fees/recommended'
);
const fees = await response.json();
// { fastestFee: 12, halfHourFee: 8, hourFee: 4, economyFee: 2 }
console.log(`Taxa próximo bloco: ${fees.fastestFee} sat/vB`);

# Python
import requests

address = 'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh'
url = f'https://mempool.space/api/address/{address}'
data = requests.get(url).json()

funded = data['chain_stats']['funded_txo_sum']
spent = data['chain_stats']['spent_txo_sum']
balance_sats = funded - spent
print(f'Saldo: {balance_sats} sats ({balance_sats/1e8} BTC)')

Bitcoin Core JSON-RPC

Para aplicações de produção, rodar seu próprio node Bitcoin Core fornece a fonte de dados mais confiável e privada. A API JSON-RPC expõe mais de 100 comandos para consultas blockchain, gerenciamento de transações e operações de carteira.

# Usando curl com Bitcoin Core RPC
curl --user myuser:mypassword \
  --data-binary '{"jsonrpc":"1.0","method":"getblockcount"}' \
  -H 'Content-Type: text/plain;' \
  http://127.0.0.1:8332/

# Resposta: {"result":890123,"error":null,"id":null}

API de Preços do CoinGecko

CoinGecko fornece dados gratuitos de mercado de criptomoedas sem necessidade de chave API para uso básico. É a escolha mais popular para dados de preço, gráficos históricos e métricas de mercado.

// JavaScript - CoinGecko API (sem chave necessária)
const response = await fetch(
  'https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd,eur,gbp'
);
const data = await response.json();
// { bitcoin: { usd: 87500, eur: 80200, gbp: 69800 } }
console.log(`BTC/USD: $${data.bitcoin.usd.toLocaleString()}`);

API do Blockchain.info

Uma das APIs de dados Bitcoin mais antigas, Blockchain.info fornece endpoints REST simples para consultar transações, blocos e taxas de câmbio. Sem necessidade de chave API para consultas básicas.

# Python - Blockchain.info API
import requests

# Obter taxas de câmbio atuais do Bitcoin
rates = requests.get('https://blockchain.info/ticker').json()
usd_price = rates['USD']['last']
print(f'BTC/USD: ${usd_price:,.2f}')

# Obter contagem de transações do endereço
addr = 'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh'
info = requests.get(f'https://blockchain.info/rawaddr/{addr}?limit=0').json()
print(f'Total de transações: {info["n_tx"]}')

Você Deveria Usar APIs Bitcoin Gratuitas ou Pagas?

Como Construir um Rastreador de Preço do Bitcoin?

Aqui está um exemplo completo combinando múltiplas APIs para construir um rastreador simples de preço do Bitcoin com consciência de taxas. Este padrão é comum em dashboards, apps de portfólio e serviços de notificação.

interface BitcoinData {
  price: { usd: number; eur: number };
  fees: { fastest: number; halfHour: number; hour: number };
  blockHeight: number;
}

async function getBitcoinData(): Promise<BitcoinData> {
  const [priceRes, feeRes, blockRes] = await Promise.all([
    fetch('https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd,eur'),
    fetch('https://mempool.space/api/v1/fees/recommended'),
    fetch('https://mempool.space/api/blocks/tip/height'),
  ]);

  const price = await priceRes.json();
  const fees = await feeRes.json();
  const blockHeight = await blockRes.json();

  return {
    price: { usd: price.bitcoin.usd, eur: price.bitcoin.eur },
    fees: { fastest: fees.fastestFee, halfHour: fees.halfHourFee, hour: fees.hourFee },
    blockHeight,
  };
}

// Uso
const data = await getBitcoinData();
console.log(`BTC: $${data.price.usd.toLocaleString()}`);
console.log(`Taxa próximo bloco: ${data.fees.fastest} sat/vB`);
console.log(`Altura do bloco: ${data.blockHeight.toLocaleString()}`);

Como Construir na Lightning Network?

A Lightning Network permite pagamentos Bitcoin instantâneos e de baixo custo e é essencial para aplicações que exigem liquidação em frações de segundo. As principais implementações são LND (Go), Core Lightning (C) e Eclair (Scala), cada uma com APIs abrangentes. Para aplicações que precisam de Lightning sem rodar infraestrutura, soluções hospedadas como Strike API, Alby e Voltage fornecem acesso gerenciado à Lightning.

Quais APIs Suportam Dados Bitcoin em Tempo Real?

APIs REST são adequadas para polling periódico, mas aplicações em tempo real se beneficiam de conexões WebSocket que enviam atualizações conforme acontecem. Mempool.space fornece uma API WebSocket para dados ao vivo de mempool e blocos, enquanto exchanges como Kraken e Coinbase oferecem feeds WebSocket para dados de preço em tempo real.

// Navegador ou Node.js com pacote ws
const ws = new WebSocket('wss://mempool.space/api/v1/ws');

ws.onopen = () => {
  // Inscrever-se para notificações de novos blocos
  ws.send(JSON.stringify({ action: 'want', data: ['blocks'] }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data.block) {
    console.log(`Novo bloco: #${data.block.height}`);
    console.log(`Transações: ${data.block.tx_count}`);
    console.log(`Tamanho: ${(data.block.size / 1e6).toFixed(2)} MB`);
  }
};

const ws = new WebSocket('wss://ws.kraken.com');

ws.onopen = () => {
  ws.send(JSON.stringify({
    event: 'subscribe',
    pair: ['XBT/USD'],
    subscription: { name: 'ticker' },
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (Array.isArray(msg) && msg[2] === 'ticker') {
    const ticker = msg[1];
    console.log(`BTC/USD: $${parseFloat(ticker.c[0]).toLocaleString()}`);
  }
};

Ao usar conexões WebSocket em produção, implemente reconexão automática com backoff exponencial. Conexões cairão periodicamente devido a manutenção do servidor, instabilidade de rede ou timeouts de inatividade. Pings de keep-alive (tipicamente a cada 30 segundos) ajudam a detectar conexões obsoletas mais cedo.

Como Proteger Sua Integração de API Bitcoin?

Construir com Bitcoin requer atenção cuidadosa à segurança. Chaves de API, chaves privadas e dados de transação são alvos de alto valor. Siga estas práticas para proteger sua aplicação e seus usuários.

Início Rápido de Integração de Pagamentos

Para comerciantes e empresas que desejam aceitar pagamentos Bitcoin, o caminho mais rápido é a API do Strike (endpoints REST simples, suporte Lightning, 0,3% de taxa) ou a API Greenfield do BTCPay Server (auto-hospedado, zero taxas, controle total). Ambos suportam webhooks para notificações de pagamento, geração de faturas e conversão automática para moeda fiduciária.

Bibliotecas Essenciais por Linguagem

Checklist de Início para Desenvolvedores

Por Onde Começar Com APIs Bitcoin?

O ecossistema de APIs do Bitcoin é maduro, bem documentado e acessível a desenvolvedores de todos os níveis. Comece com Mempool.space para operações de leitura, adicione Strike ou BTCPay para pagamentos, e use as ferramentas de estimativa de taxas para otimizar custos de transação. Evolua para rodar seu próprio node conforme sua aplicação cresce. A natureza open-source do Bitcoin significa que você nunca fica preso a um único provedor, e a comunidade está entre as mais prestativas em todo o desenvolvimento de software.

Perguntas Frequentes