# Grupamentos e Desdobramentos

> Consulte grupamentos e desdobramentos de ações, fundos imobiliários e BDRs negociados na B3 (Ibovespa).

Acesse o histórico completo de grupamentos e desdobramentos de ativos negociados na B3. Eventos corporativos que alteram a quantidade de ações em circulação — 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 Eventos

A API retorna dois tipos de eventos corporativos:

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

<tbody>
  <tr>
    <td>
      <code>
        split
      </code>
    </td>
    
    <td>
      Desdobramento
    </td>
    
    <td>
      Divisão de ações (ex.: 1 → 4).
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        reverse_split
      </code>
    </td>
    
    <td>
      Grupamento
    </td>
    
    <td>
      Consolidação de ações (ex.: 10 → 1).
    </td>
  </tr>
</tbody>
</table>

---

## Requisição

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

<endpoint endpoint="/v2/finance/splits?tickers=B3:TIMS3">



</endpoint>

<request-example endpoint="/v2/finance/splits?tickers=B3:TIMS3">



</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:TIMS3,B3:VALE3`.

</field>

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

Data inicial para filtrar eventos (`yyyy-mm-dd`). Filtra pelo campo `ex_date`.

</field>

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

Data final para filtrar eventos (`yyyy-mm-dd`). Filtra pelo campo `ex_date`.

</field>

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

Data específica para consultar eventos 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 eventos do dia atual.

</field>
</field-group>

---

## Resposta

<response-json endpoint="/v2/finance/splits?tickers=B3:TIMS3">



</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:TIMS3
    </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>
      TIMS3
    </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>
      TIM
    </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>
      TIM S.A.
    </td>
  </tr>
</tbody>
</table>

#### Eventos

Cada item do array `events` representa um evento de grupamento ou desdobramento:

<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 evento: <code>
        split
      </code>
      
       (desdobramento) ou <code>
        reverse_split
      </code>
      
       (grupamento).
    </td>
    
    <td>
      split
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        factor_from
      </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>
      Quantidade de ações antes do evento.
    </td>
    
    <td>
      1
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        factor_to
      </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>
      Quantidade de ações após o evento.
    </td>
    
    <td>
      4
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        ratio
      </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>
      Fator multiplicador do evento (<code>
        factor_to / factor_from
      </code>
      
      ).
    </td>
    
    <td>
      4.0
    </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 (última data em que o ativo será negociado com o preço vigente).
    </td>
    
    <td>
      2025-06-20T00:00:00-03:00
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        effective_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 efetiva do evento (quando as ações são efetivamente convertidas).
    </td>
    
    <td>
      2025-06-10T00:00:00-03:00
    </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>
        pending
      </code>
      
       (pendente) ou <code>
        confirmed
      </code>
      
       (confirmado).
    </td>
    
    <td>
      confirmed
    </td>
  </tr>
</tbody>
</table>

<callout color="info" icon="tabler:info-circle">

**Entendendo o ratio**: Para desdobramentos (`split`), o `ratio` será maior que 1 (ex: 4.0 significa que cada ação virou 4). Para grupamentos (`reverse_split`), o `ratio` será menor que 1 (ex: 0.1 significa que cada 10 ações viraram 1).

</callout>

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

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

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