Carteira de FIIs
Use este endpoint para responder “o que este FII possui?”. A resposta vem
agrupada por FII, com summary, allocations, financialAssets,
fundHoldings, properties, lands e rights.
Para imóveis físicos e vacância, prefira /api/v2/fii/properties.
Este endpoint é melhor para FoFs, FIIs de papel, CRIs e composição geral.
Sandbox sem token: symbols=HGLG11 e symbols=MXRF11. Para todos os FIIs,
use um token Pro.
Quando usar
- FoFs: use
fundHoldingspara ver cotas de outros FIIs. - FIIs de papel: use
financialAssetspara CRIs, emissores e valores. - Carteiras híbridas: use
allocationspara entender a composição. - Auditoria: use
referenceDatepara travar um trimestre específico. - Evolução trimestral: use
/api/v2/fii/portfolio/history.
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 referência trimestral no formato YYYY-MM-DD. Se omitida, retorna o trimestre mais recente por FII.
Listas separadas por vírgula: allocations, properties, financialAssets, fundHoldings, lands, rights. summary sempre é retornado. Se omitido, retorna todas as listas.
Incluir todas as versões do trimestre retornado (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?symbols=HGLG11%2CMXRF11"{
"fiis": [
{
"symbol": "HGLG11",
"cnpj": "11728688000147",
"referenceDate": "2026-03-31",
"version": 2,
"summary": {
"totalItems": 40,
"declaredValue": 3349501.49,
"properties": {
"count": 37,
"totalArea": 2066028.32,
"vacancyRate": 0.032785,
"averageVacancyRate": 0.03787,
"propertiesWithVacancy": 37
},
"financialAssets": {
"count": 3,
"declaredValue": 3349501.49
},
"lands": {
"count": 0,
"totalArea": null
},
"rights": {
"count": 0,
"declaredValue": null
}
},
"allocations": [
{
"assetClass": "real_estate",
"count": 37,
"value": null
},
{
"assetClass": "cri",
"count": 3,
"value": 3349501.49
}
],
"properties": [
{
"name": "DCR",
"identifier": "925452ac11b478196d767981dee8ecaf",
"address": "Av. Hélio Ossamu Daikuara, nº 1.445, Jardim Vista Alegre, Embu das Artes",
"propertyClass": "Imóveis para renda acabados",
"area": 77587.2,
"unitCount": 1,
"vacancyRate": 0.135305823641013,
"delinquencyRate": 0,
"revenueShare": 0.0398709781486898,
"leasedRate": null,
"soldRate": null,
"constructionProgressActual": null,
"constructionProgressExpected": null,
"constructionCostActual": null,
"constructionCostExpected": null,
"investedShare": null,
"confidential": false
}
],
"financialAssets": [
{
"assetClass": "cri",
"name": "VIRGO COMPANHIA DE SECURITIZAÇÃO",
"issuer": "VIRGO COMPANHIA DE SECURITIZAÇÃO",
"issuerCnpj": "08769451000108",
"identifier": "8d612f6e7e4fb1da2d668f07c4f91420",
"quantity": 35,
"value": 3349501.49,
"issue": "4",
"series": "124",
"ticker": null,
"maturityDate": null,
"confidential": false
}
],
"fundHoldings": [],
"lands": [],
"rights": []
}
],
"requestedAt": "2026-02-08T16:25:24.456Z",
"took": 8
}{
"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"
}