---
title: "Obter Cotações Históricas (OHLCV)"
method: GET
path: "/api/v2/fii/historical"
tags: ["Fundos Imobiliários"]
---

# Obter Cotações Históricas (OHLCV)

`GET /api/v2/fii/historical`

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)

## 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
- `sortOrder` 'asc' | 'desc' — Direção da ordenação por data

## Response `200`

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

- FiiHistoricalResponse
  - `fiis` FiiHistoricalSeries[], required
    - `symbol` string, required
    - `historicalDataPrice` FiiHistoricalPrice[], required
      - `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
  - `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
- `404` — Não encontrado
- `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)