Responde o que o fundo tem em carteira. 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.
Em fundos de fundos, fundHoldings lista as cotas de outros FIIs e mostra a
exposição real. Em FIIs de papel, financialAssets traz os CRIs com emissor e
valor. Em carteiras híbridas, allocations resume tudo por classe.
Para travar um trimestre, passe referenceDate. Para a evolução no tempo, use
/api/v2/fii/portfolio/history.
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 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"Value in
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/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}