Dados B3 › Transparência
Transparência
Transparência — como você confere os números você mesmo
Versão do dado 2026-11-03-ponte-b3-codigo-de-fundo · página gerada em 2026-11-07 01:13 UTC. Se isto não bater com o /saude, você está lendo uma cópia em cache.
O que é conferido, antes de cada publicação — 1238 testes automáticos, coletados ao vivo
14 são invariantes de DADO (o número fecha?) e 131 são de produto — gate de acesso, navegação, idioma, conector de IA. Chamar os 1238 de 'invariantes' seria inflar: a divisão é conferível na própria lista. Não é uma seleção à mão dos melhores exemplos: cada teste abaixo foi achado agora, introspectando os arquivos de teste de verdade, do mesmo jeito que pytest --collect-only acharia. Agrupados pelo que protegem, não pelo arquivo onde moram.
Nível 1 — Integridade: o dado fecha? (10)
PS02— PS02 · petr4, PETR4.SA, BVMF:PETR4, PETR4F e " petr4 " voltam com `atendido: PETR4` e os mesmos números de PETR4; HGLG11.SA vira HGLG11; um código antigo com troca conhecida vira o atual (a regra de dados_b3/codigo_ativo.PS04— PS04 · Sem chave: 401 que diz onde pegar a grátis e onde guardar na planilha (Dados B3 › Minha chave), até para WEGE3, que é aberta nas outras rotas: o pedido vem de IPs do Google que todas as planilhas dividem.PS05— PS05 · Até 300 códigos e 20 campos por chamada (301 e 21 dão 400 que diz o teto); campo desconhecido dá 400 com o endereço da lista; data fora do formato, inexistente ou no futuro dá 400; nenhum desses 400 gasta cota.PS06— PS06 · O pedido gasta 1 consulta a cada 100 células (código não vazio × campo), mínimo 1: 30 ativos × 10 campos = 3 consultas na tabela `uso_api` (a mesma do painel e do teto).PS07— PS07 · O UrlFetch do Apps Script chega com "Google-Apps-Script" no User-Agent: a lista de rastreadores recusados não o pega (403 do middleware) e a rota responde 200; o robots.PS10— PS10 · /planilha (PT e EN): os três passos (modelo, Dados B3 › Minha chave, usar), TODOS os campos de `planilha.PS11— PS11 · Leitura estática de cliente/planilha/Codigo.PS12— PS12 · `logo` (unidade link, as três classes): ação = https://dadosb3.com/logos/{cd_cvm}.PS13— PS13 · A coleta das gestoras: a classe (CVM 175) aponta o fundo e o fundo traz o CNPJ do gestor; o site é o SITE_ADMIN do cadastro de administradores de carteira; o ícone sai só desse site (sem o Google s2 que as companhias usam como último recurso); ícone menor que 32 px ou que some no fundo claro (branco sobre transparente) fica de fora; domínio bloqueado não recebe nem um pedido; gestora retirada perde arquivo e origem; a origem grava a URL e a data; o mapa fundo -> gestora vai para fundos.PS14— PS14 · A página do FII e a do ETF mostram o logo da gestora no mesmo padrão da página da ação: <img class="logo-cia"> antes do <h1>, servido do nosso domínio, com o title dizendo de onde veio e quando (PT e EN); nenhuma imagem de terceiro na hora da visita.
Nível 2 — Semântica: a conta significa o que o cálculo supõe? (4)
PS01— PS01 · Um pedido com códigos de ação, FII e ETF e vários campos devolve uma linha por código, na MESMA ordem, com a célula vazia no lugar da vazia; e cada número é o que o site já publica: ROE e margem = o último ano de /empresas/{t}/indicadores; P/L e P/VP = o cartão de hoje (foto_diaria.PS03— PS03 · Nenhum valor nulo sem motivo (salvo a célula vazia): FII sem P/L diz "FII não tem P/L", ETF sem ROE "ETF não tem ROE", banco sem ROIC "não se aplica a banco", código inexistente "código não encontrado" (e o painel grava o código), índice "BDR e índice ficam fora da planilha", data antes da 1ª DFP "balanço ainda não saiu nesta data", DY com data "só o valor de hoje", campo de ativo pedido para SELIC e o contrário dizem qual campo usar.PS08— PS08 · Com data, o ano do balanço é o último exercício cuja DFP a CVM já tinha recebido naquele dia (a regra do /screener com as_of), o ROE é o desse ano na tabela `indicador`, e o P/L é o `pl_ttm` de `_pl_do_screener` (o trimestre entregue e já precificado até a data).PS09— PS09 · SELIC, IPCA, DOLAR e PIB, num banco montado no teste: sem data, o último período; com data, o último período até ela (diária pela data, mensal pelo mês, trimestral pelo trimestre); porcentagem vira fração (15 → 0,15), dólar fica em R$; o campo `data` devolve o período; tabela que ainda não existe ou série vazia dizem "série ainda não coletada"; data antes do primeiro ponto diz "sem valor até esta data".
Nível 3 — Econômico: o resultado é possível no mundo real? (0)
Outros testes do produto (0)
Gate comercial, navegação e o conector MCP — testam se o produto funciona, não se um número está certo, então não entram nos 3 níveis acima por natureza. Contados e listados do mesmo jeito:
Reconstrua você mesmo — margem líquida de 5 empresas, 4 setores
Não pedimos que você confie nos números. Eis a margem líquida de cinco empresas de quatro setores diferentes, cada uma reconstruída direto do balanço anual (DFP) na CVM — lucro líquido ÷ receita, batendo exatamente com o valor publicado. Para QUALQUER indicador, de qualquer empresa, a cadeia inteira até a linha do arquivo da CVM está em /linhagem:
| Empresa · setor | Lucro líq. (conta CVM) | Receita (conta CVM) | Margem =÷ |
|---|---|---|---|
| WEGE3 · indústria | R$ 6,78 bi DRE:3.11 | R$ 40,80 bi DRE:3.01 | 16,6% |
| VALE3 · mineração | R$ 11,81 bi DRE:3.11 | R$ 213,59 bi DRE:3.01 | 5,5% |
| PETR4 · petróleo | R$ 110,61 bi DRE:3.11 | R$ 497,55 bi DRE:3.01 | 22,2% |
| ITUB4 · banco | R$ 45,85 bi DRE:3.09 | R$ 387,12 bi DRE:3.01 | 11,8% |
| BBAS3 · banco | R$ 16,78 bi DRE:3.11 | R$ 319,46 bi DRE:3.01 | 5,3% |
Baixe a DFP de qualquer uma delas na CVM, pegue as contas de lucro e receita, divida — você chega no mesmo número. Bancos usam a receita de intermediação (o que faz sentido pra um banco), então a reconciliação é ciente do setor; os demais usam a receita de vendas. Valores do último exercício.
Por que às vezes divergimos de outro site (e não é erro)
Uma diferença entre dois sites geralmente não é um estar errado — é uma escolha de método. A nossa está aberta:
- Capital médio vs final: ROE e ROIC usam patrimônio/capital médio (ano atual + anterior ÷ 2), não o saldo final — então não são uma divisão ingênua de um ano só.
- Controladora vs consolidado: dizemos qual cada item usa.
- TTM vs anual: múltiplos trimestrais usam lucro dos últimos 12 meses.
- IFRS 16, goodwill, caixa, imposto excepcional: cada um tratado explicitamente e sinalizado quando distorce.
Os testes mordem? Sim — casos reais que a bateria já pegou
Um teste que nunca falha pode significar dado perfeito — ou teste fraco. Estes nasceram de erros reais que passaram, e hoje reprovam — só aparece o que existe de verdade na bateria coletada acima:
- I-B16 · o P/L = 0 dos bancos: a CVM reporta o nº de ações ora em unidades, ora em milhares (varia por empresa e por ano); o market cap saía 1000× menor e o P/L dava zero. O I-B16 (preço × ações recomputado) pegou — corrigimos 661 múltiplos anuais e 2.027 trimestrais.
- I-B24 · o lucro que sumia: a conta de lucro/PL varia por banco (Itaú 3.09, BB 3.11); se a busca por rótulo falha, o número some em silêncio e o ROE nasce errado. I-B24 faz esse buraco reprovar.
- H-B23 · o dividend yield de 800%: provento antigo na B3 vem com preço não ajustado por desdobramento; sem o H-B23 o yield sairia absurdo como se fosse real. A flag mantém o registro e avisa.
- I-B20 · o furo do COTAHIST 2023: no 1º deploy, o download de um ano de preços falhou em silêncio; a API subiu com ~50 mil preços a menos e a bateria passou, porque nenhum teste olhava cobertura. Criamos o I-B20 — ano sem preço agora reprova o build alto.
- I-B33 · Petróleo e Gás em −89,6% numa semana: o COTAHIST não é ajustado por desdobramento; um split 10:1 lia como −90% de retorno semanal e ficava no acumulado para sempre, sem nada reprovar (um filtro cego de amplitude nem resolveu — só trocou o erro de sinal). I-B33 (nenhuma semana de setor além de ±35%, a régua é a própria bolsa) faz o build parar.
- I-B31 · 364 de 865 semanas do índice setorial congeladas: ao estender a série até 2010, setor sem nenhuma empresa com market cap naquela semana virava fator 1,0 — uma linha reta que o retorno acumulado lia como 'mercado parado', e o retorno 'desde 2010' saía ficcional (+527%). I-B31 reprova qualquer semana repetida ao centavo.
- I-E05 · o P/L de 2010 da EMBRAER com preço de 2025: a busca de preço ponto-no-tempo caía para a frente sem teto quando o ticker atual não tinha preço na época do balanço (troca de código, mudança de classe); o múltiplo saía calculado com um preço 15 anos no futuro, em 22% das linhas anuais e trimestrais, em silêncio. A janela de 45 dias (e o I-E05) barra isso: sem pregão dentro do prazo, o múltiplo não é calculado.
- I-E04 · a AZUL com R$ 1,67 quadrilhão de valor de mercado: o balanço trazia 54,7 trilhões de ações da recuperação judicial, mas o preço usado já estava na base pós-grupamento de 1:150.000 — duas pontas em bases diferentes, market cap errado por ordens de grandeza. I-E04 (valor de mercado nunca maior que o PIB do Brasil) faz esse absurdo reprovar o build.
Até onde vai cada bloco de dado
Aqui não tem asterisco: esta é a cobertura ano a ano, contada agora. Indicadores (ROE, ROIC, margens, crescimento) saem só das demonstrações e cobrem a série inteira. Múltiplos (P/L, P/VP, EV/EBITDA) exigem preço e número de ações — e o nº de ações vem do Formulário de Referência, que quanto mais antigo menos companhia entregou em formato aproveitável. A diferença entre as duas colunas é limite da fonte, não buraco de ingestão. Se você procurar um P/L antigo e não achar, é porque ninguém tem — não porque escondemos. Os mesmos números em JSON: /cobertura.
| Ano | Empresas com indicadores | Empresas com múltiplos |
|---|---|---|
| 2025 | 440 | 290 |
| 2024 | 444 | 296 |
| 2023 | 442 | 298 |
| 2022 | 429 | 295 |
| 2021 | 423 | 296 |
| 2020 | 411 | 274 |
| 2019 | 372 | 166 |
| 2018 | 327 | 167 |
| 2017 | 318 | 165 |
| 2016 | 312 | 154 |
| 2015 | 304 | 144 |
| 2014 | 302 | 140 |
| 2013 | 293 | 131 |
| 2012 | 291 | 112 |
| 2011 | 284 | 98 |
| 2010 | 277 | 34 |
Cobertura ao vivo
456 empresas · 883,569 pontos de preço · 8,670 reapresentações registradas · última atualização 2026-11-06 01:27:27. Contagens completas ao vivo em /saude.
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-03-ponte-b3-codigo-de-fundo · página gerada em 2026-11-07 01:13 UTC. Se isto não bater com o /saude, você está lendo uma cópia em cache.