v20

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

Fundos Imobiliários

Histórico da Carteira

Retorna a série trimestral compacta da composição da carteira dos FIIs. Use este endpoint para acompanhar evolução de alocação, valor declarado, quantidade de ativos, imóveis e exposição por classe ao longo do tempo.

Funcionalidades:

Série trimestral: Um ponto por FII, trimestre e versão do informe.
Resumo de carteira: Retorna summary e allocations, sem listas detalhadas de ativos.
Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição.
Filtro por período: Use startDate=YYYY-MM-DD e endDate=YYYY-MM-DD. O padrão são os últimos 12 meses.
Versionamento: Por padrão retorna a versão mais recente de cada trimestre. Use allVersions=true para incluir retificações.

Exemplos de Requisição:

curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio/history?symbols=HGLG11"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio/history?symbols=HGLG11,MXRF11&startDate=2024-01-01&endDate=2026-03-31"

Fonte dos Dados:

CVM (Informe Trimestral FII)

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

get/api/v2/fii/portfolio/history

Query parameters

symbolsstring required

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

Example:HGLG11,MXRF11

startDatestring

Data de início no formato YYYY-MM-DD

Example:2024-01-01

endDatestring

Data de fim no formato YYYY-MM-DD

Example:2025-12-31

sortBystring

Campo para ordenação

Example:referenceDate

sortOrder'asc' | 'desc'

Direção da ordenação

Example:desc

allVersions'true' | 'false'

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

Example:false

Response

Histórico trimestral da carteira retornado 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

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