BidRequest message – FIX.5.0 – FIX Reference

MsgTypek

CategoryProgramTrading

SectionTrade

AddedFIX.4.2

Fields84

Components5

The BidRequest Message can be used in one of two ways depending on which market conventions are being followed. In the "Non disclosed" convention (e.g. US/European model) the BidRequest message can be used to request a bid based on the sector, country, index and liquidity information contained within the message itself. In the "Non disclosed" convention the entry repeating group is used to define liquidity of the program. See " Program/Basket/List Trading" for an example. In the "Disclosed" convention (e.g. Japanese model) the BidRequest message can be used to request bids based on the ListOrderDetail messages sent in advance of BidRequest message. In the "Disclosed" convention the list repeating group is used to define which ListOrderDetail messages a bid is being sort for and the directions of the required bids.

Message Structure

84 fields, 5 components/groups — click any tag or field name for details

Tag

Name

Type

Req

Description

Added

◈ StandardHeader [Component]

MsgType = k (lowercase)

FIX.4.2

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

390

BidID

String

Required to relate the bid response

FIX.4.2

391

ClientBidID

String

Unique identifier for a Bid Request as assigned by institution. Uniqueness must be guaranteed within a single trading day.

FIX.4.2

374

BidRequestTransType

char

Identifies the Bid Request message transaction type

▶ 2 enum values

Value	Name	Description
C	Cancel	Cancel
N	New	New

FIX.4.2

392

ListName

String

Descriptive name for list order.

FIX.4.2

393

TotNoRelatedSym

int

Total number of securities. (Prior to FIX 4.4 this field was named TotalNumSecurities)

FIX.4.2

394

BidType

int

e.g. "Non Disclosed", "Disclosed", No Bidding Process

▶ 3 enum values

Value	Name	Description
1	NonDisclosed	"Non Disclosed" style (e.g. US/European)
2	Disclosed	"Disclosed" sytle (e.g. Japanese)
3	NoBiddingProcess	No bidding process

FIX.4.2

395

NumTickets

int

Total number of tickets/allocations assuming fully executed

FIX.4.2

Currency

Used to represent the currency of monetary amounts.

FIX.4.2

396

SideValue1

Amt

Expressed in Currency

FIX.4.2

397

SideValue2

Amt

Expressed in Currency

FIX.4.2

⟳ BidDescReqGrp [Repeating Group]

Used if BidType="Non Disclosed"

FIX.4.4

398

NoBidDescriptors

NumInGroup

Used if BidType="Non Disclosed"

FIX.4.4

399

BidDescriptorType

int

Required if NoBidDescriptors > 0. Must be first field in repeating group.

▶ 3 enum values

Value	Name	Description
1	Sector	Sector
2	Country	Country
3	Index	Index

FIX.4.4

400

BidDescriptor

String

BidDescriptor value. Usage depends upon BidDescriptorTyp (399). If BidDescriptorType = 1 Industrials etc - Free text If BidDescriptorType = 2 "FR" etc - ISO Country Codes If BidDescriptorType = 3 FT00, FT250, STOX - Free text

FIX.4.4

401

SideValueInd

int

Refers to the SideValue1 or SideValue2. These are used as opposed to Buy or Sell so that the basket can be quoted either way as Buy or Sell.

▶ 2 enum values

Value	Name	Description
1	SideValue1	Side Value 1
2	SideValue2	Side Value 2

FIX.4.4

404

LiquidityValue

Amt

Value between LiquidityPctLow and LiquidityPctHigh in Currency

FIX.4.4

441

LiquidityNumSecurities

int

Number of Securites between LiquidityPctLow and LiquidityPctHigh in Currency

FIX.4.4

402

LiquidityPctLow

Percentage

Liquidity indicator or lower limit if LiquidityNumSecurities > 1

FIX.4.4

403

LiquidityPctHigh

Percentage

Upper liquidity indicator if LiquidityNumSecurities > 1

FIX.4.4

405

EFPTrackingError

Percentage

Eg Used in EFP (Exchange For Physical) trades 12%

FIX.4.4

406

FairValue

Amt

Used in EFP trades

FIX.4.4

407

OutsideIndexPct

Percentage

Used in EFP trades

FIX.4.4

408

ValueOfFutures

Amt

Used in EFP trades

FIX.4.4

end BidDescReqGrp

⟳ BidCompReqGrp [Repeating Group]

Used if BidType="Disclosed"

FIX.4.4

420

NoBidComponents

NumInGroup

Used if BidType="Disclosed"

FIX.4.4

ListID

String

Required if NoBidComponents > 0. Must be first field in repeating group.

FIX.4.4

Side

char

When used in request for a "Disclosed" bid indicates that bid is required on assumption that SideValue1 is Buy or Sell. SideValue2 can be derived by inference.

▶ 16 enum values

Value	Name	Description
1	Buy	Buy
2	Sell	Sell
3	BuyMinus	Buy minus
4	SellPlus	Sell plus
5	SellShort	Sell short
6	SellShortExempt	Sell short exempt
7	Undisclosed	Undisclosed (valid for IOI and List Order messages only)
8	Cross	Cross (orders where counterparty is an exchange, valid for all messages except IOIs)
9	CrossShort	Cross short
A	CrossShortExempt	Cross short exxmpt
B	AsDefined	"As Defined" (for use with multileg instruments)
C	Opposite	"Opposite" (for use with multileg instruments)
D	Subscribe	Subscribe (e.g. CIV)
E	Redeem	Redeem (e.g. CIV)
F	Lend	Lend (FINANCING - identifies direction of collateral)
G	Borrow	Borrow (FINANCING - identifies direction of collateral)

FIX.4.4

336

TradingSessionID

String

Indicates off-exchange type activities for Detail.

FIX.4.4

625

TradingSessionSubID

String

Optional market assigned sub identifier for a trading session. Usage is determined by market or counterparties. Used by US based futures markets to identify exchange specific execution time bracket codes as required by US market regulations.

FIX.4.4

430

NetGrossInd

int

Indicates Net or Gross for selling Detail.

▶ 2 enum values

Value	Name	Description
1	Net	Net
2	Gross	Gross

FIX.4.4

SettlType

String

Indicates order settlement period. If present, SettlDate (64) overrides this field. If both SettlType (63) and SettDate (64) are omitted, the default for SettlType (63) is 0 (Regular) Regular is defined as the default settlement period for the particular security on the exchange of execution. In Fixed Income the contents of this field may influence the instrument definition if the SecurityID (48) is ambiguous. In the US an active Treasury offering may be re-opened, and for a time one CUSIP will apply to both the current and "when-issued" securities. Supplying a value of "7" clarifies the instrument description; any other value or the absence of this field should cause the respondent to default to the active issue. Additionally the following patterns may be uses as well as enum values Dx = FX tenor expression for "days", e.g. "D5", where "x" is any integer > 0 Mx = FX tenor expression for "months", e.g. "M3", where "x" is any integer > 0 Wx = FX tenor expression for "weeks", e.g. "W13", where "x" is any integer > 0 Yx = FX tenor expression for "years", e.g. "Y1", where "x" is any integer > 0 Noted that for FX the tenors expressed using Dx, Mx, Wx, and Yx values do not denote business days, but calendar days.

▶ 12 enum values

Value	Name	Description
0	Regular	Regular / FX Spot settlement (T+1 or T+2 depending on currency)
1	Cash	Cash (TOD / T+0)
2	NextDay	Next Day (TOM / T+1)
3	TPlus2	T+2
4	TPlus3	T+3
5	TPlus4	T+4
6	Future	Future
7	WhenAndIfIssued	When And If Issued
8	SellersOption	Sellers Option
9	TPlus5	T+5
B	BrokenDate	Broken date - for FX expressing non-standard tenor, SettlDate (64) must be specified
C	FXSpotNextSettlement	FX Spot Next settlement (Spot+1, aka next day)

FIX.4.4

SettlDate

LocalMktDate

Takes precedence over SettlType value and conditionally required/omitted for specific SettlType values.

FIX.4.4

Account

String

Account mnemonic as agreed between buy and sell sides, e.g. broker and institution or investor/intermediary and fund manager.

FIX.4.4

660

AcctIDSource

int

Used to identify the source of the Account (1) code. This is especially useful if the account is a new account that the Respondent may not have setup yet in their system.

▶ 6 enum values

Value	Name	Description
1	BIC	BIC
2	SIDCode	SID Code
3	TFM	TFM (GSPTA)
4	OMGEO	OMGEO (Alert ID)
5	DTCCCode	DTCC Code
99	Other	Other (custom or proprietary)

FIX.4.4

end BidCompReqGrp

409

LiquidityIndType

int

Code to identify the type of liquidity indicator.

▶ 4 enum values

Value	Name	Description
1	FiveDayMovingAverage	5-day moving average
2	TwentyDayMovingAverage	20-day moving average
3	NormalMarketSize	Normal market size
4	Other	Other

FIX.4.2

410

WtAverageLiquidity

Percentage

Overall weighted average liquidity expressed as a % of average daily volume

FIX.4.2

411

ExchangeForPhysical

Boolean

Indicates whether or not to exchange for phsyical.

▶ 2 enum values

Value	Name	Description
N	False	False
Y	True	True

FIX.4.2

412

OutMainCntryUIndex

Amt

% value of stocks outside main country in Currency

FIX.4.2

413

CrossPercent

Percentage

% of program that crosses in Currency

FIX.4.2

414

ProgRptReqs

int

Code to identify the desired frequency of progress reports.

▶ 3 enum values

Value	Name	Description
1	BuySideRequests	Buy-side explicitly requests status using Statue Request (default), the sell-side firm can, however, send a DONE status List STatus Response in an unsolicited fashion
2	SellSideSends	Sell-side periodically sends status using List Status. Period optionally specified in ProgressPeriod.
3	RealTimeExecutionReports	Real-time execution reports (to be discourage)

FIX.4.2

415

ProgPeriodInterval

int

Time in minutes between each ListStatus report sent by SellSide. Zero means don’t send status.

FIX.4.2

416

IncTaxInd

int

Net/Gross

▶ 2 enum values

Value	Name	Description
1	Net	Net
2	Gross	Gross

FIX.4.2

121

ForexReq

Boolean

Is foreign exchange required

▶ 2 enum values

Value	Name	Description
N	DoNotExecuteForexAfterSecurityTrade	Do Not Execute Forex After Security Trade
Y	ExecuteForexAfterSecurityTrade	Execute Forex After Security Trade

FIX.4.2

417

NumBidders

int

Indicates the total number of bidders on the list

FIX.4.2

TradeDate

LocalMktDate

Indicates date of trade referenced in this message in YYYYMMDD format. Absence of this field indicates current day (expressed in local time at place of trade).

FIX.4.2

418

BidTradeType

char

Code to represent the type of trade. (Prior to FIX 4.4 this field was named "TradeType")

▶ 4 enum values

Value	Name	Description
A	Agency	Agency
G	VWAPGuarantee	VWAP Guarantee
J	GuaranteedClose	Guaranteed Close
R	RiskTrade	Risk Trade

FIX.4.2

419

BasisPxType

char

Code to represent the basis price type.

▶ 13 enum values

Value	Name	Description
2	ClosingPriceAtMorningSession	Closing price at morning session
3	ClosingPrice	Closing price
4	CurrentPrice	Current price
5	SQ	SQ
6	VWAPThroughADay	VWAP through a day
7	VWAPThroughAMorningSession	VWAP through a morning session
8	VWAPThroughAnAfternoonSession	VWAP through an afternoon session
9	VWAPThroughADayExcept	VWAP through a day except "YORI" (an opening auction)
A	VWAPThroughAMorningSessionExcept	VWAP through a morning session except "YORI" (an opening auction)
B	VWAPThroughAnAfternoonSessionExcept	VWAP through an afternoon session except "YORI" (an opening auction)
C	Strike	Strike
D	Open	Open
Z	Others	Others