BidRequest message – FIX.5.0SP2 – FIX Reference

MsgTypek

CategoryProgramTrading

SectionTrade

AddedFIX.4.2

Fields85

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

85 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)

▶ 116 enum values

Value	Name	Description
0	Heartbeat	Heartbeat
1	TestRequest	TestRequest
2	ResendRequest	ResendRequest
3	Reject	Reject
4	SequenceReset	SequenceReset
5	Logout	Logout
6	IOI	IOI
7	Advertisement	Advertisement
8	ExecutionReport	ExecutionReport
9	OrderCancelReject	OrderCancelReject
A	Logon	Logon
AA	DerivativeSecurityList	DerivativeSecurityList
AB	NewOrderMultileg	NewOrderMultileg
AC	MultilegOrderCancelReplace	MultilegOrderCancelReplace
AD	TradeCaptureReportRequest	TradeCaptureReportRequest
AE	TradeCaptureReport	TradeCaptureReport
AF	OrderMassStatusRequest	OrderMassStatusRequest
AG	QuoteRequestReject	QuoteRequestReject
AH	RFQRequest	RFQRequest
AI	QuoteStatusReport	QuoteStatusReport
AJ	QuoteResponse	QuoteResponse
AK	Confirmation	Confirmation
AL	PositionMaintenanceRequest	PositionMaintenanceRequest
AM	PositionMaintenanceReport	PositionMaintenanceReport
AN	RequestForPositions	RequestForPositions
AO	RequestForPositionsAck	RequestForPositionsAck
AP	PositionReport	PositionReport
AQ	TradeCaptureReportRequestAck	TradeCaptureReportRequestAck
AR	TradeCaptureReportAck	TradeCaptureReportAck
AS	AllocationReport	AllocationReport
AT	AllocationReportAck	AllocationReportAck
AU	ConfirmationAck	ConfirmationAck
AV	SettlementInstructionRequest	SettlementInstructionRequest
AW	AssignmentReport	AssignmentReport
AX	CollateralRequest	CollateralRequest
AY	CollateralAssignment	CollateralAssignment
AZ	CollateralResponse	CollateralResponse
B	News	News
BA	CollateralReport	CollateralReport
BB	CollateralInquiry	CollateralInquiry
BC	NetworkCounterpartySystemStatusRequest	NetworkCounterpartySystemStatusRequest
BD	NetworkCounterpartySystemStatusResponse	NetworkCounterpartySystemStatusResponse
BE	UserRequest	UserRequest
BF	UserResponse	UserResponse
BG	CollateralInquiryAck	CollateralInquiryAck
BH	ConfirmationRequest	ConfirmationRequest
BI	TradingSessionListRequest	TradingSessionListRequest
BJ	TradingSessionList	TradingSessionList
BK	SecurityListUpdateReport	SecurityListUpdateReport
BL	AdjustedPositionReport	AdjustedPositionReport
BM	AllocationInstructionAlert	AllocationInstructionAlert
BN	ExecutionAcknowledgement	ExecutionAcknowledgement
BO	ContraryIntentionReport	ContraryIntentionReport
BP	SecurityDefinitionUpdateReport	SecurityDefinitionUpdateReport
BQ	SettlementObligationReport	SettlementObligationReport
BR	DerivativeSecurityListUpdateReport	DerivativeSecurityListUpdateReport
BS	TradingSessionListUpdateReport	TradingSessionListUpdateReport
BT	MarketDefinitionRequest	MarketDefinitionRequest
BU	MarketDefinition	MarketDefinition
BV	MarketDefinitionUpdateReport	MarketDefinitionUpdateReport
BW	ApplicationMessageRequest	ApplicationMessageRequest
BX	ApplicationMessageRequestAck	ApplicationMessageRequestAck
BY	ApplicationMessageReport	ApplicationMessageReport
BZ	OrderMassActionReport	OrderMassActionReport
C	Email	Email
CA	OrderMassActionRequest	OrderMassActionRequest
CB	UserNotification	UserNotification
CC	StreamAssignmentRequest	StreamAssignmentRequest
CD	StreamAssignmentReport	StreamAssignmentReport
CE	StreamAssignmentReportACK	StreamAssignmentReportACK
D	NewOrderSingle	NewOrderSingle
E	NewOrderList	NewOrderList
F	OrderCancelRequest	OrderCancelRequest
G	OrderCancelReplaceRequest	OrderCancelReplaceRequest
H	OrderStatusRequest	OrderStatusRequest
J	AllocationInstruction	AllocationInstruction
K	ListCancelRequest	ListCancelRequest
L	ListExecute	ListExecute
M	ListStatusRequest	ListStatusRequest
N	ListStatus	ListStatus
P	AllocationInstructionAck	AllocationInstructionAck
Q	DontKnowTrade	DontKnowTrade
R	QuoteRequest	QuoteRequest
S	Quote	Quote
T	SettlementInstructions	SettlementInstructions
V	MarketDataRequest	MarketDataRequest
W	MarketDataSnapshotFullRefresh	MarketDataSnapshotFullRefresh
X	MarketDataIncrementalRefresh	MarketDataIncrementalRefresh
Y	MarketDataRequestReject	MarketDataRequestReject
Z	QuoteCancel	QuoteCancel
a	QuoteStatusRequest	QuoteStatusRequest
b	MassQuoteAcknowledgement	MassQuoteAcknowledgement
c	SecurityDefinitionRequest	SecurityDefinitionRequest
d	SecurityDefinition	SecurityDefinition
e	SecurityStatusRequest	SecurityStatusRequest
f	SecurityStatus	SecurityStatus
g	TradingSessionStatusRequest	TradingSessionStatusRequest
h	TradingSessionStatus	TradingSessionStatus
i	MassQuote	MassQuote
j	BusinessMessageReject	BusinessMessageReject
k	BidRequest	BidRequest
l	BidResponse	BidResponse
m	ListStrikePrice	ListStrikePrice
n	XMLnonFIX	XMLnonFIX
o	RegistrationInstructions	RegistrationInstructions
p	RegistrationInstructionsResponse	RegistrationInstructionsResponse
q	OrderMassCancelRequest	OrderMassCancelRequest
r	OrderMassCancelReport	OrderMassCancelReport
s	NewOrderCross	NewOrderCross
t	CrossOrderCancelReplaceRequest	CrossOrderCancelReplaceRequest
u	CrossOrderCancelRequest	CrossOrderCancelRequest
v	SecurityTypeRequest	SecurityTypeRequest
w	SecurityTypes	SecurityTypes
x	SecurityListRequest	SecurityListRequest
y	SecurityList	SecurityList
z	DerivativeSecurityListRequest	DerivativeSecurityListRequest

FIX.4.0

1128

ApplVerID

String

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

▶ 10 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
8	FIX50SP1	FIX50SP1
9	FIX50SP2	FIX50SP2

FIX.4.4

1156

ApplExtID

int

The extension pack number associated with an application message.

FIX.5.0

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 [Repeating Group]

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

end HopGrp

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

▶ 6 enum values

Value	Name	Description
1	Day	Day
2	HalfDay	HalfDay
3	Morning	Morning
4	Afternoon	Afternoon
5	Evening	Evening
6	AfterHours	After-hours

FIX.4.4

625

TradingSessionSubID

String

Optional market assigned sub identifier for a trading phase within 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. Bilaterally agreed values of data type "String" that start with a character can be used for backward compatibility

▶ 7 enum values

Value	Name	Description
1	PreTrading	Pre-Trading
2	OpeningOrOpeningAuction	Opening or opening auction
3	Continuous	(Continuous) Trading
4	ClosingOrClosingAuction	Closing or closing auction
5	PostTrading	Post-Trading
6	IntradayAuction	Intraday Auction
7	Quiescent	Quiescent

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