v20

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

Fundos Imobiliários

Obter Indicadores Fundamentalistas

Retorna os indicadores fundamentalistas mais recentes para um ou mais FIIs. Use este endpoint para análises de valuation, rentabilidade e comparações entre fundos.

Funcionalidades:

Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição (separados por vírgula)
Indicadores de Valuation: Preço atual, Valor Patrimonial por Cota (VP/Cota), Preço/VP (P/VP)
Indicadores de Rentabilidade: Dividend Yield 12 meses, Dividend Yield 1 mês, Retorno mensal
Dados de Liquidez: Total de investidores (cotistas), Cotas emitidas, Patrimônio Líquido, Ativo Total
Classificação: Tipo de segmento (Papel, Tijolo, Híbrido, FOF)
Dados do administrador: Nome, CNPJ, endereço, telefones, site e email informados pela CVM

Campos da Resposta:

price — Preço atual da cota (R$)
navPerShare — Valor Patrimonial por Cota (VP/Cota) em R$
priceToNav — Razão Preço/Valor Patrimonial (P/VP) — valores < 1 indicam desconto
dividendYield12m — Dividend Yield acumulado nos últimos 12 meses (%)
dividendYield1m — Dividend Yield do último mês (%)
monthlyReturn — Retorno mensal (%)
totalInvestors — Total de investidores (cotistas) do fundo
sharesOutstanding — Número de cotas emitidas
equity — Patrimônio Líquido (R$)
totalAssets — Ativo Total (R$)
segmentType — Tipo de segmento (papel, tijolo, hibrido, fof)

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:

# Consultar um FII (sem autenticação - teste)
curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11"

# Consultar múltiplos FIIs
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators?symbols=HGLG11,KNCR11,XPLG11"

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/indicators

Query parameters

symbolsstring required

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

Example:HGLG11,MXRF11

Response

Indicadores atuais dos FIIs retornados 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",
      "asOfDate": "2025-12-01 00:00:00+00",
      "price": 9.58,
      "navPerShare": 9.409927,
      "priceToNav": 1.0180738,
      "dividendYield12m": 0.12381,
      "dividendYield1m": 0.009328,
      "monthlyReturn": 0.007876,
      "totalInvestors": 1357621,
      "sharesOutstanding": 460269540,
      "equity": 4331102700,
      "totalAssets": 4375755000,
      "segmentType": "papel",
      "name": "FII MAXI RENDA RL",
      "cnpj": "97521225000125",
      "mandate": null,
      "segmentoAtuacao": "Logística",
      "tipoGestao": "Ativa",
      "administratorName": "BTG PACTUAL SERVICOS FINANCEIROS S/A DTVM",
      "administratorCnpj": "59281253000123",
      "administratorAddress": "Praia de Botafogo",
      "administratorAddressNumber": "501",
      "administratorAddressComplement": "6 Andar",
      "administratorDistrict": "Botafogo",
      "administratorCity": "Rio de Janeiro",
      "administratorState": "RJ",
      "administratorZipCode": "22250040",
      "administratorPhone1": "55 11 3383-3102",
      "administratorPhone2": null,
      "administratorPhone3": null,
      "administratorWebsite": "www.btgpactual.com",
      "administratorEmail": "ri.fundoslistados@btgpactual.com"
    }
  ],
  "requestedAt": "2026-02-08T16:25:18.077Z",
  "took": 47
}