Comparação 18 abr 2026 atualizado 19 out 2026 14 min de leitura por bolsai

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

Quem desenvolve ferramentas para o mercado brasileiro normalmente chega a duas opções quando o assunto é API gratuita de dados da B3: a brapi, estabelecida há mais tempo e com ecossistema amplo, e a bolsai, mais recente e focada em profundidade fundamentalista. Esta análise compara cobertura, preços, qualidade de dados, performance e experiência do desenvolvedor para ajudar na decisão técnica.

TL;DR

Use a brapi se o projeto depende de cotações com SDKs oficiais em TypeScript e Python, integrações prontas com Notion, WordPress, Google Sheets, ou se precisa de criptomoedas, opções, futuros ou fundos na mesma API.

Use a bolsai se o projeto exige fundamentos calculados com TTM, histórico trimestral de 11 anos, dividendos por ação com DY calculado, FIIs com P/VP e DY, e integração nativa com agentes de IA via MCP.

Combine as duas quando o custo de cada requisição importa: cotações intradiárias pela brapi, análise fundamentalista e dividendos pela bolsai. A arquitetura sai em menos de 50 linhas de código.

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. Tabelas, planos e recursos da brapi foram revisados em 19 de outubro de 2026, na documentação (brapi.dev/docs) e na página de planos oficiais. 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 (cotações, criptomoedas, derivativos, Tesouro Direto e fundos) 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

Pontos fortes da bolsai

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, revisada em 19 de outubro de 2026. Entre parênteses, o plano em que o recurso fica disponível.

Cobertura bolsai brapi
Cotação diária de açõesSimSim
Histórico de preços (anos)Mais de 40 anos, desde 1986 (Pro)3 meses (gratuito), 1 ano (Startup), mais de 10 anos (Pro)
Fundamentos (27 indicadores)Endpoint dedicado (gratuito)Endpoints /api/v2/stocks/statistics e financial-data (Startup e Pro)
Histórico trimestral de fundamentos11 anos (Pro)Desde 2009 (Pro); anual no Startup
Contas CVM brutas (DRE, BPA, DFC)Endpoint /financials (Pro)BP, DRE, DFC e DVA em endpoints dedicados (Pro; DRE anual no Startup)
Dividendos com DY calculadoEndpoint /dividends (Pro)Endpoint /api/v2/stocks/dividends (1 ano no Startup, completo no Pro)
Fundos Imobiliários (FIIs)Endpoint dedicado com P/VP e DY (gratuito)Endpoints dedicados com indicadores, rendimentos, imóveis e informes CVM (Pro)
CriptomoedasNãoSim (/api/v2/crypto)
Tesouro DiretoSim: taxas do dia (gratuito), histórico diário desde 2004 (Pro)Sim (Pro)
Opções e futurosNãoSim, com gregas e volatilidade implícita (Pro)
Outros fundos (FIAGRO, FI-Infra, FIF, FIDC, FIP)NãoSim
Indicadores macro (SELIC, CDI, IPCA)Endpoint /macro com câmbio PTAX de 7 moedas e Boletim Focus (Pro)Endpoint /api/v2/macro (Startup e Pro)
Screener com filtrosEndpoint /screener (Pro)Endpoint /api/v2/stocks/screener (Startup e Pro)
Servidor MCP oficialbolsai-mcp, remoto ou localSim, remoto (ferramentas completas no Pro)
SDKs oficiaisNão (REST puro)TypeScript e Python

A tabela mudou bastante desde a primeira versão deste post. A brapi passou a oferecer endpoints dedicados de demonstrações, FIIs detalhados, screener, Tesouro Direto, opções, futuros e fundos, além de um servidor MCP próprio, e hoje tem a cobertura mais ampla das duas, com boa parte dela no plano Pro. A bolsai continua focada em indicadores fundamentalistas com metodologia documentada e benchmark de acurácia publicado, com todos os endpoints no Pro de R$49/mês, e em outubro de 2026 passou a cobrir também Tesouro Direto, expectativas do Boletim Focus, câmbio PTAX e indicadores de risco por ação (volatilidade, beta e drawdown). Se o caso de uso envolve criptomoedas, derivativos, SDKs prontos ou integrações visuais, a brapi resolve com menos atrito.

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.

Plano bolsai brapi
Plano gratuito200 req/dia15.000 req/mês (~500/dia)
O que o gratuito cobreCotação, indicadores fundamentalistas atuais e FIIsCotações (1 ativo por requisição, histórico de 3 meses)
Cartão de crédito no sign-upNãoNão
Plano pago inicialR$49/mês (Pro)R$99,99/mês (Startup, no plano anual)
Plano com todos os dadosR$49/mês (Pro)R$116,66/mês (Pro, no plano anual)
Requisições no plano pago10.000/dia150.000/mês (Startup), 500.000/mês (Pro)
Histórico completo no plano pagoSim1 ano (Startup), mais de 10 anos (Pro)
Rate limit por minutoSuave, uso razoávelSem limite por minuto; 1 a 16 requisições simultâneas, conforme o plano
AutenticaçãoHeader X-API-KeyHeader Authorization: Bearer (?token= aceito como alternativa)
Formato de respostaJSON e CSV (?format=csv)JSON

Em número absoluto, a brapi oferece um teto maior no gratuito: 15.000 requisições por mês, cerca de 500 por dia, contra 200 por dia da bolsai. O gratuito da brapi cobre cotações (um ativo por requisição, histórico de até 3 meses); dividendos, demonstrações e macro começam no Startup. O gratuito da bolsai cobre cotação, os indicadores fundamentalistas atuais, FIIs e as taxas do dia do Tesouro Direto; histórico, dividendos, demonstrações, macro e screener ficam no Pro. Nos planos pagos, a bolsai custa menos (R$49/mês, contra R$99,99 do Startup e R$116,66 do Pro da brapi no plano anual), e a brapi entrega mais volume de requisições e mais classes de ativos.

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.

Crie uma conta gratuita na bolsai para testar os endpoints lado a lado com a brapi: 200 requisições por dia, sem cartão de crédito.

Criar conta gratuita

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 publica um dicionário de campos com a fórmula de cada indicador (/api/v2/dictionary), mas, até esta revisão, não encontramos um benchmark de acurácia equivalente publicado. 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. O exemplo da brapi usa a rota v1 /api/quote com módulos, que continua funcionando. Para integrações novas, a brapi recomenda os endpoints v2 dedicados, como /api/v2/stocks/statistics.

bolsai — fundamentos dedicados
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
brapi — rota v1 com módulos
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. Na rota v1, a brapi exige especificar módulos e navegar em subobjetos; nos endpoints v2, múltiplos e dados financeiros ficam em endpoints separados (statistics e financial-data). 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.

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 também mantém um servidor MCP próprio, remoto, em https://brapi.dev/api/mcp/mcp, com login OAuth e suporte documentado para Claude, ChatGPT, Cursor, VS Code e n8n. No plano gratuito ficam as ferramentas de descoberta e sandbox, o Startup libera as ferramentas essenciais e o Pro, as completas. Para projetos onde um agente de IA é a interface principal, as duas APIs atendem; a diferença está nos dados que cada servidor expõe e no plano exigido. O post MCP server para B3 com Claude explora o tema com mais profundidade, e a comparação completa dos MCP servers de dados financeiros avalia bolsai, brapi e os demais servidores lado a lado.

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

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. O exemplo da brapi usa o módulo dividendsData da rota v1; para integrações novas, ela também oferece o endpoint dedicado /api/v2/stocks/dividends.

bolsai — dividendos
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
brapi — dividendos via módulo (v1)
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.

bolsai — cotação
r = httpx.get(
    f"{BASE}/stocks/VALE3/quote",
    headers=HEADERS,
)
q = r.json()

print(q["close"], q["trade_date"])
# 61.42 2026-04-17
brapi — cotação
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

Escolha a bolsai quando

Combine as duas quando

Muitos projetos reais tiram o melhor de cada uma. Um robô de análise pode buscar cotação intradiária 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, cobertura mais ampla (opções, futuros, fundos e criptomoedas), servidor MCP próprio e SDKs oficiais em Python e TypeScript. 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, por um preço menor. Para análise fundamentalista séria, a bolsai leva vantagem. Para integrações de baixo código, cotações em volume e derivativos, a brapi atende melhor. Se a decisão inclui um agregador de dados abertos (renda fixa, fundos, Focus), vale ver também a comparação bolsai vs dadosdemercado.

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$49 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 intradiárias 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 também tem endpoints dedicados de múltiplos e demonstrações (/api/v2/stocks/statistics, balance-sheet, income-statement, cash-flow), com séries trimestrais desde 2009 no plano Pro. A diferença da bolsai está na metodologia documentada e no benchmark de acurácia publicado, por R$49/mês.

Leia também

Referências

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.