BRbrapi-dev
Fundos Imobiliários

Histórico da carteira de FIIs

Changed on

Série trimestral da carteira de FIIs: um ponto por fundo, trimestre e versão do informe, com summary e allocations por classe de ativo.

Use para ver como a alocação de um fundo mudou no tempo, por exemplo entre imóveis, CRIs e cotas de outros FIIs.

A resposta não traz as listas item a item. Para o detalhe de um trimestre, use a carteira de FIIs com referenceDate.

Sem startDate e endDate, retorna os últimos 12 meses. sortBy aceita referenceDate (padrão), symbol, version, totalItems, declaredValue e financialAssetsDeclaredValue. allVersions=true inclui as versões retificadas.

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

get/api/v2/fii/portfolio/history

Request

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

Query parameters

symbolsstring required

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

Example:HGLG11,MXRF11
startDatestring

Data inicial no formato YYYY-MM-DD.

Example:2024-01-01
endDatestring

Data final no formato YYYY-MM-DD.

Example:2025-12-31
sortBystring

Campo de ordenação.

Example:referenceDate
sortOrder'asc' | 'desc'

Direção da ordenação.

Example:desc
allVersions'true' | 'false'

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

Example:false

Response

Série trimestral da carteira.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

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

Changes