InstrumentPartyRole (FIX tag 1051)

intFIX 5.0 SP2

InstrumentPartyRole (tag 1051) is an int field defined in FIX 5.0 SP2. It appears in 72 message types, always optionally.

At a glance

Tag
1051
Name
InstrumentPartyRole
Datatype
int
Dialects
FIX 5.0 SP2
Messages
72

What the specification says

PartyRole value within an instrument partyepeating group.

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

A real message using tag 1051

NewOrderSingle · FIX 5.0 SP2
TagFieldWire valueMeaning
8BeginStringFIXT.1.1
9BodyLength158
35MsgTypeDNewOrderSingle
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
11ClOrdIDORD-10042
1018NoInstrumentParties2 entries2repeating group
1019InstrumentPartyIDEXAMPLE
1051InstrumentPartyRole1
1019InstrumentPartyIDEXAMPLE
1051InstrumentPartyRole1
54Side1Buy
60TransactTime20240101-12:00:00.000
40OrdType1Market
10CheckSum025
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 1051 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

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