> This page is for TWS API.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://interactivebrokers.com/docs/llms.txt.

# Order Conditioning

Order Conditions are a set of parameters attached to an order that allow the order to either be placed or cancel upon achieving the condition criteria. There are 6 unique Order Conditions that can be applied to a given order: Price, Time, Margin, Execution, Volume, and PercentChange.

Order Conditions can be applied to nearly any order and more than one condition can be attached to an individual order using to be Inclusive, "AND", or Exclusive, "OR".

More information on Order Conditions can be found [here](https://www.ibkrguides.com/riskprofile/usersguidebook/ordertypes/conditionaltest.htm).

For the sake of simplicity, all Condition Orders below will be based on an example order, shown here. The additional content will be included in each order's content.

#### Python

```python
base_order = Order()
base_order.action = action
base_order.orderType = "MKT"
base_order.totalQuantity = quantity
base_order.conditionsCancelOrder = False
```

#### Java

```java
Order base_order= new Order();
base_order.action(action);
base_order.orderType("MKT");
base_order.totalQuantity(quantity);
base_order.conditionsCancelOrder(false);
```

#### C++

```cpp
Order base_order;
base_order.action = action;
base_order.orderType = "MKT";
base_order.totalQuantity = quantity;
base_order.conditionsCancelOrder = false;
```

#### C\#

```csharp
Order base_order= new Order();
base_order.Action = action;
base_order.OrderType = "MKT";
base_order.TotalQuantity = quantity;
base_order.ConditionsCancelOrder = false;
```

#### VB.NET

```vbnet
Dim base_order As Order = New Order
base_order.Action = action
base_order.OrderType = "MKT"
base_order.TotalQuantity = quantity
base_order.ConditionsCancelOrder = false
```

## Price Conditions

A Price Condition will trigger if an order should transmit or cancel when a given contract's price goes above or beyond a given threshold.

See [PriceCondition](/docs/tws-api/ref/order-conditions/price-condition) for more details on the PriceCondition class.

#### Python

```python
priceCondition = PriceCondition()
priceCondition.conId = conId
priceCondition.exchange = exchange
priceCondition.isMore = isMore
priceCondition.triggerMethod = triggerMethod
priceCondition.price = price

base_order.conditions = [priceCondition]
```

#### Java

```java
PriceCondition priceCondition = (PriceCondition)OrderCondition.create(OrderConditionType.Price);
priceCondition.conId(conId);
priceCondition.exchange(exchange);
priceCondition.isMore(isMore);
priceCondition.price(price);
priceCondition.conjunctionConnection(isConjunction);

base_order.conditions().add(priceCondition)
```

#### C++

```cpp
PriceCondition* priceCondition = dynamic_cast<PriceCondition *>(OrderCondition::create(OrderCondition::OrderConditionType::Price));
priceCondition->conId(conId);
priceCondition->exchange(exchange);
priceCondition->isMore(isMore);
priceCondition->price(price);
priceCondition->conjunctionConnection(isConjunction);

base_order.conditions->push_back(priceCondition);
```

#### C\#

```csharp
PriceCondition priceCondition = (PriceCondition)OrderCondition.Create(OrderConditionType.Price);
priceCondition.ConId = conId;
priceCondition.Exchange = exchange;
priceCondition.IsMore = isMore;
priceCondition.Price = price;
priceCondition.IsConjunctionConnection = isConjunction;

base_order.Conditions = new List();
base_order.Conditions.Add(priceCondition);
```

#### VB.NET

```vbnet
Dim _priceCondition As PriceCondition = OrderCondition.Create(OrderConditionType.Price) 
_priceCondition.ConId = conId
_priceCondition.Exchange = exchange
_priceCondition.IsMore = isMore
_priceCondition.Price = price
_priceCondition.IsConjunctionConnection = isConjunction

base_order.Conditions = New List()
base_order.Conditions.Add(_priceCondition)
```

## Time Conditions

The Time Condition will trigger an order for submission or cancellation after a time has been reached.

See [TimeCondition](/docs/tws-api/ref/order-conditions/time-condition) for more details on the TimeCondition class.

#### Python

```python
timeCondition = order_condition.Create(OrderCondition.Time)
timeCondition.isMore = isMore
timeCondition.time = time   
timeCondition.isConjunctionConnection = isConjunction

base_order.conditions = [timeCondition]
```

#### Java

```java
TimeCondition timeCondition = (TimeCondition)OrderCondition.create(OrderConditionType.Time);
timeCondition.isMore(isMore);
timeCondition.time(time);
timeCondition.conjunctionConnection(isConjunction);

base_order.conditions().add(timeCondition)
```

#### C++

```cpp
TimeCondition* timeCondition = dynamic_cast<TimeCondition *>(OrderCondition::create(OrderCondition::OrderConditionType::Time));
timeCondition->isMore(isMore);
timeCondition->time(time);
timeCondition->conjunctionConnection(isConjunction);

base_order.conditions->push_back(timeCondition);
```

#### C\#

```csharp
TimeCondition timeCondition = (TimeCondition)OrderCondition.Create(OrderConditionType.Time);
timeCondition.IsMore = isMore;
timeCondition.Time = time;
timeCondition.IsConjunctionConnection = isConjunction;

base_order.Conditions = new List();
base_order.Conditions.Add(timeCondition);
```

#### VB.NET

```vbnet
Dim _TimeCondition As TimeCondition = OrderCondition.Create(OrderConditionType.Time)
_TimeCondition.IsMore = isMore
_TimeCondition.Time = time
_TimeCondition.IsConjunctionConnection = isConjunction

base_order.Conditions = New List()
base_order.Conditions.Add(_TimeCondition)
```

## Margin Conditions

Margin Conditions permit users to ready an order in case their order starts falling to a given threshold that may lead to liquidation or to submit an order after ample margin cushion has been established.

See [MarginCondition](/docs/tws-api/ref/order-conditions/margin-condition) for more details on the MarginCondition class.

#### Python

```python
marginCondition = order_condition.Create(OrderCondition.Margin)
marginCondition.isMore = isMore
marginCondition.percent = percent
marginCondition.isConjunctionConnection = isConjunction

base_order.conditions = [marginCondition]
```

#### Java

```java
MarginCondition marginCondition = (MarginCondition)OrderCondition.create(OrderConditionType.Margin);
marginCondition.isMore(isMore);
marginCondition.percent(percent);
marginCondition.conjunctionConnection(isConjunction);

base_order.conditions().add(marginCondition)
```

#### C++

```cpp
MarginCondition* marginCondition = dynamic_cast<MarginCondition *>(OrderCondition::create(OrderCondition::OrderConditionType::Margin));
marginCondition->percent(percent);
marginCondition->isMore(isMore);
marginCondition->conjunctionConnection(isConjunction);

base_order.conditions->push_back(marginCondition);
```

#### C\#

```csharp
MarginCondition marginCondition = (MarginCondition)OrderCondition.Create(OrderConditionType.Margin);
marginCondition.IsMore = isMore;
marginCondition.Percent = percent;
marginCondition.IsConjunctionConnection = isConjunction;

base_order.Conditions = new List();
base_order.Conditions.Add(marginCondition);
```

#### VB.NET

```vbnet
Dim _MarginCondition As MarginCondition = OrderCondition.Create(OrderConditionType.Margin) ' cast to (MarginCondition)
_MarginCondition.IsMore = isMore
_MarginCondition.Percent = percent
_MarginCondition.IsConjunctionConnection = isConjunction

base_order.Conditions = New List()
base_order.Conditions.Add(_MarginCondition)
```

## Execution Conditions

The Execution Condition triggers an order whenever another order on your account has executed. The parameters allow the developer to specify how narrow a scope will trigger a condition.

See [ExecutionCondition](/docs/tws-api/ref/order-conditions/execution-condition) for more details on the ExecutionCondition class.

#### Python

```python
execCondition = order_condition.Create(OrderCondition.Execution)
execCondition.symbol = symbol
execCondition.exchange = exchange
execCondition.secType = secType

base_order.conditions = [execCondition]
```

#### Java

```java
 ExecutionCondition execCondition = (ExecutionCondition)OrderCondition.create(OrderConditionType.Execution);
execCondition.symbol(symbol);
execCondition.exchange(exchange);
execCondition.secType(secType);
execCondition.conjunctionConnection(isConjunction);

base_order.conditions().add(execCondition)
```

#### C++

```cpp
 ExecutionCondition* execCondition = dynamic_cast<ExecutionCondition *>(OrderCondition::create(OrderCondition::OrderConditionType::Execution));
execCondition->symbol(symbol);
execCondition->exchange(exchange);
execCondition->secType(secType);
execCondition->conjunctionConnection(isConjunction);

base_order.conditions->push_back(execCondition)
```

#### C\#

```csharp
ExecutionCondition execCondition = (ExecutionCondition)OrderCondition.Create(OrderConditionType.Execution);
execCondition.Symbol = symbol;
execCondition.Exchange = exchange;
execCondition.SecType = secType;
execCondition.IsConjunctionConnection = isConjunction;

base_order.Conditions = new List();
base_order.Conditions.Add(execCondition);
```

#### VB.NET

```vbnet
Dim execCondition As ExecutionCondition = OrderCondition.Create(OrderConditionType.Execution) ' cast to (ExecutionCondition)
execCondition.Symbol = symbol
execCondition.Exchange = exchange
execCondition.SecType = secType
execCondition.IsConjunctionConnection = isConjunction

base_order.Conditions = New List()
base_order.Conditions.Add(execCondition)
```

## Volume Conditions

Volume Condition will trigger in the event the contract's volume remains above or below a given threshold.

**Note:** VolumeCondition orders must be SMART routed.

See [VolumeCondition](/docs/tws-api/ref/order-conditions/volume-condition) for more details on the VolumeCondition class.

#### Python

```python
volCond = order_condition.Create(OrderCondition.Volume)
volCond.conId = conId
volCond.exchange = exchange
volCond.isMore = isMore
volCond.volume = volume
volCond.isConjunctionConnection = isConjunction
```

#### Java

```java
VolumeCondition volCon = (VolumeCondition)OrderCondition.create(OrderConditionType.Volume);
volCon.conId(conId);
volCon.exchange(exchange);
volCon.isMore(isMore);
volCon.volume(volume);
volCon.conjunctionConnection(isConjunction);
```

#### C++

```cpp
VolumeCondition* volCondition = dynamic_cast<VolumeCondition *>(OrderCondition::create(OrderCondition::OrderConditionType::Volume));
volCondition->conId(conId);
volCondition->exchange(exchange);
volCondition->isMore(isMore);
volCondition->volume(volume);
volCondition->conjunctionConnection(isConjunction);
```

#### C\#

```csharp
VolumeCondition volCond = (VolumeCondition)OrderCondition.Create(OrderConditionType.Volume);
volCond.ConId = conId;
volCond.Exchange = exchange;
volCond.IsMore = isMore;
volCond.Volume = volume;
volCond.IsConjunctionConnection = isConjunction;
```

#### VB.NET

```vbnet
 Dim volCond As VolumeCondition = OrderCondition.Create(OrderConditionType.Volume) 'cast (VolumeCondition)
volCond.ConId = conId
volCond.Exchange = exchange
volCond.IsMore = isMore
volCond.Volume = volume
volCond.IsConjunctionConnection = isConjunction
```

## Percentage Conditions

The Percent Change Condition will trigger if there is a price percent change measured against last close price.

See [PercentChangeCondition](/docs/tws-api/ref/order-conditions/percentage-condition) for more details on the PercentChangeCondition class.

#### Python

```python
 pctChangeCondition = order_condition.Create(OrderCondition.PercentChange)
pctChangeCondition.isMore = isMore
pctChangeCondition.changePercent = pctChange
pctChangeCondition.conId = conId
pctChangeCondition.exchange = exchange
pctChangeCondition.isConjunctionConnection = isConjunction

base_order.conditions = [pctChangeCondition]
```

#### Java

```java
PercentChangeCondition pctChangeCondition = (PercentChangeCondition)OrderCondition.create(OrderConditionType.PercentChange);
pctChangeCondition.isMore(isMore);
pctChangeCondition.changePercent(pctChange);
pctChangeCondition.conId(conId);
pctChangeCondition.exchange(exchange);
pctChangeCondition.conjunctionConnection(isConjunction);

base_order.conditions().add(pctChangeCondition)
```

#### C++

```cpp
PercentChangeCondition* pctChangeCondition = dynamic_cast<PercentChangeCondition *>(OrderCondition::create(OrderCondition::OrderConditionType::PercentChange));
pctChangeCondition->isMore(isMore);
pctChangeCondition->changePercent(pctChange);
pctChangeCondition->conId(conId);
pctChangeCondition->exchange(exchange);
pctChangeCondition->conjunctionConnection(isConjunction);

base_order.conditions->push_back(pctChangeCondition);
```

#### C\#

```csharp
PercentChangeCondition pctChangeCondition = (PercentChangeCondition)OrderCondition.Create(OrderConditionType.PercentCange);
pctChangeCondition.IsMore = isMore;
pctChangeCondition.ChangePercent = pctChange;
pctChangeCondition.ConId = conId;
pctChangeCondition.Exchange = exchange;
pctChangeCondition.IsConjunctionConnection = isConjunction;

base_order.Conditions = new List();
base_order.Conditions.Add(pctChangeCondition);
```

#### VB.NET

```vbnet
Dim pctChangeCondition As PercentChangeCondition = OrderCondition.Create(OrderConditionType.PercentCange)
pctChangeCondition.IsMore = isMore
pctChangeCondition.ChangePercent = pctChange
pctChangeCondition.ConId = conId
pctChangeCondition.Exchange = exchange
pctChangeCondition.IsConjunctionConnection = isConjunction

base_order.Conditions = New List()
base_order.Conditions.Add(pctChangeCondition)
```