FIX.Latest_EP296 Datatypes


Type NameBase TypeDescriptionPedigree
intSequence of digits without commas or decimals and optional sign character (ASCII characters - and 0 - 9 ). The sign character utilizes one byte (i.e. positive int is 99999 while negative int is -99999). Note that int values may contain leading zeros (e.g. 00023 = 23).Added FIX.2.7 Updated EP271
Lengthintint field representing the length in bytes. Value must be positive.Added FIX.4.3
TagNumintint field representing a field's tag number when using FIX Tag=Value syntax. Value must be positive and may not contain leading zeros.Added FIX.4.3 Updated EP271
SeqNumintint field representing a message sequence number. Value must be positive.Added FIX.4.3
NumInGroupintint field representing the number of entries in a repeating group. Value must be positive.Added FIX.4.3
DayOfMonthintint field representing a day during a particular month (values 1 to 31).Added FIX.4.1 Updated EP271
floatSequence of digits with optional decimal point and sign character (ASCII characters -, 0 - 9 and .); the absence of the decimal point within the string will be interpreted as the float representation of an integer value. All float fields must accommodate up to fifteen significant digits. The number of decimal places used should be a factor of business/market needs and mutual agreement between counterparties. Note that float values may contain leading zeros (e.g. 00023.23 = 23.23) and may contain or omit trailing zeros after the decimal point (e.g. 23.0 = 23.0000 = 23 = 23.). Note that fields which are derived from float may contain negative values unless explicitly specified otherwise.Added FIX.2.7 Updated EP206
Qtyfloatfloat field capable of storing either a whole number (no decimal places) of shares (securities denominated in whole units) or a decimal value containing decimal places for non-share quantity asset classes (securities denominated in fractional units).Added FIX.4.2
Pricefloatfloat field representing a price. Note the number of decimal places may vary. For certain asset classes prices may be negative values. For example, prices for options strategies can be negative under certain market conditions. Refer to Volume 7: FIX Usage by Product for asset classes that support negative price values.Added FIX.4.2
PriceOffsetfloatfloat field representing a price offset, which can be mathematically added to a Price. Note the number of decimal places may vary and some fields such as LastForwardPoints may be negative.Added FIX.4.2
Amtfloatfloat field typically representing a Price times a QtyAdded FIX.4.2
Percentagefloatfloat field representing a percentage (e.g. 0.05 represents 5% and 0.9525 represents 95.25%). Note the number of decimal places may vary.Added FIX.4.3
charSingle character value, can include any alphanumeric character or punctuation except the delimiter. All char fields are case sensitive (i.e. m != M).Added FIX.2.7 Updated EP206
Booleancharchar field containing one of two values:
'Y' = True/Yes
'N' = False/No
Added FIX.4.2
StringAlpha-numeric free format strings, can include any character or punctuation except the delimiter. All String fields are case sensitive (i.e. morstatt != Morstatt).Added FIX.4.2
MultipleCharValueStringstring field containing one or more space delimited single character values (e.g. |18=2 A F| ).Added FIX.4.4
MultipleStringValueStringstring field containing one or more space delimited multiple character values (e.g. |277=AV AN A| ).Added FIX.4.2
CountryStringstring field representing a country using ISO 3166 Country code (2 character) values (see Appendix 6-B).Added FIX.4.4
CurrencyStringstring field representing a currency type using ISO 4217 Currency code (3 character) values (see Appendix 6-A).Added FIX.4.2
ExchangeStringstring field representing a market or exchange using ISO 10383 Market Identifier Code (MIC) values (seeAppendix 6-C).Added FIX.4.2
MonthYearStringstring field representing month of a year. An optional day of the month can be appended or an optional week code.
Valid formats:
YYYYMM
YYYYMMDD
YYYYMMWW
Valid values:
YYYY = 0000-9999; MM = 01-12; DD = 01-31; WW = w1, w2, w3, w4, w5.
Added FIX.4.1
UTCTimestampStringstring field representing time/date combination represented in UTC (Universal Time Coordinated, also known as GMT) in either YYYYMMDD-HH:MM:SS (whole seconds) or YYYYMMDD-HH:MM:SS.sss* format, colons, dash, and period required.
Valid values:
YYYY = 0000-9999, MM = 01-12, DD = 01-31, HH = 00-23, MM = 00-59, SS = 00-60 (60 only if UTC leap second), sss* fractions of seconds.
The fractions of seconds may be empty when no fractions of seconds are conveyed (in such a case the period is not conveyed), it may include 3 digits to convey milliseconds, 6 digits to convey microseconds, 9 digits to convey nanoseconds, 12 digits to convey picoseconds; Other number of digits may be used with bilateral agreement.
Leap Seconds: Note that UTC includes corrections for leap seconds, which are inserted to account for slowing of the rotation of the earth. Leap second insertion is declared by the International Earth Rotation Service (IERS) and has, since 1972, only occurred on the night of Dec. 31 or Jun 30. The IERS considers March 31 and September 30 as secondary dates for leap second insertion, but has never utilized these dates. During a leap second insertion, a UTCTimestamp field may read 19981231-23:59:59, 19981231-23:59:60, 19990101-00:00:00. (see http://tycho.usno.navy.mil/leapsec.html)
Added FIX.4.2 Updated EP256
UTCTimeOnlyStringstring field representing time-only represented in UTC (Universal Time Coordinated, also known as GMT) in either HH:MM:SS (whole seconds) or HH:MM:SS.sss* (milliseconds) format, colons, and period required. This special-purpose field is paired with UTCDateOnly to form a proper UTCTimestamp for bandwidth-sensitive messages.
Valid values:
HH = 00-23, MM = 00-59, SS = 00-60 (60 only if UTC leap second), sss* fractions of seconds. The fractions of seconds may be empty when no fractions of seconds are conveyed (in such a case the period is not conveyed), it may include 3 digits to convey milliseconds, 6 digits to convey microseconds, 9 digits to convey nanoseconds, 12 digits to convey picoseconds; Other number of digits may be used with bilateral agreement.
Added FIX.4.2 Updated EP206
UTCDateOnlyStringstring field representing Date represented in UTC (Universal Time Coordinated, also known as GMT) in YYYYMMDD format. This special-purpose field is paired with UTCTimeOnly to form a proper UTCTimestamp for bandwidth-sensitive messages.
Valid values:
YYYY = 0000-9999, MM = 01-12, DD = 01-31.
Added FIX.4.4 Updated EP271
LocalMktDateStringstring field representing a Date of Local Market (as opposed to UTC) in YYYYMMDD format. This is the normal date field used by the FIX Protocol.
Valid values:
YYYY = 0000-9999, MM = 01-12, DD = 01-31
Added FIX.4.2 Updated EP206
TZTimeOnlyStringstring field representing the time represented based on ISO 8601. This is the time with a UTC offset to allow identification of local time and timezone of that time.
Format is HH:MM[:SS][Z | [ + | - hh[:mm]]] where HH = 00-23 hours, MM = 00-59 minutes, SS = 00-59 seconds, hh = 01-12 offset hours, mm = 00-59 offset minutes.
Added EP-1 Updated EP206
TZTimestampStringstring field representing a time/date combination representing local time with an offset to UTC to allow identification of local time and timezone offset of that time. The representation is based on ISO 8601.
Format is YYYYMMDD-HH:MM:SS.sss*[Z | [ + | - hh[:mm]]] where YYYY = 0000 to 9999, MM = 01-12, DD = 01-31 HH = 00-23 hours, MM = 00-59 minutes, SS = 00-59 seconds, hh = 01-12 offset hours, mm = 00-59 offset minutes, sss* fractions of seconds. The fractions of seconds may be empty when no fractions of seconds are conveyed (in such a case the period is not conveyed), it may include 3 digits to convey milliseconds, 6 digits to convey microseconds, 9 digits to convey nanoseconds, 12 digits to convey picoseconds; Other number of digits may be used with bilateral agreement
Added EP-1 Updated EP206
datastring field containing opaque or non-ASCII data with no format or content restrictions. Data fields are always immediately preceded by a length field. The length field should specify the number of bytes of the value of the data field (up to but not including the terminating SOH). The number of bytes does not equal the number of characters when multibyte character sets are used.
Caution: The value of these fields may contain the delimiter (SOH) character. Note that the value specified for these fields must be followed by the delimiter (SOH) character as all tag-value fields are terminated with an SOH.
Added FIX.2.7 Updated EP294
PatternUsed to build on and provide some restrictions on what is allowed as valid values in fields that uses a base FIX data type and a pattern data type. The universe of allowable valid values for the field would then be the union of the base set of valid values and what is defined by the pattern data type. The pattern data type used by the field will retain its base FIX data type (e.g. String, int, char).Added EP-1
TenorPatternused to allow the expression of FX standard tenors in addition to the base valid enumerations defined for the field that uses this pattern data type. This pattern data type is defined as follows:
Dx = tenor expression for days, e.g. D5, where x is any integer > 0
Mx = tenor expression for months, e.g. M3, where x is any integer > 0
Wx = tenor expression for weeks, e.g. W13, where x is any integer > 0
Yx = tenor expression for years, e.g. Y1, where x is any integer > 0
Added EP-1
Reserved100PlusPatternValues 100 and above are reserved for bilaterally agreed upon user defined enumerations.Added EP-1
Reserved1000PlusPatternValues 1000 and above are reserved for bilaterally agreed upon user defined enumerations.Added EP-1
Reserved4000PlusPatternValues 4000 and above are reserved for bilaterally agreed upon user defined enumerations.Added EP-1
XMLDataStringContains an XML document raw data with no format or content restrictions. XMLData fields are always immediately preceded by a length field. The length field should specify the number of bytes of the value of the data field (up to but not including the terminating SOH).Added EP-1
LanguageStringIdentifier for a national language - uses ISO 639-1 standardAdded EP90
LocalMktTimeStringstring field representing the time local to a particular market center. Used where offset to UTC varies throughout the year and the defining market center is identified in a corresponding field.
Format is HH:MM:SS where HH = 00-23 hours, MM = 00-59 minutes, SS = 00-59 seconds. In general only the hour token is non-zero.
Added EP161
XIDStringThe purpose of the XID datatype is to define a unique identifier that is global to a FIX message. An identifier defined using this datatype uniquely identifies its containing element, whatever its type and name is. The constraint added by this datatype is that the values of all the fields that have an XID datatype in a FIX message must be unique.Added EP161 Updated EP282
XIDREFStringThe XIDREF datatype defines a reference to an identifier defined by the XID datatype.Added EP161