brapi vs Yahoo Finance API 2026: Comparativo Completo para Desenvolvedores

// Usando yfinance (Python) - pode falhar sem aviso
// import yfinance as yf
// petr4 = yf.Ticker("PETR4.SA")  // Sufixo .SA obrigatório
// dados = petr4.history(period="1mo")  // Frequentemente retorna erro

const response = await fetch('https://brapi.dev/api/quote/PETR4');
const { results } = await response.json();
console.log(`Preço: R$ ${results[0].regularMarketPrice}`);
// Preço: R$ 37.85

// Precisa de biblioteca externa (yfinance)
// Sufixo .SA obrigatório para ações brasileiras
// Pode falhar sem aviso ou retornar dados vazios
// import yfinance as yf
// ticker = yf.Ticker("PETR4.SA")
// info = ticker.info  // Frequentemente retorna vazio para BR

{
  "results": [{
    "symbol": "PETR4",
    "shortName": "PETROBRAS PN",
    "longName": "Petróleo Brasileiro S.A. - Petrobras",
    "currency": "BRL",
    "regularMarketPrice": 37.85,
    "regularMarketChange": 0.45,
    "regularMarketChangePercent": 1.20,
    "regularMarketVolume": 45678900,
    "regularMarketDayHigh": 38.10,
    "regularMarketDayLow": 37.20
  }],
  "requestedAt": "2026-01-15T14:30:00.000Z",
  "took": "45ms"
}

// Até 20 ações em uma única chamada
const response = await fetch('https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,BBDC4,ABEV3');
const { results } = await response.json();

results.forEach(acao => {
  console.log(`${acao.symbol}: R$ ${acao.regularMarketPrice}`);
});

// Funciona, mas é menos confiável
// Cada ticker precisa do sufixo .SA e pode falhar individualmente
// tickers = yf.Tickers("PETR4.SA VALE3.SA ITUB4.SA")

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

const stats = dados.defaultKeyStatistics;
console.log(`ROE: ${(stats.returnOnEquity * 100).toFixed(2)}%`);
console.log(`P/L: ${stats.trailingPE.toFixed(2)}`);
console.log(`P/VP: ${stats.priceToBook.toFixed(2)}`);

// Dados podem estar incompletos ou indisponíveis para ações brasileiras
// Campos como ROE frequentemente retornam N/A para empresas BR
// ticker.balance_sheet retorna DataFrame (formato diferente)

const response = await fetch(
  'https://brapi.dev/api/quote/PETR4?range=1y&interval=1d',
  { headers: { Authorization: `Bearer ${token}` } }
);
const { results } = await response.json();
const historico = results[0].historicalDataPrice;

// Últimos 5 dias
historico.slice(-5).forEach(candle => {
  console.log(`${candle.date}: O:${candle.open} H:${candle.high} L:${candle.low} C:${candle.close}`);
});

// Retorna DataFrame pandas (mais pesado)
// Estrutura diferente do JSON
// ticker.history(period="1y", interval="1d")

ANÁLISE DE CUSTO PARA 100.000 REQ/MÊS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

brapi.dev Startup: R$ 59,99/mês
✅ Suporte brasileiro
✅ Documentação PT-BR
✅ Dados otimizados para BR
✅ SLA garantido

Yahoo Finance (RapidAPI): ~$29/mês (~R$ 150)
❌ Sem suporte
❌ Documentação só em inglês
❌ Dados BR incompletos
❌ Sem garantias

💰 ECONOMIA: ~R$ 90/mês com brapi.dev

// Função legada com Yahoo Finance
// Requer biblioteca yfinance, sufixo .SA, e frequentemente falha
// def get_stock_data_yahoo(ticker):
//     stock = yf.Ticker(f"{ticker}.SA")
//     info = stock.info  // Pode retornar vazio
//     return { price: info.get('regularMarketPrice') }

async function getStockData(ticker: string, token?: string) {
  const url = token 
    ? `https://brapi.dev/api/quote/${ticker}?token=${token}`
    : `https://brapi.dev/api/quote/${ticker}`;
  
  const response = await fetch(url);
  const { results } = await response.json();
  
  if (results?.length) {
    const stock = results[0];
    return {
      symbol: stock.symbol,
      price: stock.regularMarketPrice,
      change: stock.regularMarketChangePercent,
      volume: stock.regularMarketVolume
    };
  }
  return null;
}

// Uso idêntico, resultado mais confiável
const dados = await getStockData('PETR4');

// Cliente TypeScript para brapi.dev
const BRAPI_TOKEN = "SEU_TOKEN";

// Buscar cotações de múltiplas ações
const response = await fetch(
  "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,WEGE3,ABEV3",
  { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } }
);
const data = await response.json();

// Exibir dashboard
data.results.forEach((stock) => {
  const emoji = stock.regularMarketChangePercent > 0 ? "🟢" : "🔴";
  console.log(`${emoji} ${stock.symbol}: R$ ${stock.regularMarketPrice.toFixed(2)} (${stock.regularMarketChangePercent.toFixed(2)}%)`);
});

// Buscar dados fundamentalistas
const fundamentosResponse = await fetch(
  "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData",
  { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } }
);
const fundamentos = await fundamentosResponse.json();

// Buscar histórico
const historicoResponse = await fetch(
  "https://brapi.dev/api/quote/PETR4?range=1mo&interval=1d",
  { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } }
);
const historico = await historicoResponse.json();