Histórico de rendimentos e amortizações pagos por um ou mais FIIs. Recorte o
período com startDate e endDate, e ordene com sortBy e sortOrder.
Aceita até 20 símbolos separados por vírgula.
Rendimento e amortização não são a mesma coisa. Rendimento é a distribuição mensal do resultado. Amortização devolve capital e reduz o valor patrimonial da cota. Somar os dois infla o yield que você calcula.
Plano mínimo: Pro. No sandbox sem token, aceita apenas symbols=MXRF11
e/ou HGLG11.
Os eventos vêm dos relatórios mensais da CVM e dos comunicados de administradores e gestores. Lacunas antigas podem ser preenchidas por bases públicas, sempre depois de validação cruzada.
A revisão acontece todo mês, depois das novas distribuições. Correções extraordinárias entram assim que aparece uma inconsistência.
Não existe um histórico mínimo universal. A data inicial depende do primeiro evento com valor e datas verificáveis para cada fundo. O plano Pro libera o acesso ao conjunto disponível, mas não garante dados desde a criação de todos os FIIs.
Eventos com data-com e data de pagamento reais têm prioridade sobre a referência mensal da CVM. Renomes de ticker são consolidados no código atual e duplicidades saem da base.
A brapi não aplica deslocamento fixo para estimar data de pagamento. FIIs não
têm padrão: o intervalo entre a data-com e o pagamento varia de 4 a 14 dias
entre fundos, então um offset fixo produziria datas erradas. Quando a data real
não existe na fonte, remarks diz de onde o registro veio.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
Data de início no formato YYYY-MM-DD
Data de fim no formato YYYY-MM-DD
Campo para ordenação
Direção da ordenação
"desc"Value in
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/fii/dividends?symbols=HGLG11%2CMXRF11"{ "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}