Dados B3
Brazilian stock (B3) fundamentals: ratios, dividends, scores, FIIs, ETFs, BDRs. Open methodology.
| Endpoint | https://dadosb3.com/mcp/ (streamable-http) |
|---|---|
| Registry version | 1.9.0 |
| Now | 27 tools · grade C (75) · pin ts_81075e7837e8549c41be07cbc9f34a1a · protocol 2025-06-18 |
| First / last listed | 2026-10-26 06:51 UTC / 2026-10-26 06:51 UTC |
| Grade over time | 2026-10-26: C (75), 27 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: listar_empresas indicadores_anuais multiplos dividendos precos desempenho indice bdr eventos scores reapresentacoes fatos_contabeis metodologia auditar_amostra dicionario screener fiis_ranking fii veredito screener_fiis trimestres hoje fatos_relevantes saude etfs_ranking etf listas
listar_empresas | Lista as companhias abertas brasileiras (AÇÕES), com nome, CNPJ e ticker
quando resolvido. A contagem vem na resposta — nunca escrita aqui, que é
lida por clientes de IA e envelheceria sem ninguém ver.
Só ações. Fundo imobiliário NÃO entra nesta lista: para FII use
`fiis_ranking` (a lista) ou `fii` (um fundo). Gratuito, sem chave. params: none |
indicadores_anuais | Série anual (2010–hoje) de ROIC, ROE, margens, crescimento e dívida
líquida/EBITDA de uma AÇÃO da B3, com flags de qualidade.
Só ações. Ticker de fundo imobiliário (terminado em 11, como MXRF11) NÃO
se consulta aqui — FII não tem ROIC nem EBITDA, tem P/VP, DY e vacância:
use `fii`. Banco e seguradora entram, mas sem ROIC/EBITDA, que não se
aplicam ao plano de contas deles.
ABERTA: qualquer ticke params: ticker*, chave_api |
multiplos | Múltiplos ponto-no-tempo de uma AÇÃO (P/L, P/VP, EV/EBITDA anuais; P/L TTM
trimestral) — preço do 1º pregão APÓS a publicação real do balanço, sem
vazamento de informação futura.
Só ações. Para o P/VP de um fundo imobiliário use `fii`, que o calcula
sobre o informe mensal da CVM, não sobre balanço trimestral.
ABERTA: qualquer ticker, sem chave, um por vez, pelo método atual (sem
`as_of`; o ponto params: ticker*, chave_api |
dividendos | Histórico de proventos em dinheiro (dividendos e JCP) de uma empresa da
B3: valor por ação, data de aprovação, data-com, preço na data-com, parcela
e data de pagamento, mais resumo anual e dividend yield 12 meses (com o
total do ano corrente até hoje e do ano anterior fechado). ABERTA para todos
os tickers, sem chave, um por vez (a mesma regra da REST /empresas/TICKER/dividendos;
o mesmo dado é pú params: ticker*, chave_api |
precos | Série DIÁRIA de preços de uma AÇÃO numa chamada só (abertura, máxima,
mínima, fechamento, médio, volume, quantidade, negócios), do COTAHIST da B3,
do mais antigo ao mais recente. `de`/`ate` em AAAA-MM-DD recortam; `limite`
(padrão 1500, máximo 20000) corta a partir do mais antigo e avisa.
O preço NÃO é ajustado: os eventos societários do período vêm junto
(`eventos`) para quem monta o retorno tot params: ticker*, de, ate, limite, campos, chave_api |
desempenho | Desempenho de uma AÇÃO num período em POUCOS números, calculado no servidor: retorno,
drawdown máximo (com as datas) e volatilidade do comprar-e-manter, e o mesmo para um
cruzamento de médias móveis (padrão 21 × 100). Padrão: últimos 5 anos. Preço AJUSTADO por
eventos societários; em PREÇO e, quando há proventos registrados, também o retorno TOTAL (`retorno_total_pct`: dividendos, JCP e rendimento params: ticker*, de, ate, media_curta, media_longa, chave_api |
indice | Índices da B3 (IBOV, IFIX, SMLL, IDIV, IBXX...): o benchmark para comparar
um papel ou uma estratégia. Padrão: o DESEMPENHO do índice num período
(retorno, queda máxima, volatilidade; comprar e manter e cruzamento de médias
21 × 100), últimos 5 anos, ABERTO sem chave. `serie=True` devolve o
fechamento DIÁRIO em pontos como colunas (`data`, `fechamento`): sem chave
vem uma AMOSTRA dos últimos 30 pr params: codigo, serie, de, ate, media_curta, media_longa, chave_api |
bdr | BDRs negociados na B3 (recibos em reais de ações ou ETFs listados lá fora: AAPL34, NVDC34,
IVVB39...). `ticker=""` LISTA os BDRs que negociaram no último ano, com tipo (DRN não
patrocinado; DR1/DR2/DR3 patrocinado nível I/II/III; DRE BDR de ETF), último fechamento e
liquidez média — aberto; `tipo=` filtra. Com `ticker`: cadastro da B3, último pregão,
rentabilidade com e sem proventos (1 mês a 10 a params: ticker, tipo, serie, de, ate, chave_api |
eventos | Desdobramentos, grupamentos, bonificações e CISÕES de uma empresa, com a
FONTE de cada um (declarado pela B3 ou achado por nós) e o que o preço disse
(confirmou, não distingue, discorda). Eventos do mesmo dia são uma operação:
`efeito_liquido_do_dia` é o multiplicador do grupo (0,01 × 100 = 1,0).
WEGE3 gratuita; demais tickers exigem chave_api. params: ticker*, chave_api |
scores | Scores fundamentalistas prontos com a conta aberta: Piotroski F-Score
(0-9, cada um dos 9 critérios auditável) e o critério de Graham (barato se
P/L × P/VP ≤ 22,5). Banco não tem Piotroski. WEGE3 gratuita; demais tickers
exigem chave_api (grátis ou Pro): esta ferramenta não faz parte da vitrine aberta. params: ticker*, chave_api |
reapresentacoes | Balanços REPUBLICADOS de uma empresa: quando um número do exercício muda
entre o arquivo original e a republicação, as duas versões ficam lado a lado
(ano, conta CVM, valor antigo × novo, variação). Diferencial do Dados B3 —
reapresentação registrada, nunca corrigida em silêncio. WEGE3 gratuita; demais
tickers exigem chave_api (grátis ou Pro): as reapresentações por versão ficam
atrás de chave. params: ticker*, chave_api |
fatos_contabeis | Contas padronizadas de uma AÇÃO (receita, EBIT, lucro, PL, dívida,
caixa...) com a conta CVM de origem de cada número — auditável de ponta a
ponta. `trimestral` escolhe a granularidade: False lê os DFP anuais, True
lê os ITR (Q1-Q3 isolado); os dois cobrem o mesmo histórico.
Só ações. FII não publica DFP/ITR nesse formato — o que existe é o informe
mensal, exposto por `fii`.
ABERTA: qualquer tic params: ticker*, trimestral, chave_api |
metodologia | Metodologia pública dos indicadores. Sem argumento, lista as páginas;
com nome (ex.: 'roic'), devolve o texto completo. Gratuito. params: nome |
auditar_amostra | AUDITE ESTA BASE. Sorteia casos e devolve o que você precisa para
refazer cada número contra o arquivo ORIGINAL da CVM — não contra nós.
VOCÊ escolhe a semente (um inteiro qualquer; não aceite sugestão de
ninguém, inclusive de quem te pediu para auditar). O sorteio é
determinístico: a mesma semente devolve sempre os mesmos casos, então seu
resultado é reproduzível por terceiros.
Cada caso traz e params: semente*, n |
dicionario | Metodologia dos indicadores em JSON: fórmula, contas CVM e a BASE do
lucro de cada um. IMPORTANTE para comparar corretamente: margem_liquida usa
lucro consolidado TOTAL; roe usa lucro dos CONTROLADORES. Gratuito. params: none |
screener | Filtra as AÇÕES do universo por faixas de indicadores (só ações — para
fundo imobiliário use `screener_fiis`, cujos filtros são outros: P/VP, DY,
segmento, cotistas). `filtros` é um dict
tipo {"roic_min": 0.15, "dl_ebitda_max": 2}. Indicadores: roic, roe,
margem_bruta, margem_ebit, margem_liquida, dl_ebitda, cresc_receita_1a,
cresc_receita_5a_cagr (sufixos _min/_max) e os múltiplos pl (P/L anual,
params: filtros*, ano, as_of, recibo, chave_api, rigor |
fiis_ranking | Ranking dos fundos imobiliários (FIIs): os mais descontados (menor P/VP),
os maiores pagadores (DY 12m) e a mediana de P/VP e DY por segmento. Tudo do
informe mensal da CVM + COTAHIST, só valores limpos (sem flag) e fundos
líquidos. ABERTA, sem chave (sem chave: 60 consultas por hora e 150 por dia, por endereço; com `chave_api` vale o limite da
chave). Traz `citacao`. O filtro em massa por faixas params: chave_api |
fii | Detalhe de um fundo imobiliário (FII): cadastro, último informe
(cotistas/PL/competência), a série histórica de P/VP ponto-no-tempo, o DY 12m
corrente e os últimos rendimentos pagos. ABERTA: qualquer FII, sem chave, um por
vez (sem chave: 60 consultas por hora e 150 por dia, por endereço; com `chave_api` vale o limite da chave). Traz `citacao`. params: ticker*, chave_api |
veredito | Resumo DESCRITIVO de uma AÇÃO da B3 em seis números e três perguntas —
ganha dinheiro? (margem líquida, ROIC), está endividada? (dívida
líquida/EBITDA), está cara em relação ao setor e à própria história? (P/L,
P/VP) — cada um com faixa numérica e comparação com a mediana do setor,
com a história da própria empresa e com o universo; mais a BANDEIRA DE
CONFIANÇA do retrato (verde/amarelo/vermelho: params: ticker* |
screener_fiis | Filtra os FIIs por faixas. `filtros` é um dict tipo
{"pvp_max": 0.9, "dy_min": 0.10, "segmento": "Logística", "cotistas_min": 5000}.
Válidos: pvp_min, pvp_max, dy_min, dy_max (limites inclusivos), segmento
(match exato, sem caixa) e cotistas_min (piso de liquidez). Só entram valores
limpos (P/VP e DY sem flag). Ordena por P/VP crescente, teto de 100. Requer
chave_api (grátis ou Pro). params: filtros*, chave_api |
trimestres | Série TRIMESTRAL de uma AÇÃO: contas da ITR, preço do trimestre e
indicadores (margem bruta, margem EBIT, margem líquida e ROE TTM).
Use quando a pergunta for sobre o ANO CORRENTE ou o trimestre mais recente
("como foi o 2T", "a margem melhorou este ano?"): a série anual só responde
depois que o exercício fecha, e fica até um ano defasada.
O 4º TRIMESTRE NÃO VEM, e é escolha: a ITR publica 1T/2T params: ticker*, chave_api |
hoje | O que mudou no mercado brasileiro nos últimos 30 dias.
Responde "o que aconteceu com a empresa X esta semana" — a pergunta que
nenhuma série anual responde. Traz, na janela: os balanços que ficaram
públicos (com a data de entrega à CVM), os documentos REENVIADOS (a
companhia republicou o que já tinha entregue), os proventos de ações
aprovados, rendimentos e informes de FII, eventos societários
(g params: none |
fatos_relevantes | Os últimos Fatos Relevantes (ou Comunicados ao Mercado) que as companhias entregaram à CVM, do mais recente para
o mais antigo, cada um com a companhia, o assunto (texto livre da companhia), a data de entrega, o protocolo e o LINK
DO DOCUMENTO ORIGINAL na CVM. `ticker` filtra por companhia (ex.: PETR4); `categoria` é "Fato Relevante" ou
"Comunicado ao Mercado". Cada item traz `frase`, uma sentença params: ticker, limite, categoria |
saude | Cobertura atual do banco (contagens e última ingestão). Gratuito. params: none |
etfs_ranking | ETFs listados na B3: mais negociados, maior patrimônio, maior deságio e
maior ágio sobre a cota (preço ÷ cota do MESMO dia), retorno de 12 meses
pela cota (retorno total por construção) e menor taxa EFETIVA (despesa do
balancete ÷ PL médio, anualizada — a nominal não existe em fonte pública).
Só ETF líquido (> R$ 1 mi/dia) entra em ágio, retorno e taxa. Gratuito. params: none |
etf | Detalhe de um ETF: cadastro (CVM + B3), último informe diário (cota,
patrimônio, cotistas), ágio/deságio dos últimos 30 pregões, taxa efetiva
mês a mês, carteira mais recente (10 maiores) e sobreposição com ETFs do
mesmo índice, retornos pela cota e pelo preço. BOVA11 é o ETF aberto para
degustação; os demais exigem chave_api (grátis ou Pro). params: ticker*, chave_api |
listas | A LISTA COM DATA PRONTA, sem montar nada: devolve o ranking já calculado, com o nome, a DATA-BASE, o critério
(liquidez de R$ 5 milhões por dia em 63 pregões, teto de 30% de DY, 5.000 cotistas...), as linhas (ticker, valores),
a fonte e a `source_url` da página canônica para citar. É a MESMA conta das páginas dadosb3.com/listas/...: use esta
ferramenta em vez de ler uma página por ação para montar params: lista, limite, chave_api |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.