---
title: "How do I perform a valuation?"
slug: "how-do-i-perform-a-valuation"
updated: 2026-07-03T11:56:50Z
published: 2026-07-03T11:56:50Z
canonical: "support.lusid.com/how-do-i-perform-a-valuation"
---

> ## 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.

# How do I perform a valuation?

You can value one or more transaction portfolios, all the portfolios in a portfolio group, or notional quantities of arbitrary instruments.

## Using the LUSID API

The instructions in this section explain how to value one or more transaction portfolios or portfolio groups using the [GetValuation](https://www.lusid.com/docs/api#operation/GetValuation) API. To value notional quantities of arbitrary instruments, call the [GetValuationOfWeightedInstruments](https://www.lusid.com/docs/api#operation/GetValuationOfWeightedInstruments) API instead, specifying quantities and economic definitions in the `instruments` section. The remainder of the detail is shared.

1. [Obtain an API access token](/v1/docs/how-do-i-obtain-and-use-a-short-lived-api-access-token-from-okta).
2. Call the `GetValuation` API, specifying:
  - The `scope` and `code` of a transaction portfolio (or a list of portfolios). For a portfolio group, set `portfolioEntityType` to `GroupPortfolio`.
  - A `valuationSchedule` consisting of an `effectiveAt` valuation date. If you omit the time component, valuation occurs at 00:00:00. To specify a range of dates and have LUSID produce a separate report for each weekday in the range (by default, [Saturdays and Sundays](/v1/docs/scheduling-a-valuation#performing-a-valuation-at-the-weekend) are omitted), set `effectiveFrom` to the start date and `effectiveAt` to the end date. You can optionally specify tenors, holiday calendars and roll and business day conventions to adjust scheduled valuation dates that do not occur on good business days. [More information](/v1/docs/scheduling-a-valuation).
  - The `scope` and `code` of a [recipe](/v1/docs/what-is-a-recipe) that, at a minimum, locates market data suitable for the types of instruments you wish to value for each day in the valuation schedule.
  - At least one [metric](/v1/docs/what-is-a-metric) that reports meaningful information for the types of instruments you wish to value. You can [include properties in valuation reports](/v1/docs/including-properties-and-derived-properties-in-valuation-reports) too.
  - Optionally, one or more metrics to group by. If you omit a grouping, one result is produced per holding (this may mean multiple results are reported for the same underlying instrument if holdings have been divided into tax lots or strategies). [Find out more about grouping and aggregation](/v1/docs/grouping-and-aggregating-metrics-to-create-a-meaningful-valuation-report).
  - Optionally, one or more metrics to sort and filter results by.
  - Optionally, whether you want to `IncludeOrderFlows` in the valuation in addition to booked transactions. You can include `Allocations` or `OrdersAndAllocations`. [More information.](/v1/docs/what-is-an-allocation-in-lusid)

The following example:

- Values [this sample transaction portfolio](/v1/docs/valuing-a-multi-asset-multi-region-portfolio) every day between Monday 7 March and Friday 11 March 2022 inclusive.
- Reports the valuation date, cost, PV and PnL (PV minus cost) metrics.
- Groups by valuation date and sums the numeric metrics to produce a total for the portfolio each day. Note for cash amounts it only makes sense to sum metrics in the same currency.
- Sorts results by the valuation date, earliest first.

```json
curl -X POST "https://<your-domain>.lusid.com/api/api/aggregation/$valuation"
  -H "Authorization: Bearer <your-API-access-token>"
  -H "Content-Type: application/json-patch+json"
  -d '{
    "portfolioEntityIds": [ {"scope": "FBNUniversity", "code": "Module-4-1", "portfolioEntityType": "SinglePortfolio"} ],
    "valuationSchedule": {"effectiveFrom": "2022-03-07T00:00:00.0000000+00:00", "effectiveAt": "2022-03-11T00:00:00.0000000+00:00" },
    "recipeId": {"scope": "FBNUniversity", "code": "Module-4-1Recipe"},
    "metrics": [
      {"key": "Valuation/EffectiveAt", "op": "Value"},
      {"key": "Holding/Cost/Pfolio", "op": "Sum"},
      {"key": "Valuation/PvInPortfolioCcy", "op": "Sum"},
      {"key": "Valuation/PnL/Unrealised/PfolioCcy", "op": "Sum"},
    ],
    "groupBy": ["Valuation/EffectiveAt"],
    "sort": [ {"key": "Valuation/EffectiveAt", "sortOrder": "Ascending"} ]
  }'
```

The response might look like this (transformed to a Pandas dataframe and with columns renamed for clarity):

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/82facf83-c7a1-462b-abf0-020d8f56914e.png)

## Using the LUSID web app

1. [Sign in to the LUSID web app](https://www.lusid.com/app/home).
2. Navigate to **Dashboard > Valuation** and follow the instructions:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(588).png)

## Using Luminesce

You can use the [Lusid.Portfolio.Valuation](/v1/docs/lusidportfoliovaluation) provider