screener
Screen B3 stocks by financial indicator ranges (ROIC, ROE, debt-to-EBITDA, Piotroski) with min/max filters. Use without filters to get the list of valid ratios.
Instructions
Filtra o universo inteiro da B3 por faixas de indicadores.
Parâmetros:
filtros — dicionário de faixas. Cada chave é o nome de um indicador
seguido de `_min` ou `_max`, e o valor é o número da faixa. Frações,
não porcentagens: ROIC de 15% é 0.15.
Exemplo: {"roic_min": 0.15, "dl_ebitda_max": 2}
Indicadores aceitos: roic, roe, margem_bruta, margem_ebit,
margem_liquida, dl_ebitda, cresc_receita_1a, cresc_receita_5a_cagr,
piotroski.
Chame SEM filtros para receber o cardápio: a lista de indicadores
válidos e exemplos de uso.
ano — exercício alvo. 0 (padrão) usa, para cada empresa, o último ano
com dado disponível — que não é o mesmo ano para todas.
limite — máximo de empresas na resposta. Padrão 100.
chave_api — obrigatória aqui, mesmo para WEGE3, porque a consulta
percorre todo o universo. Deixe "" para usar DADOS_B3_API_KEY.
Só entram valores SEM flag, isto é, números que passaram limpos pela
bateria de invariantes. Um indicador marcado como suspeito não é filtrado
silenciosamente: ele simplesmente não participa. Nome de indicador
desconhecido é recusado com erro, nunca ignorado.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ano | No | ||
| limite | No | ||
| filtros | No | ||
| chave_api | No |