Skip to content

๐Ÿ“… Asset Events

Asset events represent things that happen to the asset globally โ€” not at the portfolio level. They are distinct from transactions, which track what happens in a user's portfolio.

For a deep dive into each event type โ€” including market impact, formulas, and practical examples โ€” see the Asset Events (Financial Theory) section.

๐Ÿ“Š Event Types

Type Icon Effect on Price Description Learn More
Dividend ๐Ÿ’ฐ Price drops by event value (ex-date) Cash distribution from equity or ETF ๐Ÿ“–
Interest ๐Ÿ“ˆ Price drops by event value Interest payment from debt instrument or loan ๐Ÿ“–
Split โœ‚๏ธ Changes quantity, not total value Stock or unit split ๐Ÿ“–
Price Adjustment ๐Ÿ“Š Algebraic change (+/-) Non-cash value change: write-down, haircut, re-rating ๐Ÿ“–
Maturity Settlement ๐Ÿ Final capital return Asset reaches maturity โ€” no further price calculations ๐Ÿ“–

๐Ÿ“ˆ Event Markers on the Chart

Events appear as colored markers on the price chart. Each event type has a distinct color and icon. Hover over a marker to see the event details (date, type, value, currency).

โš™๏ธ Where Events Come From

Events can be generated in two ways:

1. Provider-generated (automatic)

Some providers produce events during sync:

  • Scheduled Investment: generates INTEREST and PRICE_ADJUSTMENT events from the interest schedule configuration
  • Yahoo Finance: may produce DIVIDEND events from historical data

Provider-generated events have a provider_assignment_id and are automatically updated during sync (DELETE + INSERT deduplication on asset_id, date, type).

2. User-created (manual)

Events can also be added manually via the asset edit modal. Manual events have no provider_assignment_id and are never auto-deleted during sync.

๐Ÿงฎ How Events Affect Price Calculation

For the Scheduled Investment provider, events are integral to the price calculation:

price(d) = initial_value + accrued_interest โˆ’ ฮฃ(INTEREST events) + ฮฃ(PRICE_ADJUSTMENT events)

For market-priced assets (Yahoo Finance, justETF), events are informational โ€” they explain sudden price drops (ex-dividend dates) but don't directly modify the fetched price.