NoUndlyInstrumentParties (FIX tag 1058)

NumInGroupFIX 5.0 SP2group counter

NoUndlyInstrumentParties (tag 1058) is a NumInGroup field defined in FIX 5.0 SP2. It appears in 68 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
1058
Name
NoUndlyInstrumentParties
Datatype
NumInGroup (int)
Dialects
FIX 5.0 SP2
Messages
68

What the specification says

Identifies the number of parties identified with an underlying instrument

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

A real message using tag 1058

NewOrderSingle · FIX 5.0 SP2
TagFieldWire valueMeaning
8BeginStringFIXT.1.1
9BodyLength162
35MsgTypeDNewOrderSingle
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
11ClOrdIDORD-10042
711NoUnderlyings1 entry1repeating group
311UnderlyingSymbolEXAMPLE
1058NoUndlyInstrumentParties2 entries2repeating group
1059UnderlyingInstrumentPartyIDEXAMPLE
1059UnderlyingInstrumentPartyIDEXAMPLE
54Side1Buy
60TransactTime20240101-12:00:00.000
40OrdType1Market
10CheckSum155
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 5.0 SP2 dictionary and verified at build time: it parses and validates with no issues. Open the decoder to try your own message.

Where tag 1058 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 UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
AllocationInstructionJOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
AllocationInstructionAlertBMOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
AllocationReportASOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
AssignmentReportAWOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
CollateralAssignmentAYOptionalinside UndInstrmtCollGrp › UnderlyingInstrument › UndlyInstrumentParties
CollateralInquiryBBOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
CollateralInquiryAckBGOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
CollateralReportBAOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
CollateralRequestAXOptionalinside UndInstrmtCollGrp › UnderlyingInstrument › UndlyInstrumentParties
CollateralResponseAZOptionalinside UndInstrmtCollGrp › UnderlyingInstrument › UndlyInstrumentParties
ConfirmationAKOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
ContraryIntentionReportBOOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
CrossOrderCancelReplaceRequesttOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
CrossOrderCancelRequestuOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
DerivativeSecurityListAAOptionalinside UnderlyingInstrument › UndlyInstrumentParties
DerivativeSecurityListRequestzOptionalinside UnderlyingInstrument › UndlyInstrumentParties
DerivativeSecurityListUpdateReportBROptionalinside UnderlyingInstrument › UndlyInstrumentParties
DontKnowTradeQOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
EmailCOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
ExecutionAcknowledgementBNOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
ExecutionReport8Optionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
IOI6Optionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
ListStrikePricemOptionalinside InstrmtStrkPxGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
MarketDataIncrementalRefreshXOptionalinside MDIncGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
MarketDataRequestVOptionalinside InstrmtMDReqGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
MarketDataSnapshotFullRefreshWOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
MassQuoteiOptionalinside QuotSetGrp › UnderlyingInstrument › UndlyInstrumentParties
MassQuoteAcknowledgementbOptionalinside QuotSetAckGrp › UnderlyingInstrument › UndlyInstrumentParties
MultilegOrderCancelReplaceACOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
NewOrderCrosssOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
NewOrderListEOptionalinside ListOrdGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
NewOrderMultilegABOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
NewOrderSingleDOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
NewsBOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
OrderCancelReplaceRequestGOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
OrderCancelRequestFOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
OrderMassActionReportBZOptionalinside UnderlyingInstrument › UndlyInstrumentParties
OrderMassActionRequestCAOptionalinside UnderlyingInstrument › UndlyInstrumentParties
OrderMassCancelReportrOptionalinside UnderlyingInstrument › UndlyInstrumentParties
OrderMassCancelRequestqOptionalinside UnderlyingInstrument › UndlyInstrumentParties
OrderMassStatusRequestAFOptionalinside UnderlyingInstrument › UndlyInstrumentParties
OrderStatusRequestHOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
PositionMaintenanceReportAMOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
PositionMaintenanceRequestALOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
PositionReportAPOptionalinside PosUndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteSOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteCancelZOptionalinside QuotCxlEntriesGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteRequestROptionalinside QuotReqGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteRequestRejectAGOptionalinside QuotReqRjctGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteResponseAJOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteStatusReportAIOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
QuoteStatusRequestaOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
RFQRequestAHOptionalinside RFQReqGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
RequestForPositionsANOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
RequestForPositionsAckAOOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityDefinitiondOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityDefinitionRequestcOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityDefinitionUpdateReportBPOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityListyOptionalinside SecListGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityListRequestxOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityListUpdateReportBKOptionalinside SecLstUpdRelSymGrp › UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityStatusfOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
SecurityStatusRequesteOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
TradeCaptureReportAEOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
TradeCaptureReportAckAROptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
TradeCaptureReportRequestADOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties
TradeCaptureReportRequestAckAQOptionalinside UndInstrmtGrp › UnderlyingInstrument › UndlyInstrumentParties

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 1058 in TypeScript

decode.tsts
import { createFixEngine } from "@boarteam/fix";import { dictionary } from "@boarteam/fix-dict-fix50sp2";const fix = createFixEngine(dictionary);const { message, issues } = fix.parse(raw);// NoUndlyInstrumentParties is a group counter, so the entries live on message.groups —// NOT on message.fields. message.fields[1058] is undefined.const entries = message.groups[1058] ?? [];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-fix50sp2