UnderlyingInstrumentPartyRole (FIX tag 1061)

intFIX 5.0 SP2

UnderlyingInstrumentPartyRole (tag 1061) is an int field defined in FIX 5.0 SP2. It appears in 68 message types, always optionally.

At a glance

Tag
1061
Name
UnderlyingInstrumentPartyRole
Datatype
int
Dialects
FIX 5.0 SP2
Messages
68

What the specification says

PartyRole value within an underlying instrument partyepeating group.

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

A real message using tag 1061

NewOrderSingle · FIX 5.0 SP2
TagFieldWire valueMeaning
8BeginStringFIXT.1.1
9BodyLength176
35MsgTypeDNewOrderSingle
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
11ClOrdIDORD-10042
711NoUnderlyings1 entry1repeating group
311UnderlyingSymbolEXAMPLE
1058NoUndlyInstrumentParties2 entries2repeating group
1059UnderlyingInstrumentPartyIDEXAMPLE
1061UnderlyingInstrumentPartyRole1
1059UnderlyingInstrumentPartyIDEXAMPLE
1061UnderlyingInstrumentPartyRole1
54Side1Buy
60TransactTime20240101-12:00:00.000
40OrdType1Market
10CheckSum014
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 1061 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

A whole number, optionally signed. Leading zeros are legal on the wire and are preserved in the raw value. @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 1061 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);const field = message.fields[1061];field?.name;   // "UnderlyingInstrumentPartyRole"field?.raw;    // the verbatim wire stringfield?.value;  // coerced to a number

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