ListStatus message – FIX.5.0 – FIX Reference

MsgTypeN

CategoryProgramTrading

SectionTrade

AddedFIX.2.7

Fields59

Components4

The list status message is issued as the response to a List Status Request message sent in an unsolicited fashion by the sell-side. It indicates the current state of the orders within the list as they exist at the broker's site. This message may also be used to respond to the List Cancel Request.

Message Structure

59 fields, 4 components/groups — click any tag or field name for details

Tag

Name

Type

Req

Description

Added

◈ StandardHeader [Component]

MsgType = N

FIX.2.7

BeginString

String

FIXT.1.1 (Always unencrypted, must be first field in message)

FIX.4.0

BodyLength

Length

(Always unencrypted, must be second field in message)

FIX.4.0

MsgType

String

(Always unencrypted, must be third field in message)

▶ 101 enum values

Value	Name	Description
0	Heartbeat	Heartbeat
1	TestRequest	Test Request
2	ResendRequest	Resend Request
3	Reject	Reject
4	SequenceReset	Sequence Reset
5	Logout	Logout
6	IOI	Indication of Interest
7	Advertisement	Advertisement
8	ExecutionReport	Execution Report
9	OrderCancelReject	Order Cancel Reject
A	Logon	Logon
B	News	News
C	Email	Email
D	NewOrderSingle	New Order - Single
E	NewOrderList	New Order - List
F	OrderCancelRequest	Order Cancel Request
G	OrderCancelReplaceRequest	Order Cancel/Replace Request (a.k.a. Order Modification Request)
H	OrderStatusRequest	Order Status Request
J	AllocationInstruction	Allocation Instruction
K	ListCancelRequest	List Cancel Request
L	ListExecute	List Execute
M	ListStatusRequest	List Status Request
N	ListStatus	List Status
P	AllocationInstructionAck	Allocation Instruction Ack
Q	DontKnowTrade	Don't Know Trade (DK)
R	QuoteRequest	Quote Request
S	Quote	Quote
T	SettlementInstructions	Settlement Instructions
V	MarketDataRequest	Market Data Request
W	MarketDataSnapshotFullRefresh	Market Data - Snapshot/Full Refresh
X	MarketDataIncrementalRefresh	Market Data - Incremental Refresh
Y	MarketDataRequestReject	Market Data Request Reject
Z	QuoteCancel	Quote Cancel
a	QuoteStatusRequest	Quote Status Request
b	MassQuoteAcknowledgement	Mass Quote Acknowledgement
c	SecurityDefinitionRequest	Security Definition Request
d	SecurityDefinition	Security Definition
e	SecurityStatusRequest	Security Status Request
f	SecurityStatus	Security Status
g	TradingSessionStatusRequest	Trading Session Status Request
h	TradingSessionStatus	Trading Session Status
i	MassQuote	Mass Quote
j	BusinessMessageReject	Business Message Reject
k	BidRequest	Bid Request
l	BidResponse	Bid Response (lowercase L)
m	ListStrikePrice	List Strike Price
n	XMLNonFIX	XML message (e.g. non FIX Msg Type)
o	RegistrationInstructions	Registration Instructions
p	RegistrationInstructionsResponse	Registration Instructions Response
q	OrderMassCancelRequest	Order Mass Cancel Request
r	OrderMassCancelReport	Order Mass Cancel Report
s	NewOrderCross	New Order - Cross
t	CrossOrderCancelReplaceRequest	Cross Order Cancel/Replace Request (a.k.a. Cross Order Modification Request)
u	CrossOrderCancelRequest	Cross Order Cancel Request
v	SecurityTypeRequest	Security Type Request
w	SecurityTypes	Security Types
x	SecurityListRequest	Security List Request
y	SecurityList	Security List
z	DerivativeSecurityListRequest	Derivative Security List Request
AA	DerivativeSecurityList	Derivative Security List
AB	NewOrderMultileg	New Order - Multileg
AC	MultilegOrderCancelReplace	Multileg Order Cancel/Replace (a.k.a. Multileg Order Modification Request)
AD	TradeCaptureReportRequest	Trade Capture Report Request
AE	TradeCaptureReport	Trade Capture Report
AF	OrderMassStatusRequest	Order Mass Status Request
AG	QuoteRequestReject	Quote Request Reject
AH	RFQRequest	RFQ Request
AI	QuoteStatusReport	Quote Status Report
AJ	QuoteResponse	Quote Response
AK	Confirmation	Confirmation
AL	PositionMaintenanceRequest	Position Maintenance Request
AM	PositionMaintenanceReport	Position Maintenance Report
AN	RequestForPositions	Request For Positions
AO	RequestForPositionsAck	Request For Positions Ack
AP	PositionReport	Position Report
AQ	TradeCaptureReportRequestAck	Trade Capture Report Request Ack
AR	TradeCaptureReportAck	Trade Capture Report Ack
AS	AllocationReport	Allocation Report (a.k.a. Allocation Claim)
AT	AllocationReportAck	Allocation Report Ack (a.k.a. Allocation Claim Ack)
AU	ConfirmationAck	Confirmation Ack (a.k.a. Affirmation)
AV	SettlementInstructionRequest	Settlement Instruction Request
AW	AssignmentReport	Assignment Report
AX	CollateralRequest	Collateral Request
AY	CollateralAssignment	Collateral Assignment
AZ	CollateralResponse	Collateral Response
BA	CollateralReport	Collateral Report
BB	CollateralInquiry	Collateral Inquiry
BC	NetworkCounterpartySystemStatusRequest	Network Counterparty System Status Request
BD	NetworkCounterpartySystemStatusResponse	Network Counterparty System Status Response
BE	UserRequest	User Request
BF	UserResponse	User Response
BG	CollateralInquiryAck	Collateral Inquiry Ack
BH	ConfirmationRequest	Confirmation Request
BI	TradingSessionListRequest	Trading Session List Request
BJ	TradingSessionList	Trading Session List
BK	SecurityListUpdateReport	Security List Update Report
BL	AdjustedPositionReport	Adjusted Position Report
BM	AllocationInstructionAlert	Allocation Instruction Alert
BN	ExecutionAcknowledgement	Execution Acknowledgement
BO	ContraryIntentionReport	Contrary Intention Report
BP	SecurityDefinitionUpdateReport	Security Definition Update Report

FIX.4.0

1128

ApplVerID

String

Indicates application version using a service pack identifier. The ApplVerID applies to a specific message occurrence.

▶ 8 enum values

Value	Name	Description
0	FIX27	FIX27
1	FIX30	FIX30
2	FIX40	FIX40
3	FIX41	FIX41
4	FIX42	FIX42
5	FIX43	FIX43
6	FIX44	FIX44
7	FIX50	FIX50

FIX.4.4

1129

CstmApplVerID

String

Used to support bilaterally agreed custom functionality

FIX.4.4

SenderCompID

String

(Always unencrypted)

FIX.4.0

TargetCompID

String

(Always unencrypted)

FIX.4.0

115

OnBehalfOfCompID

String

Trading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)

FIX.4.0

128

DeliverToCompID

String

Trading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)

FIX.4.0

SecureDataLen

Length

Required to identify length of encrypted section of message. (Always unencrypted)

FIX.4.0

SecureData

data

Required when message body is encrypted. Always immediately follows SecureDataLen field.

FIX.4.0

MsgSeqNum

SeqNum

(Can be embedded within encrypted data section.)

FIX.4.0

SenderSubID

String

(Can be embedded within encrypted data section.)

FIX.4.0

142

SenderLocationID

String

Sender's LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)

FIX.4.1

TargetSubID

String

"ADMIN" reserved for administrative messages not intended for a specific user. (Can be embedded within encrypted data section.)

FIX.4.0

143

TargetLocationID

String

Trading partner LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)

FIX.4.1

116

OnBehalfOfSubID

String

Trading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)

FIX.4.0

144

OnBehalfOfLocationID

String

Trading partner LocationID (i.e. geographic location and/or desk) used when delivering messages via a third party. (Can be embedded within encrypted data section.)

FIX.4.1

129

DeliverToSubID

String

Trading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)

FIX.4.0

145

DeliverToLocationID

String

Trading partner LocationID (i.e. geographic location and/or desk) used when delivering messages via a third party. (Can be embedded within encrypted data section.)

FIX.4.1

PossDupFlag

Boolean

Always required for retransmitted messages, whether prompted by the sending system or as the result of a resend request. (Can be embedded within encrypted data section.)

▶ 2 enum values

Value	Name	Description
N	OriginalTransmission	Original transmission
Y	PossibleDuplicate	Possible duplicate

FIX.4.0

PossResend

Boolean

Required when message may be duplicate of another message sent under a different sequence number. (Can be embedded within encrypted data section.)

▶ 2 enum values

Value	Name	Description
N	OriginalTransmission	Original Transmission
Y	PossibleResend	Possible Resend

FIX.4.0

SendingTime

UTCTimestamp

(Can be embedded within encrypted data section.)

FIX.4.0

122

OrigSendingTime

UTCTimestamp

Required for message resent as a result of a ResendRequest. If data is not available set to same value as SendingTime (Can be embedded within encrypted data section.)

FIX.4.0

212

XmlDataLen

Length

Required when specifying XmlData to identify the length of a XmlData message block. (Can be embedded within encrypted data section.)

FIX.4.2

213

XmlData

data

Can contain a XML formatted message block (e.g. FIXML). Always immediately follows XmlDataLen field. (Can be embedded within encrypted data section.) See Volume 1: FIXML Support

FIX.4.2

347

MessageEncoding

String

Type of message encoding (non-ASCII characters) used in a message’s "Encoded" fields. Required if any "Encoding" fields are used.

FIX.4.2

369

LastMsgSeqNumProcessed

SeqNum

The last MsgSeqNum value received by the FIX engine and processed by downstream application, such as trading system or order routing system. Can be specified on every message sent. Useful for detecting a backlog with a counterparty.

FIX.4.2

◈ HopGrp [Component]

Number of repeating groups of historical "hop" information. Only applicable if OnBehalfOfCompID is used, however, its use is optional. Note that some market regulations or counterparties may require tracking of message hops.

FIX.4.4

627

NoHops

NumInGroup

Number of HopCompID entries in repeating group.

FIX.4.4

628

HopCompID

String

Assigned value used to identify the third party firm which delivered a specific message either from the firm which originated the message or from another third party (if multiple "hops" are performed). It is recommended that this value be the SenderCompID (49) of the third party. Applicable when messages are communicated/re-distributed via third parties which function as service bureaus or "hubs". Only applicable if OnBehalfOfCompID (115) is being used.

FIX.4.4

629

HopSendingTime

UTCTimestamp

Time that HopCompID (628) sent the message. It is recommended that this value be the SendingTime (52) of the message sent by the third party. Applicable when messages are communicated/re-distributed via third parties which function as service bureaus or "hubs". Only applicable if OnBehalfOfCompID (115) is being used.

FIX.4.4

630

HopRefID

SeqNum

Reference identifier assigned by HopCompID (628) associated with the message sent. It is recommended that this value be the MsgSeqNum (34) of the message sent by the third party. Applicable when messages are communicated/re-distributed via third parties which function as service bureaus or "hubs". Only applicable if OnBehalfOfCompID (115) is being used.

FIX.4.4

ListID

String

Unique identifier for list as assigned by institution, used to associate multiple individual orders. Uniqueness must be guaranteed within a single trading day. Firms which generate multi-day orders should consider embedding a date within the ListID field to assure uniqueness across days.

FIX.2.7

429

ListStatusType

int

Code to represent the status type.

▶ 6 enum values

Value	Name	Description
1	Ack	Ack
2	Response	Response
3	Timed	Timed
4	ExecStarted	Exec Started
5	AllDone	All Done
6	Alert	Alert

FIX.4.2

NoRpts

int

Total number of messages required to status complete list.

FIX.2.7

431

ListOrderStatus

int

Code to represent the status of a list order.

▶ 7 enum values

Value	Name	Description
1	InBiddingProcess	In bidding process
2	ReceivedForExecution	Received for execution
3	Executing	Executing
4	Cancelling	Cancelling
5	Alert	Alert
6	AllDone	All Done
7	Reject	Reject

FIX.4.2

RptSeq

int

Sequence number of this report message.

FIX.2.7

444

ListStatusText

String

Free format text string related to List Status.

FIX.4.2

445

EncodedListStatusTextLen

Length

Must be set if EncodedListStatusText field is specified and must immediately precede it.

FIX.4.2

446

EncodedListStatusText

data

Encoded (non-ASCII characters) representation of the ListStatusText field in the encoded format specified via the MessageEncoding field.

FIX.4.2

TransactTime

UTCTimestamp

Time of execution/order creation (expressed in UTC (Universal Time Coordinated, also known as "GMT")

FIX.4.2

TotNoOrders

int

Used to support fragmentation. Sum of NoOrders across all messages with the same ListID.

FIX.4.2

893

LastFragment

Boolean

Indicates whether this is the last fragment in a sequence of message fragments. Only required where message has been fragmented.

▶ 2 enum values

Value	Name	Description
N	NotLastMessage	Not Last Message
Y	LastMessage	Last Message

FIX.4.4

⟳ OrdListStatGrp [Repeating Group]

Number of orders statused in this message, i.e. number of repeating groups to follow.

FIX.4.4

NoOrders

NumInGroup

Number of orders statused in this message, i.e. number of repeating groups to follow.

FIX.4.4

ClOrdID

String

Unique identifier for Order as assigned by the buy-side (institution, broker, intermediary etc.) (identified by SenderCompID (49) or OnBehalfOfCompID (5) as appropriate). Uniqueness must be guaranteed within a single trading day. Firms, particularly those which electronically submit multi-day orders, trade globally or throughout market close periods, should ensure uniqueness across days, for example by embedding a date within the ClOrdID field.

FIX.4.4

526

SecondaryClOrdID

String

Assigned by the party which originates the order. Can be used to provide the ClOrdID (11) used by an exchange or executing system.

FIX.4.4

CumQty

Qty

Total quantity (e.g. number of shares) filled. (Prior to FIX 4.2 this field was of type int)

FIX.4.4

OrdStatus

char

Identifies current status of order. *** SOME VALUES HAVE BEEN REPLACED - See "Replaced Features and Supported Approach" *** (see Volume : "Glossary" for value definitions)

▶ 15 enum values

Value	Name	Description
0	New	New
1	PartiallyFilled	Partially filled
2	Filled	Filled
3	DoneForDay	Done for day
4	Canceled	Canceled
5	Replaced	Replaced (No longer used)
6	PendingCancel	Pending Cancel (i.e. result of Order Cancel Request)
7	Stopped	Stopped
8	Rejected	Rejected
9	Suspended	Suspended
A	PendingNew	Pending New
B	Calculated	Calculated
C	Expired	Expired
D	AcceptedForBidding	Accepted for Bidding
E	PendingReplace	Pending Replace (i.e. result of Order Cancel/Replace Request)

FIX.4.4

636

WorkingIndicator

Boolean

For optional use with OrdStatus = 0 (New)

▶ 2 enum values

Value	Name	Description
N	NotWorking	Order has been accepted but not yet in a working state
Y	Working	Order is currently being worked

FIX.4.4

151

LeavesQty

Qty

Quantity open for further execution. LeavesQty = OrderQty - CumQty.

FIX.4.4

CxlQty

Qty

Total quantity canceled for this order. (Prior to FIX 4.2 this field was of type int)

FIX.4.4

AvgPx

Price

Calculated average price of all fills on this order. For Fixed Income trades AvgPx is always expressed as percent-of-par, regardless of the PriceType (423) of LastPx (31). I.e., AvgPx will contain an average of percent-of-par values (see LastParPx (669)) for issues traded in Yield, Spread or Discount.

FIX.4.4

103

OrdRejReason

int

Used if the order is rejected

▶ 18 enum values

Value	Name	Description
0	BrokerCredit	Broker / Exchange option
1	UnknownSymbol	Unknown symbol
2	ExchangeClosed	Exchange closed
3	OrderExceedsLimit	Order exceeds limit
4	TooLateToEnter	Too late to enter
5	UnknownOrder	Unknown order
6	DuplicateOrder	Duplicate Order (e.g. dupe ClOrdID)
7	DuplicateOfAVerballyCommunicatedOrder	Duplicate of a verbally communicated order
8	StaleOrder	Stale order
9	TradeAlongRequired	Trade along required
10	InvalidInvestorID	Invalid Investor ID
11	UnsupportedOrderCharacteristic	Unsupported order characteristic
12	SurveillenceOption	Surveillence Option
13	IncorrectQuantity	Incorrect quantity
14	IncorrectAllocatedQuantity	Incorrect allocated quantity
15	UnknownAccount	Unknown account(s)
18	InvalidPriceIncrement	Invalid price increment
99	Other	Other