Order Status

Introduction

EWrapper.orderStatus gives the up-to-date information of an order every time it changes. Often there are duplicate orderStatus messages.

EWrapper.orderStatus(orderId, status, filled, remaining, avgFillPrice, permId, parentId, lastFillPrice, clientId, whyHeld, mktCapPrice)

orderId

int

The order’s client id.

status

string

The current status of the order.

filled

decimal

Number of filled positions.

remaining

decimal

The remnant positions.

avgFillPrice

double

Average filling price.

permId

int

The order’s permId used by the TWS to identify orders.

parentId

int

Parent’s id. Used for bracket and auto trailing stop orders.

lastFillPrice

double

Price at which the last positions were filled.

clientId

int

API client which submitted the order.

whyHeld

string

This field is used to identify an order held when TWS is trying to locate shares for a short sell. The value used to indicate this is ‘locate’.

mktCapPrice

double

If an order has been capped, this indicates the current capped price.

Python

Java

C++

C#

VB.NET

def orderStatus(self, orderId: OrderId, status: str, filled: Decimal, remaining: Decimal, avgFillPrice: float, permId: int, parentId: int, lastFillPrice: float, clientId: int, whyHeld: str, mktCapPrice: float):
	super().orderStatus(orderId, status, filled, remaining, avgFillPrice, permId, parentId, lastFillPrice, clientId, whyHeld, mktCapPrice)

Understanding Order Status Message

Status	Description
Inactive	Indicates that you are in the process of creating an order and you have not yet activated or transmitted it.
PendingSubmit	Indicates that you have transmitted your order, but have not yet received confirmation that it has been accepted by the order destination.
PreSubmitted	Indicates that an order has been accepted by the system (simulated orders) or an exchange (native orders) and that this order has yet to be elected.
Submitted	Indicates that your order has been accepted and is working at the destination.
Filled	Order has been completely filled.
PendingCancel	Indicates that you have sent a request to cancel the order but have not yet received cancel confirmation from the order destination. At this point, your order is not confirmed canceled. You may still receive an execution while your cancellation request is pending.
PreCancelled	Indicates that a cancellation request has been accepted by the system but that currently the request is not being recognized, due to system, exchange or other issues. At this point, your order is not confirmed canceled. You may still receive an execution while your cancellation request is pending.
Cancelled	Indicates that the balance of your order has been confirmed canceled by the system. This could occur unexpectedly when the destination has rejected your order.
WarnState	Order has a specific warning message such as for basket orders.