How do I create a derived transaction portfolio?

You can create a derived transaction portfolio that is a live copy of an existing parent transaction portfolio at that moment in time.

Note: Once created, you can only change certain characteristics of a derived portfolio in some circumstances. If you ever need to delete the parent portfolio, you must first delete the derived portfolio.

To create a derived portfolio, you must specify a unique identifier, friendly name and the unique identifier of the parent portfolio. Other characteristics are inherited (such as the accounting method, amortisation method, transaction type scope, list of sub-holding keys and so on), but you can override these if desired.

Note: While it is possible to change the inherited creation date and instrument scope of a derived portfolio, this is not recommended.

To examine the complete set of data fields for a derived portfolio, examine the API documentation. Note that to subsequently interact you can use the APIs in the Portfolios and Transaction Portfolios collections as well as the Derived Transaction Portfolios collection.

Using the LUSID REST API

1. Obtain an API access token.

2. Call the LUSID CreateDerivedPortfolio API for your LUSID domain, passing in your API access token, nominating a scope in the URL, and specifying in the request body:

   • A displayName.

   • A code unique within the scope.

   • The scope and code of the parent portfolio.

   For example, to create a derived portfolio in myexamplederivedscope (in the URL; this is created if it does not exist):

   curl -X POST "https://<your-domain>.lusid.com/api/api/derivedtransactionportfolios/myexamplederivedscope"
     -H "Authorization: Bearer <your-API-access-token>"
     -H "Content-Type: application/json-patch+json"
     -d '{
       "displayName": "Example derived transaction portfolio",
       "code": "Growth",
       "parentPortfolioId": {
         "scope": "myexamplescope",
         "code": "Income"
       }
     }'

   Providing the request is successful, the response lists the inherited values applied to other data fields. Note the identifier for the derived portfolio entity consists of the scope and code:

   {
       "id": {
           "scope": "myexamplederivedscope",
           "code": "Growth"
       },
       "type": "DerivedTransaction",
       "displayName": "Example derived transaction portfolio",
       "created": "2022-01-01T00:00:00.0000000+00:00",
       "parentPortfolioId": {
           "scope": "myexamplescope",
           "code": "Income"
       },
       "version": {
           "effectiveFrom": "2022-01-01T00:00:00.0000000+00:00",
           "asAtDate": "2022-10-14T15:42:29.7166460+00:00"
       },
       "isDerived": true,
       "baseCurrency": "GBP",
       "instrumentScopes": [],
       "accountingMethod": "Default",
       "amortisationMethod": "NoAmortisation",
   }

Using the LUSID web app

1. Sign in to the LUSID web app using the credentials of a LUSID administrator.

2. From the top left menu, select Data Management > Portfolios.

3. Find the transaction portfolio you want to derive from and select Create derived portfolio from the menu at the end of the row:
    
    

4. On the Basic data screen of the Create Derived Portfolio dialog, specify a Scope and Code:
    

5. Override the other inherited characteristics of the parent portfolio if desired and click the Create button on the Property constraints screen.