# Indicadores Históricos de FIIs
URL: /docs/fiis/indicadores-historico.mdx

Acompanhe a evolução mensal dos indicadores de FIIs: P/VP, dividend yield, patrimônio e mais, com filtros de data e ordenação.

***

title: Indicadores Históricos de FIIs
description: >-
Acompanhe a evolução mensal dos indicadores de FIIs: P/VP, dividend yield,
patrimônio e mais, com filtros de data e ordenação.
full: true
keywords: brapi, api, fii, indicadores, histórico, evolução mensal
openGraph:
title: Indicadores Históricos de FIIs
description: >-
Série temporal mensal dos indicadores fundamentalistas de FIIs.
type: website
locale: pt\_BR
lastUpdated: '2026-04-25T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/fii/indicators/history
structuredData:
headings: \[]
contents:

* content: >-
  Retorna a série histórica mensal dos indicadores de FIIs, com
  filtros por data e ordenação. Ideal para gráficos de evolução.

***

import { Callout } from 'fumadocs-ui/components/callout';

Retorna a série histórica mensal dos indicadores de FIIs. Use `startDate` e
`endDate` para delimitar o período e `sortOrder` para controlar a direção
(padrão: mais recente primeiro).

Ideal para montar gráficos de evolução de P/VP, dividend yield, patrimônio
e outros indicadores ao longo dos meses. Dados disponíveis a partir de
**setembro de 2016**.

<Callout type="info">
  **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbols=MXRF11`
  e/ou `HGLG11`.
</Callout>





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/indicators/history

Single endpoint documentation for /api/v2/fii/indicators/history

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/fii/indicators/history

**Summary:** 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:
```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)


**Tags:** Fundos Imobiliários

### Parameters

- **symbols** (query) *required*
- **startDate** (query)
- **endDate** (query)
- **sortBy** (query)
- **sortOrder** (query)

### Responses

#### 200

Histórico mensal de indicadores retornado com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### FiiIndicatorHistoryEntry

**Properties:**

- **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)*


### FiiIndicatorsHistoryResponse

**Properties:**

- **history** (array) *(required)*
  Array items:
    Reference to: **FiiIndicatorHistoryEntry**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos