dadosb3

Cliente Python da API Dados B3: fundamentos auditáveis das companhias abertas brasileiras (2010–hoje), fundos imobiliários (FIIs) e ETFs, com metodologia pública. Cada número carrega a conta CVM de origem; os múltiplos são ponto-no-tempo (preço do 1º pregão a partir da chegada do balanço à CVM); nada é publicado sem a bateria de invariantes passar.

pip install dadosb3

from dadosb3 import DadosB3

api = DadosB3()                        # sem chave: WEGE3, BOVA11, MXRF11, rankings de ETF, /hoje, /saude
api.indicadores("WEGE3")["anos"]       # ROE, ROIC, margens... com a conta CVM de cada número
api.multiplos("WEGE3")                 # P/L, P/VP, EV/EBITDA ponto-no-tempo
api.etf("BOVA11")                      # cota diária, ágio/deságio, taxa efetiva, carteira
api.auditar_amostra(semente=4242)      # sorteie a SUA amostra e confira contra a CVM

api = DadosB3(chave="sua-chave")       # ou DADOS_B3_API_KEY no ambiente
api.screener(roic_min=0.15, dl_ebitda_max=2, ano=2024)
api.fiis_screener(pvp_max=0.9, dy_min=0.10)

Chave grátis (200 consultas/dia, sem cartão) ou Pro em dadosb3.com/assinar. Documentação da API em dadosb3.com/api; metodologia em dadosb3.com/metodologia; para quem é (e para quem não é) em dadosb3.com/para-quem.

Métodos

Erros: ChaveNecessaria (401), NaoEncontrado (404), ErroDadosB3 (demais), todos com .status e .detalhe (o corpo da resposta da API).

Limites, ditos antes

Preço só de fim de dia (COTAHIST); sem tratamento de viés de sobrevivência (companhia que saiu da bolsa não está na base); sem composição histórica de índice; a base começa em 2010. A lista completa está em dadosb3.com/o-que-nao-resolvemos.

Não é recomendação de investimento. Fontes: CVM (dados abertos, ODbL) e B3 (COTAHIST). Projeto independente, não afiliado à B3 nem à CVM. Licença deste cliente: MIT. Conector MCP: Val7h/dados-b3-mcp.