Dados B3 › API
API
API and integrations — getting the data to your side
Everything on the pages is also available through the API, and the whole dataset comes out as CSV. No contract, no sales call.
Documentation
Every endpoint, with examples you can run right now.
Bulk exportJSON
The whole dataset as CSV — nine sets, one request each. Pro plan.
AI connector (MCP)
Plug Claude, ChatGPT or Cursor straight into the database.
Field dictionaryJSON
What each field means and which CVM account it comes from.
Coverage by yearJSON
How many indicators and multiples exist in each year — the real window, not the promised one.
pip install dadosb3 — official Python client: stocks, REITs, ETFs, seeded audit and typed errors, with no request-building by hand. pypi.org/project/dadosb3
For developers: one section per route
Key. Send it in the X-API-Key header. Without a key, every data route answers for BOVA11, MXRF11, WEGE3 (so you can try before signing up), the routes marked open answer for everyone, and the rest reply 401 with the link to create one. The free key allows 200 calls a day; the Pro key, 10,000. Past the limit the answer is 429, and the count restarts the next day. Create a free key.
Cache. On the routes marked “public, 5 min”, a successful answer to a request WITHOUT a key goes out with Cache-Control: public, max-age=300: a browser, proxy or CDN may reuse it for up to 5 minutes. Nothing changes faster than that here — prices are updated nightly and filings weekly. The routes under /empresas/ (data behind a key) never get public cache, and neither does any answer to a request WITH a key.
Python. pip install dadosb3 — pypi.org/project/dadosb3. The examples below use the client methods; the ones marked “package ≥ 0.2.0” need that version.
AI connector (MCP). dados-b3-mcp 1.7.0, listed on the official MCP registry as io.github.Val7h/dados-b3 · how to connect.
Company /empresas/{T}
Who the company is, its tickers, what exists about it and where each resource lives.
Access: open, no key · package ≥ 0.2.0 · Cache: no public cache
curl -s "https://dadosb3.com/empresas/WEGE3"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # key: DADOS_B3_API_KEY variable
r = c.empresa("WEGE3")
print(sorted(r))
print(r["ticker"])Real response, cut
{
"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…"
}Indicators /empresas/{T}/indicadores
Indicators by year, with the CVM account each one comes from and the caveat on each figure.
Access: key, except for BOVA11, MXRF11, WEGE3 · Cache: no public cache
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() # key: DADOS_B3_API_KEY variable
r = c.indicadores("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Real response, cut
{
"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 …"
}Multiples /empresas/{T}/multiplos
P/E, P/B, EV/EBITDA and FCF yield at the price of the day the filing became public.
Access: key, except for BOVA11, MXRF11, WEGE3 · Cache: no public cache
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() # key: DADOS_B3_API_KEY variable
r = c.multiplos("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Real response, cut
{
"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…"
}Dividends /empresas/{T}/dividendos
Each distribution with record date, amount and payment, the yearly summary and the 12-month yield.
Access: key, except for BOVA11, MXRF11, WEGE3 · Cache: no public cache
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() # key: DADOS_B3_API_KEY variable
r = c.dividendos("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Real response, cut
{
"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, with as_of and receipt /screener
Filters the universe by ranges (`<indicator>_min`, `<indicator>_max`). `as_of` uses only what was public on that day; `recibo=true` freezes the answer at a permanent address with its sha256.
Access: key always (it covers the whole universe) · package ≥ 0.2.0 · Cache: no public cache
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() # key: DADOS_B3_API_KEY variable
r = c.screener(roic_min=0.15, as_of="2019-06-30", limite=3, recibo=True)
print(sorted(r))
print(r["total"])Real response, cut
{
"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…"
}
}Receipt /recibo/{id}.json
The question, the data version, the result and the sha256 — the receipt the screener above issued.
Access: open, no key · package ≥ 0.2.0 · Cache: public, 5 min
curl -s "https://dadosb3.com/recibo/5ca05b7c7d3c2785.json"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # key: DADOS_B3_API_KEY variable
r = c.recibo("5ca05b7c7d3c2785")
print(sorted(r))
print(r["id"])Real response, cut
{
"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."
}Verdict /empresas/{T}/veredito
Six figures in three questions, each with a range and a comparison, and the data confidence flag.
Access: open, no key · package ≥ 0.2.0 · Cache: no public cache
curl -s "https://dadosb3.com/empresas/WEGE3/veredito"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # key: DADOS_B3_API_KEY variable
r = c.veredito("WEGE3")
print(sorted(r))
print(r["empresa"])Real response, cut
{
"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 …"
}Watcher /vigia/eventos
Recorded events (profit turned into loss, range change, restatement, flag), with the date of the filing that revealed each one. `classe=fiis` gives the funds watcher.
Access: open, no key · package ≥ 0.2.0 · Cache: public, 5 min
curl -s "https://dadosb3.com/vigia/eventos?ticker=WEGE3&limite=2"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # key: DADOS_B3_API_KEY variable
r = c.vigia(ticker="WEGE3", limite=2)
print(sorted(r))
print(r["versao_do_dado"])Real response, cut
{
"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"
}Company restatements /empresas/{T}/reapresentacoes
Each key account that came back different in the next annual filing, with both values and the published aggregation.
Access: key, except for BOVA11, MXRF11, WEGE3 · Cache: no public cache
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() # key: DADOS_B3_API_KEY variable
r = c.reapresentacoes("WEGE3")
print(sorted(r))
print(r["cd_cvm"])Real response, cut
{
"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…"
}REIT restatements /fiis/{T}/reapresentacoes
Reports resubmitted to the CVM and, when the build saw it, before and after field by field.
Access: open, no key · package ≥ 0.2.0 · Cache: public, 5 min
curl -s -H "Accept: application/json" "https://dadosb3.com/fiis/MXRF11/reapresentacoes"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # key: DADOS_B3_API_KEY variable
r = c.reapresentacoes_fii("MXRF11")
print(sorted(r))
print(r["fundo"])Real response, cut
{
"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"
}REIT (FII) /fiis/{T}
Registry, latest report, P/B, 12-month yield, vacancy and recent distributions.
Access: key, except for BOVA11, MXRF11, WEGE3 · Cache: public, 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() # key: DADOS_B3_API_KEY variable
r = c.fii("MXRF11")
print(sorted(r))
print(r["cadastro"])Real response, cut
{
"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}
Registry, premium over NAV, effective fee, holdings, returns and liquidity.
Access: key, except for BOVA11, MXRF11, WEGE3 · Cache: public, 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() # key: DADOS_B3_API_KEY variable
r = c.etf("BOVA11")
print(sorted(r))
print(r["cadastro"])Real response, cut
{
"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"
}
}Sources: CVM (open data, ODbL) and B3 (COTAHIST). Not affiliated with B3 or the CVM. Not investment advice.
Numbers on this page are live. Data version 2026-09-27-reapresentacao-agreg · page generated 2026-09-27 04:10 UTC. If this does not match /saude, you are reading a cached copy.