LUSID can automatically emit lifecycle events for supported term instruments, enabling you to handle those events in a seamless and consistent manner.
Important: To enable instrument events, register a recipe with every portfolio you wish events to impact. More information.
For example, LUSID automatically emits a BondCouponEvent
each time a bond coupon is due. No user input is required, providing you have mastered the underlying instrument as either type Bond
, ComplexBond
or InflationLinkedBond
in the LUSID Security Master. In addition:
LUSID provides a
BondCouponEvent
default transaction template that automatically generates a transaction representing each coupon amount on its ex-date. You can override this default template if you wish, but it is not necessary.You must implement a
BondCoupon
transaction type to confer a suitable economic impact on automatically-generated bond coupon transactions. We provide a recommendation, which you can either implement as-is or change if desired.
Note: Instruments of type
Equity
do not have a lifecycle in the normal sense but you can load a stream of corporate actions and trigger LUSID to emit appropriate events. More information.
With the BondCoupon
transaction type in place, for each portfolio with a holding in the bond instrument on the ex-date of each coupon, LUSID automatically:
Generates an output transaction scaled to your holding in that portfolio, and enriched with extra information such as gain/loss or a tax calculation.
Implements the economic impact prescribed by the transaction type, for example adding the bond coupon amount to a particular cash balance.
Recommended reading: Handling bond coupon, principal and maturity events.
The following lifecycle events are available or planned. For more information, start by calling the GetTransactionTemplateSpecification
API for that event.
LUSID instrument type | Lifecycle events automatically emitted by LUSID | Transaction types requiring implementation (click for recommendations) | Notes (see also Troubleshooting) |
---|---|---|---|
| For a To override a particular coupon or principal amount, manually load an appropriate event. More information coming soon. To handle early redemption and terminate lifecycle events, manually load an To handle a bond default and terminate lifecycle events, manually load a | ||
| |||
| |||
MBS (modelled as a |
| ||
| |||
| |||
| |||
| |||
| |||
CdsIndex, |
| For a | |
| |||
| |||
| CashSettledOptionExercise (if cash settled) | See this tutorial. | |
|
| ||
| |||
|
| ||
|
|
| |
|
| ||
|
| ||
|
|
| |
|
| ||
| |||
| |||
|
| ||
| For an example, see this tutorial. | ||
| |||
|
| For a deliverable | |
| |||
|
|
| |
| |||
|
| ||
| |||
|
| ||
| |||
| |||
|
|
| |
|
| ||
|
| ||
|
| ||
|
| ||
|
|
| |
|
| ||
| |||
|
|