EN

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.

Taxas do Tesouro Direto (Tesouro Nacional)JSON

Taxa e preço de cada título no dia-base mais recente, ou a série diária de um título, em JSON ou CSV, com fonte, licença e frase para citar.

Tarifas de energia por distribuidora (ANEEL)JSON

A tarifa residencial mais recente de cada distribuidora, ou todas as vigências de uma, em JSON ou CSV, com fonte, licença e frase para citar.

Acessos de telecom por operadora (Anatel)JSON

O ranking das operadoras de telefonia móvel e banda larga fixa, ou a série mensal de uma, em JSON ou CSV, com fonte, licença, atribuição e frase para citar.

Fundos de investimento: cota, PL e captação (CVM)JSON

Os maiores fundos por PL e quem mais captou ou perdeu no mês, a série de 13 meses de um fundo ou a busca pelo nome, em JSON ou CSV, com fonte, licença e frase para citar.

Produção de petróleo e gás por operador e campo (ANP)JSON

Os operadores ou os campos do último mês, ou a série mensal de um operador ou campo, em JSON ou CSV, com fonte, licença e frase para citar.

Séries macro (BCB e IBGE)JSON

Dólar e euro PTAX, Selic, IPCA, PIB e desemprego em JSON ou CSV, com fonte, licença e frase para citar em cada resposta.

Boletim Focus (BCB)JSON

As medianas semanais de IPCA, Selic, câmbio e PIB desde 2001 em JSON ou CSV, com fonte, licença e frase para citar.

Planilha no Google Planilhas

A função =DADOSB3() traz ROE, P/L, dividend yield e próximo provento para a sua planilha, a coluna inteira de uma vez.

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, as marcadas “qualquer ticker” respondem um ticker por vez com limite por endereço (60 consultas por hora e 150 por dia, por endereço; assistentes de IA (ChatGPT, Claude, Perplexity e o conector MCP) têm conta própria: 2.000 por hora e 20.000 por dia, por endereço; passou, 429 com Retry-After), e as demais devolvem 401 com o link para criar uma chave. Data passada (as_of), versões do balanço, a base inteira (/dump, CSV) e o screener em massa exigem chave. 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 a cada reconstrução da base. 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.9.3, 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,
      "aberto_sem_chave_com_limite_por_ip": false
    },
    "multiplos": {
      "url": "https://dadosb3.com/empresas/WEGE3/multiplos",
      "o_que": "P/L, P/VP, EV/EBITDA ponto-no-tempo e P/L TTM (o parâmetro `as_of` exige chave)",
      "exige_chave": false,
      "aberto_sem_chave_com_limite_por_ip": false
    },
    "fatos": {
      "url": "https://dadosb3.com/empresas/WEGE3/fatos",
      "o_que": "contas padronizadas com a conta CVM de origem (?trimestral=true; o parâmetro `as_of` exige chave)",
      "exige_chave": false,
      "aberto_sem_chave_com_limite_por_ip": false
    },
    "dividendos": {
      "url": "https://dadosb3.com/empresas/WEGE3/dividendos",
      "o_que": "proventos, resumo por ano e dividend yield de 12 meses",
      "exige_chave": false,
      "aberto_sem_chave_com_limite_por_ip": false
    },
    "scores": {
      "url": "https://dadosb3.com/empresas/WEGE3/scores",
      "o_que": "Piotroski com os nove critérios abertos, e Graham",
      "exige_chave": false,
      "aberto_sem_chave_com_limite_por_ip": false
    },
    "reapresentacoes": {
      "url": "https://dadosb3.com/empresas/WEGE3/reapresentacoes",
      "o_que": "balanços republicados: versão original e revisada",
      "exige_chave": false,
      "aberto_sem_chave_com_limite_por_ip": 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,
      "aberto_sem_chave_com_limite_por_ip": false
    }
  },
  "chave": {
    "necessaria_para": "os recursos marcados com exige_chave, o parâmetro `as_of` e a base inteira (/dump)",
    "aberto_sem_chave": "fatos contábeis, indicadores anuais, múltiplos, dividendos, ficha de FII e ranking de FII, de qualquer ticker, um por vez; limite por IP: 60…",
    "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: aberta, sem chave, qualquer ticker, com limite por endereço (60 consultas por hora e 150 por dia, por endereço; assistentes de IA (ChatGPT, Claude, Perplexity e o conector MCP) têm conta própria: 2.000 por hora e 20.000 por dia, por endereço) · Cache: sem cache público

curl -s "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."
  },
  "aviso_lucro_atipico": {
    "anos_marcados": {},
    "regra": "Aviso quando um trimestre do período passa nos dois testes: (1) lucro do trimestre isolado a pelo menos 3 vezes a mediana dos 4 trimestres a…"
  },
  "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. Com o ticker de outra classe da mesma companhia (PETR3, a PN, a unit), P/L e P/VP usam o fechamento daquela classe no mesmo pregão (`classe_consultada` diz qual classe e qual preço). Aberta; o parâmetro `as_of` (data passada) exige chave.

Acesso: aberta, sem chave, qualquer ticker, com limite por endereço (60 consultas por hora e 150 por dia, por endereço; assistentes de IA (ChatGPT, Claude, Perplexity e o conector MCP) têm conta própria: 2.000 por hora e 20.000 por dia, por endereço) · Cache: sem cache público

curl -s "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",
      "acoes": null,
      "lpa": null
    },
    {
      "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",
      "acoes": 620905029.0,
      "lpa": 0.9452911034482859
    },
    "… +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",
      "acoes": null,
      "lpa_ttm": null
    },
    {
      "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",
      "acoes": 620905029.0,
      "lpa_ttm": null
    },
    "… +46"
  ],
  "valuation": {
    "data_preco": "2026-11-19",
    "preco": 51.13,
    "ano": 2025,
    "acoes": 4197317998.0,
    "flags_acoes": [
      "acoes_do_fre_sem_tesouraria"
    ],
    "market_cap": 214608869237.74002,
    "ev": 211919826237.74002,
    "divida_liquida": -2689043000.0,
    "lpa": 1.5191174466738606,
    "vpa": 4.14959862662281,
    "dy_12m": 0.03917947803637786,
    "proventos_12m": 2.003246712,
    "payout": 1.613168363424186,
    "proventos_ano": 2.4505922053,
    "fco": 6451033000.0,
    "fcf": 3759712000.0,
    "p_fco": 33.267364968949934,
    "p_fcf": 57.08119910188334,
    "lucro_salto_atipico": false,
    "salto_de_lucro": null,
    "aviso_lucro": null,
    "valor_de_mercado": 214608869237.74002,
    "valor_de_mercado_classes": null
  },
  "aviso_lucro_atipico": {
    "exercicio": {
      "ano": 2025,
      "lucro_salto_atipico": false
    },
    "doze_meses": {
      "ate": "3T26",
      "lucro_salto_atipico": false
    }
  },
  "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: aberta, sem chave, qualquer ticker, com limite por endereço (60 consultas por hora e 150 por dia, por endereço; assistentes de IA (ChatGPT, Claude, Perplexity e o conector MCP) têm conta própria: 2.000 por hora e 20.000 por dia, por endereço) · Cache: sem cache público

curl -s "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": 51.78,
      "flag": null,
      "parcela": 1,
      "data_pagamento": "2027-03-10"
    },
    {
      "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,
      "parcela": 1,
      "data_pagamento": "2027-03-10"
    },
    "… +147"
  ],
  "resumo_anual": [
    {
      "ano": 2004,
      "total": 0.012941,
      "n": 1,
      "dividendos": 0.0,
      "jcp_bruto": 0.012941,
      "outros": 0.0,
      "jcp_liquido_estimado": 0.011,
      "restituicao_capital": 0.0
    },
    {
      "ano": 2005,
      "total": 0.277941,
      "n": 6,
      "dividendos": 0.225,
      "jcp_bruto": 0.052941,
      "outros": 0.0,
      "jcp_liquido_estimado": 0.045,
      "restituicao_capital": 0.0
    },
    "… +21"
  ],
  "dividend_yield_12m": {
    "valor": 0.039179,
    "proventos_12m": 2.003247,
    "ano_corrente_ate_hoje": {
      "ano": 2026,
      "ate": "2026-11-22",
      "total": 0.311758,
      "n": 3
    },
    "ano_anterior_fechado": {
      "ano": 2025,
      "total": 2.450592,
      "n": 10
    },
    "preco": 51.13,
    "data_preco": "2026-11-19",
    "ticker_preco": "WEGE3",
    "classe": "ON"
  },
  "restituicoes_de_capital": [],
  "restituicao_capital_12m": {
    "total": 0,
    "n": 0,
    "itens": []
  },
  "cobertura": {
    "situacao": "com_proventos",
    "n_proventos": 149,
    "verificado_em": "2026-11-20",
    "significado": "a B3 respondeu e há proventos"
  },
  "nota": "valor = R$ por ação (bruto, antes de IR sobre JCP). Restituição de capital (tipo B3 'REST CAP DIN') é devolução de capital aprovada em assem…"
}

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 do screener é o das companhias ativas hoje; as que saíram da bolsa ficam em tabelas própr…",
  "recibo": {
    "id": "d15a7db6778ea3b6",
    "url": "https://dadosb3.com/recibo/d15a7db6778ea3b6",
    "json": "https://dadosb3.com/recibo/d15a7db6778ea3b6.json",
    "sha256": "542a6fbd6ce78bb4625dce87d9a31a50df91dc89d98008b26d2942d74b4964d2",
    "criado_em": "2026-11-22T09:49:28+00:00",
    "versao_do_dado": "2026-11-09-ancora-do-fre|1795340958908438678",
    "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/d15a7db6778ea3b6.json"
from dadosb3 import DadosB3  # pip install dadosb3
c = DadosB3()  # chave: variável DADOS_B3_API_KEY
r = c.recibo("d15a7db6778ea3b6")
print(sorted(r))
print(r["id"])
Resposta real, cortada
{
  "id": "d15a7db6778ea3b6",
  "criado_em": "2026-11-22T09:49:28+00:00",
  "versao_do_dado": "2026-11-09-ancora-do-fre|1795340958908438678",
  "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 do screener é o das companhias ativas hoje; as que saíram da bolsa ficam em tabelas própr…",
    "nota": "só valores SEM flag entram; veja /dicionario para a base de cada indicador",
    "total": 53
  },
  "sha256": "542a6fbd6ce78bb4625dce87d9a31a50df91dc89d98008b26d2942d74b4964d2",
  "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/d15a7db6778ea3b6",
  "versao_do_dado_hoje": "2026-11-09-ancora-do-fre|1795340958908438678",
  "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 com o preço de 25/02/2026, quando o balanço saiu; com o fechamento de 19/11/2026, …",
  "frase_topo_en": "Net margin 16.6%; ROIC 38.5%; net cash; P/E 33.1 at the price of 2026-02-25, when the statements came out; at the 2026-11-19 close, 33.6; se…",
  "perguntas": [
    {
      "pergunta": "A empresa ganha dinheiro?",
      "pergunta_en": "Does the company make money?",
      "itens": [
        "margem_liquida",
        "roic"
      ]
    },
    {
      "pergunta": "Está saudável ou endividada?",
      "pergunta_en": "Is it sound or indebted?",
      "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; 80% das …",
      "comparacao": "{…}",
      "disponivel": true,
      "faixa_en": "margin above 15%",
      "texto_curto_en": "Net margin of 16.6% in 2025; sector median 2.9% (43 companies); the company itself ranged from 10.8% to 18.1% between 2010 and 2025; 80% of …",
      "apoio": "{…}"
    },
    "roic": {
      "nome": "roic",
      "rotulo": "Retorno sobre o capital investido (ROIC)",
      "valor": 0.38464,
      "ano": 2025,
      "flag": null,
      "marcas": "{…}",
      "faixa": "retorno igual ou acima da Selic média de 2025 (14,4% ao ano, antes de imposto)",
      "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,
      "faixa_en": "return equal to or above the average Selic rate of 2025 (14.4% a year, before tax)",
      "texto_curto_en": "Return on invested capital (ROIC) of 38.5% in 2025; sector median 13.8% (23 companies); the company itself ranged from 13.4% to 42.1% betwee…",
      "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,
      "faixa_en": "net cash (negative net debt)",
      "texto_curto_en": "Net debt to EBITDA of -0.3 in 2025; sector median 2.5 (42 companies); the company itself ranged from -0.9 to 0.6 between 2010 and 2025; 86% …"
    },
    "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 (preço de 25/02/2026, dia em que o balanço ficou público); com o último fechamento (19/11/2026) e o …",
      "comparacao": "{…}",
      "disponivel": true,
      "faixa_en": null,
      "texto_curto_en": "Price to earnings (P/E) of 33.1 in 2025 (price of 2026-02-25, the day the statements became public); at the latest close (2026-11-19) with t…",
      "valor_preco_atual": 33.64469368123805,
      "data_preco_atual": "2026-11-19",
      "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 (preço de 25/02/2026, dia em que o balanço ficou público); com o último fechamento (19/…",
      "comparacao": "{…}",
      "disponivel": true,
      "faixa_en": null,
      "texto_curto_en": "Price to book (P/B) of 12.1 in 2025 (price of 2026-02-25, the day the statements became public); at the latest close (2026-11-19) with the s…",
      "valor_preco_atual": 12.316912009575026,
      "data_preco_atual": "2026-11-19",
      "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.",
    "texto_en": "Data for fiscal year 2025, received by the CVM on 2026-02-25; 5 of the 5 core figures published; last restatement recorded in 2022.",
    "motivos": [],
    "motivos_en": [],
    "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-09-30",
      "ultimo_trimestre": "3T2026",
      "anos_entre_indicador_e_balanco": 0
    },
    "numeros_publicados": 5
  },
  "versao_do_dado": "2026-11-09-ancora-do-fre|1795340958908438678",
  "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.",
  "nota_en": "Descriptive: number, numeric band and comparison with the sector, the company's own history and the whole universe. Not investment advice.",
  "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` e `classe=etfs` dão os vigias dos fundos imobiliários e dos ETFs.

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-11-09-ancora-do-fre|1795340958908438678",
  "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: none of the previous year's reasons applies any more.",
      "ticker": "WEGE3",
      "nome": "WEG SA",
      "cd_cvm": 5410,
      "setor": "Bens Industriais",
      "versao_do_dado": "2026-11-09-ancora-do-fre|1795340958908438678"
    },
    {
      "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-11-09-ancora-do-fre|1795340958908438678"
    }
  ],
  "contador_mensal": [
    {
      "mes": "2026-11",
      "n": 12,
      "por_tipo": "{…}"
    },
    {
      "mes": "2026-10",
      "n": 13,
      "por_tipo": "{…}"
    },
    "… +182"
  ],
  "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…"
}

Versões do balanço /empresas/{T}/versoes

Cada DFP e ITR com todas as versões que a CVM recebeu, a data de cada uma e, onde guardamos os valores, as contas que mudaram (antes e depois). Em /fatos, `as_of=AAAA-MM-DD` devolve o balanço como estava naquela data.

Acesso: chave, menos em BOVA11, MXRF11, WEGE3 · pacote ≥ 0.3.0 · Cache: sem cache público

curl -s -H "X-API-Key: $DADOS_B3_API_KEY" "https://dadosb3.com/empresas/WEGE3/versoes?reenviados=true"
from dadosb3 import DadosB3  # pip install dadosb3
c = DadosB3()  # chave: variável DADOS_B3_API_KEY
r = c.versoes("WEGE3", reenviados=True)
print(sorted(r))
print(r["cd_cvm"])
Resposta real, cortada
{
  "cd_cvm": 5410,
  "ticker": "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 …",
  "documentos": [
    {
      "tipo": "DFP",
      "ano": 2018,
      "dt_refer": "2018-12-31",
      "n_versoes": 2,
      "versao_vigente": 2,
      "versoes": [
        "{…}",
        "{…}"
      ],
      "mudancas_total": 0,
      "mudancas": []
    },
    {
      "tipo": "ITR",
      "ano": 2017,
      "trimestre": 1,
      "dt_refer": "2017-03-31",
      "n_versoes": 2,
      "versao_vigente": 2,
      "versoes": [
        "{…}",
        "{…}"
      ],
      "mudancas_total": 0,
      "mudancas": []
    },
    "… +2"
  ],
  "total_documentos": 4,
  "reenviados": 4,
  "com_valores_de_versao_anterior": 4,
  "nota": "tipo DFP = demonstrações anuais; ITR = trimestrais. dt_receb = quando a CVM recebeu ESTA versão. valores: 'na_base' = é a versão publicada h…"
}

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"
    },
    "… +22"
  ],
  "capturadas": [],
  "versao_do_dado": "2026-11-09-ancora-do-fre|1795340958908438678",
  "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: aberta, sem chave, qualquer ticker, com limite por endereço (60 consultas por hora e 150 por dia, por endereço; assistentes de IA (ChatGPT, Claude, Perplexity e o conector MCP) têm conta própria: 2.000 por hora e 20.000 por dia, por endereço) · Cache: público, 5 min

curl -s -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["citacao"])
Resposta real, cortada
{
  "citacao": "Fonte: https://dadosb3.com/fiis/MXRF11 (Dados B3) — ficha do fundo; números recalculados do informe mensal da CVM e do COTAHIST da B3; versã…",
  "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",
    "segmento_nota": "declarado pelo administrador à CVM; o tipo real sai de `tipo_pela_carteira`"
  },
  "tipo_pela_carteira": {
    "competencia": "2026-09-01",
    "tipo": "papel",
    "pct_imoveis": 0.10917341443473316,
    "pct_papel": 0.7520493481183951,
    "pct_fof": 0.13877723744687184
  },
  "ultimo_informe": {
    "cotistas": 1570595,
    "pl": 5304823085.04,
    "competencia": "2026-09-01"
  },
  "pvp": [
    {
      "competencia": "2017-01-01",
      "data_entrega": "2017-02-16",
      "data_preco": "2017-02-16",
      "preco": 91.82,
      "vp_cota": 110.237662908153,
      "pvp": 0.8329276726095137,
      "flag": null
    },
    {
      "competencia": "2017-02-01",
      "data_entrega": "2017-03-14",
      "data_preco": "2017-03-14",
      "preco": 95.99,
      "vp_cota": 111.317070406021,
      "pvp": 0.8623115902159784,
      "flag": null
    },
    "… +115"
  ],
  "dy_12m": {
    "data_base": "2026-10-30",
    "data_preco": "2026-11-19",
    "preco": 8.5,
    "rendimento_12m": 1.19,
    "n_meses": 12,
    "dy_12m": 0.13999999999999999,
    "flag": null
  },
  "vacancia": [],
  "vacancia_nota": "não se aplica: pela carteira o fundo é de papel (não é dono de imóvel), e vacância só existe para fundo de tijolo",
  "proventos_recentes": [
    {
      "tipo": "RENDIMENTO",
      "valor": 0.095,
      "data_com": "2026-10-30",
      "data_pagamento": "2026-11-16",
      "relativo_a": "Outubro-2026/2026",
      "flag": null
    },
    {
      "tipo": "RENDIMENTO",
      "valor": 0.1,
      "data_com": "2026-09-30",
      "data_pagamento": "2026-10-15",
      "relativo_a": "Setembro-2026/2026",
      "flag": null
    },
    "… +11"
  ],
  "rentabilidade_por_janela": {
    "ate": "2026-11-19",
    "rendimentos_desde": "2025-10-31",
    "janelas": {
      "1m": "{…}",
      "3m": "{…}",
      "1a": "{…}",
      "2a": "{…}",
      "5a": "{…}",
      "10a": "{…}"
    },
    "nota": "total e real só nas janelas que os rendimentos cobrem; IFIX é retorno total, mesma janela e mesmo último dia do fundo"
  },
  "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",
    "administrador": null,
    "escriturador": "BANCO BNP PARIBAS BRASIL",
    "custodiante": "BANCO BNP PARIBAS BRASIL S/A",
    "auditor": "PRICEWATERHOUSECOOPERS AUDITORES INDEPENDENTES LTDA.",
    "id_fnet": 990,
    "cotas_data": "2008-12-03",
    "indice_nome": "Ibovespa",
    "pl_registro": 13821437957.95,
    "pl_registro_data": "2026-09-08",
    "administrador_b3": "BANCO BNP PARIBAS BRASIL S/A",
    "cotas_aprovadas_b3": 8627852083.0,
    "classe_registrada_em": "2025-04-23",
    "cotas_em_circulacao": 104400000,
    "cotas_em_circulacao_data": "2026-11-18"
  },
  "ultimo_informe": {
    "data": "2026-11-18",
    "cota": 164.985271,
    "pl": 17224462262.26,
    "cotistas": 122252,
    "captacao": 0.0,
    "resgate": 412463177.5,
    "data_entrega": "2026-11-19"
  },
  "ultimo_fechamento": {
    "data": "2026-11-19",
    "fechamento": 163.6
  },
  "ultimo_agio": {
    "data": "2026-11-18",
    "preco": 164.4,
    "cota": 164.985271,
    "agio": -0.0035474136354874952,
    "flag": null
  },
  "agio_30_pregoes": [
    {
      "data": "2026-10-06",
      "preco": 202.5,
      "cota": 202.616771,
      "agio": -0.0005763145835543382,
      "flag": null
    },
    {
      "data": "2026-10-07",
      "preco": 201.25,
      "cota": 201.109743,
      "agio": 0.0006974152415877288,
      "flag": null
    },
    "… +28"
  ],
  "taxa_efetiva_mensal": [
    {
      "competencia": "2026-10-01",
      "despesa": 1276636.0899999999,
      "pl_medio": 17895434686.48,
      "taxa_efetiva_aa": 0.0008560637586285615,
      "flag": null
    },
    {
      "competencia": "2026-09-01",
      "despesa": 1063632.17,
      "pl_medio": 14856645222.236668,
      "taxa_efetiva_aa": 0.000859116297728919,
      "flag": null
    },
    "… +15"
  ],
  "taxa_media_12m": 0.0008403194414071158,
  "carteira": {
    "competencia": "2026-09-01",
    "n_posicoes": 154,
    "pl": 15134227599.02,
    "maiores": [
      "{…}",
      "{…}",
      "… +8"
    ],
    "por_tipo": [
      [
        "Ações",
        0.7180983961423799
      ],
      [
        "Ações e outros TVM cedidos em empréstimo",
        0.22986573791550927
      ],
      "… +3"
    ],
    "sobreposicao_mesmo_indice": [
      "{…}",
      "{…}",
      "… +6"
    ]
  },
  "retornos_pela_cota": {
    "janelas": {
      "1m": "{…}",
      "3m": "{…}",
      "1a": "{…}",
      "2a": "{…}",
      "5a": "{…}",
      "10a": "{…}"
    },
    "ate": "2026-11-18",
    "mil_reais": {
      "1m": 817.1854635483554,
      "3m": 980.6399867686187,
      "1a": 1088.2466631395093
    }
  },
  "retornos_pelo_preco": {
    "janelas": {
      "1m": "{…}",
      "3m": "{…}",
      "1a": "{…}",
      "2a": "{…}",
      "5a": "{…}",
      "10a": "{…}"
    },
    "ate": "2026-11-19",
    "mil_reais": {
      "1m": 811.1458178392583,
      "3m": 971.9004336719538,
      "1a": 1076.6699572227708,
      "2a": 1298.2066338676402,
      "5a": 1665.3094462540716,
      "10a": 2724.3963363863445
    }
  },
  "pares": {
    "n": 16,
    "criterio": "indice",
    "agio": 0.00014258497707042572,
    "taxa": 0.002015268058260841
  },
  "liquidez_media_60": 1005970891.0865,
  "comparacao_indice": {
    "codigo": "IBOV",
    "rotulo": "Ibovespa",
    "ate_cota": "2026-11-18",
    "ate_preco": "2026-11-19",
    "janelas": {
      "2a": 0.2884861403451573,
      "5a": 0.62918692545032,
      "10a": 1.685462889118412,
      "1m": -0.1830707106445325,
      "3m": -0.020427671520366397,
      "1a": 0.08249558538761681
    },
    "pontas": {
      "2a": "preco",
      "5a": "preco",
      "10a": "preco",
      "1m": "cota",
      "3m": "cota",
      "1a": "cota"
    },
    "diferenca": {
      "1m": 0.00025617419288792576,
      "3m": 0.0010676582889850295,
      "1a": 0.0057510777518925416
    }
  },
  "rendimentos": [],
  "cobertura": {
    "precos": {
      "n": 4188,
      "de": "2010-01-04",
      "ate": "2026-11-19"
    },
    "informes": {
      "n": 430,
      "de": "2025-03-05",
      "ate": "2026-11-18"
    }
  },
  "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"
  }
}

Calculadoras /calculadoras/di-futuro.json

DI futuro (DI1): dias úteis até o vencimento, PU = 100000 / (1 + taxa)^(du/252), valor do ponto-base e o ganho ou a perda de quem está comprado ou vendido em taxa. Aberta, sem chave. Os números são os que você manda: não publicamos cotação, ajuste de DI nem CDI (dados da B3). Entrada inválida responde 400 com erro. Página: /calculadoras/di-futuro.

curl -s "https://dadosb3.com/calculadoras/di-futuro.json?taxa=13.5&vencimento=F28&taxa_nova=13.2&posicao=comprado"

Juros compostos /calculadoras/juros-compostos.json: valor inicial, aporte mensal, prazo e taxa ao ano, ou modo=selic (meta Selic de hoje, BCB) e modo=ipca&juro_real=6 (IPCA de 12 meses do IBGE + 6%). Valor final, juros, tabela ano a ano, valor real e IR da tabela regressiva (simplificado). Aberta, sem chave. Página: /calculadoras/juros-compostos.

curl -s "https://dadosb3.com/calculadoras/juros-compostos.json?inicial=1000&aporte=100&prazo=10&taxa=12"

Planilha /planilha/dados

A rota da função =DADOSB3() do Google Planilhas: até 300 códigos e 20 campos por chamada, uma linha por código na mesma ordem, e um motivo curto para cada valor que falta. data (AAAA-MM-DD), opcional, dá o balanço que já estava na CVM naquele dia. Exige chave (a grátis serve); cada chamada gasta 1 consulta da cota a cada 100 células (código × campo). Sem campo de preço. Página e lista de campos: /planilha.

curl -s -H "X-API-Key: SUA_CHAVE" "https://dadosb3.com/planilha/dados?codigos=PETR4,ITUB4,HGLG11&campo=roe,dy_12m"

Voltar para o início

This page in English

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-11-09-ancora-do-fre · página gerada em 2026-11-22 11:27 UTC. Se isto não bater com o /saude, você está lendo uma cópia em cache.