Eventos corporativos

GET

/traded-funds/[fundIdentifier]/corporate-actions

Retorna uma lista de eventos corporativos em cotas (ex.: desdobramentos, grupamentos, subscrições e outros eventos societários) para um fundo listado específico (FII, ETF, Fiagro, FI-Infra etc.). 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 um fundo
• Criar alertas (ex.: "vai ter desdobramento", "período de subscrição aberto")
• 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
[fundIdentifier]	URL	Identificador do fundo (ticker ou symbol).	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.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.
404	Fundo não encontrado.

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.
type	string	Tipo do evento; veja a tabela abaixo.
label	string	Rótulo do evento em português (alinhado ao type).
factor	number	Multiplicador do número de cotas — ver explicação abaixo.
issued_asset_isin_code	string	ISIN resultante/emitido.
remarks	string	Observações/texto livre (quando disponível).
legs	array	Pernas do evento (não aplicável para fundos; sempre []).

Valores de type

type	Significado
TOTAL_EQUITY_REDEMPTION	Resgate total
STOCK_SPLIT	Desdobramento
REVERSE_STOCK_SPLIT	Grupamento
STOCK_BONUS	Bonificação
SUBSCRIPTION	Subscrição

Sobre o campo factor

factor é o multiplicador do número de cotas do investidor após o evento. Exemplos:

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

Estrutura de SUBSCRIPTION

Quando type é SUBSCRIPTION, o objeto não contém os campos factor, issued_asset_isin_code, remarks e legs. Em vez disso, traz os seguintes campos exclusivos:

Campo	Tipo	Descrição
subscription_date	string (ISO 8601)	Data limite para exercício do direito de subscrição.
trading_period_start_date	string (ISO 8601)	Início do período de negociação dos direitos.
trading_period_end_date	string (ISO 8601)	Fim do período de negociação dos direitos.
price	number	Preço de emissão por cota na subscrição.

Exemplo

[
  {
    "approval_date": "2026-02-04T00:00:00.000Z",
    "prior_ex_date": "2026-02-10T00:00:00.000Z",
    "isin_code": "BRHGLGCTF004",
    "subscription_date": "2026-03-02T00:00:00.000Z",
    "trading_period_start_date": "9999-12-31T00:00:00.000Z",
    "trading_period_end_date": "2026-02-25T00:00:00.000Z",
    "price": 166.58,
    "label": "Subscrição",
    "type": "SUBSCRIPTION"
  },
  {
    "approval_date": "2018-04-17T00:00:00.000Z",
    "prior_ex_date": "2018-04-17T00:00:00.000Z",
    "factor": 10,
    "isin_code": "BRHGLGCTF004",
    "issued_asset_isin_code": "BRHGLGCTF004",
    "remarks": "",
    "legs": [],
    "type": "STOCK_SPLIT",
    "label": "Desdobramento"
  }
]