Grupamentos e Desdobramentos

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

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

Tipos de Eventos

A API retorna dois tipos de eventos corporativos:

TipoTítuloDescrição
splitDesdobramentoDivisão de ações (ex.: 1 → 4).
reverse_splitGrupamentoConsolidação de ações (ex.: 10 → 1).

Requisição

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

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

Parâmetros

tickers
string required
Ticker do ativo no formato {fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: B3:TIMS3,B3:VALE3.
start_date
string
Data inicial para filtrar eventos (yyyy-mm-dd). Filtra pelo campo ex_date.
end_date
string
Data final para filtrar eventos (yyyy-mm-dd). Filtra pelo campo ex_date.
date
string
Data específica para consultar eventos de um único dia (yyyy-mm-dd).
days_ago
number
Número de dias atrás a partir de hoje. Use 0 para eventos do dia atual.

Resposta

{
  "metadata": {
    "key_status": "valid",
    "cached": false,
    "response_time_ms": 48.5,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "B3:TIMS3",
      "symbol": "TIMS3",
      "name": "TIM S.A.",
      "full_name": "Tim S.A.",
      "events": [
        {
          "type": "reverse_split",
          "factor_from": 0.01,
          "factor_to": 1,
          "ratio": 100,
          "com_date": "2025-07-02",
          "effective_date": "2025-06-02",
          "status": "confirmed"
        }
      ],
      "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

CampoTipoDescriçãoExemplo
tickerstringTicker completo no formato {fonte}:{símbolo}.B3:TIMS3
symbolstringCódigo de negociação do ativo.TIMS3
namestringNome simplificado da empresa.TIM
full_namestringRazão social completa da empresa.TIM S.A.

Eventos

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

CampoTipoDescriçãoExemplo
typestringTipo do evento: split (desdobramento) ou reverse_split (grupamento).split
factor_fromnumberQuantidade de ações antes do evento.1
factor_tonumberQuantidade de ações após o evento.4
rationumberFator multiplicador do evento (factor_to / factor_from).4.0
com_datestringData de corte (última data em que o ativo será negociado com o preço vigente).2025-06-20T00:00:00-03:00
effective_datestringData efetiva do evento (quando as ações são efetivamente convertidas).2025-06-10T00:00:00-03:00
statusstringStatus: pending (pendente) ou confirmed (confirmado).confirmed
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).
Datas com valor null indicam que a data ainda não foi definida.

Fonte

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

CampoTipoDescriçãoExemplo
source.symbolstringCódigo da bolsa.B3
source.namestringNome da bolsa.B3 - Brasil, Bolsa, Balcão
source.full_namestringNome completo da bolsa.B3 S.A. - Brasil, Bolsa, Balcão
source.urlstringSite oficial da bolsa.https://www.b3.com.br/
source.location.timezonestringFuso horário da bolsa.America/Sao_Paulo