What is a sub-holding key (SHK)?

A sub-holding key (SHK) is a tag you can apply to transactions in a transaction portfolio. When you generate a holdings report, LUSID divides tagged transactions in the same underlying instrument into separate holdings.

By default, LUSID reports holdings for a portfolio at the instrument level, so all transactions impacting an underlying instrument such as BP contribute to a calculation of your current position (quantity and cost) in a single BP holding:

This also applies to cash, where one holding (balance) is maintained for each impacted currency instrument.

You might want to split holdings in the same underlying instrument, perhaps in order to:

• Represent different investment strategies, for example growth and income.
• Account for different kinds of cash balance, for example principle and margin.

For example:

To set up an SHK, you must:

1. Create an underlying property type for the SHK. This must be in the Transaction domain.
2. Register the 3-stage key of the SHK with a portfolio. You can register more than one.
3. Tag transactions with distinct values for the SHK property. You can also tag holdings that you set or adjust manually. 
4. Generate a holdings report and group by SHK.

For a demonstration, work through this tutorial on setting up a strategy-based transaction portfolio.