DKReason (FIX tag 127)

charFIX 4.4FIX 4.2

DKReason (tag 127) is a char field defined in FIX 4.4 and FIX 4.2. It appears in 1 message type and is required in 1 of them. It is an enumerated field with 7 defined values.

At a glance

Tag
127
Name
DKReason
Datatype
char
Dialects
FIX 4.4 and FIX 4.2
Messages
1
Valid values
7

What the specification says

FIX 4.4

Reason for execution rejection

FIX 4.2

Reason for execution rejection.

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

A real message using tag 127

DontKnowTrade · FIX 4.4
TagFieldWire valueMeaning
8BeginStringFIX.4.4
9BodyLength101
35MsgTypeQDon’t Know Trade (DK)
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
37OrderIDORD-10042
17ExecIDEXEC-88117
127DKReasonAUnknown symbol
54Side1Buy
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 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.

ValueMeaningSymbolic nameDialects
AUnknown symbolUNKNOWN_SYMBOL / UnknownSymbolFIX 4.4, FIX 4.2
BWrong sideWRONG_SIDE / WrongSideFIX 4.4, FIX 4.2
CQuantity exceeds orderQUANTITY_EXCEEDS_ORDER / QuantityExceedsOrderFIX 4.4, FIX 4.2
DNo matching orderNO_MATCHING_ORDER / NoMatchingOrderFIX 4.4, FIX 4.2
EPrice exceeds limitPRICE_EXCEEDS_LIMIT / PriceExceedsLimitFIX 4.4, FIX 4.2
FCalculation differenceCALCULATION_DIFFERENCEFIX 4.4
ZOtherOTHER / OtherFIX 4.4, FIX 4.2

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

MessageMsgTypeFIX 4.4FIX 4.2Where in the message
DontKnowTradeQRequiredRequireddirectly on the message body

Wire format

A single character. Most char fields are enumerated, so the value is one of a fixed set rather than arbitrary text. @boarteam/fix keeps the value as a string and, for enumerated fields, reports validate/value-not-in-enum when it is not a defined value.

Read tag 127 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 dKReason = message.fields[127]?.raw;// e.g. "A" — Unknown symbol// The dictionary also carries the labels:const label = fix.dictionary  .fieldByTag(127)  ?.enumValues?.find((e) => e.value === dKReason)  ?.description;

Other char 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-fix44