# Cotações Históricas de FIIs
URL: /docs/fiis/historico.mdx

Consulte cotações históricas OHLCV diárias de Fundos Imobiliários para gráficos de preço e backtests.

***

title: Cotações Históricas de FIIs
description: >-
Consulte cotações históricas OHLCV diárias de Fundos Imobiliários para
gráficos de preço e backtests.
full: true
keywords: brapi, api, fii, cotações, histórico, OHLCV
openGraph:
title: Cotações Históricas de FIIs
description: >-
Cotações históricas OHLCV diárias de Fundos Imobiliários.
type: website
locale: pt\_BR
lastUpdated: '2026-04-25T12:00:00.000Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/fii/historical
structuredData:
headings: \[]
contents:

* content: >-
  Retorna cotações históricas OHLCV diárias de FIIs, com filtros por
  data e ordenação. Ideal para gráficos de preço e backtests.

***

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

Retorna cotações históricas OHLCV (abertura, máxima, mínima, fechamento,
volume) diárias de um ou mais FIIs. Use `startDate` e `endDate` para delimitar
o período (padrão: últimos 12 meses).

Aceita até **20 símbolos** separados por vírgula. Cada símbolo retorna sua
própria série temporal.

<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/historical

Single endpoint documentation for /api/v2/fii/historical

## Base URLs

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

## GET /api/v2/fii/historical

**Summary:** Obter Cotações Históricas (OHLCV)


Retorna a série histórica de preços OHLCV (Abertura, Máxima, Mínima, Fechamento, Volume) diários. Use para backtesting, análise técnica e construção de modelos de previsão.

### Funcionalidades:
*   **Dados OHLCV completos:** Abertura, Máxima, Mínima, Fechamento, Volume, Fechamento Ajustado
*   **Granularidade diária:** Um ponto de dados por dia de negociação
*   **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:** Ascendente ou descendente por data
*   **Timestamp UNIX:** Datas em segundos desde 1º de janeiro de 1970

### Campos da Resposta:
*   **date** — Timestamp UNIX em segundos (número inteiro)
*   **open** — Preço de abertura (R$)
*   **high** — Preço máximo do dia (R$)
*   **low** — Preço mínimo do dia (R$)
*   **close** — Preço de fechamento (R$)
*   **volume** — Volume negociado (número de cotas)
*   **adjustedClose** — Preço de fechamento ajustado (R$)

### 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, ordem decrescente)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/historical?symbols=HGLG11"

# Histórico em período específico com ordem crescente
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/historical?symbols=MXRF11,KNCR11&startDate=2024-01-01&endDate=2024-12-31&sortOrder=asc"
```

### 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)
- **sortOrder** (query)

### Responses

#### 200

Série histórica OHLCV por FII retornada com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

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


### FiiHistoricalPrice

**Properties:**

- **date** (integer) *(required)*

- **open** (number) *(nullable)* *(required)*

- **high** (number) *(nullable)* *(required)*

- **low** (number) *(nullable)* *(required)*

- **close** (number) *(nullable)* *(required)*

- **volume** (number) *(nullable)* *(required)*

- **adjustedClose** (number) *(nullable)* *(required)*


### FiiHistoricalResponse

**Properties:**

- **fiis** (array) *(required)*
  Array items:
    Reference to: **FiiHistoricalSeries**

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

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


### FiiHistoricalSeries

**Properties:**

- **symbol** (string) *(required)*

- **historicalDataPrice** (array) *(required)*
  Array items:
    Reference to: **FiiHistoricalPrice**