v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Fundos Imobiliários

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:

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

get/api/v2/fii/historical

Query parameters

symbolsstring required

Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11

Example:HGLG11,MXRF11

startDatestring

Data de início no formato YYYY-MM-DD

Example:2024-01-01

endDatestring

Data de fim no formato YYYY-MM-DD

Example:2025-12-31

sortOrder'asc' | 'desc'

Direção da ordenação por data

Example:desc

Response

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

requestedAtstring date-time required

Data e hora da requisição em formato ISO 8601

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "fiis": [
    {
      "symbol": "MXRF11",
      "historicalDataPrice": [
        {
          "date": 1736478000,
          "open": 9.33,
          "high": 9.37,
          "low": 9.3,
          "close": 9.35,
          "volume": 1027483,
          "adjustedClose": 8.3454485
        },
        {
          "date": 1736391600,
          "open": 9.42,
          "high": 9.44,
          "low": 9.29,
          "close": 9.33,
          "volume": 1203345,
          "adjustedClose": 8.327598
        },
        {
          "date": 1736305200,
          "open": 9.44,
          "high": 9.47,
          "low": 9.34,
          "close": 9.42,
          "volume": 1558708,
          "adjustedClose": 8.407928
        }
      ]
    }
  ],
  "requestedAt": "2026-02-08T16:25:22.456Z",
  "took": 8
}