Definition
The Market Data message for incremental updates may contain any combination of new, changed, or deleted Market Data Entries, for any combination of instruments, with any combination of trades, imbalances, quotes, index values, open, close, settlement, high, low, and VWAP prices, trade volume and open interest so long as the maximum FIX message size is not exceeded. All of these types of Market Data Entries can be changed and deleted.
Message structure 404 distinct fields
Source order, including nested components and groups. Group counts precede the repeated entries. “Required here” is relative to the enclosing component or group, not unconditional in the message. A dash means not marked required; conditional requirements remain in the source notes. This is a reference, not a counterparty-specific validator.
StandardHeaderComponentRequired
MsgType = X
StandardHeader definition & usage →
FIXT.1.1 (Always unencrypted, must be first field in message)
(Always unencrypted, must be second field in message)
(Always unencrypted, must be third field in message)
Indicates application version using a service pack identifier. The ApplVerID applies to a specific message occurrence.
Used to support bilaterally agreed custom functionality
(Always unencrypted)
(Always unencrypted)
Trading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)
Trading partner company ID used when sending messages via a third party (Can be embedded within encrypted data section.)
Required to identify length of encrypted section of message. (Always unencrypted)
Required when message body is encrypted. Always immediately follows SecureDataLen field.
(Can be embedded within encrypted data section.)
(Can be embedded within encrypted data section.)
Sender's LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)
"ADMIN" reserved for administrative messages not intended for a specific user. (Can be embedded within encrypted data section.)
Trading partner LocationID (i.e. geographic location and/or desk) (Can be embedded within encrypted data section.)
Trading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)
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.)
Trading partner SubID used when delivering messages via a third party. (Can be embedded within encrypted data section.)
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.)
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.)
Required when message may be duplicate of another message sent under a different sequence number. (Can be embedded within encrypted data section.)
(Can be embedded within encrypted data section.)
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.)
Required when specifying XmlData to identify the length of a XmlData message block. (Can be embedded within encrypted data section.)
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
Type of message encoding (non-ASCII characters) used in a message's "Encoded" fields. Required if any "Encoding" fields are used.
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.
HopGrpRepeating groupCount tag 627—
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.
ApplicationSequenceControlComponent—
ApplicationSequenceControl definition & usage →
Identifies the application with which a message is associated. Used only if application sequencing is in effect.
Application sequence number assigned to the message by the application generating the message. Used only if application sequencing is in effect. Conditionally required if ApplID has been specified.
The previous sequence number in the application sequence stream. Permits an application to publish messages with sequence gaps where it cannot be avoided. Used only if application sequencing is in effect. Conditionally required if ApplID has been specified
Used to indicate that a message is being sent in response to an Application Message Request. Used only if application sequencing is in effect. It is possible for both ApplResendFlag and PossDupFlag to be set on the same message if the Sender's cache size is greater than zero and the message is being resent due to a session level resend request.
Describes the type of book for which the feed is intended. Can be used when multiple feeds are provided over the same connection
Describes a class of service for a given data feed, ie Regular and Market Maker
Used to specify the trading date for which a set of market data applies
Conditionally required if this message is in response to a Market Data Request.
MDIncGrpRepeating groupCount tag 268Required
Number of entries following.
Number of entries following.
Must be first field in this repeating group.
If MDUpdateAction = Delete(2), can be used to specify a reason for the deletion.
Can be used to define a subordinate book.
Can be used to define the current depth of the book.
Conditionally required if MDUpdateAction = New(0). Cannot be changed.
If specified, must be unique among currently active entries if MDUpdateAction = New (0), must be the same as a previous MDEntryID if MDUpdateAction = Delete (2), and must be the same as a previous MDEntryID if MDUpdateAction = Change (1) and MDEntryRefID is not specified, or must be unique among currently active entries if MDUpdateAction = Change(1) and MDEntryRefID is specified..
If MDUpdateAction = New(0), for the first Market Data Entry in a message, either this field or a Symbol must be specified. If MDUpdateAction = Change(1), this must refer to a previous MDEntryID.
InstrumentComponent—
Either Symbol (the instrument component block) or MDEntryRefID must be specified if MDUpdateAction = New(0) for the first Market Data Entry in a message. For subsequent Market Data Entries where MDUpdateAction = New(0), the default is the instrument used in the previous Market Data Entry if neither Symbol nor MDEntryRefID are specified, or in the case of options and futures, the previous instrument with changes specified in MaturityMonthYear, MaturityDay, StrikePrice, OptAttribute, and SecurityExchange. May not be changed.
Instrument definition & usage →
Common, "human understood" representation of the security. SecurityID value can be specified if no symbol exists (e.g. non-exchange traded Collective Investment Vehicles) Use "[N/A]" for products which do not have a symbol.
Used in Fixed Income with a value of "WI" to indicate "When Issued" for a security to be reissued under an old CUSIP or ISIN or with a value of "CD" to indicate a EUCP with lump-sum interest rather than discount price.
Takes precedence in identifying security to counterparty over SecurityAltID block. Requires SecurityIDSource if specified.
Required if SecurityID is specified.
SecAltIDGrpRepeating groupCount tag 454—
Number of alternate Security Identifiers
SecAltIDGrp definition & usage →
Indicates the type of product the security is associated with (high-level category)
Identifies an entire suite of products for a given market. In Futures this may be "interest rates", "agricultural", "equity indexes", etc
An exchange specific name assigned to a group of related securities which may be concurrently affected by market events and actions.
Indicates the type of security using ISO 10962 standard, Classification of Financial Instruments (CFI code) values. It is recommended that CFICode be used instead of SecurityType for non-Fixed Income instruments.
It is recommended that CFICode be used instead of SecurityType for non-Fixed Income instruments. Required for Fixed Income. Refer to Volume 7 - Fixed Income Futures and Options should be specified using the CFICode[461] field instead of SecurityType[167] (Refer to Volume 7 - Recommendations and Guidelines for Futures and Options Markets.)
Sub-type qualification/identification of the SecurityType (e.g. for SecurityType="MLEG"). If specified, SecurityType is required.
Specifies the month and year of maturity. Applicable for standardized derivatives which are typically only referenced by month and year (e.g. S&P futures). Note MaturityDate (a full date) can also be specified.
Specifies date of maturity (a full date). Note that standardized derivatives which are typically only referenced by month and year (e.g. S&P futures).may use MaturityMonthYear and/or this field. When using MaturityMonthYear, it is recommended that markets and sell sides report the MaturityDate on all outbound messages as a means of data enrichment. For NDFs this represents the fixing date of the contract.
For NDFs this represents the fixing time of the contract. It is optional to specify the fixing time.
Indicator to determine if Instrument is Settle on Open.
Gives the current state of the instrument
Date interest is to be paid. Used in identifying Corporate Bond issues.
Date instrument was issued. For Fixed Income IOIs for new issues, specifies the issue date.
For Fixed Income: Amortization Factor for deriving Current face from Original face for ABS or MBS securities, note the fraction may be greater than, equal to or less than 1. In TIPS securities this is the Inflation index. Qty * Factor * Price = Gross Trade Amount For Derivatives: Contract Value Factor by which price must be adjusted to determine the true nominal value of one futures/options contract. (Qty * Price) * Factor = Nominal Value
The location at which records of ownership are maintained for this instrument, and at which ownership changes must be recorded. Can be used in conjunction with ISIN to address ISIN uniqueness issues.
ISO Country code of instrument issue (e.g. the country portion typically used in ISIN). Can be used in conjunction with non-ISIN SecurityID (e.g. CUSIP for Municipal Bonds without ISIN) to provide uniqueness.
A two-character state or province abbreviation.
The three-character IATA code for a locale (e.g. airport code for Municipal Bonds).
Used for derivatives, such as options and covered warrants
Used for derivatives
Used for derivatives. Multiplier applied to the strike price for the purpose of calculating the settlement value.
Used for derivatives. The number of shares/units for the financial instrument involved in the option trade.
Used for derivatives, such as options and covered warrants to indicate a versioning of the contract when required due to corporate actions to the underlying. Should not be used to indicate type of option - use the CFICode[461] for this purpose.
For Fixed Income, Convertible Bonds, Derivatives, etc. Note: If used, quantities should be expressed in the "nominal" (e.g. contracts vs. shares) amount.
Minimum price increment for the instrument. Could also be used to represent tick value.
Minimum price increment amount associated with the MinPriceIncrement [969]. For listed derivatives, the value can be calculated by multiplying MinPriceIncrement by ContractValueFactor [231]
0
Settlement method for a contract. Can be used as an alternative to CFI Code value
Type of exercise of a derivatives security
Cash amount indicating the pay out associated with an option. For binary options this is a fixed amount
Method for price quotation
Indicates type of valuation method used.
Indicates whether the instruments are pre-listed only or can also be defined via user request
Used to express the ceiling price of a capped call
Used to express the floor price of a capped put
Used to express option right
Used to indicate if a security has been defined as flexible according to "non-standard" means. Analog to CFICode Standard/Non-standard indicator
Used to indicate if a product or group of product supports the creation of flexible securities
Used to indicate a time unit for the contract (e.g., days, weeks, months, etc.)
For Fixed Income.
Can be used to identify the security.
Position Limit for the instrument.
Near-term Position Limit for the instrument.
Must be set if EncodedIssuer field is specified and must immediately precede it.
Encoded (non-ASCII characters) representation of the Issuer field in the encoded format specified via the MessageEncoding field.
Must be set if EncodedSecurityDesc field is specified and must immediately precede it.
Encoded (non-ASCII characters) representation of the SecurityDesc field in the encoded format specified via the MessageEncoding field.
SecurityXMLComponent—
Embedded XML document describing security.
SecurityXML definition & usage →
Must be set if SecurityXML field is specified and must immediately precede it.
XML payload or content describing the Security information.
XML Schema used to validate the XML used to describe the Security.
Identifies MBS / ABS pool
Must be present for MBS/TBA
The program under which a commercial paper is issued
The registration type of a commercial paper issuance
EvntGrpRepeating groupCount tag 864—
Number of repeating EventType group entries.
Specific time of event. To be used in combination with EventDate [866]
If different from IssueDate
If different from IssueDate and DatedDate
InstrumentPartiesRepeating groupCount tag 1018—
Used to identify the parties listing a specific instrument
InstrumentParties definition & usage →
Repeating group below should contain unique combinations of InstrumentPartyID, InstrumentPartyIDSource, and InstrumentPartyRole
Used to identify party id related to instrument
Used to identify source of instrument party id
Used to identify the role of instrument party id
InstrumentPtysSubGrpRepeating groupCount tag 1052—
Repeating group of InstrumentParty sub-identifiers.
InstrumentPtysSubGrp definition & usage →
ComplexEventsRepeating groupCount tag 1483—
ComplexEvents definition & usage →
Number of complex events
Identifies the type of complex event. Required if NoComplexEvents > 0.
ComplexEventCondition is conditionally required when there are more than one ComplexEvent occurrences. A chain of ComplexEvents must be linked together through use of the ComplexEventCondition in which the relationship between any two events is described. For any two ComplexEvents the first occurrence will specify the ComplexEventCondition which links it with the second event.
ComplexEventDatesRepeating groupCount tag 1491—
Used to specify the dates and time ranges when a complex event is in effect.
ComplexEventDates definition & usage →
Number of complex event date occurrences for a given complex event.
Required if NoComplexEventDates(1491) > 0.
Required if NoComplexEventDates(1491) > 0.
ComplexEventTimesRepeating groupCount tag 1494—
ComplexEventTimes definition & usage →
Required if NoComplexEventTimes(1494) > 0.
Required if NoComplexEventTimes(1494) > 0.
UndInstrmtGrpRepeating groupCount tag 711—
UndInstrmtGrp definition & usage →
Number of underlyings
UnderlyingInstrumentComponent—
Must be provided if Number of underlyings > 0
UnderlyingInstrument definition & usage →
Used to indicate a time unit for the contract (e.g., days, weeks, months, etc.)
Specific to the < UnderlyingInstrument > Percent of the Strike Price that this underlying represents. Necessary for derivatives that deliver into more than one underlying instrument.
Specific to the <UnderlyingInstrument> (not in <Instrument>)
Specific to the <UnderlyingInstrument> (not in <Instrument>) Unit amount of the underlying security (par, shares, currency, etc.)
Specific to the < UnderlyingInstrument > Indicates order settlement period for the underlying deliverable component.
Specific to the < UnderlyingInstrument > Cash amount associated with the underlying component. Necessary for derivatives that deliver into more than one underlying instrument and one of the underlying's is a fixed cash value.
Specific to the < UnderlyingInstrument > Used for derivatives that deliver into cash underlying. Indicates that the cash is either fixed or difference value (difference between strike and current underlying price)
Specific to the <UnderlyingInstrument> (not in <Instrument>) In a financing deal clean price (percent-of-par or per unit) of the underlying security or basket.
Specific to the <UnderlyingInstrument> (not in <Instrument>) In a financing deal price (percent-of-par or per unit) of the underlying security or basket. "Dirty" means it includes accrued interest
Specific to the <UnderlyingInstrument> (not in <Instrument>) In a financing deal price (percent-of-par or per unit) of the underlying security or basket at the end of the agreement.
Specific to the <UnderlyingInstrument> (not in <Instrument>) Currency value attributed to this collateral at the start of the agreement
Specific to the <UnderlyingInstrument> (not in <Instrument>) Currency value currently attributed to this collateral
Specific to the <UnderlyingInstrument> (not in <Instrument>) Currency value attributed to this collateral at the end of the agreement
UnderlyingStipulationsRepeating groupCount tag 887—
Specific to the <UnderlyingInstrument> (not in <Instrument>)
UnderlyingStipulations definition & usage →
Required if NoUnderlyingStips >0
Specific to the <UnderlyingInstrument> (not in <Instrument>). For listed derivatives margin management, this is the number of shares adjusted for upcoming corporate action. Used only for securities which are optionable and are between ex-date and settlement date (4 days).
Specific to the <UnderlyingInstrument> (not in <Instrument>). Foreign exchange rate used to compute UnderlyingCurrentValue (885) (or market value) from UnderlyingCurrency (318) to Currency (15).
Specific to the <UnderlyingInstrument> (not in <Instrument>). Specified whether UnderlyingFxRate (1045) should be multiplied or divided to derive UnderlyingCurrentValue (885).
UndlyInstrumentPartiesRepeating groupCount tag 1058—
UndlyInstrumentParties definition & usage →
Repeating group below should contain unique combinations of InstrumentPartyID, InstrumentPartyIDSource, and InstrumentPartyRole
Used to identify party id related to instrument
Used to identify source of instrument party id
Used to identify the role of instrument party id
UndlyInstrumentPtysSubGrpRepeating groupCount tag 1062—
Repeating group of InstrumentParty sub-identifiers.
UndlyInstrumentPtysSubGrp definition & usage →
Used to express option right
InstrmtLegGrpRepeating groupCount tag 555—
InstrmtLegGrp definition & usage →
Number of legs
InstrumentLegComponent—
Must be provided if Number of legs > 0
InstrumentLeg definition & usage →
Used to indicate a time unit for the contract (e.g., days, weeks, months, etc.)
Specific to the <InstrumentLeg> (not in <Instrument>)
Specific to the <InstrumentLeg> (not in <Instrument>)
Specific to the <InstrumentLeg> (not in <Instrument>)
Identifies MBS / ABS pool
Used to express option right
LegOptionRatio is provided on covering leg to create a delta neutral spread. In Listed Derivatives, the delta of the leg is multiplied by LegOptionRatio and OrderQty to determine the covering quantity.
Used to specify an anchor price for a leg as part of the definition or creation of the strategy - not used for execution price.
Conditionally required when MDUpdateAction = New(0) and MDEntryType is not Imbalance(A) ), Trade Volume (B), or Open Interest (C). Conditionally required when MDEntryType = "auction clearing price"
SpreadOrBenchmarkCurveDataComponent—
SpreadOrBenchmarkCurveData definition & usage →
For Fixed Income
Must be present if BenchmarkPrice is used.
The identifier of the benchmark security, e.g. Treasury against Corporate bond.
Source of BenchmarkSecurityID. If not specified, then ID Source is understood to be the same as that in the Instrument block.
Used to support market mechanism type; limit order, market order, committed principal order
Can be used to specify the currency of the quoted price.
Required for NDFs to specify the settlement currency (fixing currency).
RateSourceRepeating groupCount tag 1445—
RateSource definition & usage →
Required if NoRateSource(1445) > 0
Required if NoRateSources(1445) > 0
Required if RateSource(1446)=other
Conditionally required when MDUpdateAction = New(0) andMDEntryType = Bid(0), Offer(1), Trade(2) ), Trade Volume(B), or Open Interest(C). Conditionally required when MDEntryType = "auction clearing price"
SecSizesGrpRepeating groupCount tag 1177—
SecSizesGrp definition & usage →
Number of entries following. Conditionally required when MDUpdateAction = New(0) and MDEntryType = Bid(0) or Offer(1).
Defines the type of secondary size specified in MDSecSize(1179). Must be first field in this repeating group
Can be used to specify the lot type of the quoted size in order depth books.
Market posting quote / trade. Valid values: See Volume 6: Appendix 6-C
Space-delimited list of conditions describing a quote.
Space-delimited list of conditions describing a trade
For optional use in reporting Trades
For optional use in reporting Trades
Used if MDEntryType = Opening Price(4), Closing Price(5), or Settlement Price(6).
For optional use when this Bid or Offer represents an order
For optional use when this Bid or Offer represents an order. ExpireDate and ExpireTime cannot both be specified in one Market Data Entry.
For optional use when this Bid or Offer represents an order. ExpireDate and ExpireTime cannot both be specified in one Market Data Entry.
For optional use when this Bid or Offer represents an order
Can contain multiple instructions, space delimited.
For optional use when this Bid, Offer, or Trade represents an order
For optional use to support Hit/Take (selecting a specific order from the feed) without disclosing a private order id.
For optional use when this Bid, Offer, or Trade represents a quote
For optional use in reporting Trades
For optional use in reporting Trades
For optional use in reporting Trades
In an Aggregated Book, used to show how many individual orders make up an MDEntry
Display position of a bid or offer, numbered from most competitive to least competitive, per market side, beginning with 1
Text to describe the Market Data Entry. Part of repeating group.
Must be set if EncodedText field is specified and must immediately precede it.
Encoded (non-ASCII characters) representation of the Text field in the encoded format specified via the MessageEncoding field.
Indicates the first price of a trading session; can be a bid, ask, or a trade price.
Indicates the last price of a trading session; can be a bid, ask, or a trade price.
Indicates date on which instrument will settle. For NDFs required for specifying the "value date".
For optional use in reporting Trades. Used to specify the time of trade agreement for privately negotiated trades.
For optional use in reporting Trades. Used to specify the time of matching.
Allows sequence number to be specified within a feed type
Identifies role of dealer; Agent, Principal, RisklessPrincipal
StatsIndGrpRepeating groupCount tag 1175—
StatsIndGrp definition & usage →
Number of statistics indicators
Indicates that the MD Entry is eligible for inclusion in the type of statistic specified by the StatsType. Must be provided if NoStatsIndicators greater than 0.
PartiesRepeating groupCount tag 453—
Repeating group below should contain unique combinations of PartyID, PartyIDSource, and PartyRole
Used to identify source of PartyID. Required if PartyIDSource is specified. Required if NoPartyIDs > 0.
Used to identify class source of PartyID value (e.g. BIC). Required if PartyID is specified. Required if NoPartyIDs > 0.
Identifies the type of PartyID (e.g. Executing Broker). Required if NoPartyIDs > 0.
PtysSubGrpRepeating groupCount tag 802—
Repeating group of Party sub-identifiers.
PtysSubGrp definition & usage →
Depth of application messages queued for transmission as of delivery of this message
Action taken to resolve application queuing
RoutingGrpRepeating groupCount tag 215—
RoutingGrp definition & usage →
Required if any RoutingType and RoutingIDs are specified. Indicates the number within repeating group.
Indicates type of RoutingID. Required if NoRoutingIDs is > 0.
Identifies routing destination. Required if NoRoutingIDs is > 0.
StandardTrailerComponentRequired
StandardTrailer definition & usage →
Required when trailer contains signature. Note: Not to be included within SecureData field
Note: Not to be included within SecureData field
(Always unencrypted, always last field in message)