brapi vs HG Brasil API 2026: Comparativo Completo para Dados Financeiros

const response = await fetch(
  "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData,balanceSheetHistory",
  { headers: { Authorization: `Bearer ${token}` } }
);
const { results } = await response.json();
const dados = results[0];

// Cotação + Fundamentalistas + Indicadores disponíveis
// Preço, P/L, ROE, Balanço, DRE, etc.

const response = await fetch(
  `https://api.hgbrasil.com/finance/stock_price?key=${apiKey}&symbol=PETR4`
);
const dados = await response.json();

// Apenas preço e variação básica
// Sem dados fundamentalistas ou indicadores financeiros

const response = await fetch(
  "https://brapi.dev/api/quote/ITUB4?modules=balanceSheetHistory,incomeStatementHistory,cashflowStatementHistory",
  { headers: { Authorization: `Bearer ${token}` } }
);
const { results } = await response.json();
const dados = results[0];

// Acesso a anos de histórico de demonstrativos
const balanco = dados.balanceSheetHistory.balanceSheetHistory;
const dre = dados.incomeStatementHistory.incomeStatementHistory;

// brapi.dev - Dividendos completos
const response = await fetch(
  "https://brapi.dev/api/quote/BBAS3?dividends=true",
  { headers: { Authorization: `Bearer ${token}` } }
);
const { results } = await response.json();
const dividendos = results[0].dividendsData.cashDividends;
// Acesso a datas de pagamento, valores por ação, etc.

// Até 10+ anos de histórico
const response = await fetch(
  "https://brapi.dev/api/quote/VALE3?range=5y&interval=1d",
  { headers: { Authorization: `Bearer ${token}` } }
);
const { results } = await response.json();
const historico = results[0].historicalDataPrice;
// Acesso a milhares de candles OHLCV

const response = await fetch("https://brapi.dev/api/v2/currency?currency=USD-BRL,EUR-BRL");
const { currency } = await response.json();
// Array com name, bid, ask, etc.

const response = await fetch(`https://api.hgbrasil.com/finance?key=${apiKey}`);
const dados = await response.json();
const usd = dados.results.currencies.USD;
// Acesso a cotação de compra/venda

ANÁLISE DE CUSTO PARA DADOS COMPLETOS DE AÇÕES

brapi.dev Pro (R$ 99,99/mês):
✅ 500.000 requisições
✅ Dados fundamentalistas completos
✅ Histórico de dividendos
✅ 10+ anos de cotações
✅ Indicadores financeiros

HG Brasil:
✅ Cotações básicas
✅ Câmbio e indicadores
❌ Sem fundamentalistas
❌ Sem dividendos
❌ Histórico limitado

Para análise de ações → brapi.dev
Para apenas câmbio → Ambos funcionam

async function getStockHG(symbol: string, apiKey: string) {
  const response = await fetch(
    `https://api.hgbrasil.com/finance/stock_price?key=${apiKey}&symbol=${symbol}`
  );
  return response.json();
}

async function getStockBrapi(symbol: string, token?: string) {
  const url = `https://brapi.dev/api/quote/${symbol}`;
  const headers = token ? { Authorization: `Bearer ${token}` } : {};
  
  const response = await fetch(url, { headers });
  return response.json();
}

// Mesma simplicidade, mais dados disponíveis
const dados = await getStockBrapi("PETR4", token);

// Agora você pode adicionar:
// - Fundamentalistas: ?modules=defaultKeyStatistics
// - Dividendos: ?dividends=true
// - Histórico: ?range=1y&interval=1d