# Dividendos e Proventos

> 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!

<callout color="neutral" icon="tabler:key" to="/docs/guide/key">

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

</callout>

---

## Tipos de Proventos

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

<table>
<thead>
  <tr>
    <th>
      Tipo
    </th>
    
    <th>
      Título
    </th>
    
    <th>
      Descrição
    </th>
  </tr>
</thead>

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

---

## Requisição

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

<endpoint endpoint="/v2/finance/dividends?tickers=B3:PETR4">



</endpoint>

<request-example endpoint="/v2/finance/dividends?tickers=B3:PETR4">



</request-example>

<stock-search>



</stock-search>

### Parâmetros

<field-group>
<field name="tickers" type="string" :required="true">

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

</field>

<field name="start_date" type="string">

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

</field>

<field name="end_date" type="string">

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

</field>

<field name="date" type="string">

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

</field>

<field name="days_ago" type="number">

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

</field>
</field-group>

---

## Resposta

<response-json endpoint="/v2/finance/dividends?tickers=B3:PETR4">



</response-json>

### Campos

Os dados de cada ativo retornam no array `results`:

#### Ativo

<table>
<thead>
  <tr>
    <th>
      Campo
    </th>
    
    <th>
      Tipo
    </th>
    
    <th>
      Descrição
    </th>
    
    <th>
      Exemplo
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        ticker
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Ticker completo no formato <code>
        {fonte}:{símbolo}
      </code>
      
      .
    </td>
    
    <td>
      B3:PETR4
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        unit
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Unidade dos valores (<code>
        currency
      </code>
      
       para moeda).
    </td>
    
    <td>
      currency
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        currency
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Moeda dos valores.
    </td>
    
    <td>
      BRL
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        symbol
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Código de negociação do ativo.
    </td>
    
    <td>
      PETR4
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        name
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Nome simplificado da empresa.
    </td>
    
    <td>
      Petrobras
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        full_name
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Razão social completa da empresa.
    </td>
    
    <td>
      Petróleo Brasileiro S.A.
    </td>
  </tr>
</tbody>
</table>

#### Consolidado

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

<table>
<thead>
  <tr>
    <th>
      Campo
    </th>
    
    <th>
      Tipo
    </th>
    
    <th>
      Descrição
    </th>
    
    <th>
      Exemplo
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        yield_12m_percent
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          number
        </span>
      </code>
    </td>
    
    <td>
      Dividend Yield dos últimos 12 meses (%).
    </td>
    
    <td>
      1.12
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        yield_12m_cash
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          number
        </span>
      </code>
    </td>
    
    <td>
      Valor total distribuído por ação nos últimos 12 meses.
    </td>
    
    <td>
      1.38
    </td>
  </tr>
</tbody>
</table>

#### Eventos

Cada item do array `events` representa um provento:

<table>
<thead>
  <tr>
    <th>
      Campo
    </th>
    
    <th>
      Tipo
    </th>
    
    <th>
      Descrição
    </th>
    
    <th>
      Exemplo
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        type
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Tipo do provento (veja os <a href="#tipos-de-proventos">
        tipos de proventos
      </a>
      
      ).
    </td>
    
    <td>
      dividend
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        category
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Categoria: <code>
        cash
      </code>
      
       (dinheiro) ou <code>
        stock
      </code>
      
       (ativos).
    </td>
    
    <td>
      cash
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        amount
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          number
        </span>
      </code>
    </td>
    
    <td>
      Valor por ação / cota após ajustes de grupamento e desdobramento.
    </td>
    
    <td>
      0.15
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        approval_date
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Data de aprovação do provento.
    </td>
    
    <td>
      2025-08-07
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        com_date
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Data de corte (data "com" direito ao provento).
    </td>
    
    <td>
      2025-08-14
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        payment_date
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Data de pagamento (pode ser <code>
        null
      </code>
      
       se não definida).
    </td>
    
    <td>
      2025-10-05
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        status
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Status: <code>
        not_approved
      </code>
      
       (não aprovado), <code>
        approved
      </code>
      
       (aprovado) ou <code>
        paid
      </code>
      
       (pago).
    </td>
    
    <td>
      approved
    </td>
  </tr>
</tbody>
</table>

<callout color="warning" icon="tabler:alert-triangle">

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

</callout>

#### Fonte

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

<table>
<thead>
  <tr>
    <th>
      Campo
    </th>
    
    <th>
      Tipo
    </th>
    
    <th>
      Descrição
    </th>
    
    <th>
      Exemplo
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        source.symbol
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Código da bolsa.
    </td>
    
    <td>
      B3
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        source.name
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Nome da bolsa.
    </td>
    
    <td>
      B3 - Brasil, Bolsa, Balcão
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        source.full_name
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Nome completo da bolsa.
    </td>
    
    <td>
      B3 S.A. - Brasil, Bolsa, Balcão
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        source.url
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Site oficial da bolsa.
    </td>
    
    <td>
      <a href="https://www.b3.com.br/" rel="nofollow">
        https://www.b3.com.br/
      </a>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        source.location.timezone
      </code>
    </td>
    
    <td>
      <code className="language-ts-type shiki shiki-themes one-light one-dark-pro one-dark-pro" language="ts-type" style="">
        <span class="s3iYH">
          string
        </span>
      </code>
    </td>
    
    <td>
      Fuso horário da bolsa.
    </td>
    
    <td>
      America/Sao_Paulo
    </td>
  </tr>
</tbody>
</table>