Dividendos de Ações
Endpoint para buscar dividendos, JCP e eventos de ações de um ou mais tickers B3 stock-like. Use quando você precisa apenas de proventos, sem carregar cotação, histórico ou módulos financeiros.
Este endpoint é para ações e instrumentos stock-like. Rendimentos de FIIs
continuam no endpoint dedicado /api/v2/fii/dividends, que tem fonte e
semântica próprias para FIIs.
Tickers antigos são resolvidos para o ticker atual quando houver renome
conhecido, e a resposta inclui requestedSymbol, symbol e changed.
Authorization
Bearer Token de API obtido no dashboard em brapi.dev/dashboard
In: header
Query Parameters
Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.
Data inicial em YYYY-MM-DD. Filtra por paymentDate/ex-date.
Data final em YYYY-MM-DD. Filtra por paymentDate/ex-date.
Campo usado para ordenar eventos.
"paymentDate""paymentDate" | "lastDatePrior" | "approvedOn" | "rate"Ordenação dos eventos.
"desc""asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://brapi.dev/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",
"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",
"remarks": ""
}
],
"subscriptions": []
}
}
],
"requestedAt": "2026-06-14T05:03:16.000Z",
"took": 203
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Token de autenticação inválido ou ausente",
"code": "UNAUTHORIZED"
}{
"error": true,
"message": "Você não tem permissão para acessar este recurso",
"code": "FORBIDDEN"
}{
"error": true,
"message": "Recurso não encontrado",
"code": "NOT_FOUND"
}{
"error": true,
"message": "Limite de requisições excedido. Tente novamente mais tarde.",
"code": "RATE_LIMIT_EXCEEDED"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}