v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Fundos Imobiliários

Obter Composição da Carteira

Retorna a composição normalizada da carteira dos FIIs a partir dos informes trimestrais da CVM. Use para entender o que um FII possui: CRIs, cotas de outros FIIs, imóveis, direitos e terrenos.

Funcionalidades:

Resposta agrupada por FII: Cada fundo vem com resumo, alocações e listas por tipo de ativo.
Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição.
Filtro por trimestre: Use referenceDate=YYYY-MM-DD. Sem esse parâmetro, retorna o trimestre mais recente disponível por FII.
Versionamento: Informes podem ter retificações. Por padrão, retorna apenas a versão mais recente do trimestre retornado. Use allVersions=true para todas as versões do trimestre consultado.
Payload sob controle: summary sempre vem. Use include=allocations, include=financialAssets, include=fundHoldings, include=properties, include=lands ou include=rights para escolher listas.

Campos da Resposta:

summary — Totais por FII, valor declarado e vacância consolidada dos imóveis.
allocations — Contagem e valor por classe de ativo.
financialAssets — CRIs, cotas, SPEs e outros ativos financeiros.
fundHoldings — Cotas de outros FIIs, útil para FoFs.
properties — Imóveis físicos com área, endereço, vacância e participação na receita.

Autenticação:

Os FIIs MXRF11 e HGLG11 podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido.

Exemplos de Requisição:

# Carteira mais recente do HGLG11
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11"

# Carteira em um trimestre específico
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11&referenceDate=2025-03-31"

# Apenas resumo e alocações
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11&include=allocations"

Fonte dos Dados:

CVM (Informe Trimestral FII)

Plano Mínimo: Pro Autenticação: Necessária (exceto MXRF11 e HGLG11)

get/api/v2/fii/portfolio

Query parameters

symbolsstring required

Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11

Example:HGLG11,MXRF11

referenceDatestring

Data de referência trimestral no formato YYYY-MM-DD. Se omitida, retorna o trimestre mais recente por FII.

Example:2025-03-31

includestring

Listas separadas por vírgula: allocations, properties, financialAssets, fundHoldings, lands, rights. summary sempre é retornado. Se omitido, retorna todas as listas.

Example:allocations,fundHoldings

allVersions'true' | 'false'

Incluir todas as versões do trimestre retornado (padrão: false, retorna apenas a mais recente)

Example:false

Response

Carteira detalhada dos FIIs retornada com sucesso.

requestedAtstring date-time required

Data e hora da requisição em formato 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
}