bolsai vs brapi: Comparação Honesta das APIs Gratuitas da B3 em 2026

A comparação que segue usa dados públicos de cada provedor, endpoints documentados e exemplos reais de requisições feitas em 18 de abril de 2026. A intenção não é eleger uma vencedora universal. Cada API resolve um problema ligeiramente diferente, e escolher bem depende de entender essas diferenças.

TL;DR: quando usar a bolsai e quando usar a brapi

A disputa entre bolsai vs brapi não é entre duas APIs idênticas. Os dois serviços partem de um objetivo comum (dar acesso programático a dados do mercado brasileiro), mas fizeram escolhas técnicas distintas. A brapi apostou em cobertura ampla de cotações, criptomoedas e um ecossistema rico em SDKs e integrações de baixo código. A bolsai priorizou profundidade em demonstrações financeiras, metodologia auditável e suporte a protocolos emergentes como MCP (Model Context Protocol).

Na prática, isso significa que perguntas diferentes levam a respostas diferentes. "Qual o preço de PETR4 agora?" é bem servido por qualquer uma das duas. "Qual foi o ROE consolidado do Itaú nos últimos 11 anos e como ele se compara com o Bradesco?" inclina a balança para a bolsai. "Preciso puxar a cotação do Bitcoin e de VALE3 na mesma chamada" favorece a brapi.

Pontos fortes da brapi

• Presença no mercado brasileiro há mais tempo, com base de usuários e comunidade ativa.
• SDKs oficiais mantidos em TypeScript e Python, publicados no GitHub.
• Documentação com guias específicos para Excel, Google Sheets, Notion, WordPress, React Native e C#.
• Suporte nativo a criptomoedas via /api/v2/crypto, útil quando o mesmo projeto consome ações e cripto.
• Arquivos /llms.txt e /llms-full.txt para descoberta por modelos de linguagem.

Pontos fortes da bolsai

• 27 indicadores fundamentalistas calculados com TTM a partir de dados CVM (DFP e ITR).
• Histórico trimestral de 11 anos em /fundamentals/{ticker}/history.
• Metodologia documentada: net income usa conta CVM 3.11, patrimônio bancário usa 2.07/2.08, EBIT é calculado como Resultado Bruto menos SG&A.
• Servidor MCP oficial (bolsai-mcp via uvx) para integração com Claude, Cursor e outros agentes.
• Cobertura dedicada a FIIs via /fiis/{ticker} com P/VP e DY.
• Plano gratuito sem cartão, Pro por R$29/mês.

Cobertura de dados: ações, FIIs, fundamentos, dividendos

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

A leitura que a tabela sugere é clara: se o caso de uso envolve criptomoedas, SDKs prontos ou integrações visuais, a brapi resolve com menos atrito. Se envolve análise fundamentalista profunda, séries históricas de balanço e FIIs, a bolsai foi desenhada especificamente para isso.

A documentação completa da API da bolsai está em /docs, com exemplos cURL e Python para cada endpoint. Quem já conhece a brapi e quer entender apenas as diferenças práticas pode ir direto ao guia de alternativa ao Fundamentus para ver a metodologia de cálculo dos indicadores.

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

Preço isolado nunca é a métrica certa. O que importa é custo por requisição útil, dado o perfil do projeto. Uma API mais barata que exige três chamadas para obter o mesmo dado que outra entrega em uma costuma sair mais cara no fim do mês.

A brapi oferece um teto maior no gratuito, o que favorece protótipos que consomem muitas cotações por dia. A bolsai, por outro lado, inclui no mesmo gratuito acesso a endpoints de fundamentos, dividendos e FIIs, sem limitar os tipos de consulta. Projetos de análise fundamentalista normalmente fazem algumas centenas de requisições por dia, cada uma retornando dezenas de indicadores.

Para quem precisa consultar cotações em alta frequência (um dashboard que atualiza a cada 30 segundos durante o pregão, por exemplo), o limite de 200 da bolsai fica apertado. Nesse cenário, combinar as duas APIs é a decisão mais econômica.

Qualidade dos dados fundamentalistas: benchmark contra o Fundamentus

Indicadores fundamentalistas são opiniões metodológicas, não fatos puros. Dois provedores podem olhar para o mesmo ITR e chegar a valores diferentes de P/L, ROE ou EV/EBITDA por causa de escolhas como: usar lucro consolidado ou controlador, tratar BDRs como ações, usar patrimônio da conta 2.03 ou 2.07 para bancos, calcular EBIT a partir da conta 3.05 da CVM ou via Gross Profit menos SG&A.

A bolsai publica a metodologia abertamente. O cálculo de net income TTM usa a conta CVM 3.11 (total consolidado), consistente com o Fundamentus. EBIT é calculado de forma limpa como Resultado Bruto menos SG&A, não como a conta CVM 3.05 (que inclui resultado de equivalência patrimonial). D&A é encontrada pelo padrão de nome contendo "depreci%" em contas de fluxo de caixa 6.01.01*. Para bancos, o patrimônio usado é a soma das contas 2.07 e 2.08, refletindo a estrutura contábil do setor.

O resultado desse rigor se traduz em 96% de acurácia em relação ao Fundamentus para dados frescos (DFP 2025) e 82% no conjunto geral (incluindo trimestres mais antigos, onde divergências são esperadas). A brapi, historicamente, não publica benchmark metodológico equivalente. Não significa que os dados sejam menos corretos. Significa que quem depende de reprodutibilidade exata precisa validar pessoalmente.

Mesmo ticker, duas APIs: fundamentos

O exemplo abaixo mostra uma requisição equivalente em cada API para buscar múltiplos fundamentais de PETR4. Os parâmetros variam porque a brapi agrega fundamentais como módulos adicionais na rota de cotação, enquanto a bolsai tem um endpoint dedicado.

import httpx

API_KEY = "sua_chave_aqui"
BASE = "https://api.usebolsai.com/api/v1"
HEADERS = {"X-API-Key": API_KEY}

r = httpx.get(
    f"{BASE}/fundamentals/PETR4",
    headers=HEADERS,
)
d = r.json()

print(d["pl"], d["pvp"], d["roe"])
# 5.32 1.42 26.6

import httpx

TOKEN = "seu_token_brapi"
BASE = "https://brapi.dev/api"

r = httpx.get(
    f"{BASE}/quote/PETR4",
    params={
        "token": TOKEN,
        "modules": "defaultKeyStatistics,financialData",
    },
)
d = r.json()["results"][0]
# Indicadores ficam espalhados em submódulos

A diferença prática: a bolsai responde com um objeto plano contendo os 27 indicadores. A brapi exige especificar módulos e navegar em subobjetos. Para quem vai popular um dashboard com P/L, P/VP, ROE, EV/EBITDA, margens e endividamento numa chamada só, a abordagem da bolsai economiza parsing. Para quem já tem pipeline adaptado ao formato de módulos, a brapi continua confortável.

Integração com IA: suporte a MCP (Model Context Protocol)

O MCP é um protocolo aberto definido pela Anthropic em novembro de 2024 para permitir que agentes de IA descubram e invoquem ferramentas externas de forma padronizada. Em 2026, clientes como Claude Desktop, Cursor, Zed e Continue já suportam MCP nativamente. Uma API com servidor MCP oficial vira, efetivamente, uma extensão do agente.

A bolsai publica um servidor MCP oficial instalável com uma linha:

# Instala e executa o servidor MCP da bolsai
uvx bolsai-mcp

# Em ~/.claude/config.json (Claude Desktop):
{
  "mcpServers": {
    "bolsai": {
      "command": "uvx",
      "args": ["bolsai-mcp"],
      "env": { "BOLSAI_API_KEY": "sua_chave" }
    }
  }
}

Depois disso, Claude consegue responder perguntas como "liste as dez ações do Ibovespa com maior ROE e P/L abaixo de 10" chamando os endpoints da bolsai sem nenhuma glue code adicional. O guia completo de configuração está em /mcp, incluindo exemplos para Cursor, Zed e outros clientes.

A brapi, até a data desta publicação, não mantém servidor MCP oficial. Existem tentativas comunitárias no GitHub, mas nenhuma listada na documentação oficial. Para projetos onde um agente de IA é a interface principal, essa diferença é material. O post MCP server para B3 com Claude explora o tema com mais profundidade.

Performance, latência e infraestrutura

Em testes feitos em 18 de abril de 2026, às 10h BRT, a partir de São Paulo, ambas as APIs respondem dentro do esperado para APIs REST regionais. Latência mediana por requisição fica na faixa de 80 a 220 ms, variando com tipo de endpoint. Nenhuma das duas oferece WebSockets para cotações em tempo real como primeiro cidadão (o caso de uso não é streaming).

Infraestrutura

• bolsai: FastAPI + PostgreSQL 16 + Redis 7, cache agressivo em endpoints de fundamentos (TTL variável por tipo de dado), pipeline ETL diário para preços e macro e semanal para balanços.
• brapi: arquitetura proprietária, com cache em cotações e serialização em JSON otimizada. Funciona bem para volume alto de quotes.

Para quem faz backtest em série histórica longa, a bolsai serve os dados em formato plano (JSON array ou CSV), o que reduz overhead de parsing. Para quem consome cotação em loop, a brapi responde rápido e tem proteção contra abuse bem calibrada.

Dividendos e histórico: o mesmo ticker nas duas

Consultar o histórico de dividendos de ITUB4 nas duas APIs mostra outra diferença de design. A bolsai retorna o DY TTM pré-calculado e uma lista de pagamentos. A brapi expõe o módulo dividendsData dentro da cotação.

r = httpx.get(
    f"{BASE}/dividends/ITUB4",
    headers=HEADERS,
)
d = r.json()

print(d["dividend_yield_ttm"])
# 7.42

for p in d["payments"][:3]:
    print(p["ex_date"], p["value_per_share"])
# 2026-03-14  0.3205
# 2026-02-28  0.0210
# 2026-01-31  0.0210

r = httpx.get(
    f"{BASE}/quote/ITUB4",
    params={
        "token": TOKEN,
        "modules": "dividendsData",
    },
)
d = r.json()["results"][0]
# dividendsData contém cashDividends e stockDividends
for item in d["dividendsData"]["cashDividends"][:3]:
    print(item["lastDatePrior"], item["rate"])

A bolsai pré-agrupa o DY TTM. Em projetos de carteira de dividendos, esse número costuma ser a entrada principal de decisão, o que torna a chamada mais curta. A brapi devolve o array bruto, o que dá flexibilidade para quem prefere calcular DY com janela própria (trailing 6 meses, 24 meses, custom). Para montar uma carteira de dividendos com Python, qualquer uma funciona, mas a bolsai economiza algumas linhas.

Documentação e experiência do desenvolvedor (DX)

Documentação costuma separar APIs boas de APIs que parecem boas no marketing. Nesse critério, a brapi tem vantagem histórica: cerca de 500 URLs indexadas, blog com posts por indicador, FAQ extensa e guias de integração para Excel, Google Sheets, Notion, WordPress, React Native e C#. Arquivos /llms.txt e /llms-full.txt estão disponíveis para descoberta por modelos de linguagem, um diferencial real em 2026.

A bolsai, por ser mais recente, tem documentação mais concentrada: página única em /docs com todos os endpoints, parâmetros e exemplos cURL e Python. O blog cresce semanalmente e cobre casos específicos (dividendos, FIIs, screener, MCP). Não há guias para Notion ou WordPress. Para quem usa essas ferramentas como front-end, a brapi economiza trabalho de integração.

SDKs oficiais vs REST direto

A brapi publica SDKs no GitHub em TypeScript e Python, com releases versionados. A bolsai aposta em REST puro por decisão arquitetural: qualquer cliente HTTP em qualquer linguagem consome a API sem dependências extras. Para projetos Python que já usam httpx ou requests, o ganho do SDK é marginal. Para projetos TypeScript que preferem tipos fortes, o SDK da brapi tem valor claro.

Cotação simples: a requisição mais comum

Para fechar a comparação prática, o caso mais simples: buscar a cotação de VALE3.

r = httpx.get(
    f"{BASE}/stocks/VALE3/quote",
    headers=HEADERS,
)
q = r.json()

print(q["close"], q["trade_date"])
# 61.42 2026-04-17

r = httpx.get(
    "https://brapi.dev/api/quote/VALE3",
    params={"token": TOKEN},
)
q = r.json()["results"][0]

print(q["regularMarketPrice"])
# 61.42

Duas linhas em cada lado, mesmo resultado. A diferença aparece em casos compostos: múltiplas ações, múltiplos indicadores, janelas temporais longas. Aí cada API mostra sua personalidade arquitetural.

Quando cada uma é a escolha certa

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

Escolha a brapi quando

• O projeto consome cotações em alto volume e o teto de 15.000 requisições do plano gratuito resolve bem.
• Há necessidade de integração com Notion, WordPress, Google Sheets ou Excel como front-end principal.
• O stack é TypeScript e ganhar tempo com um SDK tipado faz diferença na manutenção.
• Criptomoedas entram no escopo junto com ações da B3.
• A comunidade e a base de exemplos em português são critério de desempate.

Escolha a bolsai quando

• O foco é análise fundamentalista séria, com 27 indicadores pré-calculados e TTM automático.
• O projeto depende de histórico trimestral longo (11 anos em /fundamentals/{ticker}/history).
• FIIs fazem parte do universo analisado, com P/VP e DY específicos do veículo.
• Dividendos precisam de DY pré-calculado e série de pagamentos pronta para carteira passiva.
• Um agente de IA (Claude, Cursor, Zed) precisa conversar diretamente com os dados via MCP.
• Reprodutibilidade metodológica importa (pesquisa acadêmica, auditoria interna, fundos pequenos que precisam justificar números).

Combine as duas quando

Muitos projetos reais tiram o melhor de cada uma. Um robô de análise pode buscar cotação em tempo real pela brapi durante o pregão e cruzar com fundamentos da bolsai fora do horário de mercado. Um dashboard pode usar brapi para a home (cotações, variação, volume) e bolsai para as páginas de detalhe (indicadores, dividendos, histórico de balanço). A abordagem híbrida preserva os limites gratuitos de ambas e entrega a experiência mais rica possível ao usuário final.

O post API para FIIs com Python e dividendos mostra um exemplo dessa arquitetura híbrida aplicada a um dashboard de fundos imobiliários.

Perguntas frequentes

Qual API é melhor, bolsai ou brapi?

Depende do caso de uso. A brapi tem ecossistema mais estabelecido, SDKs oficiais em Python e TypeScript e suporte a criptomoedas. A bolsai foca em profundidade fundamentalista (27 indicadores calculados com TTM), histórico trimestral de 11 anos, suporte nativo a MCP para agentes de IA e metodologia documentada com 96% de acurácia em relação ao Fundamentus. Para análise fundamentalista séria, a bolsai leva vantagem. Para integrações de baixo código e cotações em volume, a brapi atende melhor.

bolsai é gratuita?

Sim. O plano gratuito da bolsai oferece 200 requisições por dia sem necessidade de cartão de crédito. O plano Pro custa R$29 por mês e inclui 10.000 requisições diárias, histórico completo e todos os endpoints, inclusive financials brutos e screener. A página de preços traz a tabela completa.

Posso usar a brapi e a bolsai juntas?

Sim, e muitos desenvolvedores fazem exatamente isso. Uma arquitetura comum usa brapi para cotações em tempo real e criptomoedas e bolsai para indicadores fundamentalistas, dividendos históricos e FIIs. As duas APIs retornam JSON e podem coexistir no mesmo cliente HTTP sem conflito. Os tokens ficam em variáveis de ambiente separadas e cada chamada segue o contrato de autenticação específico do provedor.

Qual tem mais dados fundamentalistas?

A bolsai oferece 27 indicadores fundamentalistas calculados com normalização TTM (P/L, P/VP, ROE, EV/EBITDA, EV/EBIT, margens, endividamento, CAGR), além de histórico trimestral de 11 anos e as contas CVM brutas via /financials. A brapi expõe informações de valuation agregadas via módulos na rota /api/quote, com granularidade menor para séries históricas de balanços. Para modelos quantitativos que dependem de painéis longos de demonstrações financeiras, a bolsai foi construída com esse caso de uso em mente.

Leia também

Referências

• brapi.dev: site oficial da brapi, com documentação e planos.
• brapi.dev/docs: documentação técnica dos endpoints da brapi.
• b3.com.br: fonte primária de cotações, COTAHIST e eventos corporativos.
• Documentação da bolsai: endpoints, parâmetros, exemplos e limites.

Este conteúdo é educativo e não constitui recomendação de investimento. Os planos e limites citados refletem informações públicas em abril de 2026 e podem mudar. Consulte a documentação oficial de cada provedor antes de tomar decisões de arquitetura ou contratar planos pagos.