---
title: "Configuring contra order instruments"
slug: "configuring-contra-order-instruments"
updated: 2026-01-28T13:44:52Z
published: 2026-01-28T13:44:52Z
canonical: "support.lusid.com/configuring-contra-order-instruments"
---

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

# Configuring contra order instruments

By default, the Rebalance dashboard offsets the [present value (PV)](/v1/docs/how-does-lusid-calculate-pv) impact of a proposed order by creating an offset cash balance in the instrument’s domestic currency.

LUSID allows you to configure an alternative instrument for the offset using the `DerivedValuation/Override/OrderContraInstrumentIdentifier` property. You can use this property to configure:

- [Which instrument each portfolio uses for the offset](/v1/docs/configuring-contra-order-instruments#portfoliospecific)
- Which instrument a particular instrument uses for the offset across all portfolios
- Default portfolio-level instruments for the offset, with [instrument-level overrides](/v1/docs/configuring-contra-order-instruments#instrumentspecific-overrides)

Note the following:

- The contra instrument currency must match the order currency.
- The contra order should net out with the cash update from the original order. If this isn’t the case, LUSID places any residual cash effect in the cash balance row.
- If the contra instrument is [non-tradeable](/v1/docs/how-do-i-designate-an-instrument-as-nontradeable), the Rebalance dashboard does *not* create an order for the contra instrument when you select **Generate orders**.

> [!WARNING]
> Important
> 
> Once LUSID generates a contra order, we recommend you do *not* update the contra order value. Instead, update the value of the original order.

## Setting a portfolio-specific contra instrument

To set a default contra instrument for a particular portfolio:

1. Sign in to the [LUSID web app](https://www.lusid.com/app/home) and navigate to **Data Management > Properties** via the top left menu.
2. Create a new property type within the **Portfolio** domain, with a **Data type** of **String**. For example, `Portfolio/Finbourne-Examples/ContraLusidInstrumentId`. [Read more on creating a property type.](/v1/docs/how-do-i-create-a-property-type) ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(817).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
3. Locate the `DerivedValuation/Override/OrderContraInstrumentIdentifier` property and click the **Edit** icon. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(818).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
4. Update the **Formula** so it returns the value of the property type you created in step 2, for example `properties[Portfolio/Finbourne-Examples/ContraLusidInstrumentId]`. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(816).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
5. Navigate to **Data Management > Portfolios**.
6. Locate the portfolio you wish to configure a contra instrument for, and click the **Edit** icon.
7. Add the property you created in step 2, for example, `Portfolio/Finbourne-Examples/ContraLusidInstrumentId`. Set the value to the [LUSID Instrument ID (LUID)](/v1/docs/what-is-a-lusid-instrument-id-or-luid) of the instrument you wish to use for contra orders, then click **Next** and **Save**. [Read more on adding a property to an entity.](/v1/docs/how-do-i-add-a-property-to-an-entity) ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(815).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
8. Repeat steps 6-7 for each portfolio you wish to configure with a default contra instrument.

## Setting instrument-specific contra overrides

To set a default contra for a particular instrument:

1. Sign in to the [LUSID web app](https://www.lusid.com/app/home) and navigate to **Data Management > Properties** via the top left menu.
2. Create a new property type within the **Instrument** domain, with a **Data type** of **String**. For example, `Instrument/Finbourne-Examples/ContraLusidInstrumentId`. [Read more on creating a property type.](/v1/docs/how-do-i-create-a-property-type) ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(819).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
3. Locate the `DerivedValuation/Override/OrderContraInstrumentIdentifier` property and click the **Edit** icon. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(818).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
4. Update the **Formula** so it returns the value of the property type you created in step 2, or if unavailable, defaults to the [portfolio-specific property](/v1/docs/configuring-contra-order-instruments#setting-a-portfoliospecific-contra-instrument). For example, `coalesce(properties[Instrument/Finbourne-Examples/ContraLusidInstrumentId], properties[Portfolio/Finbourne-Examples/ContraLusidInstrumentId])`. ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(820).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
5. Navigate to **Data Management > Instruments**.
6. Locate the instrument you wish to configure a contra instrument for, and click the **Edit** icon.
7. Add the property you created in step 2, for example, `Instrument/Finbourne-Examples/ContraLusidInstrumentId`. Set the value to the [LUSID Instrument ID (LUID)](/v1/docs/what-is-a-lusid-instrument-id-or-luid) of the instrument to use for contra orders, then click **Next** and **Save**. [Read more on adding a property to an entity.](/v1/docs/how-do-i-add-a-property-to-an-entity) ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image(822).png?sv=2026-02-06&spr=https&st=2026-11-09T06%3A06%3A02Z&se=2026-11-09T07%3A06%3A02Z&sr=c&sp=r&sig=fEU7zV5F9so464ogYYQlP9%2B5YorQjJJeDLRu2i5sDFw%3D)
8. Repeat steps 6-7 for each instrument you wish to configure with a default contra instrument.