v20

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

Fundos Imobiliários

Histórico de Imóveis e Vacância

Retorna a série trimestral compacta dos imóveis e da vacância dos FIIs. Use este endpoint para gráficos e comparações de vacância, área total e quantidade de imóveis ao longo do tempo.

Funcionalidades:

Série trimestral: Um ponto por FII, trimestre e versão do informe.
Resumo compacto: Retorna apenas summary por trimestre, sem a lista completa de imóveis.
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/properties/history?symbols=HGLG11"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties/history?symbols=HGLG11,XPLG11&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/properties/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 de imóveis e vacância 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": {
        "count": 37,
        "totalArea": 2066028.32,
        "vacancyRate": 0.032785,
        "averageVacancyRate": 0.03787,
        "propertiesWithVacancy": 37
      }
    },
    {
      "symbol": "HGLG11",
      "cnpj": "11728688000147",
      "referenceDate": "2025-12-31",
      "version": 2,
      "summary": {
        "count": 28,
        "totalArea": 1628383.15,
        "vacancyRate": 0.029088,
        "averageVacancyRate": 0.04282,
        "propertiesWithVacancy": 28
      }
    }
  ],
  "requestedAt": "2026-02-08T16:25:26.456Z",
  "took": 6
}