Proventos de ações brasileiras: dividendos, JCP, bonificações, desdobramentos, grupamentos e subscrições, com valor por ação, data-com, data ex e data de pagamento.
Use para calcular dividend yield, montar calendários de proventos e registrar proventos em carteiras.
Em conversões de ações, os proventos de cada classe permanecem separados. Uma consulta por AXIA6 retorna os proventos de AXIA6 e ELET6.
Os proventos de LCAM3 e BRFS3 permanecem separados de RENT3 e MBRF3. PRGA3 usa BRFS3. MRFG3 usa MBRF3.
Os proventos disponíveis podem ser consultados mesmo quando o ticker não tem cotação atual.
lastDatePrior é a data-com, o último dia para comprar a ação e ter direito ao provento. exDate é a data ex, o primeiro dia sem esse direito. exDate pode ser nulo.
startDate e endDate filtram proventos em dinheiro por paymentDate e eventos em ações por lastDatePrior.
includeRaw=true exige o plano Pro. Ele adiciona rawRate, o valor por ação na escala dos preços sem ajuste.
FIIs não entram aqui. Um ticker de FII retorna erro 400. Use dividendos de FIIs.
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Tickers separados por vírgula. Ex.: PETR4,VALE3. requestedSymbol identifica o ticker enviado e symbol identifica os dados retornados.
Data inicial no formato YYYY-MM-DD. Filtra proventos em dinheiro por paymentDate e eventos em ações por lastDatePrior.
Data final no formato YYYY-MM-DD. Filtra proventos em dinheiro por paymentDate e eventos em ações por lastDatePrior.
Campo de ordenação dos eventos.
"paymentDate"Value in
Ordem dos eventos.
"desc"Value in
Inclui rawRate, o valor por ação na escala dos preços sem ajuste. Exige o plano Pro.
Value in
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/stocks/dividends?symbols=PETR4%2CVALE3"{ "results": [ { "requestedSymbol": "ITSA4", "symbol": "ITSA4", "changed": false, "data": { "cashDividends": [ { "assetIssued": "BRITSAACNPR7", "paymentDate": "2026-10-01T03:00:00.000Z", "rate": 0.024242, "relatedTo": "", "approvedOn": null, "isinCode": "BRITSAACNPR7", "label": "JCP", "lastDatePrior": "2026-08-31T03:00:00.000Z", "exDate": "2026-08-31T03:00:00.000Z", "remarks": "" } ], "stockDividends": [ { "assetIssued": "BRITSAACNPR7", "factor": 1.02, "completeFactor": "1,02 para 1", "approvedOn": "2025-12-15T03:00:00.000Z", "isinCode": "BRITSAACNPR7", "label": "BONIFICACAO", "lastDatePrior": "2025-12-18T03:00:00.000Z", "exDate": "2025-12-18T03:00:00.000Z", "remarks": "" } ], "subscriptions": [] } } ], "requestedAt": "2026-06-14T05:03:16.000Z", "took": 203}