Sim — e em vários aspectos a cobertura de FIIs é tão profunda quanto a de
ações. Com a família de endpoints /api/v2/fii/* (lançada como produto
dedicado, separado do /api/quote/), a brapi entrega indicadores
fundamentalistas, relatórios gerenciais da CVM, histórico de rendimentos e
cotações OHLCV diárias.
Endpoints dedicados a FIIs
| Endpoint | O que entrega |
|---|---|
GET /api/v2/fii/list | Listagem com filtros por segmento, gestão e setor |
GET /api/v2/fii/indicators | P/VP, DY 12m e 1m, retorno mensal, patrimônio, cotistas, administrador |
GET /api/v2/fii/indicators/history | Evolução mensal dos indicadores acima |
GET /api/v2/fii/historical | OHLCV diário (open, high, low, close, volume) |
GET /api/v2/fii/reports | Relatórios mensais CVM com composição patrimonial |
GET /api/v2/fii/dividends | Histórico de rendimentos e amortizações |
Documentação completa em /docs/fiis.
O que está disponível para cada FII
| Dado | Disponibilidade | Endpoint |
|---|---|---|
| Cotações em tempo real | ✅ | /api/quote/HGLG11 |
| Histórico OHLCV diário | ✅ | /api/v2/fii/historical |
| Histórico de dividendos/rendimentos | ✅ | /api/v2/fii/dividends |
| Dividend Yield 12m e 1m | ✅ | /api/v2/fii/indicators |
| P/VP (Preço/Valor Patrimonial) | ✅ | /api/v2/fii/indicators |
| Valor Patrimonial por Cota (NAV) | ✅ | /api/v2/fii/indicators |
| Patrimônio líquido e ativos totais | ✅ | /api/v2/fii/indicators |
| Número de cotistas | ✅ | /api/v2/fii/indicators |
| Cotas em circulação | ✅ | /api/v2/fii/indicators |
| Composição patrimonial (CRI, LCI, imóveis, fundos) | ✅ | /api/v2/fii/reports |
| Taxa de administração | ✅ | /api/v2/fii/reports |
| Retorno patrimonial mensal | ✅ | /api/v2/fii/reports |
| Passivos e obrigações | ✅ | /api/v2/fii/reports |
| Administrador (nome, CNPJ, contato) | ✅ | /api/v2/fii/list e /indicators |
| Filtro por segmento (papel/tijolo/híbrido/fof) | ✅ | /api/v2/fii/list |
| Filtro por setor (Logística, Shoppings, Lajes...) | ✅ | /api/v2/fii/list |
Exemplo de Requisição
Indicadores fundamentalistas de um FII:
curl "https://brapi.dev/api/v2/fii/indicators?symbols=HGLG11"Resposta:
{
"fiis": [
{
"symbol": "HGLG11",
"asOfDate": "2025-03-31",
"price": 156.05,
"navPerShare": 171.48,
"priceToNav": 0.91,
"dividendYield12m": 0.0843,
"dividendYield1m": 0.0072,
"monthlyReturn": -0.0032,
"totalInvestors": 488272,
"sharesOutstanding": 53850000,
"equity": 9232380000.00,
"totalAssets": 10147254000.00,
"segmentType": "tijolo",
"segmentoAtuacao": "Logística",
"adminName": "Credit Suisse Hedging-Griffo Cor. de Valores S.A.",
"managerName": "CSHG Logística Fundo de Invest. Imob."
}
]
}Relatórios da CVM completos
Diferente do /api/quote/, que entrega cotação básica, o endpoint
/api/v2/fii/reports traz a composição patrimonial detalhada do relatório
gerencial mensal enviado à CVM:
- Imóveis físicos, CRI, LCI, cotas de FIIs, recebíveis, caixa
- Rentabilidade mensal patrimonial e da cota
- Dividend Yield mensal
- Taxa de administração e amortização
- Passivos (distribuições a pagar, obrigações imobiliárias)
Acesso por plano
| Plano | Cotações básicas (/api/quote/) | Endpoints /api/v2/fii/* |
|---|---|---|
| Sandbox (sem token) | ✅ | ✅ Apenas MXRF11 e HGLG11 |
| Free | ✅ | ❌ |
| Startup | ✅ | ❌ |
| Pro | ✅ | ✅ Todos os FIIs |
Para testar antes de assinar, use o sandbox com MXRF11 ou HGLG11 sem precisar de token.
FIIs cobertos
Mais de 1.500 FIIs ativos no mercado brasileiro, incluindo todos os mais negociados:
- Logística: HGLG11, BTLG11, XPLG11, LVBI11
- Shoppings: XPML11, VISC11, HGBS11
- Lajes Corporativas: HGRE11, RCRB11, BRCR11
- Papel/CRI: MXRF11, KNCR11, IRDM11, KNIP11
- Híbridos / FoF: BCFF11, KNRI11, RBRF11
Comece agora
A Brapi oferece planos personalizados para grandes volumes?
Conheça as opções de planos Enterprise da brapi para empresas com grandes volumes de requisições ou necessidades específicas de dados financeiros.
A API da brapi: Gratuita ou Paga?
A API da brapi: Gratuidade versus Planos Pagos. Descubra como começar gratuitamente e explore nossos serviços. Escolha entre os planos 'Startup' e 'Pro' para recursos adicionais, maior capacidade de requisições. Ideal para empresas e projetos de diferentes tamanhos. Assine agora!