Eventos corporativos

GET

/companies/[companyIdentifier]/corporate-actions

Retorna uma lista de eventos corporativos em ações (ex.: desdobramentos, grupamentos, bonificações, cisões e outros eventos societários) para uma empresa específica. Os registros já vêm prontos para uso em UI (timeline), alertas e conciliação com fonte oficial.

Quando usar

• Montar uma timeline/calendário de eventos corporativos de uma empresa
• Criar alertas (ex.: "vai ter grupamento/desdobramento", "cisão anunciada")
• Fazer automações de carteira (ex.: ajuste de quantidade e preço médio)
• Filtrar por janela de datas usando start_date e end_date

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[companyIdentifier]	URL	Identificador da empresa (symbol, company_id ou ticker).	Obrigatório
start_date	Query	ISO 8601. Filtra por prior_ex_date a partir desta data.	Opcional
end_date	Query	ISO 8601. Filtra por prior_ex_date até esta data.	Opcional

Boas práticas

• Para uma timeline "limpa", aplique uma janela de datas.
• Se você quer apenas um período específico, use start_date e end_date no mesmo request.

Resposta

Código	Descrição
200	Retorna os eventos corporativos em ações.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.
404	Empresa não encontrada.

Formato da resposta

A resposta é uma lista de objetos com os campos abaixo:

Campo	Tipo	Descrição
approval_date	string (ISO 8601)	Data de aprovação do evento.
prior_ex_date	string (ISO 8601)	Data-base/data-com usada para elegibilidade e ordenação.
isin_code	string	ISIN do ativo associado ao evento.
issued_asset_isin_code	string	ISIN do ativo resultante/emitido.
remarks	string	Observações/texto livre (quando disponível).
factor	number	Multiplicador do número de ações — ver explicação abaixo.
legs	array	Pernas do evento, presentes em cisões, restituições de capital e incorporações — ver estrutura abaixo.
type	string	Tipo do evento. Valores possíveis listados na tabela abaixo.
label	string	Rótulo do evento em português (alinhado ao type).

Valores de type

type	Significado
STOCK_BONUS	Bonificação
SPIN_OFF_CAPITAL_REDUCTION	Cisão com redução de capital
SPIN_OFF_CAPITAL_REDUCTION_QUANTITY	Cisão com redução de capital e quantidade
STOCK_SPLIT	Desdobramento
REVERSE_STOCK_SPLIT	Grupamento
MERGER_INCORPORATION	Incorporação
TOTAL_EQUITY_REDEMPTION	Resgate total
CAPITAL_RESTITUTION_IN_SHARES	Restituição de capital em ações
CAPITAL_RESTITUTION_WITH_SHARE_REDUCTION	Restituição de capital com redução do número de ações
SUBSCRIPTION	Subscrição

Sobre o campo factor

factor é o multiplicador do número de ações do investidor após o evento. Exemplos:

• Desdobramento 1:10 → factor: 10 (o investidor termina com 10× mais ações)
• Grupamento 10:1 → factor: 0.1 (o investidor termina com 10× menos ações)
• Bonificação de 5% → factor: 1.05

Em eventos com legs, o factor do campo raiz não se aplica diretamente — o cálculo ocorre por perna. Veja a seção abaixo.

Estrutura de legs[]

Presente nos tipos: SPIN_OFF_CAPITAL_REDUCTION, SPIN_OFF_CAPITAL_REDUCTION_QUANTITY, MERGER_INCORPORATION, CAPITAL_RESTITUTION_IN_SHARES e CAPITAL_RESTITUTION_WITH_SHARE_REDUCTION.

Campo	Tipo	Descrição
leg_type	string	ORIGINAL_ASSET (ativo de origem) ou RECEIVED_ASSET (ativo recebido após o evento).
isin_code	string	ISIN do ativo desta perna.
ticker	string	Ticker do ativo desta perna.
factor	number	Para ORIGINAL_ASSET: segue o formato relatado acima. Para RECEIVED_ASSET: proporção de ações que o investidor receberá do ativo emitido para cada ação que detinha do ORIGINAL_ASSET.

Exemplo de leitura de legs

Em uma cisão onde SANB3 (ORIGINAL_ASSET, factor: 1) gera GETT3 (RECEIVED_ASSET, factor: 0.25), o investidor recebe 0,25 ações de GETT3 para cada 1 ação de SANB3 que detinha na data-com.

Exemplo

[
  {
    "approval_date": "2021-03-31T00:00:00.000Z",
    "prior_ex_date": "2021-10-15T00:00:00.000Z",
    "isin_code": "BRSANBACNOR8",
    "issued_asset_isin_code": "BRSANBACNOR8",
    "remarks": "",
    "legs": [
      {
        "leg_type": "ORIGINAL_ASSET",
        "isin_code": "BRSANBACNOR8",
        "ticker": "SANB3",
        "factor": 1
      },
      {
        "leg_type": "RECEIVED_ASSET",
        "isin_code": "BRGETTACNOR4",
        "ticker": "GETT3",
        "factor": 0.25
      }
    ],
    "type": "SPIN_OFF_CAPITAL_REDUCTION",
    "label": "Cisão com redução de capital"
  },
  {
    "approval_date": "2014-03-18T00:00:00.000Z",
    "prior_ex_date": "2014-05-30T00:00:00.000Z",
    "factor": 0.01818181819,
    "isin_code": "BRSANBACNOR8",
    "issued_asset_isin_code": "BRSANBACNOR8",
    "remarks": "",
    "legs": [],
    "type": "REVERSE_STOCK_SPLIT",
    "label": "Grupamento"
  },
  {
    "approval_date": "2014-03-18T00:00:00.000Z",
    "prior_ex_date": "2014-05-27T00:00:00.000Z",
    "factor": 1.047619048,
    "isin_code": "BRSANBACNOR8",
    "issued_asset_isin_code": "BRSANBACNPR5",
    "remarks": "",
    "legs": [],
    "type": "STOCK_BONUS",
    "label": "Bonificação"
  }
]