Indicadores, dividendos, relatórios da CVM, imóveis e carteira dos fundos imobiliários brasileiros.
MXRF11 e HGLG11 respondem sem token. Cole no terminal:
curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11"| Você quer | Endpoint |
|---|---|
| Montar um screener | /api/v2/fii/list |
| P/VP, dividend yield, patrimônio | /api/v2/fii/indicators |
| Rendimentos e amortizações | /api/v2/fii/dividends |
| Preço histórico da cota | /api/v2/fii/historical |
| Relatório mensal da CVM | /api/v2/fii/reports |
| Imóveis e vacância | /api/v2/fii/properties |
| Carteira: CRIs, cotas, terrenos | /api/v2/fii/portfolio |
| Demonstrações auditadas | /api/v2/fii/financials |
| Informe anual | /api/v2/fii/annual-reports |
Indicadores, imóveis e carteira também têm versão histórica: indicadores, imóveis e carteira.
Se você já sabe o ticker, vá direto ao endpoint. Todos aceitam symbols sem
passar pela listagem antes.
Nem todo ticker terminado em 11 é FII. JURO11 é FI-Infra e sai em
/api/v2/funds/*, junto com FIAGRO, FIDC e FIP.
Os endpoints /api/v2/fii/* são do plano Pro. Sem token, eles respondem quando
symbols contém apenas MXRF11 e HGLG11.
Cotação básica de FII (preço e variação) funciona em qualquer plano por
/api/quote/MXRF11. O que o plano Pro abre é o dado detalhado: P/VP, vacância,
carteira e relatórios.
Cada chamada aceita até 20 símbolos separados por vírgula, e isso gasta uma requisição, não vinte.
| Dado | Atualização |
|---|---|
| Indicadores e cotações | Diária, após o fechamento do pregão |
| Relatórios da CVM e dividendos | Mensal, conforme a publicação |
| Carteira e imóveis | Trimestral, pelos informes da CVM |
Um informe trimestral de março só aparece meses depois. Se o seu produto mostra
vacância, deixe o referenceDate visível para o usuário não achar que é o dado
de hoje.
O fuso é America/Sao_Paulo. Datas em query params usam YYYY-MM-DD.
| Campo | O que significa |
|---|---|
segmentType | O que o fundo tem: papel (CRI e títulos), tijolo (imóveis), hibrido ou fof (cotas de outros FIIs) |
segmentoAtuacao | Setor do imóvel: Logística, Shoppings, Lajes Corporativas, Títulos e Val. Mob. e outros |
tipoGestao | Ativa quando o gestor compra e vende, Definida quando a carteira é fixa |
mandate | Objetivo do fundo: Renda, Ganho de Capital ou Híbrido |
priceToNav | Preço da cota dividido pelo valor patrimonial. Abaixo de 1 é desconto |
dividendYield12m | Distribuições dos últimos 12 meses sobre o preço atual |
Vacância é a fatia dos imóveis desocupados e só faz sentido em fundo de tijolo.
Tipos de FII, indicadores e como consultar cada um pela API.
Framework de análise, diversificação e monitoramento de carteira de FIIs.
O que muda entre FIIs de papel e de tijolo, com dados da API.
Como filtrar FIIs por P/VP, DY e segmento com list e indicators.
Como analisar composição patrimonial, taxas e rentabilidade via /reports.
Construa um calendário de rendimentos com projeções e exporte para Google Calendar.