NoUnderlyingStips (FIX tag 887)

NumInGroupFIX 4.4FIX 5.0 SP2group counter

NoUnderlyingStips (tag 887) is a NumInGroup field defined in FIX 4.4 and FIX 5.0 SP2. It appears in 59 message types, always optionally. Its datatype is NumInGroup, which makes it a repeating-group counter: its value is the number of entries that follow, not a quantity in its own right.

At a glance

Tag
887
Name
NoUnderlyingStips
Datatype
NumInGroup (int)
Dialects
FIX 4.4 and FIX 5.0 SP2
Messages
59

What the specification says

Number of underlying stipulation entries

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

A real message using tag 887

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

The number of entries in the repeating group that follows. The next field on the wire is the group's delimiter tag. @boarteam/fix parses the value as a number and reports parse/invalid-int when it does not lex as one; the raw string is kept either way.

Read tag 887 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);// NoUnderlyingStips is a group counter, so the entries live on message.groups —// NOT on message.fields. message.fields[887] is undefined.const entries = message.groups[887] ?? [];for (const entry of entries) {  // entry.fields is keyed by tag; entry.groups holds nested groups}

Other NumInGroup 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