BRbrapi-dev
Fundos Imobiliários

Histórico de indicadores de FIIs

Changed on

Série mensal dos indicadores de FIIs: um ponto por mês, com referenceDate no dia 1º do mês do informe (2026-09-01 00:00:00+00 é setembro de 2026). O histórico começa em setembro de 2016.

price é o último fechamento do mês, e navPerShare é o valor patrimonial do fim do mês, os dois na base de cotas atual. dividendYield1m soma os pagamentos do mês, e dividendYield12m os dos 12 meses até ele, sobre price.

Use para gráficos de P/VP e dividend yield, e para comparar um fundo com o próprio passado.

Sem startDate e endDate, retorna os últimos 12 meses. sortBy aceita referenceDate (padrão), symbol, price, navPerShare, priceToNav, dividendYield12m, dividendYield1m, monthlyReturn e totalInvestors.

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

get/api/v2/fii/indicators/history

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/fii/indicators/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

Response

Série mensal de indicadores.

requestedAtstring date-time required

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

Changes