ExecutionReport (MsgType 8)
ExecutionReport is the FIX message with MsgType 8, defined in FIX 4.4 and FIX 4.2. It is an application-level message: it carries a business event rather than managing the session. Its body has 140 top-level members once the standard header and trailer are counted.
A real ExecutionReport
| Tag | Field | Wire value | Meaning |
|---|---|---|---|
| 8 | BeginString | FIX.4.4 | |
| 9 | BodyLength | 133 | |
| 35 | MsgType | 8 | Execution Report |
| 49 | SenderCompID | BOARTEAM | |
| 56 | TargetCompID | COUNTERPARTY | |
| 34 | MsgSeqNum | 2 | |
| 52 | SendingTime | 20240101-12:00:00.000 | |
| 37 | OrderID | ORD-10042 | |
| 17 | ExecID | EXEC-88117 | |
| 150 | ExecType | 0 | New |
| 39 | OrdStatus | 0 | New |
| 54 | Side | 1 | Buy |
| 151 | LeavesQty | 0 | |
| 14 | CumQty | 1000000 | |
| 6 | AvgPx | 1.09215 | |
| 10 | CheckSum | 025 |
Shown with | separators for readability. On the wire FIX uses SOH (0x01), an invisible control byte — and because BodyLength and CheckSum are computed over the actual bytes, the two forms have different checksums. Both are valid and both decode here.
Generated from the FIX 4.4 dictionary and verified at build time: it parses and validates with no issues. Open the decoder to try your own message.
Message body — FIX 4.4
Components are listed by name and link to their own page rather than being expanded inline; repeating groups are expanded, including where they nest.
- —Standard Message HeadercomponentRequired
- 37OrderIDRequired
- 198SecondaryOrderIDOptional
- 526SecondaryClOrdIDOptional
- 527SecondaryExecIDOptional
- 11ClOrdIDOptional
- 41OrigClOrdIDOptional
- 583ClOrdLinkIDOptional
- 693QuoteRespIDOptional
- 790OrdStatusReqIDOptional
- 584MassStatusReqIDOptional
- 911TotNumReportsOptional
- 912LastRptRequestedOptional
- —PartiescomponentOptional
- 229TradeOriginationDateOptional
- —ContraGrpcomponentOptional
- 66ListIDOptional
- 548CrossIDOptional
- 551OrigCrossIDOptional
- 549CrossTypeOptional
- 17ExecIDRequired
- 19ExecRefIDConditional
- 150ExecTypeRequired
- 39OrdStatusRequired
- 636WorkingIndicatorOptional
- 103OrdRejReasonOptional
- 378ExecRestatementReasonConditional
- 1AccountOptional
- 660AcctIDSourceOptional
- 581AccountTypeOptional
- 589DayBookingInstOptional
- 590BookingUnitOptional
- 591PreallocMethodOptional
- 63SettlTypeOptional
- 64SettlDateConditional
- 544CashMarginOptional
- 635ClearingFeeIndicatorOptional
- —InstrumentcomponentRequired
- —FinancingDetailscomponentOptional
- —UndInstrmtGrpcomponentOptional
- 54SideRequired
- —StipulationscomponentOptional
- 854QtyTypeOptional
- —OrderQtyDatacomponentOptional
- 40OrdTypeOptional
- 423PriceTypeOptional
- 44PriceConditional
- 99StopPxConditional
- —PegInstructionscomponentOptional
- —DiscretionInstructionscomponentOptional
- 839PeggedPriceOptional
- 845DiscretionPriceOptional
- 847TargetStrategyOptional
- 848TargetStrategyParametersOptional
- 849ParticipationRateConditional
- 850TargetStrategyPerformanceOptional
- 15CurrencyOptional
- 376ComplianceIDOptional
- 377SolicitedFlagOptional
- 59TimeInForceOptional
- 168EffectiveTimeOptional
- 432ExpireDateConditional
- 126ExpireTimeConditional
- 18ExecInstOptional
- 528OrderCapacityOptional
- 529OrderRestrictionsOptional
- 582CustOrderCapacityOptional
- 32LastQtyConditional
- 652UnderlyingLastQtyOptional
- 31LastPxConditional
- 651UnderlyingLastPxOptional
- 669LastParPxConditional
- 194LastSpotRateOptional
- 195LastForwardPointsOptional
- 30LastMktOptional
- 336TradingSessionIDOptional
- 625TradingSessionSubIDOptional
- 943TimeBracketOptional
- 29LastCapacityOptional
- 151LeavesQtyRequired
- 14CumQtyRequired
- 6AvgPxRequired
- 424DayOrderQtyOptional
- 425DayCumQtyOptional
- 426DayAvgPxOptional
- 427GTBookingInstOptional
- 75TradeDateOptional
- 60TransactTimeOptional
- 113ReportToExchOptional
- —CommissionDatacomponentOptional
- —SpreadOrBenchmarkCurveDatacomponentOptional
- —YieldDatacomponentOptional
- 381GrossTradeAmtOptional
- 157NumDaysInterestOptional
- 230ExDateOptional
- 158AccruedInterestRateOptional
- 159AccruedInterestAmtOptional
- 738InterestAtMaturityOptional
- 920EndAccruedInterestAmtOptional
- 921StartCashOptional
- 922EndCashOptional
- 258TradedFlatSwitchOptional
- 259BasisFeatureDateOptional
- 260BasisFeaturePriceOptional
- 238ConcessionOptional
- 237TotalTakedownOptional
- 118NetMoneyOptional
- 119SettlCurrAmtOptional
- 120SettlCurrencyOptional
- 155SettlCurrFxRateOptional
- 156SettlCurrFxRateCalcOptional
- 21HandlInstOptional
- 110MinQtyOptional
- 111MaxFloorOptional
- 77PositionEffectOptional
- 210MaxShowOptional
- 775BookingTypeOptional
- 58TextOptional
- 354EncodedTextLenConditional
- 355EncodedTextConditional
- 193SettlDate2Optional
- 192OrderQty2Optional
- 641LastForwardPoints2Optional
- 442MultiLegReportingTypeOptional
- 480CancellationRightsOptional
- 481MoneyLaunderingStatusOptional
- 513RegistIDOptional
- 494DesignationOptional
- 483TransBkdTimeOptional
- 515ExecValuationPointOptional
- 484ExecPriceTypeOptional
- 485ExecPriceAdjustmentOptional
- 638PriorityIndicatorOptional
- 639PriceImprovementOptional
- 851LastLiquidityIndOptional
- —ContAmtGrpcomponentOptional
- —InstrmtLegExecGrpcomponentOptional
- 797CopyMsgIndicatorOptional
- —MiscFeesGrpcomponentOptional
- —Standard Message TrailercomponentRequired
Message body — FIX 4.2
Components are listed by name and link to their own page rather than being expanded inline; repeating groups are expanded, including where they nest.
- —Standard Message HeadercomponentRequired
- 37OrderIDRequired
- 198SecondaryOrderIDOptional
- 11ClOrdIDOptional
- 41OrigClOrdIDOptional
- 109ClientIDOptional
- 76ExecBrokerOptional
- 382NoContraBrokersrepeating groupOptional
- 375ContraBrokerOptional
- 337ContraTraderOptional
- 437ContraTradeQtyOptional
- 438ContraTradeTimeOptional
- 66ListIDOptional
- 17ExecIDRequired
- 20ExecTransTypeRequired
- 19ExecRefIDOptional
- 150ExecTypeRequired
- 39OrdStatusRequired
- 103OrdRejReasonOptional
- 378ExecRestatementReasonOptional
- 1AccountOptional
- 63SettlTypeOptional
- 64SettlDateOptional
- 55SymbolRequired
- 65SymbolSfxOptional
- 48SecurityIDOptional
- 22SecurityIDSourceOptional
- 167SecurityTypeOptional
- 200MaturityMonthYearOptional
- 205MaturityDayOptional
- 201PutOrCallOptional
- 202StrikePriceOptional
- 206OptAttributeOptional
- 231ContractMultiplierOptional
- 223CouponRateOptional
- 207SecurityExchangeOptional
- 106IssuerOptional
- 348EncodedIssuerLenOptional
- 349EncodedIssuerOptional
- 107SecurityDescOptional
- 350EncodedSecurityDescLenOptional
- 351EncodedSecurityDescOptional
- 54SideRequired
- 38OrderQtyOptional
- 152CashOrderQtyOptional
- 40OrdTypeOptional
- 44PriceOptional
- 99StopPxOptional
- 211PegOffsetValueOptional
- 388DiscretionInstOptional
- 389DiscretionOffsetValueOptional
- 15CurrencyOptional
- 376ComplianceIDOptional
- 377SolicitedFlagOptional
- 59TimeInForceOptional
- 168EffectiveTimeOptional
- 432ExpireDateOptional
- 126ExpireTimeOptional
- 18ExecInstOptional
- 47Rule80AOptional
- 32LastQtyOptional
- 31LastPxOptional
- 194LastSpotRateOptional
- 195LastForwardPointsOptional
- 30LastMktOptional
- 336TradingSessionIDOptional
- 29LastCapacityOptional
- 151LeavesQtyRequired
- 14CumQtyRequired
- 6AvgPxRequired
- 424DayOrderQtyOptional
- 425DayCumQtyOptional
- 426DayAvgPxOptional
- 427GTBookingInstOptional
- 75TradeDateOptional
- 60TransactTimeOptional
- 113ReportToExchOptional
- 12CommissionOptional
- 13CommTypeOptional
- 381GrossTradeAmtOptional
- 119SettlCurrAmtOptional
- 120SettlCurrencyOptional
- 155SettlCurrFxRateOptional
- 156SettlCurrFxRateCalcOptional
- 21HandlInstOptional
- 110MinQtyOptional
- 111MaxFloorOptional
- 77PositionEffectOptional
- 210MaxShowOptional
- 58TextOptional
- 354EncodedTextLenOptional
- 355EncodedTextOptional
- 193SettlDate2Optional
- 192OrderQty2Optional
- 439ClearingFirmOptional
- 440ClearingAccountOptional
- 442MultiLegReportingTypeOptional
- —Standard Message TrailercomponentRequired
What changed between the dialects
Present in FIX 4.4 only (79)
tag 526, tag 527, tag 583, tag 693, tag 790, tag 584, tag 911, tag 912, Parties, tag 229, ContraGrp, tag 548, tag 551, tag 549, tag 636, tag 660, tag 581, tag 589, tag 590, tag 591, tag 544, tag 635, Instrument, FinancingDetails, UndInstrmtGrp, Stipulations, tag 854, OrderQtyData, tag 423, PegInstructions, DiscretionInstructions, tag 839, tag 845, tag 847, tag 848, tag 849, tag 850, tag 528, tag 529, tag 582, tag 652, tag 651, tag 669, tag 625, tag 943, CommissionData, SpreadOrBenchmarkCurveData, YieldData, tag 157, tag 230, tag 158, tag 159, tag 738, tag 920, tag 921, tag 922, tag 258, tag 259, tag 260, tag 238, tag 237, tag 118, tag 775, tag 641, tag 480, tag 481, tag 513, tag 494, tag 483, tag 515, tag 484, tag 485, tag 638, tag 639, tag 851, ContAmtGrp, InstrmtLegExecGrp, tag 797, MiscFeesGrp
Present in FIX 4.2 only (33)
tag 109, tag 76, group 382, tag 20, tag 55, tag 65, tag 48, tag 22, tag 167, tag 200, tag 205, tag 201, tag 202, tag 206, tag 231, tag 223, tag 207, tag 106, tag 348, tag 349, tag 107, tag 350, tag 351, tag 38, tag 152, tag 211, tag 388, tag 389, tag 47, tag 12, tag 13, tag 439, tag 440
Handle ExecutionReport in TypeScript
import { createFixEngine } from "@boarteam/fix";import { dictionary } from "@boarteam/fix-dict-fix44";const fix = createFixEngine(dictionary);const { message, issues } = fix.parse(raw);if (message.msgType === "8") { message.name; // "ExecutionReport" // fields are keyed by tag; repeating groups live on message.groups}// Problems come back as data, never as exceptions:issues; // FixIssue[]fix.validate(message); // dictionary-level problemsDecode this in your own code
The same engine that produced the decoded example above is an Apache-2.0 npm package with zero runtime dependencies. It runs in Node and in the browser, and parse() returns problems as data instead of throwing.
npm i @boarteam/fix @boarteam/fix-dict-fix44