Dados B3 › API
API
API e integrações — como levar os dados para o seu lado
Tudo que está nas páginas sai também por API, e o conjunto inteiro sai em CSV. Sem contrato, sem falar com ninguém.
Documentação
Todos os endpoints, com exemplos que rodam na hora.
Exportação em massaJSON
A base inteira em CSV — nove conjuntos, uma requisição cada. Plano Pro.
Conector de IA (MCP)
Ligue o Claude, o ChatGPT ou o Cursor direto na base.
Dicionário de camposJSON
O que cada campo significa e de qual conta da CVM ele vem.
Cobertura por anoJSON
Quantos indicadores e múltiplos existem em cada ano — a janela real, não a prometida.
pip install dadosb3 — cliente Python oficial: ações, FIIs, ETFs, auditoria por semente e erros tratados, sem montar requisição na mão. pypi.org/project/dadosb3
Para quem programa: uma seção por rota
Chave. Vai no cabeçalho X-API-Key. Sem chave, toda rota de dado responde para BOVA11, MXRF11, WEGE3 (dá para provar antes de criar conta), as rotas marcadas como abertas respondem para todos, e as demais devolvem 401 com o link para criar uma. A chave grátis dá 200 consultas por dia; a Pro, 10.000. Passou do limite, a resposta é 429, e a contagem recomeça no dia seguinte. Criar chave grátis.
Cache. Nas rotas marcadas “público, 5 min”, a resposta que deu certo a um pedido SEM chave sai com Cache-Control: public, max-age=300: navegador, proxy ou CDN podem reaproveitá-la por até 5 minutos. Nada aqui muda mais rápido que isso — o preço é atualizado de noite e os balanços uma vez por semana. As rotas em /empresas/ (dado atrás de chave) nunca recebem cache público, nem resposta a pedido COM chave.
Python. pip install dadosb3 — pypi.org/project/dadosb3. Os exemplos abaixo usam os métodos do cliente; os marcados “pacote ≥ 0.2.0” pedem essa versão.
Conector de IA (MCP). dados-b3-mcp 1.7.0, listado no registro oficial de MCP como io.github.Val7h/dados-b3 · como ligar.
Companhia /empresas/{T}
Quem é a companhia, os códigos de negociação, o que existe sobre ela e onde está cada recurso.
Acesso: aberta, sem chave · pacote ≥ 0.2.0 · Cache: sem cache público
curl -s "https://dadosb3.com/empresas/WEGE3"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.empresa("WEGE3")
print(sorted(r))
print(r["ticker"])Resposta real, cortada
{
"ticker": "WEGE3",
"tickers": [
"WEGE3"
],
"nome": "WEG SA",
"cnpj": "84.429.695/0001-11",
"cd_cvm": 5410,
"setor": "Bens Industriais",
"tipo": "geral",
"pagina": "https://dadosb3.com/acoes/WEGE3",
"citacao": "Fonte: https://dadosb3.com/acoes/WEGE3 (Dados B3) — números recalculados dos arquivos públicos da CVM (DFP/ITR) e do COTAHIST da B3; versão …",
"cobertura": {
"primeiro_ano": 2010,
"ultimo_ano": 2025,
"reapresentacoes": 10
},
"recursos": {
"indicadores": {
"url": "https://dadosb3.com/empresas/WEGE3/indicadores",
"o_que": "ROE, ROIC, margens, crescimento, DL/EBITDA, ano a ano",
"exige_chave": false
},
"multiplos": {
"url": "https://dadosb3.com/empresas/WEGE3/multiplos",
"o_que": "P/L, P/VP, EV/EBITDA ponto-no-tempo e P/L TTM",
"exige_chave": false
},
"fatos": {
"url": "https://dadosb3.com/empresas/WEGE3/fatos",
"o_que": "contas padronizadas com a conta CVM de origem (?trimestral=true)",
"exige_chave": false
},
"dividendos": {
"url": "https://dadosb3.com/empresas/WEGE3/dividendos",
"o_que": "proventos, resumo por ano e dividend yield de 12 meses",
"exige_chave": false
},
"scores": {
"url": "https://dadosb3.com/empresas/WEGE3/scores",
"o_que": "Piotroski com os nove critérios abertos, e Graham",
"exige_chave": false
},
"reapresentacoes": {
"url": "https://dadosb3.com/empresas/WEGE3/reapresentacoes",
"o_que": "balanços republicados: versão original e revisada",
"exige_chave": false
},
"trimestres": {
"url": "https://dadosb3.com/empresas/WEGE3/trimestres",
"o_que": "série trimestral da ITR (1T, 2T, 3T) com preço e TTM",
"exige_chave": false
}
},
"chave": {
"necessaria_para": "os recursos marcados com exige_chave",
"degustacao_aberta": [
"BOVA11",
"MXRF11",
"… +1"
],
"como_obter": "https://dadosb3.com/chave-gratis?de=api (200 consultas/dia, sem cartão)"
},
"linhagem": "https://dadosb3.com/linhagem/WEGE3/{ano}/{indicador}",
"metodologia": "https://dadosb3.com/metodologia",
"nota": "Este índice não traz número: é o mapa da companhia. Os números estão nos recursos acima (JSON) e na página legível, que é aberta e não exige…"
}Indicadores /empresas/{T}/indicadores
Os indicadores por ano, com a conta da CVM de onde cada um sai e a ressalva de cada número.
Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · Cache: sem cache público
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" "https://dadosb3.com/empresas/WEGE3/indicadores"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.indicadores("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Resposta real, cortada
{
"cd_cvm": 5410,
"tipo": "geral",
"indicadores": [
{
"ano": 2010,
"nome": "cresc_receita_1a",
"valor": null,
"flag": "denominador_sem_comparativo"
},
{
"ano": 2010,
"nome": "cresc_receita_5a_cagr",
"valor": null,
"flag": "denominador_sem_comparativo"
},
"… +206"
],
"proveniencia": {
"cresc_receita_1a": {
"titulo": "Crescimento de receita (1 ano)",
"formula": "receita(ano) / receita(ano−1) − 1 — receita(ano−1) é o COMPARATIVO REAPRESENTADO publicado junto com o exercício, não o valor arquivado à ép…",
"contas_cvm": [
"3.01 (receita)"
],
"base_lucro": null,
"unidade": "fração; nominal, sem ajuste de inflação",
"metodologia": "https://dadosb3.com/metodologia/crescimento"
},
"cresc_receita_5a_cagr": {
"titulo": "Crescimento de receita (CAGR 5 anos)",
"formula": "(receita(ano) / receita(ano−5))^(1/5) − 1 — receita(ano−5) segue a mesma regra do crescimento de 1 ano: comparativo reapresentado quando exi…",
"contas_cvm": [
"3.01 (receita)"
],
"base_lucro": null,
"unidade": "fração; nominal, sem ajuste de inflação",
"metodologia": "https://dadosb3.com/metodologia/crescimento"
},
"divida_liquida": {
"titulo": "Dívida líquida",
"formula": "dívida bruta − caixa − aplicações financeiras",
"contas_cvm": [
"2.01.04 + 2.02.01 (dívida)",
"1.01.01 (caixa)",
"… +1"
],
"base_lucro": null,
"unidade": "R$",
"metodologia": "https://dadosb3.com/metodologia/divida_liquida_ebitda"
},
"dl_ebitda": {
"titulo": "Dívida líquida / EBITDA",
"formula": "dívida líquida / EBITDA",
"contas_cvm": [
"ver divida_liquida e ebitda"
],
"base_lucro": null,
"unidade": "vezes (x)",
"metodologia": "https://dadosb3.com/metodologia/divida_liquida_ebitda"
},
"ebitda": {
"titulo": "EBITDA",
"formula": "EBIT + depreciação/amortização",
"contas_cvm": [
"3.05 (EBIT)",
"6.01.* D&A da DFC método indireto"
],
"base_lucro": "operacional total; sem DFC_MI o valor é nulo (flag), nunca estimado",
"unidade": "R$",
"metodologia": "https://dadosb3.com/metodologia/divida_liquida_ebitda"
},
"liquidez_corrente": {
"titulo": "Liquidez corrente",
"formula": "ativo circulante / passivo circulante",
"contas_cvm": [
"1.01 (ativo circulante)",
"2.01 (passivo circulante)"
],
"base_lucro": null,
"unidade": "vezes (x); > 1 = o circulante cobre o passivo de curto prazo",
"metodologia": "https://dadosb3.com/metodologia/liquidez"
},
"margem_bruta": {
"titulo": "Margem bruta",
"formula": "resultado bruto / receita líquida",
"contas_cvm": [
"3.03 (resultado bruto)",
"3.01 (receita)"
],
"base_lucro": "consolidado total",
"unidade": "fração",
"metodologia": "https://dadosb3.com/metodologia/margens"
},
"margem_ebit": {
"titulo": "Margem EBIT",
"formula": "EBIT / receita líquida",
"contas_cvm": [
"3.05 (EBIT)",
"3.01 (receita)"
],
"base_lucro": "consolidado total",
"unidade": "fração",
"metodologia": "https://dadosb3.com/metodologia/margens"
},
"margem_liquida": {
"titulo": "Margem líquida",
"formula": "lucro líquido consolidado / receita líquida",
"contas_cvm": [
"3.11 (lucro consolidado TOTAL)",
"3.01 (receita)"
],
"base_lucro": "CONSOLIDADO TOTAL (inclui não-controladores) — difere da base do roe, que é controladores",
"unidade": "fração",
"metodologia": "https://dadosb3.com/metodologia/margens"
},
"piotroski": {
"titulo": "Piotroski F-Score",
"formula": "soma de 9 critérios SIM/NÃO (rentabilidade, alavancagem/liquidez, eficiência) — cada um vale 1 ponto",
"contas_cvm": [
"3.11 (lucro)",
"6.01 (CFO da DFC)",
"… +6"
],
"base_lucro": "consolidado total (3.11); score inteiro de 0 a 9, score parcial (conta faltando) recebe flag, nunca é chutado",
"unidade": "pontos (0 a 9)",
"metodologia": "https://dadosb3.com/metodologia/scores"
},
"roa": {
"titulo": "Retorno sobre o ativo",
"formula": "lucro líquido consolidado total / ativo total médio",
"contas_cvm": [
"3.11 (lucro consolidado TOTAL)",
"1 (ativo total)"
],
"base_lucro": "CONSOLIDADO TOTAL (inclui não-controladores) — casa com o ativo TOTAL do denominador; difere da base do roe (controladores)",
"unidade": "fração (0.08 = 8%)",
"metodologia": "https://dadosb3.com/metodologia/roa"
},
"roe": {
"titulo": "Retorno sobre o patrimônio líquido",
"formula": "lucro dos controladores / PL dos controladores médio",
"contas_cvm": [
"3.11.01 (lucro atribuído aos controladores)",
"2.03 − 2.03.09 (PL dos controladores)"
],
"base_lucro": "CONTROLADORES (exclui não-controladores)",
"unidade": "fração",
"metodologia": "https://dadosb3.com/metodologia/roe"
},
"roic": {
"titulo": "Retorno sobre o capital investido",
"formula": "NOPAT / capital investido médio",
"contas_cvm": [
"3.05 (EBIT)",
"3.07 (LAIR)",
"… +5"
],
"base_lucro": "operacional (NOPAT = EBIT após imposto, TOTAL do grupo)",
"unidade": "fração (0.18 = 18%)",
"metodologia": "https://dadosb3.com/metodologia/roic"
}
},
"contas_usadas": {
"aplic_fin": "BPA 1.01.02 (con, exercício 2025)",
"ativo_circulante": "BPA 1.01 (con, exercício 2025)",
"ativo_total": "BPA 1 (con, exercício 2025)",
"caixa": "BPA 1.01.01 (con, exercício 2025)",
"capex": "DFC_MI 6.02.02+6.02.03 (con, exercício 2025)",
"cfo": "DFC_MI 6.01 (con, exercício 2025)",
"custo": "DRE 3.02 (con, exercício 2025)",
"dep_amort": "DFC_MI 6.01.01.02 (con, exercício 2025)",
"div_curta": "BPP 2.01.04 (con, exercício 2025)",
"div_longa": "BPP 2.02.01 (con, exercício 2025)",
"ebit": "DRE 3.05 (con, exercício 2025)",
"ir_csll": "DRE 3.08 (con, exercício 2025)",
"lair": "DRE 3.07 (con, exercício 2025)",
"lucro_controladores": "DRE 3.11.01 (con, exercício 2025)",
"lucro_dmpl": "DMPL 5.05.01 (con, exercício 2025)",
"lucro_liq": "DRE 3.11 (con, exercício 2025)",
"mutacoes_internas": "DMPL 5.06 (con, exercício 2025)",
"passivo_circulante": "BPP 2.01 (con, exercício 2025)",
"passivo_total": "BPP 2 (con, exercício 2025)",
"pl_final": "DMPL 5.07 (con, exercício 2025)",
"pl_inicial": "DMPL 5.03 (con, exercício 2025)",
"pl_minoritarios": "BPP 2.03.09 (con, exercício 2025)",
"pl_total": "BPP 2.03 (con, exercício 2025)",
"receita": "DRE 3.01 (con, exercício 2025)",
"res_bruto": "DRE 3.03 (con, exercício 2025)",
"res_continuadas": "DRE 3.09 (con, exercício 2025)",
"resultado_abrangente": "DMPL 5.05 (con, exercício 2025)",
"transacoes_socios": "DMPL 5.04 (con, exercício 2025)"
},
"dicionario": "https://dadosb3.com/dicionario",
"nota": "flag != null = confie menos e leia a metodologia. A proveniência de cada indicador (fórmula, conta CVM e BASE do lucro) está em 'provenienci…",
"alerta_minoritarios": {
"por_que": "A margem líquida aqui usa o lucro consolidado TOTAL (conta CVM 3.11). Casas de análise costumam reportar sobre o lucro dos CONTROLADORES (3.…",
"lucro_total_3_11": 6775958000.0,
"lucro_controladores_3_11_01": 6376219000.0,
"diferenca_relativa": 0.058994,
"onde_isso_NAO_se_aplica": "P/L e ROE já usam o lucro dos controladores; quando não há, a flag `lucro_total_sem_minoritarios` avisa no próprio múltiplo."
},
"citacao": "Fonte: https://dadosb3.com/acoes/WEGE3 (Dados B3) — números recalculados dos arquivos públicos da CVM (DFP/ITR) e do COTAHIST da B3; versão …"
}Múltiplos /empresas/{T}/multiplos
P/L, P/VP, EV/EBITDA e FCF yield com o preço do dia em que o balanço ficou público.
Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · Cache: sem cache público
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" "https://dadosb3.com/empresas/WEGE3/multiplos"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.multiplos("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Resposta real, cortada
{
"cd_cvm": 5410,
"citacao": "Fonte: https://dadosb3.com/acoes/WEGE3 (Dados B3) — números recalculados dos arquivos públicos da CVM (DFP/ITR) e do COTAHIST da B3; versão …",
"anuais": [
{
"cd_cvm": 5410,
"ano": 2010,
"dt_receb": "2011-02-23",
"data_preco": "2011-02-23",
"preco": 20.54,
"market_cap": null,
"pl": null,
"pvp": null,
"ev_ebitda": null,
"fcf_yield": null,
"flag": "sem_acoes_em_circulacao",
"preco_de": "preço de 23/02/2011"
},
{
"cd_cvm": 5410,
"ano": 2011,
"dt_receb": "2012-02-15",
"data_preco": "2012-02-15",
"preco": 19.1,
"market_cap": 11859286053.900002,
"pl": 20.205416014522882,
"pvp": 3.12077277035519,
"ev_ebitda": 14.5512850819181,
"fcf_yield": -0.010562946152968837,
"flag": "acoes_do_fre_sem_tesouraria;acoes_defasadas",
"preco_de": "preço de 15/02/2012"
},
"… +14"
],
"trimestrais": [
{
"cd_cvm": 5410,
"ano": 2011,
"trimestre": 1,
"dt_receb": "2011-04-27",
"data_preco": "2011-04-27",
"preco": 19.9,
"market_cap": null,
"lucro_ttm": null,
"pl_ttm": null,
"pvp": null,
"flag": "sem_acoes_em_circulacao"
},
{
"cd_cvm": 5410,
"ano": 2011,
"trimestre": 2,
"dt_receb": "2011-07-22",
"data_preco": "2011-07-22",
"preco": 17.8,
"market_cap": 11052109516.2,
"lucro_ttm": null,
"pl_ttm": null,
"pvp": 3.145964388844405,
"flag": "acoes_do_fre_sem_tesouraria;ttm_sem_trimestre_1_2010"
},
"… +45"
],
"valuation": {
"data_preco": "2026-09-25",
"preco": 51.07,
"ano": 2025,
"acoes": 4197317998.0,
"flags_acoes": [
"acoes_do_fre_sem_tesouraria"
],
"market_cap": 214357030157.86002,
"ev": 211667987157.86002,
"divida_liquida": -2689043000.0,
"lpa": 1.5191174466738606,
"vpa": 4.14959862662281,
"dy_12m": 0.02305822138241629,
"proventos_12m": 1.177583366,
"payout": 1.069653214014371,
"proventos_ano": 1.6249288593,
"fco": 6451033000.0,
"fcf": 3759712000.0,
"p_fco": 33.228326402587,
"p_fcf": 57.01421549253241
},
"nota": "preço = 1º pregão A PARTIR da publicação da demonstração (dt_receb), nunca o fechamento do período — sem vazamento de informação futura. O b…"
}Dividendos /empresas/{T}/dividendos
Cada provento com data com, valor e pagamento, o resumo por ano e o dividend yield de 12 meses.
Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · Cache: sem cache público
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" "https://dadosb3.com/empresas/WEGE3/dividendos"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.dividendos("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Resposta real, cortada
{
"cd_cvm": 5410,
"citacao": "Fonte: https://dadosb3.com/acoes/WEGE3 (Dados B3) — números recalculados dos arquivos públicos da CVM (DFP/ITR) e do COTAHIST da B3; versão …",
"proventos": [
{
"tipo_acao": "ON",
"tipo": "JCP",
"acao_corporativa": "JRS CAP PROPRIO",
"valor": 0.107212121,
"data_aprovacao": "2026-09-15",
"data_com": "2026-09-18",
"preco_com": null,
"flag": "da_ficha_b3"
},
{
"tipo_acao": "ON",
"tipo": "JCP",
"acao_corporativa": "JRS CAP PROPRIO",
"valor": 0.104424242,
"data_aprovacao": "2026-06-16",
"data_com": "2026-06-19",
"preco_com": 45.16,
"flag": null
},
"… +145"
],
"resumo_anual": [
{
"ano": 2004,
"total": 0.012941,
"n": 1
},
{
"ano": 2005,
"total": 0.277941,
"n": 6
},
"… +21"
],
"dividend_yield_12m": {
"valor": 0.023058,
"proventos_12m": 1.177583,
"preco": 51.07,
"data_preco": "2026-09-25",
"ticker_preco": "WEGE3",
"classe": "ON"
},
"cobertura": {
"situacao": "com_proventos",
"n_proventos": 147,
"verificado_em": "2026-09-27",
"significado": "a B3 respondeu e há proventos"
},
"nota": "valor = R$ por ação (bruto, antes de IR sobre JCP). data_com = último dia COM direito; a ação passa a ser negociada ex no pregão seguinte. r…"
}Screener, com as_of e recibo /screener
Filtra o universo por faixas (`<indicador>_min`, `<indicador>_max`). `as_of` usa só o que era público naquele dia; `recibo=true` congela a resposta num endereço permanente com o sha256.
Acesso: chave sempre (é sobre o universo inteiro) · pacote ≥ 0.2.0 · Cache: sem cache público
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" "https://dadosb3.com/screener?roic_min=0.15&as_of=2019-06-30&limite=3&recibo=true"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.screener(roic_min=0.15, as_of="2019-06-30", limite=3, recibo=True)
print(sorted(r))
print(r["total"])Resposta real, cortada
{
"total": 53,
"filtros": [
{
"indicador": "roic",
"operador": "min",
"valor": 0.15
}
],
"empresas": [
{
"cd_cvm": 24279,
"ano": 2017,
"indicadores": "{…}",
"disponivel_em": "2018-01-30",
"nome": "INC EMPREENDIMENTOS IMOBILIÁRIOS S.A.",
"ticker": "INNC3"
},
{
"cd_cvm": 23590,
"ano": 2018,
"indicadores": "{…}",
"disponivel_em": "2019-02-26",
"nome": "WIZ CO PARTICIPAÇÕES E CORRETAGEM DE SEGUROS S.A.",
"ticker": "WIZC3"
},
"… +1"
],
"nota": "só valores SEM flag entram; veja /dicionario para a base de cada indicador",
"as_of": "2019-06-30",
"criterio": "exercício mais recente de cada companhia cujo balanço JÁ ESTAVA PÚBLICO na CVM nesta data (campo `disponivel_em` de cada linha)",
"limite_conhecido": "isto NÃO corrige viés de sobrevivência: o universo é o das companhias ativas hoje, e quem saiu da bolsa não está aqui. O tamanho disso está …",
"recibo": {
"id": "5ca05b7c7d3c2785",
"url": "https://dadosb3.com/recibo/5ca05b7c7d3c2785",
"json": "https://dadosb3.com/recibo/5ca05b7c7d3c2785.json",
"sha256": "689fd9b8c25052e32f038b32f4943f2a06a8a5e31995fab0e7c9c00a1402d72a",
"criado_em": "2026-09-27T03:18:01+00:00",
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976",
"como_conferir": "sha256 do campo `resultado` serializado como JSON com chaves ordenadas, separadores ',' e ':' sem espaço, e UTF-8 sem escapar acentos — em P…"
}
}Recibo /recibo/{id}.json
A pergunta, a versão do dado, o resultado e o sha256 — o recibo que o screener acima emitiu.
Acesso: aberta, sem chave · pacote ≥ 0.2.0 · Cache: público, 5 min
curl -s "https://dadosb3.com/recibo/5ca05b7c7d3c2785.json"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.recibo("5ca05b7c7d3c2785")
print(sorted(r))
print(r["id"])Resposta real, cortada
{
"id": "5ca05b7c7d3c2785",
"criado_em": "2026-09-27T03:18:01+00:00",
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976",
"consulta": {
"ano": null,
"as_of": "2019-06-30",
"filtros": [
[
"roic",
"min",
"… +1"
]
],
"limite": 3
},
"resultado": {
"as_of": "2019-06-30",
"criterio": "exercício mais recente de cada companhia cujo balanço JÁ ESTAVA PÚBLICO na CVM nesta data (campo `disponivel_em` de cada linha)",
"empresas": [
"{…}",
"{…}",
"… +1"
],
"filtros": [
"{…}"
],
"limite_conhecido": "isto NÃO corrige viés de sobrevivência: o universo é o das companhias ativas hoje, e quem saiu da bolsa não está aqui. O tamanho disso está …",
"nota": "só valores SEM flag entram; veja /dicionario para a base de cada indicador",
"total": 53
},
"sha256": "689fd9b8c25052e32f038b32f4943f2a06a8a5e31995fab0e7c9c00a1402d72a",
"como_conferir": "sha256 do campo `resultado` serializado como JSON com chaves ordenadas, separadores ',' e ':' sem espaço, e UTF-8 sem escapar acentos — em P…",
"versao_legivel": "https://dadosb3.com/recibo/5ca05b7c7d3c2785",
"versao_do_dado_hoje": "2026-09-27-reapresentacao-agreg|1790479031878234976",
"nota": "cópia congelada de uma consulta ao screener; não muda quando a base é atualizada. Descritivo, não é recomendação."
}Veredito /empresas/{T}/veredito
Seis números em três perguntas, cada um com faixa e comparação, e a bandeira de confiança do dado.
Acesso: aberta, sem chave · pacote ≥ 0.2.0 · Cache: sem cache público
curl -s "https://dadosb3.com/empresas/WEGE3/veredito"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.veredito("WEGE3")
print(sorted(r))
print(r["empresa"])Resposta real, cortada
{
"empresa": {
"cd_cvm": 5410,
"ticker": "WEGE3",
"pedido": "WEGE3",
"nome": "WEG SA",
"setor": "Bens Industriais",
"tipo": "geral"
},
"ano": 2025,
"modo": "fato",
"frase_topo": "Margem líquida 16,6%; ROIC 38,5%; caixa líquido; P/L 33,1 contra 16,9 do setor; dado de 2025, sem reapresentação relevante.",
"perguntas": [
{
"pergunta": "A empresa ganha dinheiro?",
"itens": [
"margem_liquida",
"roic"
]
},
{
"pergunta": "Está saudável ou endividada?",
"itens": [
"dl_ebitda"
]
},
"… +1"
],
"itens": {
"margem_liquida": {
"nome": "margem_liquida",
"rotulo": "Margem líquida",
"valor": 0.166061,
"ano": 2025,
"flag": null,
"marcas": "{…}",
"faixa": "margem acima de 15%",
"texto_curto": "Margem líquida de 16,6% em 2025; mediana do setor 2,9% (43 companhias); a própria empresa ficou entre 10,8% e 18,1% de 2010 a 2025; 79% das …",
"comparacao": "{…}",
"disponivel": true,
"apoio": "{…}"
},
"roic": {
"nome": "roic",
"rotulo": "Retorno sobre o capital investido (ROIC)",
"valor": 0.38464,
"ano": 2025,
"flag": null,
"marcas": "{…}",
"faixa": "retorno acima de 15% ao ano",
"texto_curto": "Retorno sobre o capital investido (ROIC) de 38,5% em 2025; mediana do setor 13,8% (23 companhias); a própria empresa ficou entre 13,4% e 42,…",
"comparacao": "{…}",
"disponivel": true,
"apoio": "{…}"
},
"dl_ebitda": {
"nome": "dl_ebitda",
"rotulo": "Dívida líquida sobre EBITDA",
"valor": -0.298781,
"ano": 2025,
"flag": null,
"marcas": "{…}",
"faixa": "caixa líquido (dívida líquida negativa)",
"texto_curto": "Dívida líquida sobre EBITDA de -0,3 em 2025; mediana do setor 2,5 (42 companhias); a própria empresa ficou entre -0,9 e 0,6 de 2010 a 2025; …",
"comparacao": "{…}",
"disponivel": true
},
"pl": {
"nome": "pl",
"rotulo": "Preço sobre lucro (P/L)",
"valor": 33.0853745021054,
"ano": 2025,
"flag": null,
"marcas": "{…}",
"faixa": null,
"texto_curto": "Preço sobre lucro (P/L) de 33,1 em 2025; mediana do setor 16,9 (14 companhias); a própria empresa ficou entre 26,8 e 77,7 de 2020 a 2025; 8%…",
"comparacao": "{…}",
"disponivel": true,
"data_preco": "2026-02-25"
},
"pvp": {
"nome": "pvp",
"rotulo": "Preço sobre valor patrimonial (P/VP)",
"valor": 12.112152079824611,
"ano": 2025,
"flag": null,
"marcas": "{…}",
"faixa": null,
"texto_curto": "Preço sobre valor patrimonial (P/VP) de 12,1 em 2025; mediana do setor 2,1 (11 companhias); a própria empresa ficou entre 8,9 e 15,7 de 2020…",
"comparacao": "{…}",
"disponivel": true,
"data_preco": "2026-02-25"
}
},
"bandeira": {
"cor": "verde",
"texto": "Dado do exercício de 2025, recebido pela CVM em 25/02/2026; 5 dos 5 números centrais publicados; última reapresentação registrada em 2022.",
"motivos": [],
"reapresentacoes": {
"n": 10,
"anos": [
2011,
2012,
"… +4"
],
"por_ano": "{…}",
"maior_dif_rel": 0.9797,
"ultimo_ano": 2022
},
"ressalvas": {
"n": 0,
"de": 13,
"quais": []
},
"defasagem": {
"ultimo_dfp_referencia": "2025-12-31",
"ultimo_dfp_recebido": "2026-02-25",
"ultimo_itr_referencia": "2026-06-30",
"ultimo_trimestre": "2T2026",
"anos_entre_indicador_e_balanco": 0
},
"numeros_publicados": 5
},
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976",
"apurado_em": "2026-02-25",
"nota": "Descritivo: número, faixa numérica e comparação com o setor, com a própria história e com o universo. Não é recomendação de investimento.",
"pagina": "https://dadosb3.com/acoes/WEGE3",
"metodologia": "https://dadosb3.com/metodologia",
"citacao": "Fonte: https://dadosb3.com/acoes/WEGE3 (Dados B3) — números recalculados dos arquivos públicos da CVM (DFP/ITR) e do COTAHIST da B3; versão …"
}Vigia /vigia/eventos
Os eventos registrados (lucro que virou prejuízo, mudança de faixa, reapresentação, bandeira), com a data do documento que revelou cada um. `classe=fiis` dá o vigia dos fundos.
Acesso: aberta, sem chave · pacote ≥ 0.2.0 · Cache: público, 5 min
curl -s "https://dadosb3.com/vigia/eventos?ticker=WEGE3&limite=2"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.vigia(ticker="WEGE3", limite=2)
print(sorted(r))
print(r["versao_do_dado"])Resposta real, cortada
{
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976",
"total": 24,
"mostrados": 2,
"eventos": [
{
"tipo": "bandeira",
"periodo_anterior": "2023",
"periodo_novo": "2024",
"data": "2025-02-26",
"indicador": null,
"antes": "amarelo",
"depois": "verde",
"faixa_antes": null,
"faixa_depois": null,
"motivos": [],
"fonte": "DFP 2024, recebida pela CVM em 26/02/2025",
"texto": "A bandeira de confiança do dado passou de amarela para verde com o balanço de 2024: nenhum dos motivos do exercício anterior vale mais.",
"texto_en": "The data confidence flag went from yellow to green with the 2024 statements.",
"ticker": "WEGE3",
"nome": "WEG SA",
"cd_cvm": 5410,
"setor": "Bens Industriais",
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976"
},
{
"periodo_anterior": "2022",
"periodo_novo": "2023",
"data": "2024-02-21",
"fonte": "DFP 2023, recebida pela CVM em 21/02/2024",
"tipo": "faixa_margem",
"indicador": "margem_liquida",
"antes": 0.142883,
"depois": 0.180522,
"faixa_antes": "margem entre 5% e 15%",
"faixa_depois": "margem acima de 15%",
"texto": "Margem líquida passou de 14,3% em 2022 para 18,1% em 2023: de \"margem entre 5% e 15%\" para \"margem acima de 15%\".",
"texto_en": "Net margin went from 14.3% in 2022 to 18.1% in 2023.",
"ticker": "WEGE3",
"nome": "WEG SA",
"cd_cvm": 5410,
"setor": "Bens Industriais",
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976"
}
],
"contador_mensal": [
{
"mes": "2026-09",
"n": 2,
"por_tipo": "{…}"
},
{
"mes": "2026-08",
"n": 92,
"por_tipo": "{…}"
},
"… +180"
],
"tipos": {
"lucro_prejuizo": "Lucro ou prejuízo",
"faixa_margem": "Margem líquida mudou de faixa",
"faixa_divida": "Dívida líquida/EBITDA mudou de faixa",
"reapresentacao": "Balanço reapresentado",
"bandeira": "Bandeira de confiança mudou de cor"
},
"criterio": "cada período contra o anterior: exercício contra exercício (DFP); trimestre contra o trimestre anterior (ITR, sem 4T). Só números sem ressal…",
"pagina": "https://dadosb3.com/vigia",
"metodologia": "https://dadosb3.com/metodologia"
}Reapresentações da companhia /empresas/{T}/reapresentacoes
Cada conta-chave que voltou diferente na DFP seguinte, com os dois valores e a agregação publicada.
Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · Cache: sem cache público
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" "https://dadosb3.com/empresas/WEGE3/reapresentacoes"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.reapresentacoes("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Resposta real, cortada
{
"cd_cvm": 5410,
"citacao": "Fonte: https://dadosb3.com/acoes/WEGE3 (Dados B3) — números recalculados dos arquivos públicos da CVM (DFP/ITR) e do COTAHIST da B3; versão …",
"total": 10,
"reapresentacoes": [
{
"ano": 2022,
"demo": "DFC_MI",
"cd_conta": "6.01",
"valor_ultimo": 2982930000.0,
"valor_penult": 2936931000.0,
"dif_rel": 0.015421,
"agreg": "con",
"sem_valor": null
},
{
"ano": 2021,
"demo": "DFC_MI",
"cd_conta": "6.01",
"valor_ultimo": 939385000.0,
"valor_penult": 1056058000.0,
"dif_rel": 0.11048,
"agreg": "con",
"sem_valor": null
},
"… +8"
],
"nota": "Cada linha é uma conta-chave cujo valor do exercício mudou entre a primeira publicação (valor_ultimo: coluna ÚLTIMO da DFP do próprio ano) e…",
"nota_agregacao": "agreg = agregação publicada naquele exercício: 'con' (consolidado) ou 'ind' (individual — companhia não consolida; o individual é a única ag…"
}Reapresentações do FII /fiis/{T}/reapresentacoes
Os informes reenviados à CVM e, quando o build viu o reenvio, o antes e depois campo a campo.
Acesso: aberta, sem chave · pacote ≥ 0.2.0 · Cache: público, 5 min
curl -s -H "Accept: application/json" "https://dadosb3.com/fiis/MXRF11/reapresentacoes"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.reapresentacoes_fii("MXRF11")
print(sorted(r))
print(r["fundo"])Resposta real, cortada
{
"fundo": {
"cnpj": "97.521.225/0001-25",
"ticker": "MXRF11",
"nome": "FII MAXI RENDA RL"
},
"versoes": [
{
"competencia": "2026-06-01",
"versao": 2,
"data_entrega": "2026-07-30"
},
{
"competencia": "2026-03-01",
"versao": 2,
"data_entrega": "2026-04-16"
},
"… +10"
],
"capturadas": [],
"versao_do_dado": "2026-09-27-reapresentacao-agreg|1790479031878234976",
"criterio": "`versoes`: cada competência com versão acima de 1 (reenviada à CVM), com a entrega da versão vigente. `capturadas`: antes e depois de cada c…",
"pagina": "https://dadosb3.com/fiis/MXRF11/reapresentacoes"
}FII /fiis/{T}
Cadastro, último informe, P/VP, DY de 12 meses, vacância e proventos recentes.
Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · Cache: público, 5 min
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" -H "Accept: application/json" "https://dadosb3.com/fiis/MXRF11"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.fii("MXRF11")
print(sorted(r))
print(r["cadastro"])Resposta real, cortada
{
"cadastro": {
"cnpj": "97.521.225/0001-25",
"ticker": "MXRF11",
"isin": "BRMXRFCTF008",
"nome": "FII MAXI RENDA RL",
"segmento": "Logística",
"mandato": null,
"tipo_gestao": "Ativa",
"publico_alvo": "INVESTIDORES EM GERAL",
"data_funcionamento": "2012-04-13"
},
"ultimo_informe": {
"cotistas": 1529305,
"pl": 5252427199.9,
"competencia": "2026-08-01"
},
"pvp": [
{
"competencia": "2021-01-01",
"data_entrega": "2021-02-12",
"data_preco": "2021-02-12",
"preco": 10.75,
"vp_cota": 10.0775769146549,
"pvp": 1.0667246790612193,
"flag": null
},
{
"competencia": "2021-02-01",
"data_entrega": "2021-03-15",
"data_preco": "2021-03-15",
"preco": 10.36,
"vp_cota": 10.0700103760807,
"pvp": 1.0287973510541868,
"flag": null
},
"… +66"
],
"dy_12m": {
"data_base": "2026-08-31",
"data_preco": "2026-09-25",
"preco": 9.1,
"rendimento_12m": 1.195,
"n_meses": 12,
"dy_12m": 0.13131868131868132,
"flag": null
},
"vacancia": [],
"proventos_recentes": [
{
"tipo": "RENDIMENTO",
"valor": 0.1,
"data_com": "2026-08-31",
"data_pagamento": "2026-09-15",
"relativo_a": "Agosto-2026/2026",
"flag": null
},
{
"tipo": "RENDIMENTO",
"valor": 0.1,
"data_com": "2026-07-31",
"data_pagamento": "2026-08-14",
"relativo_a": "Julho-2026/2026",
"flag": null
},
"… +10"
],
"nota": "P/VP: preço do 1º pregão A PARTIR da publicação do informe (Data_Entrega) ÷ valor patrimonial da cota — ponto-no-tempo, histórico. DY: soma …"
}ETF /etfs/{T}
Cadastro, ágio sobre a cota, taxa efetiva, carteira, retornos e liquidez.
Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · Cache: público, 5 min
curl -s -H "X-API-Key: $DADOS_B3_API_KEY" -H "Accept: application/json" "https://dadosb3.com/etfs/BOVA11"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # chave: variável DADOS_B3_API_KEY
r = c.etf("BOVA11")
print(sorted(r))
print(r["cadastro"])Resposta real, cortada
{
"cadastro": {
"cnpj": "10406511000161",
"codigo_cvm": "612",
"nome": "ISHARES IBOVESPA CLASSE DE ÍNDICE - RESPONSABILIDADE LIMITADA",
"ticker": "BOVA11",
"sigla": "BOVA",
"tipo_b3": "ETF",
"situacao": "Em Funcionamento Normal",
"data_inicio": "2025-04-23",
"gestor": "BANCO BNP PARIBAS BRASIL S/A",
"administrador": null,
"escriturador": "BANCO BNP PARIBAS BRASIL",
"custodiante": "BANCO BNP PARIBAS BRASIL S/A",
"auditor": "PRICEWATERHOUSECOOPERS AUDITORES INDEPENDENTES LTDA.",
"id_fnet": 990,
"cotas_emitidas": 8627852083.0,
"cotas_data": "2008-12-03",
"indice_nome": "Ibovespa",
"pl_registro": 13821437957.95,
"pl_registro_data": "2026-09-08"
},
"ultimo_informe": {
"data": "2026-08-31",
"cota": 174.603535,
"pl": 14090505278.94,
"cotistas": 101154,
"captacao": 174603535.0,
"resgate": 392857953.75,
"data_entrega": "2026-09-01"
},
"ultimo_fechamento": {
"data": "2026-09-25",
"fechamento": 180.82
},
"ultimo_agio": {
"data": "2026-08-31",
"preco": 174.78,
"cota": 174.603535,
"agio": 0.0010106610957218987,
"flag": null
},
"agio_30_pregoes": [
{
"data": "2026-07-21",
"preco": 170.34,
"cota": 170.337885,
"agio": 1.2416497950473726e-05,
"flag": null
},
{
"data": "2026-07-22",
"preco": 174.7,
"cota": 174.48788,
"agio": 0.0012156718277509526,
"flag": null
},
"… +28"
],
"taxa_efetiva_mensal": [
{
"competencia": "2026-08-01",
"despesa": 866611.9699999997,
"pl_medio": 14444505524.786667,
"taxa_efetiva_aa": 0.0007199515152771965,
"flag": null
},
{
"competencia": "2026-07-01",
"despesa": 4243492.73,
"pl_medio": 13901337566.459131,
"taxa_efetiva_aa": 0.0036630944696187636,
"flag": "acumulado_sem_mes_anterior"
},
"… +1"
],
"taxa_media_12m": 0.0007199515152771965,
"carteira": {
"competencia": "2026-08-01",
"n_posicoes": 156,
"pl": 14090505278.94,
"maiores": [
"{…}",
"{…}",
"… +8"
],
"por_tipo": [
[
"Ações",
0.6770268848795781
],
[
"Ações e outros TVM cedidos em empréstimo",
0.26456263090733095
],
"… +3"
],
"sobreposicao_mesmo_indice": [
"{…}",
"{…}",
"… +6"
]
},
"retornos_pela_cota": {
"janelas": {
"1m": "{…}",
"3m": "{…}",
"1a": "{…}",
"2a": "{…}",
"5a": "{…}",
"10a": "{…}"
},
"ate": "2026-08-31",
"mil_reais": {
"1m": 1010.0157754212802,
"3m": 1192.1533712359876,
"1a": 1261.065808997495
}
},
"retornos_pelo_preco": {
"janelas": {
"1m": "{…}",
"3m": "{…}",
"1a": "{…}",
"2a": "{…}",
"5a": "{…}",
"10a": "{…}"
},
"ate": "2026-09-25",
"mil_reais": {
"1m": 1046.8967114404818,
"3m": 1062.2723534249794,
"1a": 1269.4467846110642,
"2a": 1401.2709237445754,
"5a": 1660.5748920929377,
"10a": 3191.8799646954985
}
},
"pares": {
"n": 15,
"criterio": "indice",
"agio": 0.0006973911199551486,
"taxa": 0.0049824848367434555
},
"liquidez_media_60": 606795518.1101668,
"cobertura": {
"precos": {
"n": 4151,
"de": "2010-01-04",
"ate": "2026-09-25"
},
"informes": {
"n": 88,
"de": "2025-08-01",
"ate": "2026-08-31"
}
},
"fontes": {
"cadastro": "CVM RCVM 175 (classe FIIM) + B3",
"cota_pl_cotistas": "FNET Informe Diário",
"taxa": "FNET Balancete (COFI), efetiva",
"carteira": "CVM CDA (cda_fie)",
"preco": "B3 COTAHIST"
}
}Fontes: CVM (dados abertos, ODbL) e B3 (COTAHIST). Não afiliado à B3 nem à CVM. Não é recomendação de investimento.
Os números desta página são ao vivo. Versão do dado 2026-09-27-reapresentacao-agreg · página gerada em 2026-09-27 03:36 UTC. Se isto não bater com o /saude, você está lendo uma cópia em cache.