Dividendos e Proventos

Finance

Consulte dividendos, JCP, bonificações e outros proventos de ações, fundos imobiliários e BDRs negociados na B3 (Ibovespa).

Acesse o histórico completo de proventos de ativos negociados na B3. Dividendos, JCP, bonificações, desdobramentos e outros eventos corporativos — tudo em um único endpoint!

Para acessar os dados da API é necessário utilizar uma chave de integração e um plano compatível.

Tipos de Proventos

Diversos tipos de eventos corporativos são suportados. Cada tipo possui características específicas:

Tipo	Título	Descrição
`amortization`	Amortização	Devolução de parte do capital investido ao cotista.
`bonus_issue`	Bonificação	Distribuição de novos ativos sem custo ao acionista.
`dividend`	Dividendo	Parcela do lucro distribuída aos acionistas.
`full_share_redemption`	Resgate Total	Resgate completo dos ativos em renda variável.
`income`	Rendimento	Distribuição de rendimentos de fundos imobiliários e outros ativos.
`interest_on_equity`	Juros sobre Capital Próprio (JCP)	Remuneração ao acionista com benefício fiscal para a empresa.
`return_of_capital_in_cash`	Restituição de Capital em Dinheiro	Devolução de capital aos acionistas.
`return_of_capital_in_shares`	Restituição de Capital em Ativos	Devolução de capital em forma de ativos.

Requisição

Informe o ticker no formato {fonte}:{símbolo}.

GEThttps://api.hgbrasil.com/v2/finance/dividends?tickers=B3:PETR4&key=suachave

curl -X GET "https://api.hgbrasil.com/v2/finance/dividends?tickers=B3%3APETR4&key=suachave"

const url = new URL("/v2/finance/dividends", "https://api.hgbrasil.com")

url.searchParams.set("tickers", "B3:PETR4")
url.searchParams.set("key", "suachave")

const response = await fetch(url.href)
const data = await response.json()

$url = 'https://api.hgbrasil.com/v2/finance/dividends';

$queryString = http_build_query([
    'tickers' => 'B3:PETR4',
    'key' => 'suachave'
]);

$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);

import requests

url = 'https://api.hgbrasil.com/v2/finance/dividends'

params = {
    'tickers': 'B3:PETR4',
    'key': 'suachave'
}

response = requests.get(url, params=params)
data = response.json()

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.hgbrasil.com/v2/finance/dividends')

uri.query = URI.encode_www_form({
  tickers: 'B3:PETR4',
  key: 'suachave'
})

response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)

import java.net.URI;
import java.net.http.*;

var url = "https://api.hgbrasil.com/v2/finance/dividends?tickers=B3%3APETR4&key=suachave";

var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .GET()
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();

using System.Net.Http;
using System.Text.Json;
using System.Web;

var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/v2/finance/dividends";

var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "B3:PETR4";
queryParams["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);

Parâmetros

tickers

string required

Ticker do ativo no formato {fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: B3:PETR4,B3:VALE3.

start_date

string

Data inicial para filtrar proventos (yyyy-mm-dd). Filtra pelo campo com_date.

end_date

string

Data final para filtrar proventos (yyyy-mm-dd). Filtra pelo campo com_date.

date

string

Data específica para consultar proventos de um único dia (yyyy-mm-dd).

days_ago

number

Número de dias atrás a partir de hoje. Use 0 para proventos do dia atual.

Resposta

{
  "metadata": {
    "key_status": "valid",
    "cached": false,
    "response_time_ms": 41.300000000000004,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "B3:PETR4",
      "unit": "currency",
      "currency": "BRL",
      "symbol": "PETR4",
      "name": "Petrobrás",
      "full_name": "Petroleo Brasileiro S.A. Petrobras",
      "summary": {
        "yield_12m_percent": 10.648,
        "yield_12m_cash": 3.272
      },
      "series": [
        {
          "type": "interest_on_equity",
          "category": "cash",
          "amount": 0.175182,
          "approval_date": "2025-12-11",
          "com_date": "2025-12-22",
          "payment_date": "2026-03-20",
          "status": "approved"
        },
        {
          "type": "dividend",
          "category": "cash",
          "amount": 0.296421,
          "approval_date": "2025-12-11",
          "com_date": "2025-12-22",
          "payment_date": "2026-03-20",
          "status": "approved"
        },
        {
          "type": "interest_on_equity",
          "category": "cash",
          "amount": 0.471604,
          "approval_date": "2025-12-11",
          "com_date": "2025-12-22",
          "payment_date": "2026-02-20",
          "status": "approved"
        },
        {
          "type": "interest_on_equity",
          "category": "cash",
          "amount": 0.13504,
          "approval_date": "2025-08-07",
          "com_date": "2025-08-21",
          "payment_date": "2025-12-22",
          "status": "paid"
        },
        {
          "type": "dividend",
          "category": "cash",
          "amount": 0.200922,
          "approval_date": "2025-08-07",
          "com_date": "2025-08-21",
          "payment_date": "2025-12-22",
          "status": "paid"
        },
        {
          "type": "interest_on_equity",
          "category": "cash",
          "amount": 0.335962,
          "approval_date": "2025-08-07",
          "com_date": "2025-08-21",
          "payment_date": "2025-11-21",
          "status": "paid"
        },
        {
          "type": "interest_on_equity",
          "category": "cash",
          "amount": 0.146136,
          "approval_date": "2025-05-12",
          "com_date": "2025-06-02",
          "payment_date": "2025-09-22",
          "status": "paid"
        },
        {
          "type": "dividend",
          "category": "cash",
          "amount": 0.308447,
          "approval_date": "2025-05-12",
          "com_date": "2025-06-02",
          "payment_date": "2025-09-22",
          "status": "paid"
        },
        {
          "type": "interest_on_equity",
          "category": "cash",
          "amount": 0.454583,
          "approval_date": "2025-05-12",
          "com_date": "2025-06-02",
          "payment_date": "2025-08-20",
          "status": "paid"
        },
        {
          "type": "income",
          "category": "cash",
          "amount": 0.0215247,
          "approval_date": "2025-02-26",
          "com_date": "2025-04-16",
          "payment_date": "2025-06-20",
          "status": "paid"
        },
        {
          "type": "dividend",
          "category": "cash",
          "amount": 0.354773,
          "approval_date": "2025-02-26",
          "com_date": "2025-04-16",
          "payment_date": "2025-06-20",
          "status": "paid"
        },
        {
          "type": "income",
          "category": "cash",
          "amount": 0.0170601,
          "approval_date": "2025-02-26",
          "com_date": "2025-04-16",
          "payment_date": "2025-05-20",
          "status": "paid"
        },
        {
          "type": "dividend",
          "category": "cash",
          "amount": 0.354773,
          "approval_date": "2025-02-26",
          "com_date": "2025-04-16",
          "payment_date": "2025-05-20",
          "status": "paid"
        }
      ],
      "source": {
        "symbol": "B3",
        "name": "B3",
        "full_name": "B3 S.A. - Brasil, Bolsa, Balcão",
        "url": "https://www.b3.com.br",
        "location": {
          "timezone": "America/Sao_Paulo"
        }
      }
    }
  ]
}

Campos

Os dados de cada ativo retornam no array results:

Ativo

Campo	Tipo	Descrição	Exemplo
`ticker`	`string`	Ticker completo no formato `{fonte}:{símbolo}`.	B3:PETR4
`unit`	`string`	Unidade dos valores (`currency` para moeda).	currency
`currency`	`string`	Moeda dos valores.	BRL
`symbol`	`string`	Código de negociação do ativo.	PETR4
`name`	`string`	Nome simplificado da empresa.	Petrobras
`full_name`	`string`	Razão social completa da empresa.	Petróleo Brasileiro S.A.

Consolidado

O objeto summary traz métricas consolidadas dos últimos 12 meses:

Campo	Tipo	Descrição	Exemplo
`yield_12m_percent`	`number`	Dividend Yield dos últimos 12 meses (%).	1.12
`yield_12m_cash`	`number`	Valor total distribuído por ação nos últimos 12 meses.	1.38

Eventos

Cada item do array events representa um provento:

Campo	Tipo	Descrição	Exemplo
`type`	`string`	Tipo do provento (veja os tipos de proventos).	dividend
`category`	`string`	Categoria: `cash` (dinheiro) ou `shares` (ativos).	cash
`amount`	`number`	Valor por ação / cota após ajustes de grupamento e desdobramento.	0.15
`approval_date`	`string`	Data de aprovação do provento.	2025-08-07
`com_date`	`string`	Data de corte (data "com" direito ao provento).	2025-08-14
`payment_date`	`string`	Data de pagamento (pode ser `null` se não definida).	2025-10-05
`status`	`string`	Status: `not_approved` (não aprovado), `approved` (aprovado) ou `paid` (pago).	approved

Datas que com valor null indicam que a data ainda não foi definida pela empresa emissora.

Fonte

O objeto source contém informações sobre a bolsa de valores:

Campo	Tipo	Descrição	Exemplo
`source.symbol`	`string`	Código da bolsa.	B3
`source.name`	`string`	Nome da bolsa.	B3 - Brasil, Bolsa, Balcão
`source.full_name`	`string`	Nome completo da bolsa.	B3 S.A. - Brasil, Bolsa, Balcão
`source.url`	`string`	Site oficial da bolsa.	https://www.b3.com.br/
`source.location.timezone`	`string`	Fuso horário da bolsa.	America/Sao_Paulo