PartyRole (FIX tag 452)

intFIX 4.4

PartyRole (tag 452) is an int field defined in FIX 4.4. It appears in 44 message types, always optionally. It is an enumerated field with 37 defined values.

At a glance

Tag: 452
Name: PartyRole
Datatype: int
Dialects: FIX 4.4
Messages: 44
Valid values: 37

What the specification says

Identifies the type or role of the PartyID (448) specified. See "Appendix 6-G – Use of <Parties> Component Block"

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

A real message using tag 452

NewOrderSingle · FIX 4.4

Tag	Field	Wire value	Meaning
8	BeginString	FIX.4.4
9	BodyLength	153
35	MsgType	D	Order – Single
49	SenderCompID	BOARTEAM
56	TargetCompID	COUNTERPARTY
34	MsgSeqNum	2
52	SendingTime	20240101-12:00:00.000
11	ClOrdID	ORD-10042
453	NoPartyIDs2 entries	2	repeating group
448	PartyID	EXAMPLE
452	PartyRole	1	Executing Firm (formerly FIX 4.2 ExecBroker)
448	PartyID	EXAMPLE
452	PartyRole	1	Executing Firm (formerly FIX 4.2 ExecBroker)
54	Side	1	Buy
60	TransactTime	20240101-12:00:00.000
40	OrdType	1	Market
10	CheckSum	234

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.

Valid values

A value outside this list is not a parse error — the message still decodes — but validate() reports it as validate/value-not-in-enum.

Value	Meaning	Symbolic name
1	Executing Firm (formerly FIX 4.2 ExecBroker)	EXECUTING_FIRM
2	Broker of Credit (formerly FIX 4.2 BrokerOfCredit)	BROKER_OF_CREDIT
3	Client ID (formerly FIX 4.2 ClientID)	CLIENT_ID
4	Clearing Firm (formerly FIX 4.2 ClearingFirm)	CLEARING_FIRM
5	Investor ID	INVESTOR_ID
6	Introducing Firm	INTRODUCING_FIRM
7	Entering Firm	ENTERING_FIRM
8	Locate/Lending Firm (for short-sales)	LOCATE_LENDING_FIRM
9	Fund manager Client ID (for CIV)	FUND_MANAGER_CLIENT_ID
10	Settlement Location (formerly FIX 4.2 SettlLocation)	SETTLEMENT_LOCATION
11	Order Origination Trader (associated with Order Origination Firm – e.g. trader who initiates/submits the order)	ORDER_ORIGINATION_TRADER
12	Executing Trader (associated with Executing Firm - actually executes)	EXECUTING_TRADER
13	Order Origination Firm (e.g. buyside firm)	ORDER_ORIGINATION_FIRM
14	Giveup Clearing Firm (firm to which trade is given up)	GIVEUP_CLEARING_FIRM
15	Correspondant Clearing Firm	CORRESPONDANT_CLEARING_FIRM
16	Executing System	EXECUTING_SYSTEM
17	Contra Firm	CONTRA_FIRM
18	Contra Clearing Firm	CONTRA_CLEARING_FIRM
19	Sponsoring Firm	SPONSORING_FIRM
20	Underlying Contra Firm	UNDERLYING_CONTRA_FIRM
21	Clearing Organization	CLEARING_ORGANIZATION
22	Exchange	EXCHANGE
24	Customer Account	CUSTOMER_ACCOUNT
25	Correspondent Clearing Organization	CORRESPONDENT_CLEARING_ORGANIZATION
26	Correspondent Broker	CORRESPONDENT_BROKER
27	Buyer/Seller (Receiver/Deliverer)	BUYER_SELLER
28	Custodian	CUSTODIAN
29	Intermediary	INTERMEDIARY
30	Agent	AGENT
31	Sub custodian	SUB_CUSTODIAN
32	Beneficiary	BENEFICIARY
33	Interested party	INTERESTED_PARTY
34	Regulatory body	REGULATORY_BODY
35	Liquidity provider	LIQUIDITY_PROVIDER
36	Entering Trader	ENTERING_TRADER
37	Contra Trader	CONTRA_TRADER
38	Position Account	POSITION_ACCOUNT

Where tag 452 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.

Message	MsgType	Requiredness	Where in the message
AllocationInstruction	J	Conditional	inside the Parties component
AllocationInstructionAck	P	Conditional	inside the Parties component
AllocationReport	AS	Conditional	inside the Parties component
AllocationReportAck	AT	Conditional	inside the Parties component
AssignmentReport	AW	Conditional	inside the Parties component
CollateralAssignment	AY	Conditional	inside the Parties component
CollateralInquiry	BB	Conditional	inside the Parties component
CollateralInquiryAck	BG	Conditional	inside the Parties component
CollateralReport	BA	Conditional	inside the Parties component
CollateralRequest	AX	Conditional	inside the Parties component
CollateralResponse	AZ	Conditional	inside the Parties component
Confirmation	AK	Conditional	inside the Parties component
CrossOrderCancelReplaceRequest	t	Conditional	inside SideCrossOrdModGrp › Parties
CrossOrderCancelRequest	u	Conditional	inside SideCrossOrdCxlGrp › Parties
ExecutionReport	8	Conditional	inside the Parties component
MassQuote	i	Conditional	inside the Parties component
MassQuoteAcknowledgement	b	Conditional	inside the Parties component
MultilegOrderCancelReplace	AC	Conditional	inside the Parties component
NewOrderCross	s	Conditional	inside SideCrossOrdModGrp › Parties
NewOrderList	E	Conditional	inside ListOrdGrp › Parties
NewOrderMultileg	AB	Conditional	inside the Parties component
NewOrderSingle	D	Conditional	inside the Parties component
OrderCancelReplaceRequest	G	Conditional	inside the Parties component
OrderCancelRequest	F	Conditional	inside the Parties component
OrderMassStatusRequest	AF	Conditional	inside the Parties component
OrderStatusRequest	H	Conditional	inside the Parties component
PositionMaintenanceReport	AM	Conditional	inside the Parties component
PositionMaintenanceRequest	AL	Conditional	inside the Parties component
PositionReport	AP	Conditional	inside the Parties component
Quote	S	Conditional	inside the Parties component
QuoteCancel	Z	Conditional	inside the Parties component
QuoteRequest	R	Conditional	inside QuotReqGrp › Parties
QuoteRequestReject	AG	Conditional	inside QuotReqRjctGrp › Parties
QuoteResponse	AJ	Conditional	inside the Parties component
QuoteStatusReport	AI	Conditional	inside the Parties component
QuoteStatusRequest	a	Conditional	inside the Parties component
RegistrationInstructions	o	Conditional	inside the Parties component
RegistrationInstructionsResponse	p	Conditional	inside the Parties component
RequestForPositions	AN	Conditional	inside the Parties component
RequestForPositionsAck	AO	Conditional	inside the Parties component
SettlementInstructionRequest	AV	Conditional	inside the Parties component
SettlementInstructions	T	Conditional	inside SettlInstGrp › Parties
TradeCaptureReport	AE	Conditional	inside TrdCapRptSideGrp › Parties
TradeCaptureReportRequest	AD	Conditional	inside the Parties component

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 452 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);const partyRole = message.fields[452]?.raw;// e.g. "1" — Executing Firm (formerly FIX 4.2 ExecBroker)// The dictionary also carries the labels:const label = fix.dictionary  .fieldByTag(452)  ?.enumValues?.find((e) => e.value === partyRole)  ?.description;

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

Try the decoder Source on GitHub