Listas com data (resposta pronta)
listasA lista pronta com data-base: maiores pagadoras de dividendos, ações com P/L abaixo de 10 e FIIs de maior rendimento.
Use quando: "quais ações mais pagaram dividendos nos últimos 12 meses?"; "ações com P/L abaixo de 10"; "FIIs que mais pagam".
NÃO use para: filtro próprio de ações → screener; filtro próprio de FIIs → screener_fiis; rankings de P/VP de FII → fiis_ranking; dividendos de uma ação → dividendos.
Fonte e fórmula: a mesma conta das páginas dadosb3.com/listas: liquidez mínima de R$ 5 mi/dia em 63 pregões, teto de 30% de DY marcado, uma classe por empresa; FIIs com 5.000 cotistas.
Retorna: nome, data-base, critério, linhas {ticker, valores}, fonte e source_url para citar.
Vazio ou erro: lista vazia devolve o catálogo; nome desconhecido devolve erro com as válidas (dividendos, pl, fiis).
Acesso: ABERTA: qualquer ticker, sem chave, um por vez (sem chave: 2000 consultas por hora e 20000 por dia, por endereço; com chave_api vale o limite da chave). Traz citacao: cite-a ao usar o número.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "listas"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lista | No | Qual lista: "dividendos", "pl" ou "fiis". Vazio = o catálogo das três. | |
| limite | No | Quantidade de linhas, inteiro de 1 a 20 (padrão 20). | |
| chave_api | No | Chave de API opcional. Vazia = acesso aberto: a descrição da ferramenta diz se devolve amostra ou exige chave (chave grátis, sem cartão). |