Fundos Imobiliários (FIIs)

Use a API de FIIs para criar screeners, dashboards, análises de dividendos e fluxos de due diligence para fundos imobiliários brasileiros.

O fluxo mais comum é:

1. descobrir FIIs com listagem e filtros
2. consultar indicadores atuais como P/VP, DY e patrimônio
3. acompanhar histórico de preço, indicadores e dividendos
4. abrir relatórios CVM, imóveis, vacância e carteira

Cobertura e frequência

• Indicadores: atualizados diariamente após o fechamento do pregão.
• Relatórios CVM: importados mensalmente conforme publicação pela CVM.
• Carteira e imóveis: importados dos informes trimestrais da 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, hibrido 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 do fluxo listagem → indicadores → dividendos usando os tickers do sandbox.

# 1) Busque um FII disponível no sandbox
curl "https://brapi.dev/api/v2/fii/list?symbols=MXRF11&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; // opcional para MXRF11/HGLG11 no sandbox
const headers = token ? { Authorization: `Bearer ${token}` } : undefined;

// 1) Listagem com ticker do sandbox
const list = await fetch(
  `${BASE}/list?symbols=MXRF11&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")  # opcional para MXRF11/HGLG11 no sandbox
headers = {"Authorization": f"Bearer {token}"} if token else {}

# 1) Listagem com ticker do sandbox
fii_list = requests.get(
    f"{BASE}/list",
    params={"symbols": "MXRF11", "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
• Vacância de FIIs de tijolo: properties para imóveis físicos e properties/history para evolução trimestral
• Carteira detalhada: portfolio para FoFs, CRIs e composição normalizada; portfolio/history para evolução de alocação
• 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, reports, properties, properties/history, portfolio ou portfolio/history.
• 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, os endpoints de FIIs por símbolo aceitam consultas no sandbox sem token, restritas a MXRF11 e HGLG11:

• GET /api/v2/fii/list: requer token Pro para listar todos os FIIs; sem token, funciona apenas com symbols=MXRF11 e/ou symbols=HGLG11.
• GET /api/v2/fii/indicators, /indicators/history, /historical, /reports, /properties, /properties/history, /portfolio, /portfolio/history e /dividends: funcionam sem token apenas com symbols contendo exclusivamente MXRF11 e/ou HGLG11.

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

Endpoints