EventText (FIX tag 868)

StringFIX 4.4

EventText (tag 868) is a String field defined in FIX 4.4. It appears in 59 message types, always optionally.

At a glance

Tag
868
Name
EventText
Datatype
String
Dialects
FIX 4.4
Messages
59

What the specification says

Comments related to the event.

Descriptions are quoted from the FIX Orchestra sources under the Apache 2.0 licence.

A real message using tag 868

NewOrderSingle · FIX 4.4
TagFieldWire valueMeaning
8BeginStringFIX.4.4
9BodyLength153
35MsgTypeDOrder – Single
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
11ClOrdIDORD-10042
864NoEvents2 entries2repeating group
865EventType1Put
868EventTextEXAMPLE
865EventType1Put
868EventTextEXAMPLE
54Side1Buy
60TransactTime20240101-12:00:00.000
40OrdType1Market
10CheckSum012
Edit and decode it yourself

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.

Open in the full decoder →

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.

Where tag 868 appears

Requiredness is a property of the message, not of the field: the same tag can be optional in one message and conditionally required in another.

MessageMsgTypeRequirednessWhere in the message
Advertisement7Optionalinside Instrument › EvntGrp
AllocationInstructionJOptionalinside Instrument › EvntGrp
AllocationReportASOptionalinside Instrument › EvntGrp
AssignmentReportAWOptionalinside Instrument › EvntGrp
CollateralAssignmentAYOptionalinside Instrument › EvntGrp
CollateralInquiryBBOptionalinside Instrument › EvntGrp
CollateralInquiryAckBGOptionalinside Instrument › EvntGrp
CollateralReportBAOptionalinside Instrument › EvntGrp
CollateralRequestAXOptionalinside Instrument › EvntGrp
CollateralResponseAZOptionalinside Instrument › EvntGrp
ConfirmationAKOptionalinside Instrument › EvntGrp
CrossOrderCancelReplaceRequesttOptionalinside Instrument › EvntGrp
CrossOrderCancelRequestuOptionalinside Instrument › EvntGrp
DerivativeSecurityListAAOptionalinside RelSymDerivSecGrp › Instrument › EvntGrp
DontKnowTradeQOptionalinside Instrument › EvntGrp
EmailCOptionalinside InstrmtGrp › Instrument › EvntGrp
ExecutionReport8Optionalinside Instrument › EvntGrp
IOI6Optionalinside Instrument › EvntGrp
ListStrikePricemOptionalinside InstrmtStrkPxGrp › Instrument › EvntGrp
MarketDataIncrementalRefreshXOptionalinside MDIncGrp › Instrument › EvntGrp
MarketDataRequestVOptionalinside InstrmtMDReqGrp › Instrument › EvntGrp
MarketDataSnapshotFullRefreshWOptionalinside Instrument › EvntGrp
MassQuoteiOptionalinside QuotSetGrp › QuotEntryGrp › Instrument › EvntGrp
MassQuoteAcknowledgementbOptionalinside QuotSetAckGrp › QuotEntryAckGrp › Instrument › EvntGrp
MultilegOrderCancelReplaceACOptionalinside Instrument › EvntGrp
NewOrderCrosssOptionalinside Instrument › EvntGrp
NewOrderListEOptionalinside ListOrdGrp › Instrument › EvntGrp
NewOrderMultilegABOptionalinside Instrument › EvntGrp
NewOrderSingleDOptionalinside Instrument › EvntGrp
NewsBOptionalinside InstrmtGrp › Instrument › EvntGrp
OrderCancelReplaceRequestGOptionalinside Instrument › EvntGrp
OrderCancelRequestFOptionalinside Instrument › EvntGrp
OrderMassCancelReportrOptionalinside Instrument › EvntGrp
OrderMassCancelRequestqOptionalinside Instrument › EvntGrp
OrderMassStatusRequestAFOptionalinside Instrument › EvntGrp
OrderStatusRequestHOptionalinside Instrument › EvntGrp
PositionMaintenanceReportAMOptionalinside Instrument › EvntGrp
PositionMaintenanceRequestALOptionalinside Instrument › EvntGrp
PositionReportAPOptionalinside Instrument › EvntGrp
QuoteSOptionalinside Instrument › EvntGrp
QuoteCancelZOptionalinside QuotCxlEntriesGrp › Instrument › EvntGrp
QuoteRequestROptionalinside QuotReqGrp › Instrument › EvntGrp
QuoteRequestRejectAGOptionalinside QuotReqRjctGrp › Instrument › EvntGrp
QuoteResponseAJOptionalinside Instrument › EvntGrp
QuoteStatusReportAIOptionalinside Instrument › EvntGrp
QuoteStatusRequestaOptionalinside Instrument › EvntGrp
RFQRequestAHOptionalinside RFQReqGrp › Instrument › EvntGrp
RequestForPositionsANOptionalinside Instrument › EvntGrp
RequestForPositionsAckAOOptionalinside Instrument › EvntGrp
SecurityDefinitiondOptionalinside Instrument › EvntGrp
SecurityDefinitionRequestcOptionalinside Instrument › EvntGrp
SecurityListyOptionalinside SecListGrp › Instrument › EvntGrp
SecurityListRequestxOptionalinside Instrument › EvntGrp
SecurityStatusfOptionalinside Instrument › EvntGrp
SecurityStatusRequesteOptionalinside Instrument › EvntGrp
TradeCaptureReportAEOptionalinside Instrument › EvntGrp
TradeCaptureReportAckAROptionalinside Instrument › EvntGrp
TradeCaptureReportRequestADOptionalinside Instrument › EvntGrp
TradeCaptureReportRequestAckAQOptionalinside Instrument › EvntGrp

Wire format

Free-form text. Any byte except the SOH separator is legal, so values are not trimmed or case-folded on the wire. @boarteam/fix keeps the value as a string; format rules are checked by validate(), which reports validate/invalid-value rather than throwing.

Read tag 868 in TypeScript

decode.tsts
import { createFixEngine } from "@boarteam/fix";import { dictionary } from "@boarteam/fix-dict-fix44";const fix = createFixEngine(dictionary);const { message, issues } = fix.parse(raw);const field = message.fields[868];field?.name;   // "EventText"field?.raw;    // the verbatim wire stringfield?.value;  // coerced to a string

Other String fields

Decode 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