Instrument Attribute Specifications

The following information will be returned in JSON format, based on the customer's queries. The collection is returned in an embedded object with an array for each instrument. 

RBT instruments are not listed or tradable on CME Globex, however RBT instruments can have globexSecurityid assigned for internal purposes only. Clients should reply on product level attributes not the globexSecurityid to determine if the instrument is Globex Eligible for trading.

Attributes Without Tick Information

If an instrument does not have tick values, reference the tick values at the product level. Tick values may return in the numeric or exponential notation.

BrokerTec Allowable Order Quantities

For BrokerTec US and EU Repo orders where the allowable order quantities change at mid-session, 10:00 am eastern time, customers should use the following attributes:

  • minGlobexOrdQty
  • maxGlobexOrdQty
  • minIncrementalOrder
  • minIntraGlobexOrdQty 
  • minIntraGlobexOrdQty 
  • maxIntraGlobexOrdQty
API LabelDescriptionFound in Web Calendar Specifications?Web Attribute NameTypeExchange

leadMonthInd

Boolean flag to identify whether a contract is the lead month.

  • "Y"
  • "N"

N

N

String

F&O

airDaysToMaturity  

The physical days to maturity. The number of calendar days to maturity for physical settlement counting from the current settle value date to the value date for maturity.

N


Number

F&O
bilAccRejTimer

Bilateral accept reject timer - number of seconds.

Post trade attibute only available via CME Reference Data API version 3.

N
IntegerBrokerTec
clrAliasCLR Alias: The instrument symbol used in CME Clearing for clearing reports like the Trade Register.N
StringF&O
cfiCode

CFI Codes in RD API match those used in clearing systems but will not necessarily match those used on Globex.

N
StringALL
couponDayCount

The convention used for accruing interest. Values include:

  • ACTACT = ACT/ACT (ICMA)
  • ACTAFB = ACT/ACT (AFB)
  • ACT365 = ACT/365 (FIXED)
  • ACT360 = ACT/360
  • US30360 = 30/360 (SIA)
  • EU30360 = 30E/360 (EUROBOND BASIS)
N
StringBrokerTec
couponFreqPeriodNumber of periods in a year. Data example is for a Semiannual coupon frequency unit.N
IntegerBrokerTec
couponFreqUnitHow often are there are coupon payments.N
StringBrokerTec
couponRateThe fixed rate at which a bond or loan pays out on a periodic basis (rate of interest * principal).N
IntegerALL
couponTypeDescribes the type of interest payment such a discount, fixed, float, and variable.N
StringBrokerTec
cusipUS & Canadian externally registered security identifier.N
StringBrokerTec
datedDate

The date at which interest begins to accrue.

This will be the same as the issue date except when the issue date falls on a weekend or holiday.

N

Date

Format:
"YYYY-MM-DD"
BrokerTec

daysToMaturity

The number of calendar days between current exchange business day and the contract's final settlement date.

N


Number

F&O
debtSecurityMaturityThe date the debt security matures.N

Date

Format:
"YYYY-MM-DD"
BrokerTec
endDateDate a repo endsN
DateBrokerTec
exchangeClearing

Query for all products by Exchange identifier used in the Post Trade Application.

Valid Values

  • BTUS = BrokerTec US
  • BTEU = BrokerTec Europe
  • CBT = Chicago Board of Trade
  • CME = Chicago Mercantile Exchange 
  • COMEX = COMEX (Commodities Exchange Center) 
  • DME = Dubai Mercantile Exchange 
  • FEX=FEX Global
  • FXS= Indicates the Exchange for the FX Spot side of a FX Link trade.
  • MGE= Minneapolis Grain Exchange
  • NYMEX = New York Mercantile Exchange
N
StringALL
exchangeGlobex

Query for all products by the Market Identifier Code (MIC) as defined by the ISO.

For inter-exchange spreads, this field contains the hybrid value displayed in the Market Data Platform Security Definition (tag 35=d) message tag 207-SecurityExchange.

Valid Values

  • BTAM = BrokerTec Amsterdam
  • BTEC = BrokerTec US
  • BTEE = BrokerTec Europe
  • DUMX = Dubai Mercantile Exchange 
  • EBSC=EBS Market for FX Spot/Spot Precious Metals (including eFix Matching)
  • GLBX = Indicates the Exchange for the FX Spot side of a FX Link trade.
  • MGCB = XMGE-XCBT inter-exchange spread
  • NEXS = EBS Market for ON SEF/ON-MTF NDFs
  • NYUM = XNYM-DUMX inter-exchange spread 
  • XCBT = Chicago Board of Trade 
  • XCME = Chicago Mercantile Exchange 
  • XCEC = COMEX (Commodities Exchange Center)
  • XEBS = EBS Market for OFF SEF/ON-MTF NDFs
  • XFXS = CME FX Link spread 
  • XKLS = Bursa Malaysia 
  • XMGE = Minneapolis Grain Exchange 
  • XNYM = New York Mercantile Exchange
N
StringALL

exchBusinessDate

Exchange business date.

  • For polls before 4:00 PM CT current exchange business date.
  • For polls after 4:00 PM CT this is the exchange next business date.

N


Date

F&O
finalSettlementDate

Final settlement date:

Final settlement date for futures

YSettlement

Date

Format:
"YYYY-MM-DD"
F&O
firstDeliveryDate

First delivery date. The first date that users will complete delivery.

Not applicable to financially settled instruments.

YFirst Delivery

Date

Format:
"YYYY-MM-DD"
F&O
firstNoticeDate

First notice date. The first date that users will get notified that they have been assigned a delivery.

Not applicable to financially settled instruments.

YFirst Notice

Date

Format:
"YYYY-MM-DD"
F&O
firstIntDateFirst position date. 

The first date on which CME Clearing will accept intents and run assignments for deliverable contracts.

Not applicable to financially settled instruments.

YFirst Position

Date

Format:
"YYYY-MM-DD"
F&O

firstTradeDate

Clearing first trade date (actual contract trade date)YFirst Trade

Date

Format:
"YYYY-MM-DD"
ALL
fisnFinancial instrument short name. Used for MiFid reporting.N
StringBrokerTec
flexIndicator

Y/N flag that indicates if instrument is Flex-defined.

N
StringF&O

fnlInvDate

Final inventory date

N

Date

Format:
"YYYY-MM-DD"
F&O

gbxAlias

CME Globex alias

N
StringALL
globexLastTradeDate

Last date instrument is tradable on CME Globex CLOB.

N

Date Format is in Central Time 

YYYYMMDDHHMMSS

ALL
gcBasketIndentifierUnderlying cusip or isin for repo special

StringBrokerTec

globexFirstTradeDate

The calendar date when the instrument becomes tradable on CME Globex. 

  • Only sent if instrument is eligible to be listed on CME Globex
N

Date Format is in Central Time 

YYYYMMDDHHMMSS

ALL
contractMonth

For monthly, quarterly and serial instruments identifies the named month and year in format YYYYMM.

For all other instruments, identifies the month, year and date in format YYYYMMDD.

Y
StringALL
globexSecurityIdA unique identifier for each CME Globex instrument; same value as in tag 48-SecurityID on iLink and MDP.
N
StringALL
globexSymbolCME Globex instrument product symbol.N
StringALL
govBondType

Sub-category for government bonds.



String

BrokerTec

guidUnique instrument identifier in alpha-numeric format.N
StringALL
guidIntUnique instrument identifier in integer format.N
IntegerALL
initialInventoryDueDateFirst inventory date also considered the First Holding Date. The date when CME Clearing will begin accepting position dates, where applicable, for deliverable contracts.


Not applicable to financially settled instruments.

N

Date

Format:
"YYYY-MM-DD"
F&O
instrumentNameHuman-readable instrument name for display purposes.N
StringF&O
isBticProductBoolean flag to identify whether the overlying product is a BTIC product ("Y", "N").N
StringF&O

isSyntheticInstrument

Boolean flag to identify Synthetic instruments ("Y", "N").

N
StringF&O

isTamProduct

Boolean flag identifies whether the overlying product is a TAM product ("Y", "N").

N
StringF&O

isTasProduct

Boolean flag to identifies whether the overlying product is a TAS product ("Y", "N").

N
StringF&O
isinEuropean externally registered security identifier.N
StringBrokerTec
issueDateThis is the issue date (which is the first settlement date with the issuing counterparty).N

Date

Format:
"YYYY-MM-DD"
BrokerTec
issuerCountryThe country the issuer is domiciled in. The 2 character ISO code will be used.N
StringBrokerTec
issuerLeiIssuers Legal Entity IDN
StringBrokerTec
issuerLongNameThe entity issuing the debt instrument.N
StringBrokerTec
issuerSubTypeSub category for assets N
StringBrokerTec
issuerTypeThe bond type which will flag supra national debt securities. These values will be available on the collateral - thus the list includes non-tradeable instruments.N
StringBrokerTec
isUserDefined

Identifies a Tailor-Made or UDI.

UDS instruments (Under Development)

N
StringALL

itcAlias

ITC alias

N
StringALL
lastDeliveryDateLast delivery date. The last date that users will complete delivery.


Not applicable to financially settled instruments.

YLast Delivery

Date

Format:
"YYYY-MM-DD"
F&O
lastEfpDate Last EFP DateN

Date

Format:
"YYYY-MM-DD"
F&O
lastInventoryDueDateLast inventory date also considered the Last Holding Date. 

The date when CME Clearing will no longer require position dates, where applicable, for deliverable contracts.

Not applicable to financially settled instruments.

N

Date

Format:
"YYYY-MM-DD"
F&O

lastIntDate

Last intent date

N

Date

Format:
"YYYY-MM-DD"
ALL
lastNoticeDate

Last notice date. The last date that users will get notified that they have been assigned a delivery.

Not applicable to financially settled instruments.

YLast Notice

Date

Format:
"YYYY-MM-DD"
F&O
lastTradeDateLast date instrument is tradable across all venues and trade typesYLast Trade

Date

Format:
"YYYY-MM-DD"
ALL
lastUpdated

Timestamp from last time the instrument definition / product was updated:

  • first listed
  • modified

 

N

Date and Timezone (CST)

Format: "YYYY-MM-DDThh:ss

All

longName

BrokerTec - Used to list the instrument for trading in the US. In EU, this plus the term code is used for the listing.

EBS - Used to identify individual NDFs because it is possible to have the same NDF listed with two different tenors.

N
String

BrokerTec

EBS

nonConsecutiveMonthSpreadTick

Used for instruments where there are both monthly and quarterly contracts (often used with FX spreads), and the quarterly product has monthly products in between. There will be 2 different spread ticks, one for consecutive-month spreads and one for non-consecutive month spreads.

Only applicable to ClearPort contracts.

N
DoubleF&O
originalContractSize

Sent for Decay-eligible instruments.

Indicates the contract size before decay begins.

N
StringF&O
positionRemovalDatePosition removal date.N

Date

Format:
"YYYY-MM-DD"
ALL
priceBand

Differential value for price bands on CME Globex.

N
StringF&O
priceBandDl
Decimal locator for price band (priceBand).N
StringF&O
productGuidIntUnique product identifier in integer-only format.N
IntegerALL
putCallIndicator

Indicates whether an option instrument is a put or call.

0 - Put
1 - Call

N
StringF&O

pxUomCcy

Price unit of measure currency

N
StringUnder development
repoTermCodeThe overnight or term code used for determining the repo start date relative to the trade date, and end date if a fixed term (e.g. 1W, !M)N
StringBrokerTec
settleDaysHow many days after a trade the debt security settles.N
IntegerBrokerTec
settlementTickUsed when instruments settle in a smaller tick than they are traded at; this field supports the settlement tick.N
DoubleALL
spreadTick
N
DoubleF&O
startDateDate a repo startsN
DateBrokerTec
strikePx

Strike price for an option.

The option strike price format in RD APIv3 is the Clearing format and does not align with the MDP 3.0 Security Definition message (FIX Tag 202-StrikePrice) price format. Additional information on CME Globex strike price format can be found in MDP 3.0 CME Globex Pricing.

Example: RD APIv3 Strike Price Format = 10.70 vs MDP 3.0 Security Definition Strike Price Format = 1070.

N
DoubleF&O
strikePxCcyStrike pSpread tick. Used for any spread where there is no “non-consecutive-month” spread tick.
Only applicable to ClearPort contracts.rice currency for an option.
N
StringF&O

tccAlias

TCC Alias: Instrument symbol used for trade reporting on CME ClearPort, CME STP and CME STP FIX.

N
StringALL
tradeTickTrade price tick. May differ from the settlementTick.N
DoubleALL
uomCcyUnit of measure currencyN
StringALL
valuationMethod

Type of valuation method used

Valid values include but are not limited to:

EQTY - Premium Style


FUT - Futures Style

FUTDA - Cash Adjusted Futures Style

FUTER - Futures Style with Erosion

FUTI - Futures Style Inverse

FUTOP - Futures Style for Options


FWD - Forward

FWDC - Forward, Cash-Settled Daily, Standard Currency Convention


BILL - Bills


BOND - Cash Notes and bonds


IRS - Interest Rate Swap


SPOT - Spot


RPO - Repo Specific

RPOBS - Repo Specific / GC - Buy Sell Back (only Spain)

RPOGC - Repo General Collateral

RPOGF - Repo GCF / DBV / GC+

RPOSC - Repo Specific / GC - EONIA bond

N
StringALL
variableTickTableVariable tick table for trading on CME Globex.

StringF&O
vttHighTickFor some instruments, the tick is price dependent. This field defines the widest tick the instrument can trade at.N
DoubleF&O
vttLowTickFor some instruments, the tick is price dependent. This field defines the smallest tick the instrument can trade at.N
DoubleF&O
vttPriceThresholdFor some instruments, the tick is price dependent. This field defines the price threshold at which the minimum tick changes.N
DoubleF&O
workupPrivateTimer

Where workup session are used, this would be the duration in seconds for the private phase.

0 (= Disabled)
> 0 (= Number of seconds)

N
IntegerBrokerTec
workupPublicTimer

Where workup session are used, this would be the duration in seconds for the publicphase.

0 (= Disabled)
> 0 (= Number of seconds)

N
IntegerBrokerTec
workupPublicTimerExt

Where workup session are used, this would be the duration in seconds for the extending the public phase.

0 (= Disabled)
> 0 (= Number of seconds)

N
IntegerBrokerTec
zeroPriceEligibleY/N flag to indicate if instrument may be quoted and/or traded at a zero price.N
StringALL
maxSubstitionCntNumber of substitutions allowed for the GC; 0 value will indicate the repo is not eligible for substitutions. Also called rights of substitution.

IntegerBrokerTec

instrumentType

Description of instrument type.

N


String

ALL

settleMethodQuery for all products by settlement method.YSettlement MethodStringF&O

priceRatio


Used for price calculation in spread and leg pricing for Implied Intercommodity Ratio

N


Number

F&O

baseIndexType


Returned value represents base index name

N


Varchar (2)

BrokerTec

minGlobexOrdQty


Minimum order or quote size required on CME Globex.

  • For BrokerTec orders, this will reflect the minimum initial order.
  • For EBS this value will be in notional quantity.

N


String

ALL

maxGlobexOrdQty


Maximum value allowed for a single quote or order on CME Globex.

  • For EBS this value will be in notional quantity.

N


String

ALL

minIncrementalOrder


Minimum incremental order quantity.

N


String

ALL

minIntraGlobexOrdQty


MidSession value allowed for a single order.


N


String

BrokerTec

maxIntraGlobexOrdQty


MidSession Maximum value allowed for a single order.


N


String

BrokerTec

minIntraIncrementalOrder


MidSession Minimum incremental order.


N


String

BrokerTec

minInitialOrder


Minimum initial order.

N


Integer

BrokerTec


parValue


The par value of the bond.

N


Number

BrokerTec

maxSubstitutionCnt


Number of substitutions allowed for the GC; 0 value will indicate the repo is not eligible for substitutions.

N


Integer

BrokerTec

isAONInstrument


Boolean flag to identify AON instrument ("Y", "N").

N


String

BrokerTec

relatedInstrumentGuidInt


This will be the GUID_INT for the related instrument to the AON.

AON markets on CME Globex are listed as separate instruments. The relatedInstrumentGuidInt field will contain the GUID Integer for the related CLOB instrument. For AON instruments that do not have a related CLOB instrument, relatedInstrumentGuidInt = null


N


Number

BrokerTec

firstCouponDate


The first coupon date of the debt maturity

N


Date

Format:

"YYYY-MM-DD"


BrokerTec

allocationDeadline17:15:00 (for LCH German Special)N
StringBrokerTec
airAccruedFunding The accrued funding value for this contract for the specified business date, to seven decimal places.

N


Number
airDailyFunding Today’s contribution to that aggregate Accrued Funding value, likewise to seven decimal places.N
Number
airBusinessDate The business date to which these values pertain.N
Date
airFundingStatus

An indicator which specifies whether these are the final or preliminary values for the specified business date.

Valid values:

  • Prelim
  • Final
N
VARCHAR2
floatOffset

The float offset (spread) is applied to the reference rate of the US FRN (the 13 week US T Bill) and is determined at the auction.

The spread will remain for the life of an US FRN. 

N
Decimal

exchangeGlobex

Market Identifier Code (MIC) as defined by the ISO. For inter-exchange spreads, this field contains the hybrid value displayed in the Market Data Platform Security Definition (tag 35=d) message tag 207-SecurityExchange.

N


String

ALL

exchangeClearing

Exchange identifier used in the CME Group Post Trade Application.

N


String

ALL

leadMonthInd

Boolean flag to identify whether a contract is the lead month.

  • Y
  • N

N

N

String

F&O

isTmacProduct

Boolean flag identifies whether the overlying product is a TMAC product.

  • Y
  • N

N

N

String

F&O
Repeating Group
bookDepthGlobex market data book depth repeating group.N

String

ALL

mdFeedType

Globex market data feed type. Describes a class of service for a given data feed.

  • GBX=CME Globex Book Depth
  • GBI=CME Globex Implied Book Depth (under development)
N

String

ALL

marketDepthIdentifies the depth of book of the Globex market data feed type.N

String

ALL

clrSymbol 

CLR Symbol: The product code used in CME Clearing for clearing reports like the Trade Register.

Example: “L1”

N
StringF&O
trdgUnitPeriodMult

Transaction Size

  • For Peak products, this will reflect the number of days
  • For Off-Peak products, this will reflect the number of hours

Example: 22, 392

N
NumberF&O
transformationDate

Date of Transformation

Example: “2021-06-01”

N
DateF&O
peakType

Peak Type

Example: Peak, Off-Peak, Null

N
StringF&O
transformedInstruments 

Repeating Group listing the instruments trades are transformed into, using the Clearing product code

Example: "JD 20210601”, “JD 20210602”... “JD 20210630"

N
StringF&O
legID

Leg ID represents day of month

Example: 1 - 31 

N
StringF&O
daysHours

1 Day or 1 - 24 Hours

Example: “1”, “8”

N
StringF&O
swapEffDateSwap start dateNNDate
Format:
"YYYY-MM-DD"
F&O
maturityDateSwap termination dateNNDate
Format:
"YYYY-MM-DD"
F&O
notionalPerContractNotional amount per contractNNNumberF&O
ctdCusipRelated treasury cusipNNStringF&O
isEfixInstrumentBoolean flag to identify eFix Matching Service (Y, N).N BooleanEBS
minQuoteLife

Minimum Quote Life functionality defines the minimum duration, in number of microseconds, that a resting order must be exposed to the market before it can be cancelled or modified in number of microseconds.

If a product does not support MQL Protection, then its duration value will be zero.

N

 

NumberEBS
maxPriceDiscretionOffset

Maximum allowed discretionary offset from the Limit order price. When the value in this field = 0.0, discretionary price is not allowed to be submitted for the instrument.

N

 

Price FormatEBS
interveningDays 

For FX SPOT - Number of business days, as an offset from Trade Date which determines the instrument's Settlement Date.

For NDF - Number of business days (plus tenor) used to determine settlement date.

N


IntegerEBS
fixingName

Name that includes the fixing source, time and location.

Only for eFix Matching Service instruments.
e.g. WM 23:30 London

N

 

String


EBS

fixingSourceLocalTime

The local time of the fixing source.N
StringEBS
tenorType

Indicates the settlement period or contract tenor type and duration.

Tenors may be fixed or expressed in a number of days/weeks/months/years; where where "x" is any integer > 0

  • 0 = Regular / FX Spot settlement (T+0, T+1 or T+2)
  • Dx = FX tenor expression for "days"
  • Wx = FX tenor expression for "weeks"
  • Mx = FX tenor expression for "months"
  • Yx =  FX tenor expression for "years"
  • B =  Fixed Date tenor for Fixed Date NDFs only. 

N

 

StringEBS
maxSweepQtyThe maximum quantity a Sweepable order may be submitted for in units of the instrument’s unitOfMeasureQtyN StringEBS
New Attributes
Attribute NameDescriptionWeb ContactData TypeExchange/DCM
globexGroupCode

CME Globex uses this group code to identify logical groupings of products.

CME Globex group code is only populated for instruments listed for trading on CME Globex.

 StringALL
variableTickTableVariable tick table for trading on CME Globex. StringF&O
goodForSessionBoolean flag (“Y”,”N”) to identify GFS (Good For Session) TimeInForce eligibility on CME Globex. BooleanEBS
isTacoProduct

Boolean flag to identify TACO products ("Y", "N").

 BooleanF&O
rbtEligibleIndRelationship Based Trading Eligibility Indicator. RBT eligible products are not eligible to trade on Globex. BooleanBrokerTec
calculatedContractSizeDisplays the variable quantity product’s total calculated contract size. StringF&O





How was your Client Systems Wiki Experience? Submit Feedback

Copyright © 2024 CME Group Inc. All rights reserved.