--- title: "Dividendos de ações" method: GET path: "/api/v2/stocks/dividends" tags: ["Ações"] --- # Dividendos de ações `GET /api/v2/stocks/dividends` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/stocks/dividends` - Auth: HTTP bearer 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](https://brapi.dev/docs/fiis/dividendos). ## Query parameters - `symbols` string, required: Tickers separados por vírgula. Ex.: PETR4,VALE3. `requestedSymbol` identifica o ticker enviado e `symbol` identifica os dados retornados. - `startDate` string: Data inicial no formato YYYY-MM-DD. Filtra proventos em dinheiro por `paymentDate` e eventos em ações por `lastDatePrior`. - `endDate` string: Data final no formato YYYY-MM-DD. Filtra proventos em dinheiro por `paymentDate` e eventos em ações por `lastDatePrior`. - `sortBy` 'paymentDate' | 'lastDatePrior' | 'approvedOn' | 'rate': Campo de ordenação dos eventos. - `sortOrder` 'asc' | 'desc': Ordem dos eventos. - `includeRaw` 'true' | 'false': Inclui `rawRate`, o valor por ação na escala dos preços sem ajuste. Exige o plano Pro. ## Response `200` Dividendos recuperados com sucesso. - StockDividendsResponse - `results` StockDividendsSeries[], required - `requestedSymbol` string, required: Ticker enviado na requisição. - `symbol` string, required: Ticker usado para os dados retornados. - `changed` boolean, required: `true` quando `symbol` difere de `requestedSymbol`. - `data` DividendsData, required: Proventos. Na rota `/api/quote/{tickers}`, vem com `dividends=true`. Na rota `/api/v2/stocks/dividends`, não exige esse parâmetro. - `cashDividends` object[], required: Dividendos e JCP pagos em dinheiro. - `assetIssued` string, required: Código ISIN do ativo que dá direito ao provento. - `paymentDate` string, nullable, required: Data de pagamento. - `paymentDateIsDeadline` boolean, required: `true` quando a empresa informou só o prazo máximo do pagamento ("até 31/12/2026"). Nesse caso, `paymentDate` é o prazo e muda quando a empresa divulgar a data. - `verified` boolean, required: `true` quando o provento foi conferido em um documento publicado pela empresa ou pelo fundo. `false` quando vem de dados históricos que ainda não têm esse documento. - `rate` number, required: Valor por ação, em reais, na escala das cotações ajustadas por desdobramentos, grupamentos e bonificações (`close` do histórico). Um provento anterior a um desdobramento de 1 para 5 aparece dividido por 5. Em BDRs, o valor líquido por BDR, já sem o imposto no exterior, o IOF e a taxa da instituição depositária. - `rawRate` number, nullable: Valor pago por ação na data do provento, na escala dos preços sem ajuste. Vem com `includeRaw=true`. - `relatedTo` string, required: Período a que o provento se refere. Ex.: 1º Trimestre/2024. - `approvedOn` string, nullable, required: Data de aprovação. - `isinCode` string, required: Código ISIN. - `label` string, required: Tipo do provento: DIVIDENDO ou JCP. - `lastDatePrior` string, nullable, required: Data-com, o último dia para comprar o ativo e ter direito ao provento. - `exDate` string, nullable, required: Data ex, o primeiro dia sem direito ao provento. Pode ser nulo. - `remarks` string, required: Observações. - `bdr` object: Só em BDRs: o provento no exterior e os descontos até chegar em `rate`. Campos não informados no aviso vêm nulos. - `currency` string, nullable, required: Moeda do provento no exterior. Ex.: USD. - `grossPerShare` number, nullable, required: Valor bruto por ação no exterior, na moeda do provento. - `ratio` string, nullable, required: Ações no exterior para BDRs. Ex.: "1:4" quando 1 ação equivale a 4 BDRs. - `grossPerBdr` number, nullable, required: Valor bruto por BDR, na moeda do provento. - `fxRate` number, nullable, required: Câmbio usado na conversão para reais. - `fxDate` string, nullable, required: Data do câmbio (AAAA-MM-DD). - `grossBrlPerBdr` number, nullable, required: Valor por BDR em reais, antes dos descontos no Brasil. - `withholdingTaxPercent` number, nullable, required: Imposto retido no exterior, em %. - `iofPercent` number, nullable, required: IOF sobre o câmbio, em %. - `depositaryFeePercent` number, nullable, required: Taxa da instituição depositária, em % do provento. - `final` boolean, nullable, required: `false` enquanto o valor é uma estimativa. `true` quando é o valor definitivo. - `stockDividends` object[], required: Eventos em ações: desdobramentos, grupamentos e bonificações. - `assetIssued` string, required: Código ISIN do ativo que dá direito ao provento. - `factor` number, required: Fator do evento. Ex.: 2 em um desdobramento de 2 para 1. - `completeFactor` string, required: Fator em texto. Ex.: 2 para 1. - `approvedOn` string, nullable, required: Data de aprovação. - `isinCode` string, required: Código ISIN. - `label` string, required: Tipo do evento: DESDOBRAMENTO, GRUPAMENTO ou BONIFICAÇÃO. - `lastDatePrior` string, nullable, required: Data-com, o último dia para comprar o ativo e ter direito ao evento. - `exDate` string, nullable, required: Data ex, o primeiro dia sem direito ao evento. Pode ser nulo. - `remarks` string, required: Observações. - `subscriptions` unknown[], required: Direitos de subscrição. - unknown - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `429`: Limite de requisições excedido. - `500`: Erro interno do servidor. ## Changes - **2026-10-29** `dae9d382e9b7`: 1 info - added the optional property `results/items/data/cashDividends/items/bdr` to the response with the `200` status - **2026-10-16** `62eafb05acb0`: 2 info - added the required property `results/items/data/cashDividends/items/paymentDateIsDeadline` to the response with the `200` status - added the required property `results/items/data/cashDividends/items/verified` to the response with the `200` status - **2026-09-04** `2dc90b0ebf1f`: 2 info - added the new optional `query` request parameter `includeRaw` - added the optional property `results/items/data/cashDividends/items/rawRate` to the response with the `200` status - **2026-09-04** `623e15020627`: 2 info - added the required property `results/items/data/cashDividends/items/exDate` to the response with the `200` status - added the required property `results/items/data/stockDividends/items/exDate` to the response with the `200` status - **2026-06-15** `73e0f61e068f`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/stocks/dividends/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)