Série trimestral da carteira de FIIs: um ponto por fundo, trimestre e versão do informe, com summary e allocations por classe de ativo.
Use para ver como a alocação de um fundo mudou no tempo, por exemplo entre imóveis, CRIs e cotas de outros FIIs.
A resposta não traz as listas item a item. Para o detalhe de um trimestre, use a carteira de FIIs com referenceDate.
Sem startDate e endDate, retorna os últimos 12 meses. sortBy aceita referenceDate (padrão), symbol, version, totalItems, declaredValue e financialAssetsDeclaredValue. allVersions=true inclui as versões retificadas.
Plano Pro. Sem token, aceita só symbols com MXRF11 e HGLG11.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.
Data inicial no formato YYYY-MM-DD.
Data final no formato YYYY-MM-DD.
Campo de ordenação.
Direção da ordenação.
"desc"Value in
true inclui todas as versões de cada trimestre. false retorna só a mais recente.
"false"Value in
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/fii/portfolio/history?symbols=HGLG11%2CMXRF11"{ "history": [ { "symbol": "HGLG11", "cnpj": "11728688000147", "referenceDate": "2026-03-31", "version": 2, "summary": { "totalItems": 57, "declaredValue": 1256045042.52, "properties": { "count": 37, "totalArea": 2066028.32, "vacancyRate": 0.032785, "averageVacancyRate": 0.03787, "propertiesWithVacancy": 37 }, "financialAssets": { "count": 20, "declaredValue": 1256045042.52 }, "lands": { "count": 0, "totalArea": null }, "rights": { "count": 0, "declaredValue": null } }, "allocations": [ { "assetClass": "cri", "count": 1, "value": 106876.54 }, { "assetClass": "fii", "count": 8, "value": 232510079.3 }, { "assetClass": "real_estate_company", "count": 11, "value": 1023428086.68 }, { "assetClass": "real_estate", "count": 37, "value": null } ] } ], "requestedAt": "2026-02-08T16:25:27.456Z", "took": 7}