v20

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

Fundos Imobiliários

Obter Histórico de Proventos

Retorna o histórico de pagamentos de proventos (Rendimentos, Amortizações) dos FIIs. Analise a rentabilidade histórica e padrões de distribuição de cada fundo.

Funcionalidades:

Histórico completo: Rendimentos e amortizações desde a criação do fundo
Múltiplos FIIs: Consulte até 20 FIIs em uma única requisição
Filtro por período: Especifique startDate e endDate (padrão: últimos 12 meses)
Ordenação: Ordene por data de pagamento, taxa, data de aprovação, etc.
Tipos de proventos: Rendimentos (distribuições mensais) e Amortizações (devolução de capital)

Campos da Resposta:

symbol — Ticker do FII
label — Tipo do provento (RENDIMENTO, AMORTIZAÇÃO)
rate — Valor por cota distribuído (R$)
paymentDate — Data efetiva de pagamento quando disponível; quando a data real não estiver disponível, pode usar a data de referência informada pela CVM
lastDatePrior — Data-com (último dia para ter direito ao provento)
approvedOn — Data de aprovação do provento
relatedTo — Período relacionado (quando aplicável)
isinCode — Código ISIN (quando aplicável)
remarks — Observações sobre a origem do registro, quando aplicável

Importante:

Quando disponível, paymentDate representa a data efetiva de pagamento. Para alguns fundos e períodos, a CVM informa apenas a data de referência do relatório; nesses casos, paymentDate pode coincidir com essa referência.

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:

# Histórico de proventos dos últimos 12 meses
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/dividends?symbols=HGLG11"

# Histórico em período específico, ordenado por data decrescente
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11,KNCR11&startDate=2023-01-01&endDate=2024-12-31&sortBy=paymentDate&sortOrder=desc"

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

Query parameters

symbolsstring required

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

Example:HGLG11,MXRF11

startDatestring

Data de início no formato YYYY-MM-DD

Example:2024-01-01

endDatestring

Data de fim no formato YYYY-MM-DD

Example:2025-12-31

sortBystring

Campo para ordenação

Example:referenceDate

sortOrder'asc' | 'desc'

Direção da ordenação

Example:desc

Response

Histórico de rendimentos dos FIIs retornado 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

{
  "dividends": [
    {
      "symbol": "MXRF11",
      "approvedOn": null,
      "label": "RENDIMENTO",
      "lastDatePrior": "2025-12-01 00:00:00+00",
      "paymentDate": "2025-12-01 00:00:00+00",
      "rate": 0.08941643,
      "relatedTo": null,
      "isinCode": null,
      "remarks": "backfilled from FiiMonthlyReports"
    },
    {
      "symbol": "MXRF11",
      "approvedOn": null,
      "label": "RENDIMENTO",
      "lastDatePrior": "2025-11-01 00:00:00+00",
      "paymentDate": "2025-11-01 00:00:00+00",
      "rate": 0.098144606,
      "relatedTo": null,
      "isinCode": null,
      "remarks": "backfilled from FiiMonthlyReports"
    }
  ],
  "requestedAt": "2026-02-08T16:25:19.026Z",
  "took": 23
}