bolsai vs Investidor10: dados da B3 para automação e código (2026)

Antes de comparar, um esclarecimento importante e verificado: o Investidor10 não publica uma API pública oficial documentada para desenvolvedores. A única menção a "API" no domínio deles é uma página de ativo sobre uma empresa cujo ticker na Nasdaq é justamente "API" (a Agora Inc.), o que confunde quem pesquisa. Existem projetos comunitários no GitHub que fazem scraping do site, mas raspagem não é uma API oficial: quebra quando o HTML muda e pode contrariar os termos de uso. Portanto, a comparação honesta aqui não é "API contra API". É "site para ler no navegador" contra "API para consumir em código". As duas coisas são úteis, só que para tarefas distintas.

Dois produtos, dois problemas diferentes

O Investidor10 é uma plataforma web voltada ao investidor pessoa física. A experiência principal é visual: você abre a página de PETR4, VALE3 ou HGLG11 e lê os números renderizados na tela, com gráficos, histórico e ferramentas de acompanhamento de carteira. É a forma certa de estudar um ativo específico quando a decisão é humana e pontual.

A bolsai parte de outro problema. A pergunta que ela responde não é "como está a WEGE3 hoje?", e sim "como faço um programa perguntar isso sozinho, mil vezes, sem ninguém abrir o navegador?". A resposta é uma API REST: você faz uma requisição HTTP para https://api.usebolsai.com/api/v1/, recebe JSON estruturado e integra o resultado a qualquer linguagem, planilha ou fluxo automatizado. Os dados vêm de fontes públicas oficiais (B3, CVM e BCB) e cobrem cotações de fim de dia, fundamentos, dividendos, FIIs e indicadores macro.

A diferença fica óbvia quando o volume cresce. Ler manualmente os indicadores de 300 ações no Investidor10 é inviável. Rodar um screener programático que aplica filtros de P/L, ROE e dividend yield sobre todo o universo da B3 numa única chamada é exatamente o que uma API existe para fazer.

O que cada um faz bem

• Investidor10 (site): páginas de ativos com indicadores e gráficos, histórico de proventos, gerenciador de carteira, comparadores visuais e recursos para o investidor pessoa física acompanhar seus investimentos.
• bolsai (API): endpoints REST em JSON e CSV, 27+ indicadores fundamentalistas calculados, histórico de preços desde 1986, screener sobre todo o universo, dividendos e FIIs estruturados, séries macro e servidor MCP para agentes de IA.

Site para consultar vs API para consumir

A distinção central desta comparação não é sobre quantidade de dados. É sobre a interface pela qual o dado chega até você. Uma plataforma web entrega HTML para olhos humanos. Uma API entrega JSON para máquinas. Quando o consumidor final é um programa, um HTML bonito é atrito, e um JSON limpo é produtividade.

A tabela abaixo organiza os casos de uso. A leitura correta não é "quem tem mais colunas verdes vence", e sim "qual dessas linhas descreve o que eu preciso fazer hoje". As afirmações sobre o Investidor10 se limitam a fatos gerais e verificáveis: é uma plataforma web para investidores, com assinatura PRO, sem API pública oficial documentada.

Repare que várias linhas não têm "vencedor". Um gerenciador de carteira pessoal com tela e alertas é território natural de uma plataforma como o Investidor10. Um endpoint que devolve o balanço trimestral em JSON para alimentar um modelo é território natural de uma API. A escolha certa depende de quem, ou o que, vai consumir o dado. A documentação completa dos endpoints da bolsai, com exemplos em cURL e Python, está em /docs.

O mesmo dado, mas em Python

Nada ilustra melhor a diferença do que o mesmo dado nos dois mundos. No Investidor10, obter o P/L de PETR4 significa abrir a página do ativo e ler o número. Na bolsai, significa uma requisição HTTP que devolve todos os múltiplos de uma vez, prontos para uso em código. O exemplo abaixo é executável: basta uma chave gratuita, obtida com login pelo Google em /dashboard.

import requests

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

# Fundamentos de PETR4 em uma unica requisicao
r = requests.get(f"{BASE}/fundamentals/PETR4", headers=HEADERS)
d = r.json()

# Multiplos de valuation e rentabilidade, todos no mesmo objeto
print(d["pl"], d["pvp"], d["roe"], d["ev_ebitda"])

A resposta chega como um objeto plano. Os valores abaixo são ilustrativos, apenas para mostrar o formato; os números reais dependem do último balanço processado e você os verá ao rodar a chamada:

Essa é a essência da comparação. Ler um P/L no navegador é trivial para um ativo. Ler o P/L, o P/VP, o ROE e o EV/EBITDA de dezenas de empresas, cruzar com dividendos e jogar tudo numa planilha ou num modelo, é trabalho de API. O campo dividend_yield aparece nos fundamentos como TTM; o histórico detalhado de proventos, com ex_date e valor por evento, fica no endpoint /dividends/{ticker}. Os indicadores seguem uma metodologia documentada, com 96% de acurácia em relação ao Fundamentus para dados recentes (DFP 2025).

Screener: triar toda a B3 em uma requisição

O recurso onde a diferença de propósito mais aparece é a triagem. Filtrar ações por indicadores numa plataforma web é possível clicando em controles na tela, um resultado de cada vez. Fazer a mesma triagem por código, retornando uma lista pronta para processar, é o que o endpoint /screener da bolsai faz. Ele aceita operadores (_gt, _gte, _lt, _lte, _eq) sobre qualquer campo de fundamentos, mais sector, sort, order e limit.

O exemplo abaixo pede empresas do setor de Bancos com dividend yield acima de 6%, ROE acima de 10% e P/L abaixo de 15, ordenadas pelo maior yield. Em vez de listar um ranking fixo aqui (que envelheceria no dia seguinte), o certo é mostrar a consulta e deixar você rodá-la para o ranking real de hoje:

# Bancos com DY > 6%, ROE > 10% e P/L < 15, do maior yield ao menor
params = {
    "sector": "Bancos",
    "dividend_yield_gt": 6,
    "roe_gt": 10,
    "pl_lt": 15,
    "sort": "dividend_yield",
    "order": "desc",
    "limit": 20,
}
r = requests.get(f"{BASE}/screener", params=params, headers=HEADERS)

for acao in r.json()["data"]:
    print(acao["ticker"], acao["dividend_yield"], acao["roe"])

Os nomes de setor seguem a taxonomia da CVM em português ("Bancos", "Energia Elétrica", "Petróleo e Gás", "Saneamento"). Para descobrir os valores válidos sem adivinhar, consulte /companies/sectors. Trocar o setor, afrouxar um filtro ou reordenar é questão de mudar um parâmetro, algo que uma interface visual não oferece com a mesma flexibilidade. Esse é o tipo de tarefa em que uma API supera uma tela.

Planilhas: do navegador direto para o Google Sheets

Muita gente que usa o Investidor10 não é programadora, e sim usuária de planilha. Aqui a bolsai também atende, sem escrever uma linha de Python. Qualquer endpoint de listagem aceita ?format=csv, e o Google Sheets consome esse CSV nativamente com a função IMPORTDATA. A planilha passa a receber os dados diretamente da API, atualizados a cada recarga, em vez de copiar e colar da tela.

# Cole em uma celula do Google Sheets:
=IMPORTDATA("https://api.usebolsai.com/api/v1/screener?sector=Bancos÷nd_yield_gt=6&format=csv&api_key=sua_chave")

Note que, no Google Sheets, a autenticação vai como parâmetro api_key na própria URL, já que a função não permite cabeçalhos HTTP. Em scripts, o padrão é o cabeçalho X-API-Key. As duas formas são suportadas. Para quem monta controle de carteira em planilha, essa ponte transforma a bolsai numa fonte de dados viva, o que uma página de site, por natureza, não é.

Integração com IA: MCP para agentes

Um diferencial que não tem equivalente numa plataforma de leitura é a integração nativa com agentes de IA. A bolsai publica um servidor MCP (Model Context Protocol), o padrão aberto que permite a assistentes como o Claude descobrir e chamar ferramentas externas. Instalar é uma linha, e a partir daí o agente conversa direto com os dados da B3.

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

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

Com isso configurado, dá para pedir em linguagem natural: "liste bancos com ROE acima de 12% e P/L abaixo de 10" ou "compare os fundamentos de ITUB4, BBAS3 e BBDC4", e o agente executa as ferramentas screen_stocks e compare_stocks por baixo dos panos. São 10 ferramentas MCP no total, cobrindo cotação, fundamentos, dividendos, FIIs, macro e balanços. O guia de instalação para Claude, Cursor e outros clientes está em /mcp. Um site de consulta manual, por definição, não oferece esse tipo de interface para máquinas.

Cobertura de dados da bolsai

Vale detalhar o que a API entrega, já que é aqui que ela justifica existir ao lado de uma plataforma de leitura. A cobertura da bolsai abrange todo o universo negociado na B3, com 350+ ações e 400+ FIIs, organizados em endpoints temáticos:

• Ações: cotação de fim de dia, estatísticas de 52 semanas, histórico OHLCV desde 1986 e eventos corporativos (splits, grupamentos, bonificações).
• Fundamentos: 27+ indicadores por /fundamentals/{ticker}, incluindo P/L, P/VP, ROE, ROIC, EV/EBITDA, margens, endividamento e CAGR, além de histórico via /fundamentals/{ticker}/history.
• Financials: contas contábeis brutas da CVM (DRE, BPA, BPP, DFC) em /financials/{ticker}, com report anual (DFP) ou trimestral (ITR).
• Dividendos: histórico de proventos por /dividends/{ticker}, com ex_date, data de pagamento, valor e tipo (dividendo, JCP, bonificação).
• FIIs: detalhes por fundo, distribuições, composição de ativos, vacância e um screener dedicado em /fiis/screener.
• Macro: séries de SELIC, CDI, IPCA, IGP-M, câmbio e Ibovespa em /macro/{series}.

Todos os campos usam snake_case e nomenclatura consistente. A metodologia é aberta: o lucro líquido TTM usa a conta CVM 3.11 (total consolidado), o patrimônio de bancos usa as contas 2.07/2.08 e o EBIT é calculado como Resultado Bruto menos SG&A. Esse rigor é o que sustenta a acurácia de 96% frente ao Fundamentus em dados recentes. Para uma visão de outras APIs do mercado, o guia de alternativas ao Fundamentus com API cobre o assunto em profundidade.

Atualização, limites e o que a bolsai não é

Ser honesto sobre limitações é parte de uma comparação séria. A bolsai trabalha com dados de fim de dia: preços e séries macro são atualizados diariamente às 20:30 (horário de Brasília), após o fechamento da B3. Empresas, balanços, dividendos e FIIs são atualizados semanalmente, e os fundamentos são recalculados a cada nova ingestão de balanços. Não há cotação intradia nem streaming em tempo real. Para day trade e book de ofertas ao vivo, a bolsai não é a ferramenta certa, e isso é intencional: o foco é análise fundamentalista, histórico e automação.

Sobre acesso e preço, os números são diretos. O plano gratuito dá 200 requisições por dia, sem cartão de crédito, com login pelo Google. O plano Pro custa R$49 por mês, sobe para 10.000 requisições diárias e libera o histórico completo, cancelável a qualquer momento pela Stripe. Os limites reiniciam a 00:00 UTC.

A bolsai também não é uma corretora: não executa ordens nem custodia ativos. E não cobre mercados internacionais, apenas a B3. É uma fonte de dados analíticos, informativa, não uma recomendação de investimento. Já o Investidor10, como plataforma web para o investidor pessoa física, oferece uma experiência de consulta e acompanhamento que uma API não pretende substituir. São camadas diferentes da mesma jornada.

Quando usar cada um

A decisão fica simples quando o critério é "quem vai consumir o dado". Abaixo, uma divisão honesta por caso de uso, reconhecendo que muitos investidores usam os dois em momentos diferentes.

Fique no Investidor10 quando

• O objetivo é estudar um ativo por vez, lendo indicadores e gráficos no navegador.
• Você quer acompanhar a própria carteira com uma interface visual pronta.
• A decisão é humana e pontual, sem necessidade de automatizar nada.
• Você prefere não escrever código nem lidar com chaves de API.

Vá para a bolsai quando

• O dado precisa entrar em um programa, notebook, dashboard ou pipeline.
• Você quer triar todo o universo da B3 por indicadores numa única requisição.
• Precisa levar cotações, fundamentos ou um screener direto para o Google Sheets via CSV.
• Um agente de IA (Claude, Cursor) precisa consultar dados da B3 via MCP.
• O projeto depende de histórico de preços longo ou de séries de fundamentos por trimestre.
• Reprodutibilidade e metodologia documentada importam para a análise.

Use os dois quando

O fluxo mais comum combina os dois sem conflito. O investidor descobre uma ideia lendo a página de um ativo no Investidor10, valida a tese e depois usa a API da bolsai para automatizar o que não escala no navegador: rodar o screener toda semana, monitorar dividendos de uma carteira inteira, alimentar uma planilha viva ou deixar um agente de IA acompanhar os fundamentos. A leitura humana e a automação se complementam, cada uma na etapa em que é mais forte.

Perguntas frequentes

O Investidor10 tem uma API pública para desenvolvedores?

Não há uma API pública oficial do Investidor10 documentada para desenvolvedores. O Investidor10 é uma plataforma web voltada ao investidor pessoa física, com páginas de ativos, gerenciador de carteira e assinatura PRO. Quem precisa consumir dados da B3 de forma programática, em JSON ou CSV, usa uma API REST como a bolsai, que expõe endpoints para cotações de fim de dia, fundamentos, dividendos, FIIs e macro.

Qual a diferença prática entre o Investidor10 e a bolsai?

O Investidor10 é feito para consultar um ativo por vez no navegador: você digita o ticker e lê a página. A bolsai é feita para código: um endpoint REST devolve os mesmos tipos de indicador em JSON, e o screener filtra todo o universo da B3 numa única requisição. Um serve à leitura humana; o outro serve automação, planilhas, backtest e agentes de IA via MCP.

A bolsai é gratuita?

Sim. O plano gratuito da bolsai oferece 200 requisições por dia sem cartão de crédito, com login pelo Google em /dashboard. O plano Pro custa R$49 por mês, inclui 10.000 requisições diárias e libera o histórico completo. Os limites reiniciam a 00:00 UTC e o Pro pode ser cancelado a qualquer momento pela Stripe.

Os dados da bolsai são em tempo real?

Não. A bolsai trabalha com dados de fim de dia. Preços e indicadores macro são atualizados diariamente às 20:30 (horário de Brasília), após o fechamento da B3. Empresas, balanços, dividendos e FIIs são atualizados semanalmente. Não há cotação intradia nem streaming: o foco é análise fundamentalista, histórico e automação, não day trade.

Posso exportar os dados da bolsai para o Google Sheets?

Sim. Qualquer endpoint de listagem aceita o parâmetro format=csv. No Google Sheets, a fórmula IMPORTDATA aponta para a URL do endpoint com format=csv e a chave, e a planilha passa a receber os dados diretamente da API, sem copiar e colar. É a forma mais rápida de levar cotações, fundamentos ou um resultado de screener para uma planilha.

Leia também

Referências

• investidor10.com.br: plataforma web para o investidor pessoa física.
• b3.com.br: fonte primária de cotações, COTAHIST e eventos corporativos.
• gov.br/cvm: demonstrações financeiras (DFP e ITR) usadas no cálculo dos fundamentos.
• 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 o Investidor10 refletem fatos públicos e gerais verificados em julho de 2026 e podem mudar; confirme sempre na fonte oficial. Os planos e limites da bolsai citados também podem ser atualizados. Consulte a documentação oficial antes de tomar decisões de arquitetura ou contratar planos pagos.