Como a carteira do fundo mudou, trimestre a trimestre. Cada item em history[]
traz summary e allocations, sem as listas de CRIs, cotas, imóveis, terrenos
e direitos.
A resposta é pequena de propósito. Para abrir os itens de um trimestre, chame
/api/v2/fii/portfolio com referenceDate.
Sandbox sem token: symbols=HGLG11 e symbols=MXRF11. Para todos os FIIs,
use um token Pro.
history[].allocations mostra a composição por classe de ativo em cada
trimestre. history[].summary.declaredValue traz o valor declarado do total.
Para FIIs de papel e fundos de fundos, financialAssets.declaredValue é o campo
que conta a história.
Informes recebem retificação. Se você precisa auditar o que mudou entre a
primeira versão e a corrigida, use allVersions=true.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
Data de início no formato YYYY-MM-DD
Data de fim no formato YYYY-MM-DD
Campo para ordenação
Direção da ordenação
"desc"Value in
Incluir todas as versões de cada trimestre (padrão: false, retorna apenas 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}