BRbrapi-dev
Ações

Dividendos de ações

Changed on

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.

get/api/v2/stocks/dividends

Request

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

Query parameters

symbolsstring required

Tickers separados por vírgula. Ex.: PETR4,VALE3. requestedSymbol identifica o ticker enviado e symbol identifica os dados retornados.

Example:PETR4,VALE3
startDatestring

Data inicial no formato YYYY-MM-DD. Filtra proventos em dinheiro por paymentDate e eventos em ações por lastDatePrior.

Example:2024-01-01
endDatestring

Data final no formato YYYY-MM-DD. Filtra proventos em dinheiro por paymentDate e eventos em ações por lastDatePrior.

Example:2024-12-31
sortBy'paymentDate' | 'lastDatePrior' | 'approvedOn' | 'rate'

Campo de ordenação dos eventos.

Example:paymentDate
sortOrder'asc' | 'desc'

Ordem dos eventos.

Example:desc
includeRaw'true' | 'false'

Inclui rawRate, o valor por ação na escala dos preços sem ajuste. Exige o plano Pro.

Example:true

Response

Dividendos recuperados com sucesso.

requestedAtstring date-time required

Data e hora da requisição em ISO 8601.

tookinteger required

Tempo de processamento, em milissegundos.

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",
            "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
}

Changes

  • dae9d382e9b7Revision changes
    • info

      added the optional property ///// to the response with the status

  • 62eafb05acb0Revision changes
    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status