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.
Tesouro Direto rates (National Treasury)JSON
Rate and price of each bond on the latest base date, or the daily series of one bond, as JSON or CSV, with source, licence and a citation line.
Electricity tariffs per distributor (ANEEL)JSON
The latest residential tariff of each distributor, or every period of one, as JSON or CSV, with source, licence and a citation line.
Telecom accesses per operator (Anatel)JSON
The ranking of mobile and fixed broadband operators, or the monthly series of one, as JSON or CSV, with source, licence, attribution and a citation line.
Investment funds: unit value, net assets and inflows (CVM)JSON
The largest funds by net assets and the largest net inflows and outflows of the month, the 13-month series of one fund or a name search, as JSON or CSV, with source, licence and a citation line.
Oil and gas production per operator and field (ANP)JSON
The operators or the fields of the latest month, or the monthly series of one operator or field, as JSON or CSV, with source, licence and a citation line.
Macro series (BCB and IBGE)JSON
PTAX dollar and euro, Selic, IPCA, GDP and unemployment as JSON or CSV, with source, licence and a citation line in every response.
Focus Report (BCB)JSON
Weekly medians for IPCA, Selic, the exchange rate and GDP since 2001 as JSON or CSV, with source, licence and a citation line.
Google Sheets spreadsheet
The =DADOSB3() function brings ROE, P/E, dividend yield and next payout into your spreadsheet, the whole column at once.
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, the routes marked “any ticker” answer one ticker at a time with a limit per address (60 calls per hour and 150 per day, per address; AI assistants (ChatGPT, Claude, Perplexity and the MCP connector) have their own count: 2,000 per hour and 20,000 per day, per address; past it, 429 with Retry-After), and the rest reply 401 with the link to create a key. A past date (as_of), filing versions, the whole database (/dump, CSV) and the mass screener need a key. 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 at each database rebuild. 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.9.3, 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,
"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…"
}Indicators /empresas/{T}/indicadores
Indicators by year, with the CVM account each one comes from and the caveat on each figure.
Access: open, no key, any ticker, with a per-address limit (60 calls per hour and 150 per day, per address; AI assistants (ChatGPT, Claude, Perplexity and the MCP connector) have their own count: 2,000 per hour and 20,000 per day, per address) · Cache: no public cache
curl -s "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."
},
"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 …"
}Multiples /empresas/{T}/multiplos
P/E, P/B, EV/EBITDA and FCF yield at the price of the day the filing became public. With the ticker of another class of the same company (PETR3, the preferred, the unit), P/E and P/B use that class's close on the same trading day (`classe_consultada` says which class and which price). Open; the `as_of` parameter (a past date) needs a key.
Access: open, no key, any ticker, with a per-address limit (60 calls per hour and 150 per day, per address; AI assistants (ChatGPT, Claude, Perplexity and the MCP connector) have their own count: 2,000 per hour and 20,000 per day, per address) · Cache: no public cache
curl -s "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",
"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…"
}Dividends /empresas/{T}/dividendos
Each distribution with record date, amount and payment, the yearly summary and the 12-month yield.
Access: open, no key, any ticker, with a per-address limit (60 calls per hour and 150 per day, per address; AI assistants (ChatGPT, Claude, Perplexity and the MCP connector) have their own count: 2,000 per hour and 20,000 per day, per address) · Cache: no public cache
curl -s "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": 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, 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 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…"
}
}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/d15a7db6778ea3b6.json"from dadosb3 import DadosB3 # pip install dadosb3
c = DadosB3() # key: DADOS_B3_API_KEY variable
r = c.recibo("d15a7db6778ea3b6")
print(sorted(r))
print(r["id"])Real response, cut
{
"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."
}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 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 …"
}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` and `classe=etfs` give the REIT and ETF watchers.
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-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"
}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…"
}Filing versions /empresas/{T}/versoes
Each annual and quarterly filing with every version the CVM received, the date of each and, where we kept the values, the accounts that changed (before and after). On /fatos, `as_of=YYYY-MM-DD` returns the statements as they stood on that date.
Access: key, except for BOVA11, MXRF11, WEGE3 · package ≥ 0.3.0 · Cache: no public cache
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() # key: DADOS_B3_API_KEY variable
r = c.versoes("WEGE3", reenviados=True)
print(sorted(r))
print(r["cd_cvm"])Real response, cut
{
"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…"
}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"
},
"… +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"
}REIT (FII) /fiis/{T}
Registry, latest report, P/B, 12-month yield, vacancy and recent distributions.
Access: open, no key, any ticker, with a per-address limit (60 calls per hour and 150 per day, per address; AI assistants (ChatGPT, Claude, Perplexity and the MCP connector) have their own count: 2,000 per hour and 20,000 per day, per address) · Cache: public, 5 min
curl -s -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["citacao"])Real response, cut
{
"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}
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",
"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"
}
}Calculators /calculadoras/di-futuro.json
DI future (DI1): business days to maturity, PU = 100000 / (1 + rate)^(du/252), basis point value and the gain or loss for a position long or short the rate. Open, no key. The figures are the ones you send: we publish no DI quote, settlement rate or CDI (B3 data). Invalid input answers 400 with erro. Page: /calculadoras/di-futuro.
curl -s "https://dadosb3.com/calculadoras/di-futuro.json?taxa=13.5&vencimento=F28&taxa_nova=13.2&posicao=comprado"Compound interest /calculadoras/juros-compostos.json: initial amount, monthly contribution, term and annual rate, or modo=selic (today's Selic target, BCB) and modo=ipca&juro_real=6 (12-month IPCA from IBGE + 6%). Final value, interest, year-by-year table, real value and simplified regressive income tax. Open, no key. Page: /calculadoras/juros-compostos.
curl -s "https://dadosb3.com/calculadoras/juros-compostos.json?inicial=1000&aporte=100&prazo=10&taxa=12"Spreadsheet /planilha/dados
The route behind the =DADOSB3() Google Sheets function: up to 300 tickers and 20 fields per call, one row per ticker in the same order, and a short reason for every missing value. Optional data (YYYY-MM-DD) gives the statement already filed on that day. Requires a key (the free one works); each call uses 1 call of the quota per 100 cells (ticker × field). No price field. Page and field list: /planilha.
curl -s -H "X-API-Key: SUA_CHAVE" "https://dadosb3.com/planilha/dados?codigos=PETR4,ITUB4,HGLG11&campo=roe,dy_12m"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-11-09-ancora-do-fre · page generated 2026-11-22 11:19 UTC. If this does not match /saude, you are reading a cached copy.