BidRequest

← AllocationAck→ BidResponse
MsgTypek
CategoryProgramTrading
SectionPreTrade
AddedFIX.4.2
Fields82
Components2
The BidRequest Message can be used in one of two ways depending on which market conventions are being followed.

Message Structure

82 fields, 2 components/groups — click any tag or field name for details
TagNameTypeReq DescriptionAdded
StandardHeader [Component]YMsgType = k (lowercase)FIX.4.2
8BeginStringStringYFIX.4.3 (Always unencrypted, must be first field in message)FIX.4.0
9BodyLengthintY(Always unencrypted, must be second field in message)FIX.4.0
35MsgTypeStringY(Always unencrypted, must be third field in message)
68 enum values
ValueNameDescription
0HeartbeatHeartbeat
1TestRequestTest Request
2ResendRequestResend Request
3RejectReject
4SequenceResetSequence Reset
5LogoutLogout
6IOIIndication of Interest
7AdvertisementAdvertisement
8ExecutionReportExecution Report
9OrderCancelRejectOrder Cancel Reject
aQuoteStatusRequestQuote Status Request
ALogonLogon
AADerivativeSecurityListDerivative Security List
ABNewOrderMultilegNew Order - Multileg
ACMultilegOrderCancelReplaceMultileg Order Cancel/Replace (a.k.a. Multileg Order Modification Request)
ADTradeCaptureReportRequestTrade Capture Report Request
AETradeCaptureReportTrade Capture Report
AFOrderMassStatusRequestOrder Mass Status Request
AGQuoteRequestRejectQuote Request Reject
AHRFQRequestRFQ Request
AIQuoteStatusReportQuote Status Report
bMassQuoteAcknowledgementMass Quote Acknowledgement
BNewsNews
cSecurityDefinitionRequestSecurity Definition Request
CEmailEmail
dSecurityDefinitionSecurity Definition
DNewOrderSingleOrder Single
eSecurityStatusRequestSecurity Status Request
ENewOrderListOrder List
fSecurityStatusSecurity Status
FOrderCancelRequestOrder Cancel Request
GOrderCancelReplaceRequestOrder Cancel/Replace Request
gTradingSessionStatusRequestTrading Session Status Request
hTradingSessionStatusTrading Session Status
HOrderStatusRequestOrder Status Request
iMassQuoteMass Quote
jBusinessMessageRejectBusiness Message Reject
JAllocationInstructionAllocation
KListCancelRequestList Cancel Request
kBidRequestBid Request
lBidResponseBid Response (lowercase L)
LListExecuteList Execute
mListStrikePriceList Strike Price
MListStatusRequestList Status Request
NListStatusList Status
nXMLNonFIXXML message (e.g. non-FIX MsgType)
oRegistrationInstructionsRegistration Instructions
PAllocationInstructionAckAllocation ACK
pRegistrationInstructionsResponseRegistration Instructions Response
qOrderMassCancelRequestOrder Mass Cancel Request
QDontKnowTradeDont Know Trade (DK)
rOrderMassCancelReportOrder Mass Cancel Report
RQuoteRequestQuote Request
sNewOrderCrossNew Order - Cross
SQuoteQuote
tCrossOrderCancelReplaceRequestCross Order Cancel/Replace Request (a.k.a. Cross Order Modification Request)
TSettlementInstructionsSettlement Instructions
uCrossOrderCancelRequestCross Order Cancel Request
vSecurityTypeRequestSecurity Type Request
VMarketDataRequestMarket Data Request
wSecurityTypesSecurity Types
WMarketDataSnapshotFullRefreshMarket Data-Snapshot/Full Refresh
xSecurityListRequestSecurity List Request
XMarketDataIncrementalRefreshMarket Data-Incremental Refresh
ySecurityListSecurity List
YMarketDataRequestRejectMarket Data Request Reject
zDerivativeSecurityListRequestDerivative Security List Request
ZQuoteCancelQuote Cancel
FIX.4.0
49SenderCompIDStringY(Always unencrypted)FIX.4.0
56TargetCompIDStringY(Always unencrypted)FIX.4.0
115OnBehalfOfCompIDStringNTrading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)FIX.4.0
128DeliverToCompIDStringNTrading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)FIX.4.0
90SecureDataLenLengthNRequired to identify length of encrypted section of message. (Always unencrypted)FIX.4.0
91SecureDatadataNRequired when message body is encrypted. Always immediately follows SecureDataLen field.FIX.4.0
34MsgSeqNumintY(Can be embedded within encrypted data section.)FIX.4.0
50SenderSubIDStringN(Can be embedded within encrypted data section.)FIX.4.0
142SenderLocationIDStringNSender's LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)FIX.4.1
57TargetSubIDStringN"ADMIN" reserved for administrative messages not intended for a specific user. (Can be embedded within encrypted data section.)FIX.4.0
143TargetLocationIDStringNTrading partner LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)FIX.4.1
116OnBehalfOfSubIDStringNTrading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)FIX.4.0
144OnBehalfOfLocationIDStringNTrading 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
129DeliverToSubIDStringNTrading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)FIX.4.0
145DeliverToLocationIDStringNTrading 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
43PossDupFlagBooleanNAlways 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
ValueNameDescription
NOriginalTransmissionOriginal transmission
YPossibleDuplicatePossible duplicate
FIX.4.0
97PossResendBooleanNRequired when message may be duplicate of another message sent under a different sequence number. (Can be embedded within encrypted data section.)
2 enum values
ValueNameDescription
NOriginalTransmissionOriginal transmission
YPossibleResendPossible resend
FIX.4.0
52SendingTimeUTCTimestampY(Can be embedded within encrypted data section.)FIX.4.0
122OrigSendingTimeUTCTimestampNRequired 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
212XmlDataLenLengthNRequired when specifying XmlData to identify the length of a XmlData message block. (Can be embedded within encrypted data section.)FIX.4.2
213XmlDatadataNCan 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
347MessageEncodingStringNType of message encoding (non-ASCII characters) used in a message’s "Encoded" fields. Required if any "Encoding" fields are used.
4 enum values
ValueNameDescription
UTF-8UTF8(for using Unicode)
ISO-2022-JPISO2022JP(for using JIS)
EUC-JPEUCJP(for using EUC)
Shift_JISShiftJIS(for using SJIS)
FIX.4.2
369LastMsgSeqNumProcessedintNThe 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
370OnBehalfOfSendingTimeUTCTimestampN(deprecated) Used when a message is sent via a "hub" or "service bureau". If A sends to Q (the hub) who then sends to B via a separate FIX session, then when Q sends to B the value of this field should represent the SendingTime on the message A sent to Q. (always expressed in UTC (Universal Time Coordinated, also known as "GMT")FIX.4.2
627Tag627?NNumber 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.3
628Tag628?NThird 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.FIX.4.3
629Tag629?NTime that HopCompID (628) sent the message. It is recommended that this value be the SendingTime (52) of the message sent by the third party.FIX.4.3
630Tag630?NReference 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.FIX.4.3
390BidIDStringNRequired to relate the bid responseFIX.4.2
391ClientBidIDStringYUnique identifier for a Bid Request as assigned by institution. Uniqueness must be guaranteed within a single trading day.FIX.4.2
374BidRequestTransTypecharYIdentifies the Bid Request message transaction type
2 enum values
ValueNameDescription
NNewNew
CCancelCancel
FIX.4.2
392ListNameStringNDescriptive name for list order.FIX.4.2
393TotalNumSecuritiesintYTotal number of securities.FIX.4.2
394BidTypeintYe.g. "Non Disclosed", "Disclosed", No Bidding Process
3 enum values
ValueNameDescription
1NonDisclosedNon Disclosed Style (e.g. US/European)
2DisclosedDisclosed Style (e.g. Japanese)
3NoBiddingProcessNo Bidding Process
FIX.4.2
395NumTicketsintNTotal number of tickets/allocations assuming fully executedFIX.4.2
15CurrencyCurrencyNUsed to represent the currency of monetary amounts.FIX.4.2
396SideValue1AmtNExpressed in CurrencyFIX.4.2
397SideValue2AmtNExpressed in CurrencyFIX.4.2
398NoBidDescriptorsintNUsed if BidType="Non Disclosed"FIX.4.2
399BidDescriptorTypeintNRequired if NoBidDescriptors > 0. Must be first field in repeating group.
3 enum values
ValueNameDescription
3IndexIndex
2CountryCountry
1SectorSector
FIX.4.2
400BidDescriptorStringNBidDescriptor value. Usage depends upon BidDescriptorType.FIX.4.2
401SideValueIndintNRefers 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
ValueNameDescription
1SideValue1SideValue1
2SideValue2SideValue 2
FIX.4.2
404LiquidityValueAmtNValue between LiquidityPctLow and LiquidityPctHigh in CurrencyFIX.4.2
441LiquidityNumSecuritiesintNNumber of Securites between LiquidityPctLow and LiquidityPctHigh in CurrencyFIX.4.2
402LiquidityPctLowfloatNLiquidity indicator or lower limit if LiquidityNumSecurities > 1FIX.4.2
403LiquidityPctHighfloatNUpper liquidity indicator if LiquidityNumSecurities > 1FIX.4.2
405EFPTrackingErrorfloatNEg Used in EFP (Exchange For Physical) trades 12%FIX.4.2
406FairValueAmtNUsed in EFP tradesFIX.4.2
407OutsideIndexPctfloatNUsed in EFP tradesFIX.4.2
408ValueOfFuturesAmtNUsed in EFP tradesFIX.4.2
420NoBidComponentsintNUsed if BidType="Disclosed"FIX.4.2
66ListIDStringNRequired if NoBidComponents > 0. Must be first field in repeating group.FIX.4.2
54SidecharNWhen 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.
12 enum values
ValueNameDescription
6SellShortExemptSell short exempt
BAsDefinedAs Defined (for use with multileg instruments)
COppositeOpposite (for use with multileg instruments)
8CrossCross (orders where counterparty is an exchange, valid for all messages except IOIs)
9CrossShortCross short
1BuyBuy
2SellSell
3BuyMinusBuy minus
4SellPlusSell plus
ACrossShortExemptCross short exempt
5SellShortSell short
7UndisclosedUndisclosed (valid for IOI and List Order messages only)
FIX.4.2
336TradingSessionIDStringNIndicates off-exchange type activities for Detail.FIX.4.2
625Tag625?NFIX.4.3
430NetGrossIndintNIndicates Net or Gross for selling Detail.
2 enum values
ValueNameDescription
1NetNet
2GrossGross
FIX.4.2
63SettlmntTypcharNIndicates order settlement period. Absence of this field is interpreted as Regular. Regular is defined as the default settlement period for the particular security on the exchange of execution.
11 enum values
ValueNameDescription
5TPlus4T+4
AT1T+1
6FutureFuture
3TPlus2T+2
2NextDayNext Day
8SellersOptionSellers Option
1CashCash
7WhenAndIfIssuedWhen And If Issued
0RegularRegular
9TPlus5T+ 5
4TPlus3T+3
FIX.4.2
64FutSettDateLocalMktDateNTakes precedence over SettlmntTyp value and conditionally required/omitted for specific SettlmntTyp values.FIX.4.2
1AccountStringNAccount mnemonic as agreed between broker and institution.FIX.4.2
409LiquidityIndTypeintNCode to identify the type of liquidity indicator.
4 enum values
ValueNameDescription
3NormalMarketSizeNormal Market Size
4OtherOther
2TwentyDayMovingAverage20 day moving average
1FiveDayMovingAverage5day moving average
FIX.4.2
410WtAverageLiquidityfloatNOverall weighted average liquidity expressed as a % of average daily volumeFIX.4.2
411ExchangeForPhysicalBooleanNIndicates whether or not to exchange for phsyical.
2 enum values
ValueNameDescription
NFalseFalse
YTrueTrue
FIX.4.2
412OutMainCntryUIndexAmtN% value of stocks outside main country in CurrencyFIX.4.2
413CrossPercentfloatN% of program that crosses in CurrencyFIX.4.2
414ProgRptReqsintNCode to identify the desired frequency of progress reports.
3 enum values
ValueNameDescription
3RealTimeExecutionReportsReal-time execution reports (to be discouraged)
2SellSideSendsSellSide periodically sends status using ListStatus. Period optionally specified in ProgressPeriod
1BuySideRequestsBuySide explicitly requests status using StatusRequest (Default) The sell-side firm can however, send a DONE status List Status Response in an unsolicited fashion
FIX.4.2
415ProgPeriodIntervalintNTime in minutes between each ListStatus report sent by SellSide. Zero means don’t send status.FIX.4.2
416IncTaxIndintNNet/Gross
2 enum values
ValueNameDescription
2GrossGross
1NetNet
FIX.4.2
121ForexReqBooleanNIs foreign exchange required
2 enum values
ValueNameDescription
YExecuteForexAfterSecurityTradeExecute Forex after security trade
NDoNotExecuteForexAfterSecurityTradeDo not execute Forex after security trade
FIX.4.2
417NumBiddersintNIndicates the total number of bidders on the listFIX.4.2
75TradeDateLocalMktDateNIndicates 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
418TradeTypecharYCode to represent the type of trade.
4 enum values
ValueNameDescription
GVWAPGuaranteeVWAP Guarantee
AAgencyAgency
JGuaranteedCloseGuaranteed Close
RRiskTradeRisk Trade
FIX.4.2
419BasisPxTypecharYCode to represent the basis price type.
13 enum values
ValueNameDescription
8VWAPThroughAnAfternoonSessionVWAP through an afternoon session
DOpenOpen
ZOthersOthers
CStrikeStrike
BVWAPThroughAnAfternoonSessionExceptVWAP through an afternoon session except YORI (an opening auction)
9VWAPThroughADayExceptVWAP through a day except YORI (an opening auction)
7VWAPThroughAMorningSessionVWAP through a morning session
6VWAPThroughADayVWAP through a day
5SQSQ
4CurrentPriceCurrent price
3ClosingPriceClosing Price
2ClosingPriceAtMorningSessionClosing Price at morning session
AVWAPThroughAMorningSessionExceptVWAP through a morning session except YORI (an opening auction)
FIX.4.2
443StrikeTimeUTCTimestampNUsed when BasisPxType = "C"FIX.4.2
58TextStringNFree format text string (Note: this field does not have a specified maximum length)FIX.4.2
354EncodedTextLenLengthNMust be set if EncodedText field is specified and must immediately precede it.FIX.4.2
355EncodedTextdataNEncoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field.FIX.4.2
StandardTrailer [Component]YThe standard FIX message trailerFIX.4.2
93SignatureLengthLengthNRequired when trailer contains signature. Note: Not to be included within SecureData fieldFIX.4.0
89SignaturedataNNote: Not to be included within SecureData fieldFIX.4.0
10CheckSumStringY(Always unencrypted, always last field in message)FIX.4.0