Histórico da Carteira de FIIs
Use este endpoint para acompanhar a evolução da carteira dos FIIs por trimestre.
A resposta é compacta: cada item em history[] traz summary e allocations,
sem as listas detalhadas de CRIs, cotas, imóveis, terrenos e direitos.
Para abrir os itens de um trimestre específico, use
/api/v2/fii/portfolio com referenceDate.
Sandbox sem token: symbols=HGLG11 e symbols=MXRF11. Para todos os FIIs,
use um token Pro.
Quando usar
- Composição ao longo do tempo: use
history[].allocations. - Valor declarado: use
history[].summary.declaredValue. - FIIs de papel e FoFs: acompanhe
financialAssets.declaredValue. - Retificações: use
allVersions=truepara ver versões anteriores do informe.
Authorization
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
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""asc" | "desc"Incluir todas as versões de cada trimestre (padrão: false, retorna apenas a mais recente)
"false""true" | "false"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/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
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Token de autenticação inválido ou ausente",
"code": "UNAUTHORIZED"
}{
"error": true,
"message": "Você não tem permissão para acessar este recurso",
"code": "FORBIDDEN"
}{
"error": true,
"message": "Recurso não encontrado",
"code": "NOT_FOUND"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}