Fundos que têm um ativo em carteira, com o valor e o peso da posição em cada fundo. Os dados vêm da carteira mensal que os fundos entregam à CVM.
Use para ver quais fundos e ETFs compram uma ação, ou quais fundos têm cotas de outro fundo.
Informe symbol (ticker na bolsa, como PETR4) ou cnpj (um fundo cujas cotas outros fundos têm).
Só posições diretas: um fundo que tem o ativo por meio de outro fundo não aparece. Ações próprias e emprestadas somam uma posição. Posições confidenciais não aparecem.
Sem referenceDate, a resposta traz o mês mais recente que a maioria dos fundos já entregou: os fundos entregam a carteira ao longo de semanas.
Plano Pro.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Ticker do ativo na bolsa. Ex.: PETR4.
1 <= length <= 20CNPJ de um fundo, para ver quais fundos têm cotas dele. Use symbol ou cnpj, não os dois.
1 <= length <= 20Data no formato YYYY-MM-DD. Traz o mês mais recente até esta data. Sem ela, traz o mês mais recente que a maioria dos fundos já entregou.
Só fundos deste tipo. Ex.: etf.
Value in
marketValue (padrão) ou weightPercent.
"marketValue"Value in
Ordem crescente (asc) ou decrescente (desc, padrão).
"desc"Value in
Página, a partir de 1.
1 <= value <= 100001Fundos por página. Padrão 20, máximo 100.
1 <= value <= 10020application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/funds/holders"{ "asset": { "symbol": "PETR4", "cnpj": null, "name": "PETROBRAS" }, "referenceDate": "2026-10-31", "summary": { "fundsCount": 222, "totalMarketValue": 7167252686.58, "totalQuantity": 195508604 }, "funds": [ { "symbol": "BOVA11", "cnpj": "10406511000161", "name": "ISHARES BOVA", "assetType": "etf", "weightPercent": 9.7349, "marketValue": 1725247109.46, "quantity": 32730926, "netAssets": 17722231680.72 }, { "symbol": null, "cnpj": "08935128000159", "name": "GERAÇÃO L. PAR FUNDO DE INVESTIMENTO FINANCEIRO DE AÇÕES DE RESPONSABILIDADE LIMITADA", "assetType": "fif", "weightPercent": 28.2624, "marketValue": 1634010000, "quantity": 31000000, "netAssets": 5781568892.94 } ], "pagination": { "page": 1, "limit": 2, "totalItems": 222, "totalPages": 111, "hasNextPage": true }, "requestedAt": "2026-11-12T19:00:00.000Z", "took": 24}