Log in

UnderlyingInstrument

The UnderlyingInstrument component block, like the Instrument component block, contains all the fields commonly used to describe a security or instrument. In the case of the UnderlyingInstrument component block it describes an instrument which underlies the primary instrument Refer to the Instrument component block comments as this component block mirrors Instrument, except for the noted fields.

TagNameTypeRequiredDescription
311StringCommon, "human understood" representation of the security. SecurityID value can be specified if no symbol exists (e.g. non-exchange traded Collective Investment Vehicles)
312String Enum
309String
305String Enum
Component
2874StringUsed for unique identification of the underlying instance that can subsequently be used to serve as input value for fields such as UnderlyingRefID(2841), for example, whenever a simple underlying reference is allowed or needed
462Int Enum
ComponentEmbedded XML document describing the underlying instrument
463String
2894String
310String Enum
763String
313MonthYear
542LocalMktDate
1213TZTimeOnly
2984String EnumConditionally required when UnderlyingMaturityFrequencyPeriod(2985) is specified
2985IntConditionally required when UnderlyingMaturityFrequencyUnit(2984) is specified and the value is not EOM (End of Month) or F (Flexible)
1837MonthYear
241LocalMktDate
1453String Enum
1454String Enum
2614Amount
2615Currency
2921String Enum
2616String
2617Int Enum
2619XIDREF
1455Percentage
1456Percentage
1459Percentage
1460Percentage
242LocalMktDate
243String
244Int
245Percentage
246Float
256String
595String
592Country
593String
594String
247LocalMktDate
316Price
941Currency
2917String Enum
317Char
436Float
1437Int Enum
2363Int
1441Int Enum
998String Enum
1423Quantity
1718Currency
2918String Enum
1424String Enum
1425Quantity
1719Currency
2919String Enum
1000String EnumUsed to indicate a time unit for the contract (e.g., days, weeks, months, etc.)
1419Int Enum
1526Currency
2920String Enum
435Percentage
308Exchange
306String
362LengthMust be set if UnderlyingEncodedIssuer(363) field is specified and must immediately precede it
363DataEncoded (non-ASCII characters) representation of the UnderlyingIssuer(363) field in the encoded format specified via the MessageEncoding(347) field
2742String
2720String
2721LengthMust be set if EncodedUnderlyingFinancialInstrumentFullName(2722) field is specified and must immediately precede it
2722DataEncoded (non-ASCII characters) representation of the UnderlyingFinancialInstrumentFullName(2720) field in the encoded format specified via the MessageEncoding(347) field
2723String EnumRequires UnderlyingSecurityID(305) to identify the index. Requires UnderlyingIndexCurvePeriod(2724)
2724IntRequires UnderlyingSecurityID(305) to identify the index. Requires UnderlyingIndexCurveUnit(2723)
307String
364LengthMust be set if UnderlyingEncodedSecurityDesc(307) field is specified and must immediately precede it
365DataEncoded (non-ASCII characters) representation of the UnderlyingSecurityDesc(307) field in the encoded format specified via the MessageEncoding(347) field
877Int Enum
878String
972PercentageSpecific to the < UnderlyingInstrument > Percent of the Strike Price that this underlying represents. Necessary for derivatives that deliver into more than one underlying instrument
318CurrencySpecific to the (not in )
2916String Enum
879QuantitySpecific to the (not in )
975Int EnumSpecific to the < UnderlyingInstrument > Indicates order settlement period for the underlying deliverable component
973AmountSpecific to the < UnderlyingInstrument > Cash amount associated with the underlying component. Necessary for derivatives that deliver into more than one underlying instrument and one of the underlying's is a fixed cash value
974String EnumSpecific to the < UnderlyingInstrument > Used for derivatives that deliver into cash underlying. Indicates that the cash is either fixed or difference value (difference between strike and current underlying price)
810PriceSpecific to the (not in )
882PriceSpecific to the (not in )
883PriceSpecific to the (not in )
884AmountSpecific to the (not in )
885AmountSpecific to the (not in )
886AmountSpecific to the (not in )
2885Amount
2886Int
ComponentSpecific to the (not in )
1044QuantitySpecific to the (not in ). For listed derivatives margin management, this is the number of shares adjusted for upcoming corporate action. Used only for securities which are optionable and are between ex-date and settlement date (4 days)
1045FloatSpecific to the (not in ). Foreign exchange rate used to compute UnderlyingCurrentValue (885) (or market value) from UnderlyingCurrency (318) to Currency (15)
1046Char EnumSpecific to the (not in ). Specified whether UnderlyingFxRate (1045) should be multiplied or divided to derive UnderlyingCurrentValue (885)
1038Amount
Component
1039String Enum
315Int EnumUsed to express option right
2683Int EnumUsed to express in-the-moneyness behavior in general terms for the option without the use of UnderlyingStrikePrice(316) and UnderlyingPutOrCall(315)
2687Boolean
1988Float
1989Int Enum
1990Amount
1991IntConditionally required when UnderlyingCouponFrequencyUnit(1992) is specified
1992String EnumConditionally required when UnderlyingCouponFrequencyPeriod(1991) is specified
1993Int Enum
2881String
1994String
1995String EnumConditionally required when UnderlyingObligationID(1994) is specified
1996String
1997String EnumConditionally required when UnderlyingEquityID(1996) is specified
2620String
2621String EnumRequired if UnderlyingFutureID(2620) is specified
Component
1998Int Enum
1999Int Enum
2000Int Enum
2003Int
2004Int
2005LocalMktDate
2006String
2284String
2285String
2286String
2287LengthMust be set if EncodedUnderlyingOptionExpirationDesc(2288) field is specified and must immediately precede it
2288DataEncoded (non-ASCII characters) representation of the UnderlyingOptionExpirationDesc(2286) field in the encoded format specified via the MessageEncoding(347) field
2007String
2008String
2009String
2010Char Enum
2011String Enum
2012String Enum
2491Int Enum
2013Int EnumRequired if UnderlyingAssetSubClass(2014) is specified
2014Int EnumRequired if UnderlyingAssetType(2015) is specified
2015StringRequired if UnderlyingAssetSubType(2744) is specified
2744String
Component
Component
2016String Enum
2289String Enum
2017IntConditionally required when UnderlyingMthToDefault(2018) is specified
2018Int
2019String
2020LocalMktDate
2021Float
2022Float
2290String Enum
2622String
2291String
2623Int Enum
2292PriceOffset
2023Int Enum
2024Int EnumWhen specified, UnderlyingPutOrCall(315), UnderlyingStrikePrice(316), and UnderlyingStrikePriceBoundaryPrecision(2025) must also be specified
2025Percentage
2026Float
2027Amount
2028Int Enum
2029AmountConditionally required if UnderlyingOptPayoutType(2028) = 3 (Binary)
2757Int Enum
2030String Enum
2031String Enum
2293String
2294String
2032Int Enum
2033Price
2034Price
2035Boolean
2036Boolean
2037Int
2038Int
2039String
2040MonthYear
2041LocalMktDate
2042LocalMktDate
2043Int Enum
2044Int
41314XIDREF
41315XIDREF
Component
2295String Enum
2296Boolean
2297Int Enum
2756String
2298Char Enum
2299Int
Component
Component
Component
Component
Component
Component
Component
Component
Component
Component
Component
Component
Component
2624Int Enum
2625Boolean
2626Amount
2627Int
2628Boolean
2629Quantity
2630Float
2631XID