BRbrapi-dev
Fundos Imobiliários

Dividendos de FIIs

Changed on

Rendimentos e amortizações pagos por FIIs. Cada evento traz tipo (label), valor por cota em reais (rate e rawRate), data-com (lastDatePrior), data de pagamento, data de aprovação e ISIN.

Use para calcular dividend yield, montar calendários de rendimentos e somar a renda de uma carteira.

rate está na escala das cotações ajustadas por desdobramentos e grupamentos. Divida por close do histórico para ter o yield. rawRate é o valor pago na data. Some rawRate para calcular a renda recebida.

label é RENDIMENTO ou AMORTIZAÇÃO. Amortização devolve capital e reduz o valor patrimonial da cota. Não some as duas para calcular yield.

Os dados vêm dos informes mensais da CVM e de comunicados dos administradores. Quando a fonte não tem as datas reais, paymentDate e lastDatePrior recebem a data de referência do informe mensal, e remarks indica a origem. A data inicial varia por fundo.

startDate e endDate filtram por paymentDate. Sem startDate, começa 12 meses atrás. Sem endDate, não tem limite final e inclui pagamentos já anunciados com data futura. sortBy aceita paymentDate (padrão), lastDatePrior, approvedOn, rate e symbol.

Plano Pro. Sem token, aceita só symbols com MXRF11 e HGLG11.

get/api/v2/fii/dividends

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/fii/dividends
  • Auth
    HTTP bearer

Query parameters

symbolsstring required

Tickers de FIIs separados por vírgula, até 20. Ex.: HGLG11,MXRF11.

Example:HGLG11,MXRF11
startDatestring

Data inicial no formato YYYY-MM-DD.

Example:2024-01-01
endDatestring

Data final no formato YYYY-MM-DD.

Example:2025-12-31
sortBystring

Campo de ordenação.

Example:referenceDate
sortOrder'asc' | 'desc'

Direção da ordenação.

Example:desc

Response

Rendimentos e amortizações dos FIIs.

requestedAtstring date-time required

Data e hora da requisição em 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",
      "exDate": "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",
      "exDate": "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
}

Changes