Composição de um fundo ou ETF em um mês, como na lâmina: cada ativo com o peso no patrimônio, e o resumo por classe de ativo, país e setor. Os dados vêm da carteira mensal que os fundos entregam à CVM.
Use para ver os maiores ativos de um ETF, quanto ele tem no exterior ou em cada setor.
Informe symbols ou cnpjs. Sem referenceDate, a resposta traz o mês mais recente. availableDates lista os meses com carteira.
Posições repetidas viram uma só: ações próprias e emprestadas, o mesmo título público em várias linhas e as cotas de um mesmo fundo.
Com lookThrough=true (padrão), uma cota de outro fundo vira os ativos desse fundo, proporcionais ao peso da cota: um ETF do exterior, pelos relatórios públicos do fundo no exterior (SEC), e um fundo brasileiro com pelo menos 1% do patrimônio, pela carteira dele no mesmo mês. Até três níveis. lookThrough.funds lista os fundos abertos, cada um com a data da própria carteira. via mostra por qual fundo vem cada ativo.
Posições confidenciais não aparecem em holdings. Elas entram em confidentialWeightPercent e no resumo por classe.
Um fundo sem carteira no período não aparece na resposta. A CVM publica a carteira com meses de atraso. Mostre referenceDate junto do dado.
Plano Pro.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Tickers separados por vírgula, até 20. Ex.: BOVA11,WRLD11.
1 <= length <= 300CNPJs separados por vírgula, até 20, com ou sem pontuação.
1 <= length <= 400Data no formato YYYY-MM-DD. Traz o mês mais recente até esta data. Sem ela, traz o mês mais recente.
true (padrão) abre as cotas de outros fundos e mostra os ativos deles. false mostra só as posições diretas.
Value in
Classes de ativo separadas por vírgula. Filtra só a lista holdings; o resumo usa a carteira toda. Ex.: equity,bdr.
Página, a partir de 1.
1 <= value <= 100001Posições por fundo e por página. Padrão 10, máximo 500.
1 <= value <= 50010application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/funds/holdings"{ "funds": [ { "symbol": "BOVA11", "cnpj": "10406511000161", "name": "ISHARES BOVA", "assetType": "etf", "referenceDate": "2026-09-30", "netAssets": 15134227599.02, "source": { "name": "CVM", "url": "https://dados.cvm.gov.br/dados/FI/DOC/CDA/DADOS/cda_fi_202609.zip", "documentId": 1340049 }, "availableDates": [ "2026-10-31", "2026-09-30" ], "summary": { "holdingsCount": 84, "top10WeightPercent": 53.5802, "confidentialWeightPercent": 0, "confidentialUntil": null, "assetClasses": [ { "assetClass": "equity", "weightPercent": 98.1409, "marketValue": 14852868979.25 }, { "assetClass": "receivable", "weightPercent": 3.2506, "marketValue": 491950309.04 }, { "assetClass": "repo", "weightPercent": 0.6812, "marketValue": 103094368.38 } ], "countries": [ { "country": "BR", "countryName": "Brasil", "weightPercent": 99.0229 } ], "sectors": [ { "sector": "Finance", "weightPercent": 31.021 }, { "sector": "Utilities", "weightPercent": 18.1345 }, { "sector": "Energy Minerals", "weightPercent": 15.0089 } ], "sectorCoveragePercent": 99.7841 }, "lookThrough": { "applied": false, "funds": [] }, "holdings": [ { "rank": 1, "symbol": "VALE3", "name": "VALE", "isin": "BRVALEACNOR0", "assetClass": "equity", "assetType": "Ação ordinária", "country": "BR", "sector": "Non-Energy Minerals", "weightPercent": 9.6943, "marketValue": 1467163977.88, "quantity": 20986468, "maturityDate": null, "via": null }, { "rank": 2, "symbol": "ITUB4", "name": "ITAUUNIBANCO", "isin": "BRITUBACNPR1", "assetClass": "equity", "assetType": "Ação preferencial", "country": "BR", "sector": "Finance", "weightPercent": 8.8887, "marketValue": 1345230429.48, "quantity": 30380091, "maturityDate": null, "via": null } ], "pagination": { "page": 1, "limit": 2, "totalItems": 84, "totalPages": 42, "hasNextPage": true } } ], "requestedAt": "2026-11-12T19:00:00.000Z", "took": 37}