How do I create a valuation point?

You can create a valuation point for a fund that you can then use to publish an official valuation of that fund as part of a workflow.

Note that a valuation point is an accounting diary entry of type ValuationPoint. It shares some characteristics with other types of diary entry, though certain behaviour and implications are unique.

Using the LUSID web app

1. Sign in to the LUSID web app as a user with suitable permissions.

2. From the top left menu, select Financial Reporting > Accounting Diary.

3. Select a fund.

4. Click the Create valuation point button and follow the instructions. For more information on the fields, see this section.
   

Using Luminesce

You can use the Lusid.Fund.ValuationPoint.Writer provider.

Using the LUSID API

1. Obtain an API access token.

2. Call the UpsertDiaryEntryTypeValuationPoint API, specifying a scope and code in the URL and, in the body of the request:

   • A diaryEntryCode that is unique among all diary entries of type ValuationPoint for this fund.

   • Optionally, a meaningful name.

   • An effectiveAt datetime at which to value the fund.

   • Optionally, a queryAsAt datetime at which to query the system. This can be the same as effectiveAt, or any subsequent datetime. In most circumstances, we recommend omitting this parameter to use the current system datetime of the API request (see below).

   • Optionally in the properties collection, any number of custom properties from the DiaryEntry domain to extend the data model.

Consider the following example, of a call made at 7pm to create a valuation point with a unique diaryEntryCode of 04June2024-5pm-asAt7pm that values a fund at exactly 5pm UTC on 4 June 2024 using all the data the system knows about at the time of the request:

curl -X POST 'https://<your-domain>.lusid.com/api/api/funds/MyFunds/Income/valuationpoints/$upsert'  
  -H 'Content-Type: application/json-patch+json'
  -H 'Authorization: Bearer <your-API-access-token>'
  -d '{
  "diaryEntryCode": "04June2024-5pm-asAt7pm",
  "effectiveAt": "2024-06-04T17:00:00Z"
}'

In the response, LUSID confirms default values for omitted fields. Note the status is Estimate and previousEntryTime is 1 January 0001, which means this is the first valuation point created for this fund:

{
  "aborId": {
    "scope": "MyFunds",
    "code": "Income"
  },
  "diaryEntryCode": "04June2024-5pm-asAt7pm",
  "type": "ValuationPoint",
  "name": "04June2024-5pm-asAt7pm",
  "status": "Estimate",
  "effectiveAt": "2024-06-04T17:00:00.0000000+00:00",
  "queryAsAt": "2024-06-04T19:00:00.2305300+00:00",
  "previousEntryTime": "0001-01-01T00:00:00.0000000+00:00",
  "properties": {},
  ...
}