Pular para o conteúdo principal

Eventos do Portfólio (Portfolio Security Events)

Os Eventos do Portfólio (Portfolio Security Events) reúnem todos os eventos do ativo que afetaram as posições de um Portfólio em um período. Em vez de olhar um ativo por vez, você enxerga, em um só lugar, os proventos, vencimentos e alterações de quantidade que impactaram a carteira.

Esses eventos são essenciais para entender a rentabilidade. Uma amortização ou um dividendo devolve caixa ao investidor sem que haja uma venda; se esse fluxo não fosse considerado, o cálculo de P&L e de TWR ficaria distorcido.

Tipos de evento​

O GorilaCORE classifica cada evento em um tipo (eventType). As principais famílias de tipos são:

  • Eventos em dinheiro (prefixo CASH_): fluxos financeiros pagos ao detentor do ativo, como dividendos (CASH_DIVIDEND), juros sobre capital próprio (CASH_JSCP), juros (CASH_INTEREST) e amortizações (CASH_AMORTIZATION). Podem ocorrer várias vezes ao longo da vida do ativo.
  • Eventos de custódia (prefixo ASSET_): alteram a quantidade ou a identidade do ativo em carteira, como desdobramento (ASSET_SPLIT), grupamento (ASSET_INPLIT), bonificação em ativos (ASSET_BONUS), cisão (ASSET_SPINOFF), fusão ou incorporação (ASSET_MERGER_AND_ACQUISITION) e mudança de nome (ASSET_NAME_CHANGE).
  • Vencimento (EXPIRATION): marca o encerramento do ativo, comum em títulos de crédito e produtos estruturados. Ocorre uma única vez por ativo.

Há ainda tipos específicos de alguns ativos, como o vencimento de termos (FORWARD_EXPIRATION), a conversão de recibos de subscrição (RECEIPT_EXCHANGE) e o aniversário da poupança (SAVINGS_ANNIVERSARY). A lista completa de tipos, com o efeito de cada um na posição, na rentabilidade e no caixa, está disponível em List Security Event Types.

Datas de um evento​

Cada evento carrega duas datas. A data do evento (eventDate), ou data "ex", define quem tem direito ao evento: é a posição nessa data que conta. É também nessa data que ocorre o impacto no portfólio, tanto no cálculo da rentabilidade (e das demais métricas do portfólio) quanto em eventuais alterações de custódia, dependendo do evento (como grupamentos e desdobramentos). A data de pagamento (paymentDate) indica quando o valor é efetivamente creditado, e pode ocorrer alguns dias depois.

Valores de um evento​

Para eventos em dinheiro, o valor unitário (unitValue) é aplicado à quantidade em custódia na data do evento (sourceQuantity) para chegar ao valor total recebido (receivedValue). Já nos eventos que entregam outro ativo, como bonificações e cisões, a resposta indica o ativo recebido (receivedSecurity), a quantidade recebida (receivedQuantity) e o fator aplicado sobre a posição (eventFactor).

Eventos em ativos personalizados​

Para ativos personalizados, os eventos não vêm de uma fonte de mercado: você mesmo os registra, via Create Security Event. Na criação, a data do evento é informada no campo referenceDate. Uma vez cadastrados, eles passam a aparecer nos eventos do portfólio como qualquer outro.

Ao registrar um evento em dinheiro, ajuste também o preço do ativo na mesma data. Se um ativo vale R$ 1.000,00 e paga uma amortização de R$ 600,00, o preço deveria cair para cerca de R$ 400,00; caso contrário, a amortização é lida como ganho de capital.

Onde acessar​

Para listar os eventos de um portfólio em um período, com filtro opcional por ativo, consulte List Security Events. Para os eventos de todos os portfólios de um Grupo Econômico, consulte List Economic Group Security Events.

Para medir quanto cada ativo pagou em proventos em relação ao seu preço no período, consulte o Dividend Yield.