QuoteStatus (FIX tag 297)

intFIX 4.4FIX 4.2FIX 5.0 SP2

QuoteStatus (tag 297) is an int field defined in FIX 4.4, FIX 4.2 and FIX 5.0 SP2. 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, FIX 4.2 and FIX 5.0 SP2
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.

FIX 5.0 SP2

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, FIX 5.0 SP2
1Canceled for Symbol(s)CANCELED_FOR_SYMBOL / CancelForSymbol / CANCEL_FOR_SYMBOLFIX 4.4, FIX 4.2, FIX 5.0 SP2
2Canceled for Security Type(s)CANCELED_FOR_SECURITY_TYPE / CanceledForSecurityTypeFIX 4.4, FIX 4.2, FIX 5.0 SP2
3Canceled for UnderlyingCANCELED_FOR_UNDERLYING / CanceledForUnderlyingFIX 4.4, FIX 4.2, FIX 5.0 SP2
4Canceled AllCANCELED_ALL / CanceledAllFIX 4.4, FIX 4.2, FIX 5.0 SP2
5RejectedREJECTED / RejectedFIX 4.4, FIX 4.2, FIX 5.0 SP2
6Removed from MarketREMOVED_FROM_MARKETFIX 4.4, FIX 5.0 SP2
7ExpiredEXPIREDFIX 4.4, FIX 5.0 SP2
8QueryQUERYFIX 4.4, FIX 5.0 SP2
9Quote Not FoundQUOTE_NOT_FOUNDFIX 4.4, FIX 5.0 SP2
10PendingPENDINGFIX 4.4, FIX 5.0 SP2
11PassPASSFIX 4.4, FIX 5.0 SP2
12Locked Market WarningLOCKED_MARKET_WARNINGFIX 4.4, FIX 5.0 SP2
13Cross Market WarningCROSS_MARKET_WARNINGFIX 4.4, FIX 5.0 SP2
14Canceled due to lock marketCANCELED_DUE_TO_LOCK_MARKETFIX 4.4, FIX 5.0 SP2
15Canceled due to cross marketCANCELED_DUE_TO_CROSS_MARKETFIX 4.4, FIX 5.0 SP2
16ActiveACTIVEFIX 5.0 SP2
17CanceledCANCELEDFIX 5.0 SP2
18Unsolicited quote replenishmentUNSOLICITED_QUOTE_REPLENISHMENTFIX 5.0 SP2
19Pending end tradePENDING_END_TRADEFIX 5.0 SP2
20Too late to endTOO_LATE_TO_ENDFIX 5.0 SP2

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.2FIX 5.0 SP2Where in the message
MassQuoteAcknowledgementbRequiredRequiredRequireddirectly on the message body
QuoteStatusReportAIOptionalOptionaldirectly 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