---
title: "Histórico de indicadores de FIIs"
method: GET
path: "/api/v2/fii/indicators/history"
tags: ["Fundos Imobiliários"]
---

# Histórico de indicadores de FIIs

`GET /api/v2/fii/indicators/history`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/fii/indicators/history`
- Auth: HTTP bearer

Série mensal dos [indicadores de FIIs](https://brapi.dev/docs/fiis/indicadores): 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.

## Query parameters

- `symbols` string, required: Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.
- `startDate` string: Data inicial no formato YYYY-MM-DD.
- `endDate` string: Data final no formato YYYY-MM-DD.
- `sortBy` string: Campo de ordenação.
- `sortOrder` 'asc' | 'desc': Direção da ordenação.

## Response `200`

Série mensal de indicadores.

- FiiIndicatorsHistoryResponse
  - `history` FiiIndicatorHistoryEntry[], required
    - `symbol` string, required
    - `referenceDate` string, required
    - `price` number, nullable, required
    - `navPerShare` number, nullable, required
    - `priceToNav` number, nullable, required
    - `dividendYield12m` number, nullable, required
    - `dividendYield1m` number, nullable, required
    - `monthlyReturn` number, nullable, required
    - `totalInvestors` number, nullable, required
    - `sharesOutstanding` number, nullable, required
    - `equity` number, nullable, required
    - `totalAssets` number, nullable, required
    - `segmentType` string, nullable, required
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `500`: Erro interno do servidor.

## Changes

- **2026-04-07** `19f807c15a24`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/fii/indicators/history/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)