Sign in

v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB
Fundos Imobiliários

Obter Histórico de Indicadores

Retorna a série temporal mensal dos indicadores fundamentalistas. Analise tendências de valuation, rentabilidade e crescimento patrimonial ao longo do tempo.

Funcionalidades:

  • Histórico desde setembro/2016: Dados mensais de mais de 8 anos
  • Granularidade mensal: Um ponto de dados por mês para cada FII
  • Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição
  • Filtro por período: Especifique startDate e endDate (padrão: últimos 12 meses)
  • Ordenação flexível: Ordene por qualquer campo (referenceDate, price, DY, P/VP, etc.)
  • Análises de tendência: Identifique padrões de rentabilidade, valuation e crescimento

Campos da Resposta:

Os mesmos indicadores do endpoint /indicators, com adição de referenceDate (data do último dia do mês de referência).

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:

# Histórico dos últimos 12 meses (padrão)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators/history?symbols=HGLG11,MXRF11"

# Histórico em período específico (2023-2024)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators/history?symbols=KNCR11&startDate=2023-01-01&endDate=2024-12-31"

# Histórico ordenado por Dividend Yield decrescente
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators/history?symbols=XPLG11,BTLG11&sortBy=dividendYield12m&sortOrder=desc"

Fonte dos Dados:

CVM (Comissão de Valores Mobiliários)

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

get/api/v2/fii/indicators/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

Response

Histórico mensal de indicadores 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": "MXRF11",
      "referenceDate": "2025-12-01 00:00:00+00",
      "price": 9.411791,
      "navPerShare": 9.409927,
      "priceToNav": 1.0001981,
      "dividendYield12m": 0.12381,
      "dividendYield1m": 0.009328,
      "monthlyReturn": 0.007876,
      "totalInvestors": 1357621,
      "sharesOutstanding": 460269540,
      "equity": 4331102700,
      "totalAssets": 4375755000,
      "segmentType": "papel"
    },
    {
      "symbol": "MXRF11",
      "referenceDate": "2025-11-01 00:00:00+00",
      "price": 9.463164,
      "navPerShare": 9.42361,
      "priceToNav": 1.0041974,
      "dividendYield12m": 0.125273,
      "dividendYield1m": 0.010665,
      "monthlyReturn": 0.010727,
      "totalInvestors": 1339326,
      "sharesOutstanding": 460269540,
      "equity": 4337401000,
      "totalAssets": 4386052600,
      "segmentType": "papel"
    }
  ],
  "requestedAt": "2026-02-08T16:25:20.123Z",
  "took": 12
}