A posição de um fundo em um ativo, mês a mês: peso no patrimônio, valor e quantidade. Os dados vêm da carteira mensal que os fundos entregam à CVM.
Use para ver quando um fundo ou ETF comprou ou vendeu uma ação, ou como mudou o peso de um ativo na carteira.
Informe o fundo (symbol ou cnpj) e o ativo (asset com o ticker, ou assetCnpj com o CNPJ de um fundo ou de uma empresa, como em /api/v2/funds/holders). Sem datas, a resposta traz os últimos 24 meses.
Um mês em que o fundo entregou a carteira sem o ativo aparece com zeros. Um mês sem carteira não aparece.
Só posições diretas: o ativo detido por meio de outro fundo não entra. Ações próprias e emprestadas somam uma posição. Derivativos, valores a pagar e posições confidenciais não entram.
Plano Pro.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Ticker do fundo. Ex.: BOVA11.
1 <= length <= 20CNPJ do fundo, com ou sem pontuação. Use symbol ou cnpj, não os dois.
1 <= length <= 20Ticker do ativo na bolsa. Ex.: PETR4.
1 <= length <= 20CNPJ de um fundo, para as cotas dele, ou de uma empresa, para as ações e a dívida dela. Use asset ou assetCnpj, não os dois.
1 <= length <= 20Data inicial no formato YYYY-MM-DD. Padrão: 24 meses antes de endDate.
Data final no formato YYYY-MM-DD. Padrão: hoje.
Do mês mais antigo (asc) ou do mais recente (desc, padrão).
"desc"Value in
application/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/history"{ "fund": { "symbol": "BOVA11", "cnpj": "10406511000161", "name": "ISHARES BOVA", "assetType": "etf" }, "asset": { "symbol": "PETR4", "cnpj": null, "name": "PETROBRAS" }, "history": [ { "referenceDate": "2026-10-31", "weightPercent": 9.7349, "marketValue": 1725247109.46, "quantity": 32730926, "netAssets": 17722231680.72 }, { "referenceDate": "2026-09-30", "weightPercent": 8.148, "marketValue": 1233134317.12, "quantity": 25104526, "netAssets": 15134227599.02 } ], "requestedAt": "2026-11-12T19:00:00.000Z", "took": 9}