QuoteStatus (FIX tag 297)

intFIX 4.4FIX 4.2

QuoteStatus (tag 297) is an int field defined in FIX 4.4 and FIX 4.2. It appears in 2 message types and is required in 1 of them. It is an enumerated field with 16 defined values. FIX 4.2 calls this field QuoteAckStatus; the tag number is unchanged, so the two are the same field on the wire.

Also known as QuoteAckStatus
FIX 4.2 calls tag 297 QuoteAckStatus. It is the same field on the wire — only the name changed — so a message encoded by either side interoperates.

At a glance

Tag
297
Name
QuoteStatus
Datatype
int
Dialects
FIX 4.4 and FIX 4.2
Messages
2
Valid values
16

What the specification says

FIX 4.4

Identifies the status of the quote acknowledgement

FIX 4.2

Identifies the status of the quote acknowledgement.

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

A real message using tag 297

MassQuoteAcknowledgement · FIX 4.4
TagFieldWire valueMeaning
8BeginStringFIX.4.4
9BodyLength69
35MsgTypebMass Quote Acknowledgement
49SenderCompIDBOARTEAM
56TargetCompIDCOUNTERPARTY
34MsgSeqNum2
52SendingTime20240101-12:00:00.000
297QuoteStatus0Accepted
10CheckSum246
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
0AcceptedACCEPTED / AcceptedFIX 4.4, FIX 4.2
1Canceled for Symbol(s)CANCELED_FOR_SYMBOL / CancelForSymbolFIX 4.4, FIX 4.2
2Canceled for Security Type(s)CANCELED_FOR_SECURITY_TYPE / CanceledForSecurityTypeFIX 4.4, FIX 4.2
3Canceled for UnderlyingCANCELED_FOR_UNDERLYING / CanceledForUnderlyingFIX 4.4, FIX 4.2
4Canceled AllCANCELED_ALL / CanceledAllFIX 4.4, FIX 4.2
5RejectedREJECTED / RejectedFIX 4.4, FIX 4.2
6Removed from MarketREMOVED_FROM_MARKETFIX 4.4
7ExpiredEXPIREDFIX 4.4
8QueryQUERYFIX 4.4
9Quote Not FoundQUOTE_NOT_FOUNDFIX 4.4
10PendingPENDINGFIX 4.4
11PassPASSFIX 4.4
12Locked Market WarningLOCKED_MARKET_WARNINGFIX 4.4
13Cross Market WarningCROSS_MARKET_WARNINGFIX 4.4
14Canceled due to lock marketCANCELED_DUE_TO_LOCK_MARKETFIX 4.4
15Canceled due to cross marketCANCELED_DUE_TO_CROSS_MARKETFIX 4.4

Where tag 297 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
MassQuoteAcknowledgementbRequiredRequireddirectly on the message body
QuoteStatusReportAIOptionaldirectly on the message body

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 297 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 quoteStatus = message.fields[297]?.raw;// e.g. "0" — Accepted// The dictionary also carries the labels:const label = fix.dictionary  .fieldByTag(297)  ?.enumValues?.find((e) => e.value === quoteStatus)  ?.description;

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