Fundos Imobiliários (FIIs)

A API de FIIs foi desenhada para cobrir os principais casos de uso do mercado de fundos imobiliários brasileiros:

1. listar FIIs com filtros por segmento, gestão e setor
2. consultar indicadores atuais (P/VP, DY, vacância, patrimônio)
3. acompanhar a evolução mensal dos indicadores
4. pegar cotações históricas (OHLCV)
5. acessar relatórios gerenciais mensais da CVM
6. consultar o histórico de dividendos e rendimentos

Cobertura e frequência

• Indicadores: atualizados diariamente após o fechamento do pregão.
• Relatórios CVM: importados mensalmente conforme publicação pela CVM.
• Dividendos: consolidados a partir dos relatórios mensais.
• Cotações históricas: OHLCV diário, mesmo formato dos demais ativos.
• Fuso horário: America/Sao_Paulo. Campos de data em respostas seguem formato ISO 8601 ou timestamp Unix.
• Formato de datas em query params: YYYY-MM-DD.

Acesso por plano

Dados detalhados de FIIs fazem parte do plano Pro. O sandbox permite experimentação sem token para MXRF11 e HGLG11.

Termos que você vai ver

• Segmento (segmentType): classificação patrimonial do FII — papel, tijolo, híbrido ou fof (fundo de fundos).
• Segmento de atuação (segmentoAtuacao): setor do mercado imobiliário. Ex.: Logística, Shoppings, Lajes Corporativas, Títulos e Val. Mob..
• Tipo de gestão (tipoGestao): Ativa ou Definida (passiva).
• Mandato (mandate): perfil de investimento — Renda, Ganho de Capital ou Híbrido.
• P/VP (priceToNav): preço de mercado dividido pelo valor patrimonial por cota. Abaixo de 1 indica desconto.
• Dividend Yield (dividendYield12m): rendimento dos últimos 12 meses em relação ao preço atual.
• Vacância: percentual de imóveis desocupados (relevante para FIIs de tijolo).
• Relatório gerencial: documento mensal enviado à CVM com composição patrimonial, rentabilidade e dados operacionais.

Início rápido

Exemplo completo do fluxo listagem → indicadores → dividendos para FIIs.

# 1) Liste FIIs de logística
curl "https://brapi.dev/api/v2/fii/list?segmentoAtuacao=Logística&limit=5"

# 2) Consulte indicadores de um FII específico
curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11"

# 3) Veja o histórico de dividendos
curl "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11"

const BASE = 'https://brapi.dev/api/v2/fii';
const token = process.env.BRAPI_TOKEN; // dispensável para MXRF11/HGLG11

const headers = token ? { Authorization: `Bearer ${token}` } : undefined;

// 1) Listagem com filtro por segmento
const list = await fetch(
  `${BASE}/list?segmentoAtuacao=Logística&limit=5`,
  { headers },
).then((r) => r.json());

// 2) Indicadores atuais
const indicators = await fetch(
  `${BASE}/indicators?symbols=MXRF11,HGLG11`,
  { headers },
).then((r) => r.json());

// 3) Histórico de dividendos
const dividends = await fetch(
  `${BASE}/dividends?symbols=MXRF11`,
  { headers },
).then((r) => r.json());

console.log({ list, indicators, dividends });

import os
import requests

BASE = "https://brapi.dev/api/v2/fii"
token = os.getenv("BRAPI_TOKEN")  # dispensável para MXRF11/HGLG11
headers = {"Authorization": f"Bearer {token}"} if token else {}

# 1) Listagem com filtro por segmento
fii_list = requests.get(
    f"{BASE}/list",
    params={"segmentoAtuacao": "Logística", "limit": 5},
    headers=headers,
).json()

# 2) Indicadores atuais
indicators = requests.get(
    f"{BASE}/indicators",
    params={"symbols": "MXRF11,HGLG11"},
    headers=headers,
).json()

# 3) Histórico de dividendos
dividends = requests.get(
    f"{BASE}/dividends",
    params={"symbols": "MXRF11"},
    headers=headers,
).json()

print(fii_list, indicators, dividends)

Fluxo recomendado

Casos de uso mais comuns

• Tela de screening de FIIs: list com filtros → exibir indicadores
• Dashboard de acompanhamento: indicators para dados atuais + indicators/history para evolução
• Análise de dividendos: dividends para histórico de rendimentos
• Gráfico de preço: historical para OHLCV diário
• Due diligence: reports para relatórios CVM + indicators para snapshot atual
• Comparação entre FIIs: indicators com múltiplos symbols (até 20 por request)

Quando você pode pular etapas

• Se você já sabe o ticker, pode ir direto para indicators, historical, dividends ou reports.
• Se você quer só listar e filtrar, use list sem precisar dos outros endpoints.
• Se você quer só dividendos, pode ir direto para dividends com o ticker.

Perguntas frequentes

Receitas prontas

Guias e tutoriais publicados no blog com código pronto para copiar:

Sandbox sem token

Para facilitar a experimentação, todos os endpoints de FIIs aceitam consultas no sandbox sem token, restritas a MXRF11 e HGLG11:

• GET /api/v2/fii/list: funciona sem token (listagem geral).
• GET /api/v2/fii/indicators, /indicators/history, /historical, /reports, /dividends: apenas com symbols contendo exclusivamente MXRF11 e/ou HGLG11.

Para qualquer outro FII, é necessário autenticar com um token do plano Pro.

Endpoints