v20

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

Fundos Imobiliários

Listar Fundos Imobiliários

Retorna a lista paginada de todos os Fundos de Investimento Imobiliário (FIIs) registrados, com dados do instrumento e indicadores atuais. Ideal para descobrir novos FIIs, comparar rentabilidades e construir carteiras diversificadas.

Funcionalidades:

Filtro por símbolos: Consulte FIIs específicos com symbols=HGLG11,MXRF11
Filtro por CNPJs: Consulte FIIs específicos com cnpjs=11728688000147
Busca por nome ou símbolo: Encontre FIIs rapidamente por texto (ex: "hglg" retorna HGLG11)
Filtros por segmento: Papel (Títulos/CRI), Tijolo (Imóveis físicos), Híbrido (Misto), FOF (Fundo de Fundos)
Filtros por setor: Logística, Shoppings, Escritórios, Lajes Corporativas, Títulos e Val. Mob., Residencial, Hospital, Hotel, Educacional, Híbrido, Multicategoria, Varejo, Outros
Filtros por mandato: Renda, Híbrido, Títulos e Valores Mobiliários, etc.
Filtros por tipo de gestão: Ativa, Definida
Dados do administrador: Nome, CNPJ, endereço, telefones, site e email informados pela CVM
Ordenação flexível: Ordene por qualquer campo (DY, P/VP, Preço, Total de Investidores, etc.)
Paginação: Controle o número de resultados por página

Autenticação:

Este endpoint lista o universo de FIIs e requer um token de API válido. Para testar sem token, filtre por símbolos sandbox com MXRF11 ou HGLG11.

Exemplos de Requisição:

# Listar todos os FIIs (primeiros 20)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list"

# Buscar FIIs específicos por símbolo
curl "https://brapi.dev/api/v2/fii/list?symbols=HGLG11,MXRF11"

# Buscar FII por CNPJ
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?cnpjs=11728688000147"

# Buscar FIIs por nome (ex: HGLG)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?search=hglg"

# Filtrar por setor (Logística) e ordenar por Dividend Yield decrescente
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?segmentoAtuacao=Logística&sortBy=dividendYield12m&sortOrder=desc&limit=10"

# Filtrar por tipo de segmento (Tijolo) e tipo de gestão (Ativa)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&tipoGestao=Ativa&page=1&limit=20"

FIIs Populares:

MXRF11 (Multisegmento), HGLG11 (Logística), KNCR11 (Logística), XPLG11 (Logística), XPML11 (Logística), KNRI11 (Renda), BTLG11 (Logística), VISC11 (Varejo)

Fonte dos Dados:

CVM (Comissão de Valores Mobiliários)

Plano Mínimo: Pro Autenticação: Necessária para listagem completa

get/api/v2/fii/list

Query parameters

pageinteger

Página (começa em 1)

Example:1

limitinteger

Itens por página (sem limite rígido; valores altos como 10000 são aceitos)

Example:20

sortBystring

Campo para ordenação

Example:referenceDate

sortOrder'asc' | 'desc'

Direção da ordenação

Example:desc

symbolsstring

Lista de símbolos de FIIs separados por vírgula. Máximo de 20 símbolos.

Example:HGLG11,MXRF11

cnpjsstring

Lista de CNPJs de FIIs separados por vírgula, com ou sem formatação. Máximo de 20 CNPJs.

Example:11728688000147

searchstring

Buscar por nome, símbolo ou CNPJ

Example:hglg

segmentType'papel' | 'tijolo' | 'hibrido' | 'fof'

Tipo de segmento do indicador

segmentoAtuacaostring

Segmento de atuação (Logística, Shoppings, Escritórios, etc.)

mandatestring

Mandato (Renda, Híbrido, Títulos e Valores Mobiliários, etc.)

tipoGestaostring

Tipo de gestão (Ativa, Definida)

Response

Lista paginada de FIIs com indicadores retornada 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",
      "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",
      "price": 9.58,
      "navPerShare": 9.409927,
      "priceToNav": 1.0180738,
      "dividendYield12m": 0.12381,
      "totalInvestors": 1357621,
      "segmentType": "papel"
    },
    {
      "symbol": "XPML11",
      "name": "XP MALLS FII",
      "cnpj": "28757546000100",
      "mandate": null,
      "segmentoAtuacao": "Shoppings",
      "tipoGestao": "Ativa",
      "administratorName": "XP INVESTIMENTOS CCTVM S.A.",
      "administratorCnpj": "02332886000104",
      "administratorAddress": "Avenida Afranio de Melo Franco",
      "administratorAddressNumber": "290",
      "administratorAddressComplement": "Sala 606",
      "administratorDistrict": "Leblon",
      "administratorCity": "Rio de Janeiro",
      "administratorState": "RJ",
      "administratorZipCode": "22430060",
      "administratorPhone1": "55 21 3265-3700",
      "administratorPhone2": null,
      "administratorPhone3": null,
      "administratorWebsite": "www.xpi.com.br",
      "administratorEmail": "adm.fundos@xpi.com.br",
      "price": 110.37,
      "navPerShare": 108.160446,
      "priceToNav": 1.0204285,
      "dividendYield12m": 0.100098,
      "totalInvestors": 633076,
      "segmentType": "tijolo"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 2,
    "totalItems": 1545,
    "totalPages": 773,
    "hasNextPage": true
  },
  "requestedAt": "2026-02-08T16:26:20.498Z",
  "took": 4
}