---
title: "Portfolios"
slug: "portfolios"
updated: 2024-11-27T10:08:57Z
published: 2024-11-27T10:08:57Z
canonical: "support.lusid.com/portfolios"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Portfolios

A portfolio is a store of economic activity in a set of [instruments](/v1/docs/instruments) mastered in the LUSID Security Master.

There are three types of portfolio:

- A [transaction portfolio](/v1/docs/what-is-a-transaction-portfolio) enables you to load transactions and other activity in order to build holdings (positions).
- A [derived transaction portfolio](/v1/docs/what-is-a-derived-transaction-portfolio) enables you to perform pre-trade *what-if* analysis on a live parent transaction portfolio.
- A [reference portfolio](/v1/docs/what-is-a-reference-portfolio) enables you to model an index such as the FTSE 100 or S&P 500.

> **Note**: Once created, you can only change certain characteristics of a portfolio, and only in some circumstances. [More information](/v1/docs/updating-certain-characteristics-of-an-existing-portfolio).

There are several ways to group, nest or relate portfolios:

- A [portfolio group](/v1/docs/what-is-a-portfolio-group) collates similar portfolios together, for example an `EMEA` portfolio group that acts as an umbrella for `UK`, `FR` and `DE` portfolios. You can list transactions and holdings for all the portfolios in a portfolio group, and also value the entire group.
- A [composite portfolio](/v1/docs/what-is-a-composite-portfolio) has a special kind of relationship with one or more constituent portfolios. You can aggregate performance returns for the composite portfolio and for its constituents to assess overall performance.
- A [fund of funds](/v1/docs/setting-up-and-valuing-a-fund-of-funds-portfolio) parent portfolio has one or more child portfolios securitised as instruments and purchased as assets in the parent. You can value the parent and drill down (or ‘lookthrough’) to see scaled valuations for individual holdings in child portfolios.

Note the following about all types of portfolio:

- A portfolio has a [creation date](/v1/docs/understanding-the-importance-of-portfolio-creation-date) that you can set to be in the past in order to load historical activity.
- A portfolio has a single identifier consisting of a `scope` and `code` (the latter must be unique within the former). [More about identifiers](/v1/docs/what-is-an-entity).
- A portfolio has a base (or reporting) currency to which LUSID can normalise foreign currencies in order to provide meaningful valuation reports.
- A portfolio can have a [recipe](/v1/docs/setting-a-portfolio-recipe), which is nominally optional but actually required to enable LUSID functionality such as instrument events, and also to generate holdings for complex instruments that require market data (such as floating rate bonds).
- A portfolio has a minimal set of mandatory data fields, but you can extend the data model by adding [custom properties](/v1/docs/properties) in the normal way.
- You can create [relationships](/v1/docs/creating-relationships-between-certain-types-of-entity) to certain other types of entity, for example between a portfolio and the person(s) who manage that portfolio.
- You can apply [access metadata](/v1/docs/understanding-access-metadata-amd) to a portfolio. This may be a more effective way of restricting access to portfolio data stored in LUSID.

Providing you have suitable [access control permissions](/v1/docs/identity-management-and-access-control-iam), you can interact with portfolios using the **Data Management > Portfolios** dashboard in the [LUSID web app](https://www.lusid.com/app/home):

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/3d30c374-3372-4bc3-8564-325816a749ad.png)

Alternatively, you can interact with portfolios programmatically:

- For any type of portfolio, using the API endpoints in the [Portfolios](https://www.lusid.com/docs/api#tag/Portfolios) collection, plus:
  - For a transaction portfolio, the API endpoints in the [Transaction Portfolios](https://www.lusid.com/docs/api#tag/Transaction-Portfolios) collection.
  - For a derived transaction portfolio, the API endpoints in the [Transaction Portfolios](https://www.lusid.com/docs/api#tag/Transaction-Portfolios) *and* [Derived Transaction Portfolios](https://www.lusid.com/docs/api#tag/Derived-Transaction-Portfolios) collections.
  - For a reference portfolio, the API endpoints in the [Reference Portfolios](https://www.lusid.com/docs/api#tag/Reference-Portfolio) collection.
- Using the equivalent methods in the [LUSID SDK](/v1/docs/understanding-all-the-applications-in-the-finbourne-platform).
- If you have a Luminesce license, using dedicated [read](/v1/docs/lusidportfolio) and [write](/v1/docs/lusidportfoliowriter) providers.

**Explanation**: *See the big picture*

- [Understanding the importance of portfolio creation date](/v1/docs/understanding-the-importance-of-portfolio-creation-date)

**Tutorials**: *Get started by doing something tangible*

- [Creating a strategy-based transaction portfolio](/v1/docs/creating-a-strategy-based-transaction-portfolio)
- [Setting up and valuing a fund of funds portfolio](/v1/docs/setting-up-and-valuing-a-fund-of-funds-portfolio)

**Reference**: *Understand concepts and implications*

- [What is a transaction portfolio?](/v1/docs/what-is-a-transaction-portfolio)
- [Registering a portfolio recipe](/v1/docs/setting-a-portfolio-recipe)
- [What is a derived transaction portfolio?](/v1/docs/what-is-a-derived-transaction-portfolio)
- [Transaction syncing in derived transaction portfolios](/v1/docs/transaction-syncing-in-derived-transaction-portfolios)
- [What is a reference portfolio?](/v1/docs/what-is-a-reference-portfolio)
- [Loading constituents and rebalancing a reference portfolio](/v1/docs/loading-constituents-and-rebalancing-a-reference-portfolio)
- [What is a portfolio group?](/v1/docs/what-is-a-portfolio-group)
- [What is a composite portfolio?](/v1/docs/what-is-a-composite-portfolio)
- [Aggregating performance return for a portfolio](/v1/docs/aggregating-performance-returns-for-a-portfolio)
- [Updating certain characteristics of an existing portfolio](/v1/docs/updating-certain-characteristics-of-an-existing-portfolio)

**How-to guides**: *Get something done*

- [How do I create a transaction portfolio?](/v1/docs/how-do-i-create-a-transaction-portfolio)
- [How do I register sub-holding keys (SHKs) with a transaction portfolio?](/v1/docs/how-do-i-register-sub-holding-keys-shks-with-a-portfolio)
- [How do I create a reference portfolio?](/v1/docs/how-do-i-create-a-reference-portfolio)
- [How do I create a derived transaction portfolio?](/v1/docs/how-do-i-create-a-derived-transaction-portfolio)
- [How do I create a portfolio group?](/v1/docs/how-do-i-create-a-portfolio-group)
