Eventos em ativos personalizados

12 de março de 2026

Agora você pode cadastrar e gerenciar os eventos dos seus ativos personalizados, como vencimento, amortizações, juros e dividendos, para que eles sejam refletidos nas posições, no Lucro e Prejuízo e na rentabilidade dos seus portfólios.

Novos endpoints:

Create Security Event: cadastra um evento por requisição.
List Security Custom Events: lista os eventos cadastrados, com filtros por período (startDate, endDate) e tipo (types).
Update Security Event e Delete Security Event: editam e excluem um evento.

Tipos aceitos:

Vencimento (EXPIRATION), com o preço de liquidação (settlementPrice). Ele encerra as posições no ativo na data do evento, e cada ativo pode ter apenas um.
Eventos em dinheiro (CASH_AMORTIZATION, CASH_AMORTIZATION_UNSCHEDULED, CASH_DIVIDEND, CASH_INCOME, CASH_INTEREST, CASH_JSCP, CASH_PREMIUM e CASH_RETURN_OF_CAPITAL), com o valor pago por unidade do ativo (unitValue).

Todo evento tem uma data de referência (referenceDate) e uma data de pagamento (paymentDate), que não pode ser anterior à data de referência.

// REQUEST
// POST https://core.gorila.com.br/securities/{securityId}/events

{
  "type": "CASH_AMORTIZATION",
  "referenceDate": "2024-01-31",
  "paymentDate": "2024-02-05",
  "unitValue": 2.5
}

Saiba mais em Ativo Personalizado.