brapi vs Alpha Vantage 2026: Comparativo Completo de APIs Financeiras

// Consulta simples de ação brasileira
const response = await fetch("https://brapi.dev/api/quote/WEGE3", {
  headers: { Authorization: "Bearer SEU_TOKEN" }
});
const { results } = await response.json();
// results[0].regularMarketPrice → 35.42
// results[0].sector → "Bens Industriais"

// Tentando buscar ação brasileira - precisa adicionar .SAO
const response = await fetch(
  "https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=WEGE3.SAO&apikey=SUA_API_KEY"
);
const data = await response.json();
// Resultado: dados limitados ou indisponíveis
// Muitas ações brasileiras não são encontradas

// FIIs totalmente suportados - múltiplos em uma requisição
const response = await fetch("https://brapi.dev/api/quote/MXRF11,HGLG11,XPML11", {
  headers: { Authorization: "Bearer SEU_TOKEN" }
});
const { results } = await response.json();
// Retorna: cotação, dividend yield, P/VP, etc.

// FIIs NÃO suportados
const response = await fetch(
  "https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=MXRF11.SAO&apikey=KEY"
);
const data = await response.json();
// Resultado: Erro ou dados vazios

// Dados fundamentalistas completos
const response = await fetch("https://brapi.dev/api/quote/ITUB4?fundamental=true", {
  headers: { Authorization: "Bearer SEU_TOKEN" }
});
const { results } = await response.json();
const data = results[0];

// 50+ indicadores disponíveis:
const fundamentals = {
  // Valuation
  pl: data.priceEarnings,
  pvp: data.priceToBook,
  pReceita: data.priceToSales,
  evEbitda: data.enterpriseToEbitda,
  
  // Rentabilidade
  roe: data.returnOnEquity,
  roa: data.returnOnAssets,
  roic: data.returnOnCapital,
  margemLiquida: data.netMargin,
  margemEbitda: data.ebitdaMargin,
  
  // Dividendos
  dividendYield: data.dividendYield,
  payout: data.payoutRatio,
  
  // Endividamento
  dividaPl: data.debtToEquity,
  dividaEbitda: data.debtToEbitda,
  
  // Crescimento
  crescReceita5a: data.revenueGrowth5y,
  crescLucro5a: data.earningsGrowth5y,
};

// Alpha Vantage - Overview para ações brasileiras
const response = await fetch(
  "https://www.alphavantage.co/query?function=OVERVIEW&symbol=ITUB4.SAO&apikey=KEY"
);
const data = await response.json();
// Resultado: Muitos campos vazios ou inexistentes para Brasil

// TypeScript - Simples e direto
async function getQuote(ticker: string) {
  const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, {
    headers: { Authorization: "Bearer TOKEN" }
  });
  const { results } = await response.json();
  return results[0];
}

// Múltiplas ações em uma requisição
const response = await fetch("https://brapi.dev/api/quote/PETR4,VALE3,ITUB4", {
  headers: { Authorization: "Bearer TOKEN" }
});

// TypeScript/Next.js - SDK oficial
import { brapi } from '@brapi/sdk';

const client = brapi({ token: 'TOKEN' });

// Type-safe
const quote = await client.quote('PETR4');
console.log(quote.regularMarketPrice); // TypeScript sabe o tipo

// TypeScript - Mais verboso
async function getQuote(ticker: string) {
  const response = await fetch(
    `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${ticker}.SAO&apikey=API_KEY`
  );
  const data = await response.json();
  // Estrutura de resposta aninhada
  return data["Global Quote"] ?? {};
}

// Apenas uma ação por requisição
// Para 10 ações = 10 requisições

// Estratégia híbrida - roteamento automático
class FinanceAPI {
  constructor(
    private brapiToken: string,
    private alphaKey: string
  ) {}

  async getBrazilianStock(ticker: string) {
    const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, {
      headers: { Authorization: `Bearer ${this.brapiToken}` }
    });
    return response.json();
  }

  async getUSStock(ticker: string) {
    const response = await fetch(
      `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${ticker}&apikey=${this.alphaKey}`
    );
    return response.json();
  }

  async getStock(ticker: string) {
    // Roteamento automático baseado no padrão brasileiro
    const isBrazilian = /\d{1,2}$/.test(ticker); // termina em número
    return isBrazilian 
      ? this.getBrazilianStock(ticker) 
      : this.getUSStock(ticker);
  }
}

async function getPriceAlpha(ticker: string): Promise<number> {
  const response = await fetch(
    `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${ticker}.SAO&apikey=${ALPHA_KEY}`
  );
  const data = await response.json();
  const quote = data["Global Quote"] ?? {};
  return parseFloat(quote["05. price"] ?? "0");
}

async function getPriceBrapi(ticker: string): Promise<number> {
  const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, {
    headers: { Authorization: `Bearer ${BRAPI_TOKEN}` }
  });
  const { results } = await response.json();
  return results[0].regularMarketPrice;
}

// Wrapper para migração gradual - simula interface do Alpha Vantage usando brapi.dev
class AlphaVantageCompat {
  constructor(private brapiToken: string) {}

  async query(func: string, symbol: string) {
    const ticker = symbol.replace(".SAO", "");

    switch (func) {
      case "GLOBAL_QUOTE":
        return this.globalQuote(ticker);
      case "TIME_SERIES_DAILY":
        return this.timeSeries(ticker);
      case "OVERVIEW":
        return this.overview(ticker);
      default:
        throw new Error(`Function ${func} not supported`);
    }
  }

  private async globalQuote(ticker: string) {
    const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, {
      headers: { Authorization: `Bearer ${this.brapiToken}` }
    });
    const { results } = await response.json();
    const data = results[0];

    // Retorna no formato Alpha Vantage
    return {
      "Global Quote": {
        "01. symbol": data.symbol,
        "05. price": String(data.regularMarketPrice),
        "09. change": String(data.regularMarketChange),
        "10. change percent": `${data.regularMarketChangePercent}%`
      }
    };
  }
}