BRbrapi-dev
Fundos Imobiliários

Carteira de FIIs

Changed on

Composição da carteira de FIIs pelo informe trimestral da CVM: imóveis, CRIs e outros ativos financeiros, cotas de outros FIIs, terrenos e direitos, com totais em summary.

Use para analisar FIIs de papel e fundos de fundos, ver os CRIs de um fundo ou somar a exposição por classe de ativo.

include escolhe as listas. Sem include, retorna todas. summary sempre vem.

Em fundos de fundos, fundHoldings lista as cotas de outros FIIs. Em FIIs de papel, financialAssets lista os CRIs com emissor e valor. allocations resume a carteira por classe de ativo.

Sem referenceDate, retorna o trimestre mais recente de cada fundo. Informes podem ser retificados. O padrão retorna a versão mais recente, e allVersions=true retorna todas.

Para imóveis e vacância, use imóveis de FIIs. Para a série no tempo, use o histórico da carteira.

Plano Pro. Sem token, aceita só symbols com MXRF11 e HGLG11.

get/api/v2/fii/portfolio

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/fii/portfolio
  • Auth
    HTTP bearer

Query parameters

symbolsstring required

Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.

Example:HGLG11,MXRF11
referenceDatestring

Fim do trimestre no formato YYYY-MM-DD. Sem valor, retorna o trimestre mais recente de cada FII.

Example:2025-03-31
includestring

Listas a retornar, separadas por vírgula: allocations, properties, financialAssets, fundHoldings, lands, rights. summary sempre vem. Sem valor, retorna todas.

Example:allocations,fundHoldings
allVersions'true' | 'false'

true inclui todas as versões do trimestre. false retorna só a mais recente.

Example:false

Response

Carteira dos FIIs.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "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
}

Changes