How do I create a compliance rule?

A compliance rule applies a sequence of grouping and filtering operations to your valued holdings, then checks the result against a limit you define. Familiarise yourself with how compliance rules, templates, and operations work before creating your own; see understanding compliance rules in LUSID.

Provided you have suitable access control permissions, you can create a wide range of compliance rules to use in pre- and post-trade compliance runs. See what compliance rules LUSID supports.

• Method 1: Using the LUSID web app

• Method 2: Using the LUSID API

Using the LUSID web app

Compliance wizard for supported templates

We recommend using the Compliance wizard to create compliance rules for supported templates. This method guides you through every step of creating a compliance rule, from choosing your portfolio group to building your sequence of operations and the final pass/fail check.

To get started:

1. Sign in to the LUSID web app and navigate to Portfolio Management > Compliance Rules.

2. Select Create compliance rule with wizard.
   

3. Follow the instructions on the screen. If you need more detail than the wizard provides, see understanding compliance rules in LUSID.
   

Creating a rule without the wizard

You can also use the LUSID web app to create compliance rules from any supplied or custom template. To do this:

1. Sign in to the LUSID web app and navigate to Portfolio Management > Compliance Rules:
    

2. Select Create compliance rule.
    

3. Supply the following:

   • A Scope and RuleID that together uniquely identify the compliance rule.

     Note

     The default Scope is PMS. An enabled rule in this scope is automatically included in pre-trade compliance runs in the Order Blotter.

   • A friendly Name and Description for the rule.

   • The Portfolio Group that the rule applies to.

   • Whether the rule should be enabled as soon as it’s created.

4. Select a Template and Template variation. Each template defines a sequence of operations. You supply the values those operations use. You can read a variation’s Description to learn more about it.
    

5. Provide the required values for the operations in your rule. You must specify a reference list for certain operations; see how to create a reference list.
   For example, to create a rule checking that no portfolio exceeds 20% exposure to any one country, you might select the PercentCheck template with its standard variation. You could then supply the following values to create your rule:
    

6. Click Save to create your rule.

See how to run pre-trade compliance and view the results.

Using the LUSID API

You can create and manage compliance rules programmatically by calling the UpsertComplianceRule endpoint.

Use the LUSID API when no existing template covers the rule you need. You can create a custom template, then create rules from it.

If you are creating a rule from a FINBOURNE template, we recommend using the LUSID web app, which shows you exactly which parameters the variation you have chosen requires.