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
26 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? (21)
I-X05— Toda cotação é positiva e dentro de faixa possível.I-X06— Nenhum salto diário acima de 15%.I-X07— O retorno em US$ tem de ser o retorno em R$ menos a variação do câmbio — a identidade que o próprio cálculo afirma.I-X10— O `n` de cada defasagem é EXATAMENTE o tamanho da sobreposição entre o fluxo e o retorno deslocado — nem um par a mais.I-X11— Nenhum `n` pode passar do comprimento da série mais curta.I-X12— A permutação preserva o tamanho de cada grupo E embaralha blocos que são contíguos NO TEMPO.I-X13— Ataca o I-X12 com três implementações defeituosas e exige que ele reprove duas e aprove uma.I-X14— Uma janela do SGS que falha é tentada de novo antes de virar buraco, e cada falha deixa o MOTIVO no log.I-X01— `líquido = ingresso − saída` em TODOS os meses.I-X04— Competência é sempre 'AAAA-MM'.I-X15— A resposta GRAVADA do SGS (séries 1, 21619 e 1178, 27 a 29/10/2026) vira [(AAAA-MM-DD, número)] em ordem, com os valores publicados: dólar venda 5,3744 e euro venda 6,0000 em 29/10 (o boletim de fechamento da PTAX daquele dia), Selic efetiva 13,65. Texto que não é número ('.I-X16— A resposta GRAVADA do SIDRA tem o cabeçalho como PRIMEIRA linha; ele não vira dado.I-X17— Falha ISOLADA: com o SGS respondendo só a série 1 (gravada), o IBGE fora do ar e a série 10813 com vírgula trocada (53738 em vez de 5,3738), a coleta grava a série 1, NÃO grava a 10813 (fora da faixa: o lote inteiro é recusado), não apaga o que as outras já tinham, não levanta, e deixa em meta['macro_coleta'] o erro de cada série que falhou.I-X18— Coleta COMPLETA: as séries do SGS são pedidas desde 1999 em janelas de no máximo 9 anos, contíguas e sem sobreposição, até hoje; o SIDRA pede `p/all`.I-X19— Na rodada da NOITE (`_proventos_da_noite`), a coleta macro que levanta exceção vira `erro_macro` e as etapas seguintes rodam (comunicados).I-X20— `/macro/series/{codigo}` devolve as linhas do grupo, uma por período e uma coluna por série, com `fonte` (órgão, códigos, LICENÇA: ODbL para o BCB, citação da fonte para o IBGE), `citacao` (página, versão do dado, último dado) e a cobertura; `de`/`ate` recortam; `formato=csv` devolve o cabeçalho e as mesmas linhas.I-X21— No modo comercial, sem chave: dólar, euro e Selic devolvem 200 com os ÚLTIMOS 30 pontos e `aviso` (a regra de /indices/{codigo}/precos; o CSV também vira amostra em JSON); IPCA, PIB e desemprego saem INTEIROS, abertos (a regra do /fluxo-estrangeiro).I-X22— Entre o deploy e a primeira coleta (base sem `macro_serie`): `/macro/series/{codigo}` responde 503 com Retry-After (I-N06), o catálogo `/macro/series` responde 200 com a cobertura nula, a página responde 200 com o aviso de série em coleta, `noindex`, SEM número e SEM link para o JSON que daria 503, e o /saude não cai.I-X23— Cada página (/macro/dolar, /euro, /selic, /ipca, /pib, /desemprego), em PT e EN, abre 200 com o último número da base e a data no formato do idioma, a fonte com a licença, o link para o JSON e o CSV, a frase de citação no idioma da página, canonical, JSON-LD Dataset com a licença da FONTE, e o desemprego diz o trimestre móvel por extenso.I-X24— O bloco `macro` do /saude traz, por série, o último período, os dias desde o FIM dele e o limite da periodicidade (7 dias nas diárias, 50 no IPCA, 70 no desemprego, 170 no PIB) e o resultado da última coleta.I-X25— O hub /macro (PT e EN) tem um cartão para cada uma das seis páginas e o catálogo; o sitemap anuncia só as páginas cuja série a base TEM (vazia é noindex e fica fora), com o fim do último período como lastmod; o llms.
Nível 2 — Semântica: a conta significa o que o cálculo supõe? (3)
I-X02— Ingresso e saída são fluxos BRUTOS: não existem negativos.I-X03— A série não pula mês entre o primeiro e o último.I-X26— Invariantes na base real (pula se a base ainda não tem `macro_serie`): na PTAX do dólar e do euro a venda nunca é menor que a compra no mesmo dia; todo valor está na faixa plausível da série; o IPCA de 12 meses é o produto dos 12 meses publicados com tolerância de 0,02 p.
Nível 3 — Econômico: o resultado é possível no mundo real? (2)
I-X08— Toda correlação publicada carrega o próprio n, e n nunca é pequeno o bastante para ser ruído.I-X09— A correlação do MESMO mês é a maior de todas.
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.