---
title: "Obter Indicadores Fundamentalistas"
method: GET
path: "/api/v2/fii/indicators"
tags: ["Fundos Imobiliários"]
---

# Obter Indicadores Fundamentalistas

`GET /api/v2/fii/indicators`

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:
```bash
# 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)

## Query parameters

- `symbols` string, required — Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11

## Response `200`

Indicadores atuais dos FIIs retornados com sucesso.

- FiiIndicatorsResponse
  - `fiis` FiiIndicatorWithInfo[], required
    - `symbol` string, required
    - `asOfDate` string, nullable, required
    - `price` number, nullable, required
    - `navPerShare` number, nullable, required
    - `priceToNav` number, nullable, required
    - `dividendYield12m` number, nullable, required
    - `dividendYield1m` number, nullable, required
    - `monthlyReturn` number, nullable, required
    - `totalInvestors` number, nullable, required
    - `sharesOutstanding` number, nullable, required
    - `equity` number, nullable, required
    - `totalAssets` number, nullable, required
    - `segmentType` string, nullable, required
    - `name` string, nullable, required
    - `cnpj` string, nullable, required
    - `mandate` string, nullable, required
    - `segmentoAtuacao` string, nullable, required
    - `tipoGestao` string, nullable, required
    - `administratorName` string, nullable, required
    - `administratorCnpj` string, nullable, required
    - `administratorAddress` string, nullable, required
    - `administratorAddressNumber` string, nullable, required
    - `administratorAddressComplement` string, nullable, required
    - `administratorDistrict` string, nullable, required
    - `administratorCity` string, nullable, required
    - `administratorState` string, nullable, required
    - `administratorZipCode` string, nullable, required
    - `administratorPhone1` string, nullable, required
    - `administratorPhone2` string, nullable, required
    - `administratorPhone3` string, nullable, required
    - `administratorWebsite` string, nullable, required
    - `administratorEmail` string, nullable, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `404` — Não encontrado
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)