bolsai vs HG Brasil: qual API de dados da B3 escolher em 2026

Antes de comparar, o critério: este texto não elege uma API de dados financeiros do Brasil "melhor" no vazio. HG Brasil e bolsai resolvem problemas diferentes. Uma responde bem a "qual o preço de PETR4, quanto está o dólar e o bitcoin agora?" em uma chamada. A outra responde a "qual o ROE consolidado do Itaú nos últimos onze anos, e como o P/L dele se compara ao do Bradesco?" com fundamentos calculados. Confundir os dois casos de uso leva à frustração. A comparação usa a documentação pública de cada provedor em julho de 2026.

O que cada API resolve bem

A disputa entre bolsai e HG Brasil não é entre duas APIs idênticas. As duas partem do objetivo comum de dar acesso programático a dados do mercado brasileiro, mas fizeram escolhas técnicas distintas. A HG Brasil apostou em simplicidade e cobertura de cotações em várias classes de ativo (ações, índices, câmbio, cripto, juros) numa API fácil de consumir. A bolsai priorizou profundidade em demonstrações financeiras, metodologia auditável e suporte a protocolos emergentes como o MCP (Model Context Protocol).

Pontos fortes da HG Brasil

• Maturidade: a HG Brasil está no mercado brasileiro há mais de quinze anos, com base de usuários e infraestrutura estável.
• Cotação de ações da B3 e do Ibovespa numa chamada simples, além de BDRs.
• Câmbio de várias moedas (dólar, euro, libra, iene) na mesma resposta.
• Cotação de bitcoin em várias exchanges (Mercado Bitcoin, Coinbase, entre outras).
• Dados de dividendos, JCP e bonificações, além de SELIC e CDI.
• Autenticação simples por parâmetro de query e plano gratuito para começar.

Pontos fortes da bolsai

• 27 indicadores fundamentalistas calculados com TTM a partir de dados da CVM (DFP e ITR).
• Histórico trimestral de cerca de 11 anos em /fundamentals/{ticker}/history.
• Contas CVM brutas (DRE, BPA, BPP, DFC) via /financials/{ticker}.
• Metodologia documentada: lucro líquido usa a conta CVM 3.11, patrimônio bancário usa 2.07/2.08, EBIT é calculado como Resultado Bruto menos SG&A.
• Cobertura dedicada a FIIs via /fiis/{ticker} com P/VP, DY e vacância.
• Servidor MCP oficial (bolsai-mcp) para integração com Claude, Cursor e outros agentes de IA.
• Plano gratuito sem cartão e exportação em CSV via ?format=csv.

Cobertura de dados lado a lado

Cobertura de dados é o critério que, sozinho, habilita ou elimina casos de uso. A tabela abaixo resume o que cada API entrega hoje, com base na documentação pública de ambas em julho de 2026.

A leitura é direta. Se o caso de uso envolve cotação, câmbio e cripto numa API simples e consolidada, a HG Brasil resolve com pouco atrito. Se envolve análise fundamentalista profunda, séries históricas de balanço, FIIs detalhados ou acesso por IA, a bolsai foi desenhada especificamente para isso. A documentação completa da bolsai, com exemplos em cURL e Python, está em /docs. Para um panorama mais amplo com outras fontes, vale ler o comparativo melhores APIs de dados da B3 em 2026.

Preços e limites das versões gratuitas e pagas

Preço isolado nunca é a métrica certa. O que importa é o custo por requisição útil, dado o perfil do projeto. Uma API mais barata que não entrega o dado de que você precisa não é uma economia. A tabela resume os planos de entrada de cada provedor, com base nas páginas públicas em julho de 2026.

Os planos de entrada ficam próximos em preço: a HG Brasil começa em torno de R$24,90 por mês no plano Member, e a bolsai em R$49 por mês no Pro. A diferença não está no valor, e sim no que cada real compra. Na HG Brasil, você paga por cobertura ampla de cotações e câmbio de várias classes de ativo. Na bolsai, você paga por profundidade: os 27 indicadores calculados, o histórico trimestral, as demonstrações CVM e o screener entram no mesmo plano. A escolha depende do que o seu projeto consome, não do preço na etiqueta.

Uma chamada em cada API: cotação

O caso mais simples é buscar a cotação de PETR4. As duas resolvem com poucas linhas, mas o formato da requisição e da resposta difere. A HG Brasil usa um endpoint de cotações com o parâmetro tickers (no formato B3:PETR4) e a chave na query. A bolsai usa um endpoint por ticker e a chave no header.

# Header X-API-Key, endpoint por ticker
GET https://api.usebolsai.com/api/v1/stocks/PETR4/quote

# Resposta (objeto plano):
{
  "ticker": "PETR4",
  "trade_date": "2026-07-03",
  "close": 39.84,
  "volume": 41230500
}

# Chave na query, ticker no formato B3:PETR4
GET https://api.hgbrasil.com/v2/finance/quotes?key=SUA_CHAVE&tickers=B3:PETR4

# Resposta (dentro de results):
{
  "results": {
    "stocks": {
      "PETR4": { "price": 39.84 }
    }
  }
}

Mesmo resultado, dois estilos. A HG Brasil aninha os dados em results.stocks.{ticker} e permite pedir vários tickers, câmbio e cripto na mesma chamada, o que é conveniente para um painel que mistura classes de ativo. A bolsai devolve um objeto plano por ticker, o que reduz o parsing quando o foco é uma ação de cada vez. Para consumir cotações da B3 em Python passo a passo, o post como consultar a cotação de uma ação em Python mostra o padrão de chamada.

Onde as duas divergem: fundamentos e demonstrações

É neste ponto que a diferença entre as duas deixa de ser de estilo e passa a ser de escopo. A HG Brasil foca em cotações e não é o destino natural para análise fundamentalista profunda: ela não expõe um endpoint com dezenas de indicadores calculados nem as demonstrações financeiras brutas. A bolsai foi construída para isso. Com uma chamada, o endpoint /fundamentals/{ticker} devolve um objeto plano com os 27 indicadores normalizados por TTM.

# bolsai: fundamentos calculados em uma chamada
GET https://api.usebolsai.com/api/v1/fundamentals/ITUB4

# Resposta (trecho, valores ilustrativos):
{
  "ticker": "ITUB4",
  "pl": 9.12,
  "pvp": 1.78,
  "roe": 19.4,
  "net_margin": 27.8,
  "reference_date": "2026-06-30"
}

Os valores acima são ilustrativos, apenas para mostrar o formato: os números reais vêm da chamada, com os dados do último período. Sobre a precisão, a bolsai documenta abertamente como cada indicador é calculado. O lucro líquido TTM usa a conta CVM 3.11 (total consolidado), consistente com a metodologia do Fundamentus; o EBIT é calculado de forma limpa como Resultado Bruto menos SG&A; para bancos, o patrimônio usa as contas 2.07 e 2.08. Esse rigor se traduz em 96% de acurácia em relação ao Fundamentus para dados recentes (DFP 2025). Quem quiser o detalhe da metodologia pode ler o comparativo alternativa ao Fundamentus com API oficial.

Além dos indicadores calculados, a bolsai entrega as contas CVM brutas via /financials/{ticker}, em DFP (anual) ou ITR (trimestral), e a série trimestral dos indicadores via /fundamentals/{ticker}/history. Para modelos quantitativos que dependem de painéis longos de demonstrações, essa profundidade é o diferencial. A HG Brasil, por design, não cobre esse território.

FIIs e dividendos históricos

As duas cobrem dividendos, mas com granularidade diferente. Na bolsai, o endpoint /dividends/{ticker} devolve o dividend yield TTM já calculado, o provento por ação dos últimos doze meses e a lista de pagamentos com data ex, data de pagamento, tipo (dividendo, JCP, bonificação) e valor por ação:

# bolsai: dividendos com DY TTM pré-calculado
GET https://api.usebolsai.com/api/v1/dividends/BBSE3

# Resposta (trecho, valores ilustrativos):
{
  "dividend_yield_ttm": 8.45,
  "ttm_per_share": 2.3412,
  "payments": [
    { "ex_date": "2026-03-14", "type": "JCP", "value_per_share": 0.2934 }
  ]
}

Para FIIs, a bolsai vai além da cotação: o endpoint /fiis/{ticker} traz P/VP, dividend yield, NAV e vacância, campos que interessam a quem analisa fundos imobiliários e que uma API centrada em cotações não expõe. Para montar um ranking de fundos programaticamente, o post melhores FIIs de 2026 mostra como usar o screener de FIIs. Já a HG Brasil cobre o essencial de dividendos e a cotação de FIIs de forma direta, adequada a quem só precisa desses números soltos.

Integração com IA: o servidor MCP da bolsai

O Model Context Protocol é um padrão aberto que permite a agentes de IA descobrirem e chamarem ferramentas externas de forma estruturada. Em 2026, clientes como Claude Desktop, Cursor e Zed já suportam MCP nativamente. Uma API com servidor MCP oficial passa a funcionar como uma extensão do agente: ele consegue, sozinho, buscar cotações, fundamentos e dividendos para responder a uma pergunta. A bolsai publica um servidor MCP oficial instalável com o pacote bolsai-mcp.

# Instala o servidor MCP da bolsai
pip install bolsai-mcp

# Em claude_desktop_config.json:
{
  "mcpServers": {
    "bolsai": {
      "command": "uvx",
      "args": ["bolsai-mcp"],
      "env": { "BOLSAI_API_KEY": "sua_chave" }
    }
  }
}

Depois disso, você pode pedir ao Claude coisas como "compare o P/L e o ROE de ITUB4, BBAS3 e BBDC4" ou "liste bancos com dividend yield acima de 6%", e ele chama os dados da bolsai para responder, sem glue code. O guia completo, com exemplos para Cursor e Zed, está em /mcp. A HG Brasil, até esta data, não mantém um servidor MCP oficial listado na documentação. Não impede o uso com IA, já que qualquer REST pode ser chamado por um agente, mas a ausência de servidor oficial significa mais trabalho de integração.

Quando usar cada uma

Todo comparativo útil termina com uma decisão por caso de uso. Abaixo, uma divisão honesta, reconhecendo que projetos reais raramente caem num único bucket.

Escolha a HG Brasil quando

• Você precisa de cotação de ações, câmbio e cripto numa única chamada simples.
• A maturidade e a estabilidade de uma API com mais de quinze anos são um critério de desempate.
• O projeto mistura classes de ativo (dólar, bitcoin, VALE3) na mesma tela.
• O escopo é cotação básica e dividendos soltos, sem necessidade de fundamentos calculados.

Escolha a bolsai quando

• O foco é análise fundamentalista séria, com 27 indicadores pré-calculados e TTM automático.
• O projeto depende das demonstrações CVM brutas ou do histórico trimestral de balanços.
• FIIs fazem parte do universo, com P/VP, DY e vacância específicos do veículo.
• Você quer rodar um screener por código e exportar o resultado em CSV.
• Um agente de IA (Claude, Cursor, Zed) precisa conversar diretamente com os dados via MCP.
• Reprodutibilidade metodológica importa (pesquisa, auditoria interna, fundos pequenos).

Combine as duas quando

Muitos projetos reais tiram o melhor de cada uma. Um dashboard pode buscar cotação, câmbio e cripto pela HG Brasil na home e cruzar com fundamentos, dividendos históricos e FIIs da bolsai nas páginas de detalhe. As duas retornam JSON e coexistem no mesmo cliente HTTP, cada uma com sua chave em variável de ambiente separada. A abordagem híbrida entrega a experiência mais completa sem forçar uma única fonte a cobrir tudo. Para uma comparação direta entre APIs focadas em fundamentos, vale ler o comparativo bolsai vs brapi.

Veredito

A HG Brasil e a bolsai não competem pela mesma tarefa. A HG Brasil é uma API de cotações madura e simples, ótima para quem precisa de preço, câmbio e cripto numa chamada direta, com um plano de entrada barato. A bolsai é uma API de profundidade, feita para quem precisa de fundamentos calculados, demonstrações da CVM, FIIs, dividendos históricos e acesso por IA. Se a sua pergunta é "quanto custa esse ativo agora?", a HG Brasil responde com elegância. Se a sua pergunta é "esse negócio é bom, está barato, paga bem e como isso evoluiu ao longo dos anos?", a bolsai foi construída para responder. E nada impede usar as duas.

Perguntas frequentes

Qual a diferença entre a HG Brasil Finance e a bolsai?

A HG Brasil Finance é uma API simples e madura para cotações de ações da B3, Ibovespa, câmbio (dólar, euro), bitcoin e dividendos, com integração fácil e planos a partir de cerca de R$24,90 por mês. A bolsai é focada em profundidade: 27 indicadores fundamentalistas calculados com TTM, histórico trimestral de cerca de 11 anos, contas CVM brutas (DFP e ITR), dividendos históricos, FIIs, screener e um servidor MCP nativo para agentes de IA. Uma resolve cotação básica com poucas linhas; a outra foi desenhada para análise fundamentalista e automação.

A HG Brasil Finance tem dados fundamentalistas?

A HG Brasil Finance foca em cotações de ações, índices, câmbio, cripto, juros e dividendos. Ela não é o destino natural para análise fundamentalista profunda: não expõe um endpoint dedicado com dezenas de indicadores calculados nem as demonstrações financeiras brutas da CVM. Quem precisa de P/L, P/VP, ROE, EV/EBITDA, margens e endividamento calculados, além de histórico trimestral de balanços, encontra isso na bolsai via os endpoints /fundamentals e /financials.

Quanto custa cada API?

A HG Brasil oferece um plano gratuito com limite de volume e planos pagos a partir de cerca de R$24,90 por mês (plano Member), subindo conforme o volume de requisições. A bolsai tem um plano gratuito de 200 requisições por dia com login pelo Google e sem cartão de crédito, e o plano Pro a R$49 por mês com 10.000 requisições diárias, histórico completo e todos os endpoints. Preço isolado não é a métrica certa: o que importa é o custo por requisição útil dado o seu caso de uso. A página de preços traz a tabela completa da bolsai.

Posso usar a HG Brasil e a bolsai juntas?

Sim, e faz sentido. Uma arquitetura comum usa a HG Brasil para cotações, câmbio e cripto numa única chamada simples, e a bolsai para os fundamentos calculados, as demonstrações CVM, os dividendos históricos, os FIIs e o acesso por agentes de IA via MCP. As duas retornam JSON e coexistem no mesmo cliente HTTP, cada uma com sua chave de autenticação em variável de ambiente separada.

Leia também

Referências

• hgbrasil.com/finance: site oficial da HG Brasil Finance, com documentação e planos.
• b3.com.br: fonte primária de cotações, COTAHIST e eventos corporativos.
• gov.br/cvm: Comissão de Valores Mobiliários, fonte das demonstrações financeiras.
• Documentação da bolsai: endpoints, parâmetros, exemplos e limites.

Este conteúdo é educativo e não constitui recomendação de investimento. As informações sobre a HG Brasil refletem a documentação e as páginas públicas em julho de 2026 e podem mudar; consulte a fonte oficial antes de tomar decisões de arquitetura ou contratar planos pagos. Os planos e limites da bolsai citados também podem ser atualizados. Os dados da bolsai são de fim de dia (20:30 BRT), não em tempo real.