UnderlyingStipValue (FIX tag 889)

StringFIX 4.4FIX 5.0 SP2

UnderlyingStipValue (tag 889) is a String field defined in FIX 4.4 and FIX 5.0 SP2. It appears in 59 message types, always optionally.

At a glance

Tag
889
Name
UnderlyingStipValue
Datatype
String
Dialects
FIX 4.4 and FIX 5.0 SP2
Messages
59

What the specification says

FIX 4.4

Value of stipulation. Same values as StipulationValue (234)

FIX 5.0 SP2

Value of stipulation.

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

A real message using tag 889

NewOrderSingle · FIX 4.4
TagFieldWire valueMeaning
8BeginStringFIX.4.4
9BodyLength183
35MsgTypeDOrder – Single
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
11ClOrdIDORD-10042
711NoUnderlyings1 entry1repeating group
311UnderlyingSymbolEXAMPLE
887NoUnderlyingStips2 entries2repeating group
888UnderlyingStipTypeEXAMPLE
889UnderlyingStipValueEXAMPLE
888UnderlyingStipTypeEXAMPLE
889UnderlyingStipValueEXAMPLE
54Side1Buy
60TransactTime20240101-12:00:00.000
40OrdType1Market
10CheckSum193
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 889 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.

MessageMsgTypeFIX 4.4FIX 5.0 SP2Where in the message
Advertisement7OptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
AllocationInstructionJOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
AllocationInstructionAlertBMOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
AllocationReportASOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
AssignmentReportAWOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
CollateralAssignmentAYOptionalOptionalinside UndInstrmtCollGrp › UnderlyingInstrument › UnderlyingStipulations
CollateralInquiryBBOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
CollateralInquiryAckBGOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
CollateralReportBAOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
CollateralRequestAXOptionalOptionalinside UndInstrmtCollGrp › UnderlyingInstrument › UnderlyingStipulations
CollateralResponseAZOptionalOptionalinside UndInstrmtCollGrp › UnderlyingInstrument › UnderlyingStipulations
ConfirmationAKOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
ContraryIntentionReportBOOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
CrossOrderCancelReplaceRequesttOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
CrossOrderCancelRequestuOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
DerivativeSecurityListAAOptionalOptionalinside UnderlyingInstrument › UnderlyingStipulations
DerivativeSecurityListRequestzOptionalOptionalinside UnderlyingInstrument › UnderlyingStipulations
DerivativeSecurityListUpdateReportBROptionalinside UnderlyingInstrument › UnderlyingStipulations
DontKnowTradeQOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
EmailCOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
ExecutionAcknowledgementBNOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
ExecutionReport8OptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
IOI6OptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
ListStrikePricemOptionalOptionalinside UndInstrmtStrkPxGrp › UnderlyingInstrument › UnderlyingStipulations
MarketDataIncrementalRefreshXOptionalOptionalinside MDIncGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
MarketDataRequestVOptionalOptionalinside InstrmtMDReqGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
MarketDataSnapshotFullRefreshWOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
MassQuoteiOptionalOptionalinside QuotSetGrp › UnderlyingInstrument › UnderlyingStipulations
MassQuoteAcknowledgementbOptionalOptionalinside QuotSetAckGrp › UnderlyingInstrument › UnderlyingStipulations
MultilegOrderCancelReplaceACOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
NewOrderCrosssOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
NewOrderListEOptionalOptionalinside ListOrdGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
NewOrderMultilegABOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
NewOrderSingleDOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
NewsBOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
OrderCancelReplaceRequestGOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
OrderCancelRequestFOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
OrderMassActionReportBZOptionalinside UnderlyingInstrument › UnderlyingStipulations
OrderMassActionRequestCAOptionalinside UnderlyingInstrument › UnderlyingStipulations
OrderMassCancelReportrOptionalOptionalinside UnderlyingInstrument › UnderlyingStipulations
OrderMassCancelRequestqOptionalOptionalinside UnderlyingInstrument › UnderlyingStipulations
OrderMassStatusRequestAFOptionalOptionalinside UnderlyingInstrument › UnderlyingStipulations
OrderStatusRequestHOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
PositionMaintenanceReportAMOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
PositionMaintenanceRequestALOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
PositionReportAPOptionalOptionalinside PosUndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteSOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteCancelZOptionalOptionalinside QuotCxlEntriesGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteRequestROptionalOptionalinside QuotReqGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteRequestRejectAGOptionalOptionalinside QuotReqRjctGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteResponseAJOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteStatusReportAIOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
QuoteStatusRequestaOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
RFQRequestAHOptionalOptionalinside RFQReqGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
RequestForPositionsANOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
RequestForPositionsAckAOOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityDefinitiondOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityDefinitionRequestcOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityDefinitionUpdateReportBPOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityListyOptionalOptionalinside SecListGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityListRequestxOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityListUpdateReportBKOptionalinside SecLstUpdRelSymGrp › UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityStatusfOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
SecurityStatusRequesteOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
TradeCaptureReportAEOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
TradeCaptureReportAckAROptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
TradeCaptureReportRequestADOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations
TradeCaptureReportRequestAckAQOptionalOptionalinside UndInstrmtGrp › UnderlyingInstrument › UnderlyingStipulations

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 889 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[889];field?.name;   // "UnderlyingStipValue"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