Ações
Dividendos v2 de ações
Retorna dividendos, JCP e eventos de ações para tickers B3 stock-like.
Este endpoint substitui o uso de /api/quote/{tickers}?dividends=true para novas integrações que precisam apenas de proventos de ações. Para rendimentos de FIIs, use /api/v2/fii/dividends, que possui uma fonte e semântica específicas para FIIs.
get/api/v2/stocks/dividends
Query parameters
symbolsstring required
Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.
Example:PETR4,VALE3
startDatestring
Data inicial em YYYY-MM-DD. Filtra por paymentDate/ex-date.
Example:2024-01-01
endDatestring
Data final em YYYY-MM-DD. Filtra por paymentDate/ex-date.
Example:2024-12-31
sortBy'paymentDate' | 'lastDatePrior' | 'approvedOn' | 'rate'
Campo usado para ordenar eventos.
Example:paymentDate
sortOrder'asc' | 'desc'
Ordenação dos eventos.
Example:desc
Response
Dividendos recuperados com sucesso.
Example response
{
"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
}