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

# Obter Histórico de Indicadores

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

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:
```bash
# 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)

## Query parameters

- `symbols` string, required — Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
- `startDate` string — Data de início no formato YYYY-MM-DD
- `endDate` string — Data de fim no formato YYYY-MM-DD
- `sortBy` string — Campo para ordenação
- `sortOrder` 'asc' | 'desc' — Direção da ordenação

## Response `200`

Histórico mensal de indicadores retornado com sucesso.

- 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 formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)