Dados B3 › Para quem

Para quem

Para quem é o Dados B3 — e para quem não é

O Dados B3 publica os fundamentos da bolsa brasileira — 356 páginas de companhia, 468 fundos imobiliários e 159 ETFs — com a conta da CVM por trás de cada número. Esta página diz a quem ele serve, a quem não serve, e quanto custa.

Se você programa ou roda modelos

Você recebe uma API REST que devolve JSON, um pacote Python oficial (pip install dadosb3), um dump completo em CSV e um conector MCP com 19 ferramentas. Indicadores, múltiplos, proventos, scores de Piotroski e Graham, série trimestral e reapresentações de balanço, de 2010 até hoje. Os múltiplos são ponto-no-tempo: o preço é o que você poderia ter pago no 1º pregão depois de o balanço chegar à CVM. Todo número tem página de linhagem até a linha do arquivo da CVM, e nada é publicado antes de a bateria de invariantes passar.

Limites, ditos antes: preço só de fim de dia; sem tratamento de sobrevivência (companhia que saiu da bolsa não está aqui); sem composição histórica de índice; a base começa em 2010.

Comece por aqui: a WEGE3 é aberta sem chave em HTML e em JSON; a chave grátis dá 200 consultas por dia; a documentação da API e o guia do MCP são uma página cada.

pip install dadosb3

from dadosb3 import DadosB3
DadosB3().indicadores("WEGE3")   # sem chave

# ou HTTP puro:
curl -H "Accept: application/json" https://dadosb3.com/acoes/WEGE3

Se você investe e quer conferir um número

Cada companhia tem uma página aberta — ROE, ROIC, margens, dívida, múltiplos com a data do pregão usado, proventos por ano, balanços republicados — em /acoes/TICKER. Os FIIs têm P/VP ponto-no-tempo e DY de 12 meses do informe mensal da CVM; os ETFs têm a cota patrimonial dia a dia, ágio ou deságio, a taxa efetiva do balancete e a carteira mensal. Screeners e comparações de pares ordenam por critério declarado. Nada disso é recomendação.

Se você escreve, ensina ou pesquisa

O protocolo de auditoria deixa você sortear a própria amostra (a semente é sua) e conferir cada caso contra o arquivo da CVM. As reapresentações guardam as duas versões de um balanço republicado; o que erramos é datado e público. O dado é ODbL: cite a fonte e compartilhe nos mesmos termos.

Quando NÃO usar o Dados B3

• Você precisa de cotação intradiária ou em tempo real — só temos fim de dia.
• Você precisa de preço anterior a 2010 — outras fontes voltam a 1986.
• Você precisa de transações de insiders, DVA ou um catálogo de 160 indicadores — cobrimos menos campos, cada um com a fórmula publicada.
• Você precisa de universo sem viés de sobrevivência para um backtest completo — não reconstruímos delisting.
• Você precisa de terminal institucional com mesa de suporte — é outra categoria de produto.

O comparativo nomeia quem faz cada uma dessas coisas melhor que nós, com link e a data em que conferimos.

Preço

Chave grátis: 200 consultas por dia, sem cartão, sem prazo. Pro: R$ 49,90 por mês, 10.000 consultas por dia, garantia de 7 dias — /assinar. Páginas, metodologia e auditoria são abertas a todos.

Perguntas que fazem

O Dados B3 é grátis?

Para a maior parte dos usos, sim. Toda página de companhia (/acoes/TICKER, 356 delas), toda página de FII e de ETF, a metodologia, a amostra de auditoria e as páginas de confiança abrem sem chave. A API em JSON exige chave: a grátis dá 200 consultas por dia sem cartão; o Pro custa R$ 49,90/mês por 10.000 por dia, com garantia de 7 dias.

De onde vêm os dados?

Demonstrações financeiras dos dados abertos da CVM (licença ODbL), preços do arquivo COTAHIST de fim de dia da B3, informes mensais de FII da CVM e informes diários de ETF do FNET. Cada número carrega a conta CVM de origem.

Tem preço em tempo real ou intradiário?

Não. Os preços são só de fim de dia, por decisão. Para cotação intradiária use uma API de cotação (o comparativo nomeia quais).

Dá para fazer backtest com ele?

Em parte. Os múltiplos são ponto-no-tempo (preço do 1º pregão a partir do dia em que o balanço chegou à CVM), o que tira o look-ahead entre balanço e preço. O universo NÃO trata viés de sobrevivência: companhia que saiu da bolsa não está na base, e não há composição histórica de índice.

Como ligo ao Claude, ChatGPT ou Cursor?

Adicione o conector MCP remoto https://dadosb3.com/mcp/ ou rode o servidor local de código aberto. Ele expõe 19 ferramentas: indicadores, múltiplos, dividendos, scores, reapresentações, série trimestral, FIIs, ETFs, screeners e a metodologia.

É recomendação de investimento?

Não. Rankings e screeners são descritivos, ordenados por critério declarado, e cada número liga ao documento que o sustenta.