Which metrics can I include in my valuation report?

LUSID can report many hundreds of metrics about almost any aspect of the valuation process. Not all are useful, and not all may be valid for each type of instrument you wish to value.

To help you discover useful/valid metrics for a combination of a particular instrument type and a pricing model valid for that type, call either:

Note: If you find you need an additional license to use these APIs, contact Technical Support.

Consider the following example, of a call to the QueryInstrumentCapabilities API with the economic definition of a FxForward in the body of the request and the ForwardFromCurve pricing model specified in the URL:

curl -X POST "https://<your-domain>.lusid.com/api/api/instruments/capabilities?model=ForwardFromCurve"
  -H "Authorization: Bearer <your-API-access-token>"
  -H "Content-Type: application/json-patch+json"
  -d '{
        "instrumentType": "FxForward",
        "startDate": "2021-11-15T10:00:00.0000000+00:00",
        "maturityDate": "2022-05-15T10:00:00.0000000+00:00",
        "domAmount": 1000000,
        "domCcy": "EUR",
        "fgnAmount": -1200000,
        "fgnCcy": "USD"
     }'

The response contains:

  • A list of features, if available for this instrument type.

  • The market data your recipe must be able to locate.

  • Useful metrics you can include in your valuation report. As an example, see the supportedAddresses array below. Note the metrics suggested, and the format in which they are presented, may change over time: 

{
  "instrumentId": "",
  "model": "ForwardFromCurve",
  "features": [],
  "supportedAddresses": [
    "Valuation/InstrumentPV",
    "Valuation/PV",
    "Valuation/DirtyPriceKey",
    "Valuation/CleanPriceKey",
    "Valuation/InstrumentAccrued",
    "Valuation/Accrued",
    "Valuation/EffectiveAt",
    "Valuation/InstrumentExposure",
    "Valuation/Model/Name",
    "Valuation/Model/Approach",
    "Valuation/PV/Ccy",
    "Valuation/PV/Amount",
    "Valuation/CleanPV",
    "Valuation/Exposure/Ccy",
    "Valuation/Exposure/Amount",
    "Valuation/Exposure",
    "Valuation/Pnl/*
  ],
  "economicDependencies": [
   {
      "domesticCurrency": "EUR",
      "foreignCurrency": "USD",
      "curveType": "FxFwdCurve",
      "date": "0001-01-01T00:00:00.0000000+00:00",
      "dependencyType": "FxForwardsDependency"
    },
    {
      "currency": "EUR",
      "date": "0001-01-01T00:00:00.0000000+00:00",
      "dependencyType": "DiscountingDependency"
    },
    {
      "currency": "USD",
      "date": "0001-01-01T00:00:00.0000000+00:00",
      "dependencyType": "CashDependency"
    },
    {
      "currency": "EUR",
      "date": "0001-01-01T00:00:00.0000000+00:00",
      "dependencyType": "CashDependency"
    },
    {
      "domesticCurrency": "EUR",
      "foreignCurrency": "USD",
      "date": "0001-01-01T00:00:00.0000000+00:00",
      "dependencyType": "FxDependency"
    },
  ],
  ...
}

You can include any listed metric when you perform a valuation.