NoInstrumentParties (FIX tag 1018)

NumInGroupFIX 5.0 SP2group counter

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

What the specification says

Identifies the number of parties identified with an instrument

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

A real message using tag 1018

NewOrderSingle · FIX 5.0 SP2
TagFieldWire valueMeaning
8BeginStringFIXT.1.1
9BodyLength144
35MsgTypeDNewOrderSingle
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
11ClOrdIDORD-10042
1018NoInstrumentParties2 entries2repeating group
1019InstrumentPartyIDEXAMPLE
1019InstrumentPartyIDEXAMPLE
54Side1Buy
60TransactTime20240101-12:00:00.000
40OrdType1Market
10CheckSum168
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 1018 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
AdjustedPositionReportBLOptionalinside InstrmtGrp › Instrument › InstrumentParties
Advertisement7Optionalinside Instrument › InstrumentParties
AllocationInstructionJOptionalinside Instrument › InstrumentParties
AllocationInstructionAlertBMOptionalinside Instrument › InstrumentParties
AllocationReportASOptionalinside Instrument › InstrumentParties
AssignmentReportAWOptionalinside Instrument › InstrumentParties
CollateralAssignmentAYOptionalinside Instrument › InstrumentParties
CollateralInquiryBBOptionalinside Instrument › InstrumentParties
CollateralInquiryAckBGOptionalinside Instrument › InstrumentParties
CollateralReportBAOptionalinside Instrument › InstrumentParties
CollateralRequestAXOptionalinside Instrument › InstrumentParties
CollateralResponseAZOptionalinside Instrument › InstrumentParties
ConfirmationAKOptionalinside Instrument › InstrumentParties
ContraryIntentionReportBOOptionalinside Instrument › InstrumentParties
CrossOrderCancelReplaceRequesttOptionalinside Instrument › InstrumentParties
CrossOrderCancelRequestuOptionalinside Instrument › InstrumentParties
DerivativeSecurityListAAOptionalinside RelSymDerivSecGrp › Instrument › InstrumentParties
DerivativeSecurityListUpdateReportBROptionalinside RelSymDerivSecUpdGrp › Instrument › InstrumentParties
DontKnowTradeQOptionalinside Instrument › InstrumentParties
EmailCOptionalinside InstrmtGrp › Instrument › InstrumentParties
ExecutionAcknowledgementBNOptionalinside Instrument › InstrumentParties
ExecutionReport8Optionalinside Instrument › InstrumentParties
IOI6Optionalinside Instrument › InstrumentParties
ListStrikePricemOptionalinside InstrmtStrkPxGrp › Instrument › InstrumentParties
MarketDataIncrementalRefreshXOptionalinside MDIncGrp › Instrument › InstrumentParties
MarketDataRequestVOptionalinside InstrmtMDReqGrp › Instrument › InstrumentParties
MarketDataSnapshotFullRefreshWOptionalinside Instrument › InstrumentParties
MassQuoteiOptionalinside QuotSetGrp › QuotEntryGrp › Instrument › InstrumentParties
MassQuoteAcknowledgementbOptionalinside QuotSetAckGrp › QuotEntryAckGrp › Instrument › InstrumentParties
MultilegOrderCancelReplaceACOptionalinside Instrument › InstrumentParties
NewOrderCrosssOptionalinside Instrument › InstrumentParties
NewOrderListEOptionalinside ListOrdGrp › Instrument › InstrumentParties
NewOrderMultilegABOptionalinside Instrument › InstrumentParties
NewOrderSingleDOptionalinside Instrument › InstrumentParties
NewsBOptionalinside InstrmtGrp › Instrument › InstrumentParties
OrderCancelReplaceRequestGOptionalinside Instrument › InstrumentParties
OrderCancelRequestFOptionalinside Instrument › InstrumentParties
OrderMassActionReportBZOptionalinside Instrument › InstrumentParties
OrderMassActionRequestCAOptionalinside Instrument › InstrumentParties
OrderMassCancelReportrOptionalinside Instrument › InstrumentParties
OrderMassCancelRequestqOptionalinside Instrument › InstrumentParties
OrderMassStatusRequestAFOptionalinside Instrument › InstrumentParties
OrderStatusRequestHOptionalinside Instrument › InstrumentParties
PositionMaintenanceReportAMOptionalinside Instrument › InstrumentParties
PositionMaintenanceRequestALOptionalinside Instrument › InstrumentParties
PositionReportAPOptionalinside Instrument › InstrumentParties
QuoteSOptionalinside Instrument › InstrumentParties
QuoteCancelZOptionalinside QuotCxlEntriesGrp › Instrument › InstrumentParties
QuoteRequestROptionalinside QuotReqGrp › Instrument › InstrumentParties
QuoteRequestRejectAGOptionalinside QuotReqRjctGrp › Instrument › InstrumentParties
QuoteResponseAJOptionalinside Instrument › InstrumentParties
QuoteStatusReportAIOptionalinside Instrument › InstrumentParties
QuoteStatusRequestaOptionalinside Instrument › InstrumentParties
RFQRequestAHOptionalinside RFQReqGrp › Instrument › InstrumentParties
RequestForPositionsANOptionalinside Instrument › InstrumentParties
RequestForPositionsAckAOOptionalinside Instrument › InstrumentParties
SecurityDefinitiondOptionalinside Instrument › InstrumentParties
SecurityDefinitionRequestcOptionalinside Instrument › InstrumentParties
SecurityDefinitionUpdateReportBPOptionalinside Instrument › InstrumentParties
SecurityListyOptionalinside SecListGrp › Instrument › InstrumentParties
SecurityListRequestxOptionalinside Instrument › InstrumentParties
SecurityListUpdateReportBKOptionalinside SecLstUpdRelSymGrp › Instrument › InstrumentParties
SecurityStatusfOptionalinside Instrument › InstrumentParties
SecurityStatusRequesteOptionalinside Instrument › InstrumentParties
SettlementObligationReportBQOptionalinside SettlObligationInstructions › Instrument › InstrumentParties
StreamAssignmentReportCDOptionalinside StrmAsgnRptGrp › StrmAsgnRptInstrmtGrp › Instrument › InstrumentParties
StreamAssignmentRequestCCOptionalinside StrmAsgnReqGrp › StrmAsgnReqInstrmtGrp › Instrument › InstrumentParties
TradeCaptureReportAEOptionalinside Instrument › InstrumentParties
TradeCaptureReportAckAROptionalinside Instrument › InstrumentParties
TradeCaptureReportRequestADOptionalinside Instrument › InstrumentParties
TradeCaptureReportRequestAckAQOptionalinside Instrument › InstrumentParties
TradingSessionStatushOptionalinside Instrument › InstrumentParties

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 1018 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);// NoInstrumentParties is a group counter, so the entries live on message.groups —// NOT on message.fields. message.fields[1018] is undefined.const entries = message.groups[1018] ?? [];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