--- title: "Filtrar fundos listados por indicadores" method: GET path: "/api/v2/funds/screener" tags: ["Fundos"] --- # Filtrar fundos listados por indicadores `GET /api/v2/funds/screener` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/funds/screener` - Auth: HTTP bearer Filtra e ordena os fundos negociados na B3 (FIIs, Fiagros, FI-Infra, ETFs, FIDCs e FIPs) por preço, rendimentos, P/VP, liquidez, patrimônio e cotistas. Uma chamada percorre todos os fundos. `assetType` escolhe o tipo de fundo. Para FIIs, `segmentType` separa tijolo, papel, fundos de fundos e híbridos, e `segment` usa o segmento do cadastro da CVM. Para ETFs, `etfCategory` separa renda fixa, renda variável, cripto e imobiliário. Cada indicador aceita `{chave}Min` e `{chave}Max`. Os limites são inclusivos e usam a mesma unidade da resposta: 10% é `0.1`. Um filtro remove os fundos sem o dado. Na ordenação, os nulos ficam no fim. Exemplos: - FIIs de papel com dividend yield de pelo menos 12% e P/VP até 0,95: `?assetType=fii&segmentType=papel÷ndYieldMin=0.12&priceToNavMax=0.95&sortBy=dividendYield` - ETFs de renda fixa pela menor taxa: `?assetType=etf&etfCategory=fixed-income&sortBy=totalFeePercent&sortOrder=asc` `dividendYield` soma só os rendimentos dos últimos 12 meses pela data-com, sem amortizações, e divide pelo último preço. `priceToNav` usa o último preço e o valor patrimonial por cota do último informe. `averageDailyTradedValue` divide o valor negociado nos últimos 30 dias pelos pregões do período. Plano Pro. | Indicador | Chave | Unidade | | --- | --- | --- | | Preço | `lastPrice` | reais | | Variação no dia | `changePercent` | porcentagem (2.81 = 2,81%) | | Volume | `volume` | quantidade | | Liquidez diária | `averageDailyTradedValue` | reais | | Valor de mercado | `marketCap` | reais | | Dividend yield 12m | `dividendYield` | fração (0.06 = 6%) | | Último rendimento | `lastDividend` | reais | | Yield do último rendimento | `lastDividendYield` | fração (0.06 = 6%) | | Meses com rendimento | `incomeMonths12m` | quantidade | | Valor patrimonial/cota | `navPerShare` | reais | | P/VP | `priceToNav` | múltiplo | | Patrimônio líquido | `equity` | reais | | Cotistas | `totalInvestors` | quantidade | | Variação em 12 meses | `priceChange12m` | fração (0.06 = 6%) | | Taxa total | `totalFeePercent` | porcentagem (2.81 = 2,81%) | ## Query parameters - `search` string: Parte do ticker ou do nome do fundo. - `assetType` 'fii' | 'fiagro' | 'fiinfra' | 'etf' | 'fidc' | 'fip' | 'fif': Tipo do fundo: fii, fiagro, fiinfra, etf, fidc, fip ou fif. Sem ele, todos os fundos listados. - `segmentType` 'tijolo' | 'papel' | 'hibrido' | 'fof': Tipo do FII pelo último informe: tijolo (imóveis), papel (CRI, LCI e títulos), fof (cotas de outros FIIs) ou hibrido. - `segment` string: Segmento do FII no cadastro da CVM, como Logística, Shoppings, Escritórios ou Títulos e Val. Mob. Nome exato, sem diferença de maiúsculas. - `etfCategory` 'fixed-income' | 'equity' | 'crypto' | 'real-estate': Categoria do ETF pela lista da bolsa: fixed-income, equity, crypto ou real-estate. - `sortBy` 'symbol' | 'name' | 'lastPrice' | 'changePercent' | 'volume' | 'averageDailyTradedValue' | 'marketCap' | 'dividendYield' | 'lastDividend' | 'lastDividendYield' | 'incomeMonths12m' | 'navPerShare' | 'priceToNav' | 'equity' | 'totalInvestors' | 'priceChange12m' | 'totalFeePercent': Campo de ordenação: uma chave de métrica, `symbol` ou `name`. Padrão: `averageDailyTradedValue`. Valores nulos ficam no fim. - `sortOrder` 'asc' | 'desc': Ordem. Padrão: `desc`. - `page` integer: Número da página. Começa em 1. - `limit` integer: Itens por página. Máximo: 200. - `lastPriceMin` number: Preço: valor mínimo, inclusive. Unidade: reais. - `lastPriceMax` number: Preço: valor máximo, inclusive. Unidade: reais. - `changePercentMin` number: Variação no dia: valor mínimo, inclusive. Unidade: porcentagem (2.81 = 2,81%). - `changePercentMax` number: Variação no dia: valor máximo, inclusive. Unidade: porcentagem (2.81 = 2,81%). - `volumeMin` number: Volume: valor mínimo, inclusive. Unidade: quantidade. - `volumeMax` number: Volume: valor máximo, inclusive. Unidade: quantidade. - `averageDailyTradedValueMin` number: Liquidez diária: valor mínimo, inclusive. Unidade: reais. - `averageDailyTradedValueMax` number: Liquidez diária: valor máximo, inclusive. Unidade: reais. - `marketCapMin` number: Valor de mercado: valor mínimo, inclusive. Unidade: reais. - `marketCapMax` number: Valor de mercado: valor máximo, inclusive. Unidade: reais. - `dividendYieldMin` number: Dividend yield 12m: valor mínimo, inclusive. Unidade: fração (0.06 = 6%). - `dividendYieldMax` number: Dividend yield 12m: valor máximo, inclusive. Unidade: fração (0.06 = 6%). - `lastDividendMin` number: Último rendimento: valor mínimo, inclusive. Unidade: reais. - `lastDividendMax` number: Último rendimento: valor máximo, inclusive. Unidade: reais. - `lastDividendYieldMin` number: Yield do último rendimento: valor mínimo, inclusive. Unidade: fração (0.06 = 6%). - `lastDividendYieldMax` number: Yield do último rendimento: valor máximo, inclusive. Unidade: fração (0.06 = 6%). - `incomeMonths12mMin` number: Meses com rendimento: valor mínimo, inclusive. Unidade: quantidade. - `incomeMonths12mMax` number: Meses com rendimento: valor máximo, inclusive. Unidade: quantidade. - `navPerShareMin` number: Valor patrimonial/cota: valor mínimo, inclusive. Unidade: reais. - `navPerShareMax` number: Valor patrimonial/cota: valor máximo, inclusive. Unidade: reais. - `priceToNavMin` number: P/VP: valor mínimo, inclusive. Unidade: múltiplo. - `priceToNavMax` number: P/VP: valor máximo, inclusive. Unidade: múltiplo. - `equityMin` number: Patrimônio líquido: valor mínimo, inclusive. Unidade: reais. - `equityMax` number: Patrimônio líquido: valor máximo, inclusive. Unidade: reais. - `totalInvestorsMin` number: Cotistas: valor mínimo, inclusive. Unidade: quantidade. - `totalInvestorsMax` number: Cotistas: valor máximo, inclusive. Unidade: quantidade. - `priceChange12mMin` number: Variação em 12 meses: valor mínimo, inclusive. Unidade: fração (0.06 = 6%). - `priceChange12mMax` number: Variação em 12 meses: valor máximo, inclusive. Unidade: fração (0.06 = 6%). - `totalFeePercentMin` number: Taxa total: valor mínimo, inclusive. Unidade: porcentagem (2.81 = 2,81%). - `totalFeePercentMax` number: Taxa total: valor máximo, inclusive. Unidade: porcentagem (2.81 = 2,81%). ## Response `200` Fundos que passam nos filtros, com paginação. - FundScreenerResponse - `results` FundScreenerItem[], required - `symbol` string, required: Ticker do ativo. - `name` string, required: Nome da empresa ou do fundo. - `longName` string, nullable, required: Nome longo. Pode ser nulo. - `assetType` 'stock' | 'fund' | 'bdr', nullable, required: Tipo do ativo. - `subType` 'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr', nullable, required: Subtipo do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr. - `exchange` 'B3', required: Bolsa. - `currency` 'BRL', required: Moeda. - `sector` string, nullable, required: Setor. Pode ser nulo. - `subsector` string, nullable, required: Subsetor. Pode ser nulo. - `isActive` boolean, required: `true` quando o ativo está em negociação. - `logoUrl` string, nullable, required: URL do logo. - `quote` TickerQuoteSummary, required - `lastPrice` number, nullable, required: Último preço. - `changePercent` number, nullable, required: Variação no dia, em porcentagem. - `volume` number, nullable, required: Volume negociado no dia. - `marketCap` number, nullable, required: Valor de mercado, em reais. Pode ser nulo. - `fund` FundScreenerFund, required - `cnpj` string, required - `type` string, required: Tipo do fundo: fii, fiagro, fiinfra, etf, fidc, fip ou fif. - `segmentType` string, nullable, required: Tipo do FII: tijolo, papel, fof ou hibrido. - `segment` string, nullable, required: Segmento do FII no cadastro da CVM. - `mandate` string, nullable, required: Mandato do FII no cadastro da CVM. - `managementType` string, nullable, required: Tipo de gestão do FII: Ativa ou Passiva. - `etfCategory` 'fixed-income' | 'equity' | 'crypto' | 'real-estate', nullable, required: Categoria do ETF. Nulo para os outros fundos. - `managerName` string, nullable, required - `administratorName` string, nullable, required - `reportDate` string, nullable, required: Data do informe de onde vêm patrimônio, valor patrimonial por cota e cotistas (AAAA-MM-DD). - `lastDividendDate` string, nullable, required: Data-com do último rendimento dos últimos 12 meses (AAAA-MM-DD). - `metrics` FundScreenerMetrics, required: Indicadores do fundo. - `averageDailyTradedValue` number, nullable, required: Liquidez diária. Média do valor negociado por pregão nos últimos 30 dias, em reais. Dias sem negócio contam como zero. Unidade: reais. Nulo quando não há dado. - `marketCap` number, nullable, required: Valor de mercado. Último preço vezes as cotas emitidas do último informe, em reais. Unidade: reais. Nulo quando não há dado. - `dividendYield` number, nullable, required: Dividend yield 12m. Rendimentos dos últimos 12 meses, pela data-com, sobre o último preço, em fração (0.1 = 10%). Não soma amortizações. Nulo quando o fundo não pagou rendimentos. Unidade: fração (0.06 = 6%). Nulo quando não há dado. - `lastDividend` number, nullable, required: Último rendimento. Valor por cota do último rendimento, pela data-com, em reais. Unidade: reais. Nulo quando não há dado. - `lastDividendYield` number, nullable, required: Yield do último rendimento. Último rendimento sobre o último preço, em fração (0.008 = 0,8%). Unidade: fração (0.06 = 6%). Nulo quando não há dado. - `incomeMonths12m` number, nullable, required: Meses com rendimento. Quantos dos últimos 12 meses tiveram rendimento, pela data-com. Mede a regularidade dos pagamentos. Unidade: quantidade. Nulo quando não há dado. - `navPerShare` number, nullable, required: Valor patrimonial/cota. Valor patrimonial por cota do último informe, em reais. Nulo quando o informe não fecha com o patrimônio e o número de cotas. Unidade: reais. Nulo quando não há dado. - `priceToNav` number, nullable, required: P/VP. Último preço sobre o valor patrimonial por cota do último informe. Unidade: múltiplo. Nulo quando não há dado. - `equity` number, nullable, required: Patrimônio líquido. Patrimônio líquido do último informe, em reais. Unidade: reais. Nulo quando não há dado. - `totalInvestors` number, nullable, required: Cotistas. Número de cotistas do último informe. Unidade: quantidade. Nulo quando não há dado. - `priceChange12m` number, nullable, required: Variação em 12 meses. Último preço sobre o fechamento de 12 meses atrás, em fração (0.05 = 5%). Não soma os rendimentos. Unidade: fração (0.06 = 6%). Nulo quando não há dado. - `totalFeePercent` number, nullable, required: Taxa total. Taxa total ao ano do regulamento mais recente, em percentual (0.2 = 0,20% a.a.). Por enquanto, só ETFs. Unidade: porcentagem (2.81 = 2,81%). Nulo quando não há dado. - `pagination` TickerPagination, required - `page` number, required - `limit` number, required - `totalItems` number, required - `totalPages` number, required - `hasNextPage` boolean, required - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `500`: Erro interno do servidor. ## Changes - **2026-11-01** `d430f6ae89cb`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/funds/screener/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)