Migrate to Reference Data API Version 3 now. CME Reference Data API Version 2 will not be supported after October 27, 2023.
The CME Reference Data APIv2 is a set of JSON RESTful web service APIs that provide real-time restricted access to product and instrument referential data using OAuth, an open protocol that supports secure authorization in a simple, standard method and decouples authentication from authorization. CME Reference Data APIv2 provides product and instrument reference data for all CME Group, BrokerTec, EBS, Hosted Partners and CME Group-cleared markets.
Products contain all available products - BrokerTec, EBS, futures, options on futures, spreads and products - on an underlying asset or related index or related future.
Instruments are the individual traded and cleared contracts.
Information includes:
- Contract specifications
- Product codes and symbols for all CME Group venues
- Trade and order type eligibility
- Instrument life cycle dates including first and last trade date, all notice dates, delivery dates and settlement dates.
Client systems can automate their product and instrument definitions by pulling the information from the CME Reference Data APIs, reducing the manual work involved in setting up new products. All customers are strongly encouraged to develop to the CME Reference Data APIs and integrate it into their product definition architecture.
Data will be updated every 15 minutes.
For pre-listed instruments with next day activation, clients should start polling CME Reference Data API version 2 for the instruments after 3:00 p.m. CST
BrokerTec and EBS product information is not supported in the Security Definition Flat File (secdef.dat) alongside CME Futures and Options products.
Contents
Testing and Certification
Certification is not required for CME Reference Data API version 2.
Restricted Access
CME Reference Data API version 2 uses OAuth, an open protocol that supports secure authorization in a simple, standard method and decouples authentication from authorization.
See: Client API Service Adoption using OAuth 2.0 Protocol
Authorization and Entitlement
A registered OAuth API ID is required to access the CME Reference Data API version 2 services. API IDs for CME Group Logins are created and managed in the Customer Center under My Profile.
New Clients
New clients - should start by Creating a CME Group Login.
- Once a client creates and activates their CME Group Login ID, they can login to Customer Center under My Profile and create an OAuth API ID
Clients with Existing CME Group Logins
- Clients with existing CME Group Login ID can login to Customer Center and under My Profile create an OAuth API ID
- Clients with existing CME Group Login ID and existing Basic Auth API ID can convert the Basic Auth API ID to an OAuth API ID under the API Management section of the CME Group Login under My Profile.
Requesting Entitlement
Client's API IDs must be entitled and registered by the Enterprise Access and Entitlements (EASE) team to view and consume the BrokerTec and EBS content.
- To request access in the New Release environment, complete the following forms:
- To request access in the Production environment, complete the following forms:
- CME Group requires customers to create unique OAuth API IDs for both the New Release and Production environments.
Default Entitlements
Entitlement registration is not required to access Futures and Options attributes; clients can simply log into the API with their API ID credentials.
Accessing CME Reference Data API Version 2 Endpoints
To access CME Reference Data API version 2 endpoints in the New Release and Production environments, an OAuth API ID and access token are required.
The following endpoints are used by client applications to communicate with the OAuth Authorization Server to request and refresh access tokens.
Client systems are allowed to use any API tool of their choice to request and refresh access tokens to access CME Reference Data API version 2 endpoints using the OAuth protocol.
See Client API Service Adoption using OAuth 2.0 Protocol for an example of using a token.
OAuth 2.0 Authorization Server Access Token Retrieval Endpoints
The below endpoints are available to request and refresh access tokens in the New Release and Production environments.
OAuth 2.0 Authorization Server Endpoints | ||
---|---|---|
Detail | New Release | Production |
OAuth Token Endpoint | https://authnr.cmegroup.com/as/token.oauth2 | https://auth.cmegroup.com/as/token.oauth2 |
Authorized API ID's may access the endpoints in the New Release and Production environments:
New Release Endpoints by Market
F&O | BTEC | EBS |
---|---|---|
/v2/products | /v2/products | /v2/products |
/v2/instruments | /v2/instruments | /v2/instruments |
/v2/displayGroups | /v2/tradingSessionValueDates |
Production Endpoints by Market
F&O | BTEC | EBS |
---|---|---|
/v2/products | /v2/products | /v2/products |
/v2/instruments | /v2/instruments | /v2/instruments |
/v2/displayGroups | /v2/tradingSessionValueDates |
EBS Market and eFix Network Connections
CME Reference Data API for EBS product and instrument information is available over all CME Group network connections for EBS Market and eFix.
EBS Market New Release eFix Network Connections
Access Reference Data API in the New Release environment over Cert VPN and Cert Data Center connections enabled for EBS Market and eFix at:
CME Group Network Connections | |||
---|---|---|---|
Environment | Path | IP | Port |
New Release | api.refdata.nr.cmegroup.com | 164.74.124.195 | 443 |
EBS Market Production eFix Network Connections
Access Reference Data API in the production environment over all CME Group connections enabled for EBS Market and eFix at:
CME Group Network Connections | |||
---|---|---|---|
Environment | Path | IP | Port |
Production | api.refdata.cmegroup.com | 167.204.72.195 | 443 |
Clients must either have access to Internet-based DNS or resolve the original path name to the new IP at their side.
Hours of Availability
The CME Reference Data APIs are real-time APIs available 24 hours a day, 7 days a week. Clients systems should consider all returned data to be accurate as of the time of the request submission. Since the products are updated dynamically, multiple requests may return different results.
There are weekly maintenance periods that occur on Friday from 10:00 pm CT to Saturday 4:00 a.m. CT and Sunday from 11:30 am CT – 11:50 a.m. CT. During these times, data may be unavailable or unreliable.
Returned Attributes
All attributes for a product or instrument are always returned. Attributes that are undefined or have no value for a particular product or instrument will return "null."
Sorted Results
CME Reference Data API does not support sorted results.
Pagination and Scrolling Links
To make responses more manageable, CME Reference Data API returns results in pages or by scrolling.
Pagination
By default, 20 results per page are included, but up to 1000 results per page can be requested by using the size parameter. CME Reference Data API also supports a page parameter to allow clients to jump to a specific page in the result set.
Pagination Links
Name | Description | Additional Details |
---|---|---|
self | href URL for the query. | |
prev | href URL for the previous page of query results. | |
first | href URL for the first page of query results. | Page=0 is the value for the first page. |
next | href URL for the next page of query results. | |
last | href URL for the last page of query result. | The page value on this reference will be one less than the totalPages value. |
Pagination Metadata
Name | Description | Additional Details |
---|---|---|
size | Number of results returned per page. | Optional query parameter. The maximum size value is 1000 and the minimum size value is 1. If size is not specified, the default is 20. If size is specified but is less than 1 (e.g., size=0 or size=-9 ), the default of 20 is used. If size is specified but is greater than 1000 (e.g., 2000), 1000 will be used. |
totalElements | Total number of items returned by the query. | |
totalPages | Number of pages required to list all items. | Only included when results are paginated. |
number | Current page number; numbering starts with 0. | |
type | Describes whether pagination or scrolling is used for the data return. | Will return page for responses with less than 10,000 results; for results greater than 10,000 will return scroll. |
Pagination Metadata Example
These examples are based on a query of all products where size=1000 and page=1:
"_links": {
"first": {
"href": "__/v#/products/?page=0&size=1000"
},
"prev": {
"href": "__/v#/products/?page=0&size=1000"
},
"self": {
"href": "__/v#/products/?size=1000&page=1"
},
"next": {
"href": "__/v#/products/?page=2&size=1000"
},
"last": {
"href": "__/v#/products/?page=6&size=1000"
}
},
"_metadata": {
"size": 1000,
"totalElements": 3674,
"totalPages": 4,
"number": 1,
"type": "page"
}
}
Scrolling
Scrolling will return 20 products per scroll as a default. Like pagination, the return size can be increased up to 1000.
The scroll link will be valid for 5 seconds.
Scrolling Links
Name | Description | Additional Details |
---|---|---|
next | href URL for the next set of query results. |
Scroll Metadata
Name | Description | Additional Details |
---|---|---|
totalElements | The total number of records returned. | |
scrollID | The Scroll ID for the returned set of data. | |
type | Describes whether pagination or scrolling is used for the data return. | Will return scroll. |
Scrolling Example
"_links": {
"next": {
"href": "__/v#/instruments/?scrollId=DnF1ZXJ5VGhlbkZldGNoBQAAAAAAABMoFnZrMFlvQUItVEpHdFFwZmI4dHN3QXcAAAAAAAAPlRZNc3lBUlNFMFJlbW11SVBFS0dNX19BAAAAAAAAEykWdmswWW9BQi1USkd0UXBmYjh0c3dBdwAAAAAAAA-XFk1zeUFSU0UwUmVtbXVJUEVLR01fX0EAAAAAAAAPlhZNc3lBUlNFMFJlbW11SVBFS0dNX19B"
}
},
"_metadata": {
"totalElements": 3764,
"scrollId": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAABMoFnZrMFlvQUItVEpHdFFwZmI4dHN3QXcAAAAAAAAPlRZNc3lBUlNFMFJlbW11SVBFS0dNX19BAAAAAAAAEykWdmswWW9BQi1USkd0UXBmYjh0c3dBdwAAAAAAAA-XFk1zeUFSU0UwUmVtbXVJUEVLR01fX0EAAAAAAAAPlhZNc3lBUlNFMFJlbW11SVBFS0dNX19B",
"type": "scroll"
}
Collection Header
CME Reference Data API does not support attributes in collection headers.
Errors
CME Reference Data API uses standard HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success; codes in the 4xx range indicate an error resulting from the query request; and codes in the 5xx range indicate an error with the CME Group servers.
Status Code | Explanation |
---|---|
200 | OK
|
400 | Request was missing required information or was malformed |
403 | Forbidden - returned when the particular HTTPS method is not allowed (e.g., POST, PATCH, PUT, DELETE...) |
404 | Requested item not found |
5xx | There is a server error on the CME Group side |
Searches
CME Reference Data API supports GET requests for all product or instrument records, using the following calls:
- All product records: _/v#/products
- All instrument records: _/v#/instruments
- All display groups (BrokerTec): _/v#/displayGroups
- All trading session value dates (EBS): _/v#/tradingSessionValueDates
Sending Query Requests
The following request can be made using an OAuth authorized API ID and access token.
Client systems send Query Requests by invoking the HTTPS GET method to a URL of the form: https://{{path}}/v2/products, https://{{path}}/v2/instruments or https://{{path}}/v2/displayGroups
Environment | Path |
---|---|
New Release | api.refdata.nr.cmegroup.com |
Production | api.refdata.cmegroup.com |
Special Characters
There are certain characters (/ , # , \ , < , >, space) which are reserved and unsafe characters and should not be used in queries and if used should be encoded.
Note the + (plus) is not supported and the ? should be used as a substitute. The ? is one of the wildcard characters currently supported in RD API.
Characters | Encoding |
---|---|
/ | %2F |
# | %23 |
\ | %5C |
< | %3C |
> | %3E |
space | %20 |
+ | Not supported |
Encoded Examples:
Query | Encoded Query |
---|---|
longName=8_11/21 09/03-10/20 | longName=8_11%2F21%2009%2F03-10%2F20 |
longName=EUROGC+_LCR_MIN_SIZE_25MM | longName=EUROGC?_LCR_MIN_SIZE_25MM |
longName=GC<10* | longName=GC%3C10* |
globexGroupCode=#USBD | globexGroupCode=%23USBD |
Query Searches
Query searches consist of one or more items that include an attribute, operator and value that are implemented as part of an HTTPS GET request. Query attributes are listed below. Only the "=" operator is currently supported. A wildcard "*" can be included in the value to return all products or instruments that match a partial value. Terms can be combined with question mark (?) for the first parameter, and an ampersand (&) for subsequent parameters to return only the results that match ALL of the search terms. Values are case-insensitive.
Query Samples
Query | Query Type | Description |
---|---|---|
_/v#/products | Product | Returns information on every product cleared or hosted at CME Group. |
_/v#/instruments | Instrument | Returns information on every instrument cleared or hosted at CME Group. |
_/v#/products?globexProductCode=GE | Product with Globex Product Code filter | Returns information on all products traded on CME Globex under the product code "GE". |
_/v#/instruments?globexSymbol=05* _/v#/instruments?globexSymbol=*05 _/v#/instruments?globexSymbol=*05* | Instrument with Globex Symbol filter of "05" and wildcard | * at the end of a string brings up all matches that start with the string. * at the beginning of a string brings up all matches that end with the string. * at both the beginning and end of a string brings up all matches that have that string in the middle. |
_/v#/instruments?cusip=912828XU9 | Instrument with exact pattern match | Returns US & Canadian externally registered security identifier. |
_/v#/products?securityType=FUT | Product with securityType Filter | Returns information on all products traded or cleared as a Futures contract. |
_/v#/products?securityType=FUT&exchangeClearing=CME | Product with securityType and exchangeClearing filters | Returns information on all products cleared as a Futures contract and listed under the CME Rulebook |
v#/products?securityType=TBOND&globexEligible=Y | Product with securityType and globexEligible filters | Returns information on all US Treasury Bond products and eligible to trade on CME Globex |
v#/products?globexGroupCode=USBD& globexEligible=Y | Product with globexGroupCode and globexEligible filters | Returns information on all US Treasury Notes and Bonds products and eligible to trade on CME Globex |
/v#/displayGroups?centralGroupName=BENCH/WI | Display Group central group name | Returns central group and list of instruments |
/v2/instruments?lastTradedAfter=Tuesday, September 15, 2020 7:00:00 PM CST&lastTradedBefore=Wednesday, September 16, 2020 7:00:00 PM CST /v2/instruments?lastTradedAfter=1600214400000&lastTradedBefore=1600300800000 | Instrument with last trade date range | Returns all instruments with last trade date after a certain date and before a certain date. |
_/v2/tradingSessionValueDates?rbtEligibleInd=N | Trading Session Value Dates | Returns trade date to value date (date of settlement) mapping for EBS Markets on CME Globex. |
_/v2/tradingSessionValueDates?instrumentguidInt= Unique instrument identifier in integer-only format. | Trading Session Value Dates | Returns trade date to value date (date of settlement) mapping for a specific instrument for EBS Direct or EBS Markets on CME Globex . |
_/v2/products?marketSegmentId= | Market Segment Id | Returns all products on Market Segment Id
|
Record Relationships
Product and instrument records are tied together by the following relationship definitions:
- Product
- Underlying
- Overlying
- Instruments
- BTIC
- TACO
- TAS
- TAM
- Instruments:
- Underlying
- Overlying
- Product
Relationships function differently for different product and instrument types. The links will only appear in the results if applicable; for instance, a BTIC product that doesn't have any related overlying products will not return Overlying→Overlying.
BTIC and BTIC+ products settling into the same underlying product (e.g. E-mini S&P 500 Futures). In this scenario clients should note there are two relationships to consider:
- The BTIC+ on E-mini Standard and Poor's 500 Stock Price Index Futures
- Underlying of the BTIC+ is the BTIC
- bticUnderlying a BTIC on E-mini-Standard and Poor's 500 Stock Price Index Futures
- underlying a E-mini-S&P 500 Futures
- bticUnderlying a BTIC on E-mini-Standard and Poor's 500 Stock Price Index Futures
- Underlying of the BTIC+ is the BTIC
See Record Relationship Linkage Examples for examples of record relationship types and returned links.
Product Relationships
Type | Underlying | Overlying | Instruments | BTIC Underlying | TAS Underlying | TAM Underlying | TACO Underlying |
---|---|---|---|---|---|---|---|
Future Outright | Not present | References to all products related to the outright future
| All listed instruments on the outright future | Not present | Not present | Not present | Not present |
Future Spread | Leg construction information for the future spread, with references to the outright future legs
| Only present for spreads that are used as legs for spread-of-spreads (e.g., Future Bundles as legs of Bundle Spreads) Leg construction information, with references to the future spread legs
| All listed instruments for the future spread | Not present | Not present | Not present | Not present |
Option Outright | Relationship information for the option outright
| Not present | All listed instruments for the outright option | Not present | Not present | Not present | Not present |
Basis Trade at Index Close (BTIC) Futures | Not present | References to all products related to the BTIC outright future
| All listed instruments for the BTIC outright future | Underlying product for the BTIC (e.g., E-mini S&P 500 future for the BTIC on E-mini S&P 500) | Not present | Not present | Not present |
Trade at Cash Open (TACO) Futures | Not present | References to all products related to the TACO outright future
| All listed instruments for the TACO outright future | Not present | Not present | Underlying product for the TACO future (e.g., E-mini S&P 500 future for the TACO on E-mini S&P 500) | |
Trade at Settlement (TAS) Futures | Not present | References to all products related to the TAS outright future
| All listed instruments for the TAS outright future | Not present | Underlying product for the TAS future (e.g., Sweet Crude Oil futures for the TAS Sweet Crude Oil) | Not present | Not present |
Trade at Marker (TAM) Futures | Not present | References to all products related to the TAM outright future
| All listed instruments for the TAM outright future | Not present | Not present | Underlying product for the TAM future (e.g., Sweet Crude Oil futures for the TAM London Sweet Crude Oil) | Not present |
REPO | Underlying = Physical Collateral of the REPO (e.g. US Government Bonds) | Not present | All listed instruments for the REPO | Not present | Not present | Not present | Not present |
US Treasury Actives and European Government Bonds | Not present | References to all products related to the US Actives Outrights
| All listed instruments for the US Actives | Not present | Not present | Not present | Not present |
eFix Matching Service Product | References to all products related to the eFix Matching Service Product
| Not present | All listed instruments for the eFix Matching Service products. | Not present | Not present | Not present | Not present |
FX Spot Currency Pair Product | Not present | References to all products related to the FX Spot Currency Pair Product
| All listed instruments for the FX Spot Currency Pair products. | Not present | Not present | Not present | Not present |
Instrument Relationships
Type | Underlying Instruments | Overlying Instruments | Product |
---|---|---|---|
Future Outright | Not present | References to all related instruments
| Product record |
Future Spread | Leg construction information for the future spread, with references to the outright future legs
| Only present for spreads that are used as legs for spread-of-spreads (e.g., Future Bundles as legs of Bundle Spreads) Leg construction information, with references to the future spread legs
| Product record |
Option Outright | Relationship information for the option outright
| Not present | Product record |
US Treasury Actives and European Government Bonds Outright | Not present | References to all related instruments
| Product record |
Spreads are defined as distinct products within the CME Reference Data API, separate from the outright products. To search for all related outright and spread products, use the wildcard character to expand your search parameters.
Spreads in the Product API
- _/v#/products?symbol=GE query will return outright futures, outright options and the calendar spread
- _/v#/products?symbol=GE* query will return outright futures, TAS, TAM, BTIC, TACO, outright options and all exchange-defined spreads
Query Parameters
The following parameters can be used to query product information. Either a direct match, or searches using the wildcard "*" can be used for queries.
Example Query to Return BrokerTec tradable instruments
To return only tradable BrokerTec products for a specific security type. Query using security type Globex eligibility flag = 'Y' (for example, securityType=TBOND&globexEligible=Y)
Product Parameters
# | Parameter | Valid Values | Description |
---|---|---|---|
1 | assetClass |
| Query for products by asset class. Note: Not all products have a defined assetClass. |
2 | assetSubClass | Query for all products by asset sub class:
| |
3 | blockTradeEligible | Y,N | Query for all products eligible or ineligible for block trading Not applicable to BrokerTec |
4 | clearingSymbol | Query for products by CME Clearing product code | |
5 | clearportEligible | Y,N | Query for products available on or excluded from CME ClearPort Not applicable to BrokerTec |
6 | dailyFlag | Y,N | Query for or excluding daily products Not applicable to BrokerTec |
7 | ebfEligible | Y,N | Query for products eligible or ineligible for EBF trading Not applicable to BrokerTec |
8 | efpEligible | Y,N | Query for products eligible or ineligible for EFP trading Not applicable to BrokerTec |
9 | exchangeClearing |
| Query for all products by Exchange identifier used in the Post Trade Application. |
10 | 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. |
11 | exerciseStyle | Query for products by the human-readable options exercise instructions. Not applicable to BrokerTec | |
12 | fixingSource |
| Query by instrument fixing source. |
13 | flexEligible | Y,N | Query for products eligible or ineligible for Flex trading Not applicable to BrokerTec |
14 | floorCallSymbol | Query for products by the Floor Call Symbol Not applicable to BrokerTec | |
15 | floorEligible | Y,N | Query for products eligible or ineligible for trading on the floor Not applicable to BrokerTec |
16 | floorPutSymbol | Query for products by the Floor Put Symbol Not applicable to BrokerTec | |
17 | globexEligible | Y,N | Query for products eligible or ineligible for trading on CME Globex |
18 | globexGroupCode | Query for products by CME Globex group code (MDP 3.0 tag 1151-Security Group) | |
19 | globexProductCode | Query for outright products using the CME Globex Product Code (MDP 3.0 tag 6937-Asset) For spreads and combinations (securityType=COMBO), the CME Globex Product Code will be postpended with additional information. To ensure you receive all product records, CME Group recommends querying with a wild card when using this parameter, for example: "globexProductCode=CL*" Examples of globexProductCodes for combos:
| |
20 | ilinkEligible | Y,N | Query for products eligible for iLink Mass Quote order entry on CME Globex. |
21 | isBticProduct | Y,N | Query for Basis Trade at Cash Open (BTIC) products Not applicable to BrokerTec |
22 | isEfixProduct | Y, N | "Y" will return all eFix Match products. |
23 | isTacoProduct | Y,N | Query for Trade at Cash Open (TACO) products Not applicable to BrokerTec |
24 | isTamProduct | Y,N | Query for Trade at Marker (TAM) products Not applicable to BrokerTec |
25 | isTasProduct | Y,N | Query for Trade at Settlement (TAS) products Not applicable to BrokerTec |
26 | marketSegmentID | Query for all products traded on a CME Globex Market Segment May be null for some BrokerTec products | |
27 | massQuoteEligible | Y,N | Query for products eligible or ineligible for Mass Quoting on CME Globex |
28 | masterSymbol | Query for all products under an individual master symbol. This code is only used to associate outright instruments (futures and options) with the product-level spreads/combos. It is not a meaningful attribute of the product itself. This is the only way to query for all products associated with a single business product. For example: ?masterSymbol=SR will return all SOFR products including the futures, options, calendar and bundle spreads BrokerTec - Under Development | |
29 | modifiedAfter | Input a time in UNIX millisecond timestamp format to receive all products modified on or after a certain date. Example: modifiedAfter=1478473019000 | Query for all products modified after the specifIed date. |
30 | modifiedBefore | Input a time in UNIX millisecond timestamp format to receive all products modified on or before a certain date. Example: modifiedBefore=1478473019000 | Query for all products modifed before the specified date. |
31 | negativePxEligible | Y,N | Query for all products eligible or ineligible to trade at negative prices on CME Globex |
32 | negativeStrikeEligible | Y,N | Query for all products eligible or ineligible to list strikes at negative prices Not applicable to BrokerTec |
33 | onMtf | Y,N | Query for all products eligible or ineligible for On-MTF. |
34 | onSef | Y,N | Query for all products eligible or ineligible for On-SEF. |
35 | otcEligible | Y,N | Query for all products eligible or ineligible for OTC trading. Not applicable to BrokerTec |
36 | page | 1...[N] | Retrieve a specific page from the product service |
37 | productGuidInt | Unique product identifier in integer-only format. | |
38 | productName | Legal Product Name. | Query for the human-readable product name. |
39 | rfqCrossEligible | Y,N | Query for products eligible or ineligible for R-Cross on CME Globex |
40 | sector | Query for all products in the specified Subgroup as reflected on cmegroup.com For BrokerTec Tradable Products the following values:
| |
41 | securityType |
| Query for all products by type |
42 | size | 1-1000 | Specify the number of results returned per page |
43 | strategyType | Query on strategy type, e.g. "RV", "SP", "FX", "BF" etc.. | |
44 | subSector | Query for all products in the specified Category as reflected on cmegroup.com May be null for BrokerTec | |
45 | symbol | Query for all products using symbol across all venues. Product code searches using this parameter will return all products with that code across any/all trading venues and CME Clearing:
| |
46 | tradePxCcy | Query for all products with the specified trade currency | |
47 | unitOfMeasure | Query for all products with the specified Unit of Measure for the contract. For example, "IPNT" (Index Points) for E-mini S&P Futures. Unit of measure values are defined here. | |
48 | rbtEligibleInd | Y or N | Will return all RBT products Note: RBT eligible products are not traded on CME Globex. |
49 | clearingOrgID | e.g.
| Will return the entity where the trade will be cleared |
Instrument Parameters
# | Parameter | Valid Values | Description |
---|---|---|---|
1 | cusip | US & Canadian externally registered security identifier. | |
2 | fisn | Financial instrument short name. Used for MiFid reporting. | |
3 | globexSecurityId | Query for instrument by Security ID (MDP 3.0 tag 48-SecurityID) | |
4 | globexSymbol | Query for instrument by CME Globex symbol (MDP 3.0 tag 55-Symbol). | |
5 | guidInt | Unique instrument identifier in integer-only format. | |
6 | instrumentName | Query for instruments by the human-readable instrument name May be null for BrokerTec instruments | |
7 | isin | e.g. FR0013341682 | European externally registered security identifier. |
8 | issuerCountry | e.g. US, DE, GB | The country the issuer is domiciled in. The 2 character ISO code will be used. |
9 | issuerLongName | e.g. UNITED STATES TREASURY | Query for all instruments listed with this issuer long name. |
10 | longName | e.g. Exact Match longName=2_YEAR e.g. Pattern Match longName=*_YEAR | Query for all instruments listed with this long name. |
11 | modifiedAfter | Input a time in UNIX millisecond timestamp format to receive all products modified on or after a certain date. Example: modifiedAfter=1478473019000 | Query for all instruments modified after the specified date |
12 | modifiedBefore | Input a time in UNIX millisecond timestamp format to receive all products modified on or after a certain date. Example: modifiedBefore=1478473019000 | Query for all instruments modified before specified date |
13 | page | 1...[N] | Query to retrieve a specific page |
14 | productGuidInt | Query for all instruments listed on a particular product. | |
15 | repoTermCode | e.g. Examples: C C-1W REG O S-N | Query for all instruments listed with this repo term code |
16 | size | 1-1000 | Specify the number of results returned per page |
17 | startedBefore | Input a time in UNIX millisecond timestamp format to receive all instruments listed on or after a certain date. Example: startedBefore=1478473019000 | Query for all instruments listed before a repo start date. |
18 | startedAfter | Input a time in UNIX millisecond timestamp format to receive all instruments listed on or after a certain date. Example: endedBefore=1478473019000 | Query for all instruments listed after a repo start date. |
19 | endedBefore | Input a time in UNIX millisecond timestamp format to receive all instruments listed on or after a certain date. Example: endedAfter=1478473019000 | Query for all instruments listed before a repo end date. |
20 | endedAfter | Input a time in UNIX millisecond timestamp format to receive all instruments listed on or after a certain date. Example: endedAfter=1478473019000 | Query for all instruments listed after a repo end date. |
21 | zeroPriceEligible | Query for instruments eligible or ineligible for trading at zero price | |
22 | IsUserDefined | true or false | Will return instruments for the following instrument types:
|
23 | isAONInstrument | Y or N | Will return all AON instruments |
24 | instrumentType |
| Query for instruments by instrument type |
25 | govBondType | Query for all instruments by sub-category for government bonds See Government Bond Type Query Parameters for full list of sub-category for government bond values | |
26 | firstTradedAfter | Input a time in UNIX millisecond timestamp format to receive all instruments with a first trade date after a certain date. Example: firstTradedAfter=1600705800000 | Query for all instruments after a first trade date |
27 | firstTradedBefore | Input a time in UNIX millisecond timestamp format to receive all instruments with a first trade date before a certain date. Example: firstTradedBefore=1600705800000 | Query for all instruments before a first trade date |
28 | lastTradedAfter | Input a time in UNIX millisecond timestamp format to receive all instruments with a last trade date after a certain date. Example: lastTradedAfter=1600705800000 | Query for all instruments after a last trade date |
29 | lastTradedBefore | Input a time in UNIX millisecond timestamp format to receive all instruments with a last trade date before a certain date. Example: lastTradedBefore =1600705800000 | Query for all instruments before a last trade date |
30 | globexGroupCode | Query for all instruments by CME Globex group code. (MDP 3.0 tag 1151-Security Group) | |
31 | exchangeGlobex |
| Query for all instruments by the Market Identifier Code (MIC) as defined by the ISO. The CME Globex exchange code is only populated for instruments listed for trading on CME Globex. |
32 | exchangeClearing |
| Query for all products by Exchange identifier used in the Post Trade Application. |
33 | isEfixInstrument | Y, N | "Y" will return all eFix Matching Service instruments. |
BrokerTec Display Groups
Display Groups contain Central Groups, which are customized combinations of associated instruments used for vendor front-end displays.
TYPE | QUERY PARAMETERS | DATA EXAMPLE | DESCRIPTIOIN | |
---|---|---|---|---|
displayGroups | STRING | GC_SA_NETHER* BENCH/WI | Lists all display groups | |
centralGroupName | STRING | Filter attribute | Returns quested Display Group | |
sortCriteria | STRING | C = Country+Maturity+Coupon = ISSUECOUNTRY+MATURITY+COUPON M= Maturity+Coupon = MATURITY+COUPON L=Leg = DEFAULT | ||
legNumber | NUMBER | 9 | Sort order The “leg number” is the listed position of the instrument in the Display Group |
Example of Display Group with instruments listed according to legNumber position.
Central Group Leg# Sort Long_Name_Exp
BENCH/WI 1 L 2_YEAR
BENCH/WI 2 L 3_YEAR
BENCH/WI 3 L 5_YEAR
BENCH/WI 4 L 7_YEAR
BENCH/WI 5 L 10_YEAR
BENCH/WI 6 L 30_YEAR
BENCH/WI 7 L W_7_YR
BENCH/WI 8 L 10_YEAR
BENCH/WI 9 L 30_YEAR
Product and Instrument Attribute Details
Spread Attributes
Spread attributes are applicable to both Product and Instrument, and define the leg construction for combos as well as links to the outright legs. These attributes are only applicable to spreads.
Attribute | Description | Type |
---|---|---|
marketSide | Side (Buy/Sell) for each leg. | String |
legNumber | The relative position of each outright instrument within a spread For example, for an SP calendar spread, the expiring first front leg will reflect legNumber=1 and the later expiring back leg will reflect legNumber=2 | String |
ratio | The quantity multiplier for each leg traded as part of a spread. | String |
Product Attributes
The Product service contains information about all products traded and cleared at CME Group. The collection is returned in an embedded object with an array for each product.
Attributes for Daily Options on Futures, Combos, TAS, TAM, TACO and BTIC Products
For Spreads (securityType=COMBO) and TAS, TAM, TACO or BTIC products, attributes that are part of the contract specifications on www.cmegroup.com if applicable, such as Minimum Price Fluctuation and Price Quotation, are available in the underlying future.
The TAS / TAM / BTIC / TACO indicator flag will be set only for outright futures products and instruments.
For daily options on futures, attributes that are part of contract specifications on www.cmegroup.com, are available in the Day 1 daily product.
- For example, with Crude Oil Short-Term Options contract specs, Crude Oil Short-Term Options D01- Crude Oil Short-Term Options D31 are the daily products. The contract specs for Crude Oil Short-Term Options D02- Crude Oil Short-Term Options D31 (Globex Product Codes C02 - C31) will be found in Crude Oil Short-Term Options D01 (Globex Product Code C01).
Contract Specs are supported on the CME Group website, and identified, along with the Contract Spec attribute source, in the table below.
Default Attributes - Minimum Tick, Listing Rules, Trading Schedules and Termination of Trade Default Values
- Minimum Tick: If values for globexMinTick, minClearPortTick, minimumHalfTick, minClearPortFloorTick, minOutrightTick, minQtrlySerialTick are null, customers should use the value in defaultMinTick.
- Listing Rules: if values for listing rules fields (fields with ListingRules as a suffix, such as globexListingRules and serialListingRules) are null, customers should use the value in defaultListingRules.
- Trading Schedules: If values for globexSchedule, clearportSchedule, and floorSchedule are null, customers should use the value in stdTradingHours. These attributes are in development.
- Termination of Trade: If values for termination of trade fields (all fields prefixed by tot, such as totGlobex and totClearPort) are null, customers should use the value in totDefault.
# | Attribute | Description | Found in Web Contract Specifications? | Web Attribute Name | Type | Exchange |
---|---|---|---|---|---|---|
1 | assetClass | Underlying asset type. | N | String | ALL | |
2 | assetSubClass | Sub class within asset class (for example: Credit, Foreign Exchange). | N | String | ALL | |
3 | assignmentMethod | Method used for assignment of futures upon options delivery:
| N | String | ALL | |
4 | blockTradeEligible | Block Trade eligible products | N | String | ALL | |
5 | calendarTickRules | Tick behavior for calendar spreads | N | String | F&O | |
6 | clearingCabPx | All applicable cabinet prices for cleared trades. | N | String | F&O | |
7 | clearingOrgID | The entity where the trade will be cleared. Values include:
| N | String | BrokerTec | |
8 | clearingSymbol | The product code used in CME Clearing for post-trade processing and back-office functions. | N | String | ALL | |
9 | clearportEligible | CME ClearPort eligible products. | N | String | F&O | |
10 | clearportSchedule | CME ClearPort trading hours. Attribute is under development. | N | String | F&O | |
11 | commodityStandards | The commodity standards for physically-delivered contracts. | N | String | F&O | |
12 | contraryInstructionsAllowed | Boolean flag to identify whether Contrary Instructions are allowed ("Y", "N"). | N | String | ALL | |
13 | dailyFlag | Y/N flag to indicate if product is daily. | N | String | F&O | |
14 | daysOrHours | Indicates for variable quantity products whether the instrument is effected in days or hours. | N | String | F&O | |
15 | defaultListingRules | The standard product listing rules as defined in the Rulebook. | Y | Listed Contracts | String | F&O |
16 | defaultMinTick | Default minimum trading/clearing tick for the product before the application of special tick rules for individual instruments. | Y | Minimum Price Fluctuation | String | F&O |
17 | ebfEligible | Indicates if product is EBF eligible. (Y/N) | N | String | F&O | |
18 | efpEligible | Indicates if product is EFP eligible. (Y/N) | N | String | F&O | |
19 | efrEligible | Indicates if product is EFR eligible. (Y/N) | N | String | F&O | |
20 | exchangeClearing | Exchange identifier used in the CME Group Post Trade Application. | N | String | ALL | |
21 | 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 | |
22 | exerciseStyle | Human-readable options exercise instructions. | N | String | F&O | |
23 | exerciseStyleAmericanEuropean | Indicator for American or European option exercise style. 0 = American style 1 = European style | Y | Exercise Style | String | F&O |
24 | flexEligible | Y/N flag to indicate whether product is eligible for FLEX functionality. | N | String | F&O | |
25 | floorCallSymbol | Floor call symbol. FloorCall and FloorPut may be different for some option products. | N | String | F&O | |
26 | floorEligible | Floor Eligible products. | N | String | F&O | |
27 | floorListingRules | Description of the contract listing rules for open outcry eligible contracts. | Y | Listed Contracts | String | F&O |
28 | floorPutSymbol | Floor put symbol. FloorCall and FloorPut may be different for some option products. | N | String | F&O | |
29 | floorSchedule | Standard open outcry trading hours for floor-traded products. Attribute is under development. | Y | Trading Hours | String | F&O |
30 | fractional | Y/N value to indicate if product price should be displayed in fractional or decimal notation. | N | String | ALL | |
31 | globexCabPx | Smallest price CME Globex will accept for an option trade. Returns in a 19 character CME Globex format string. First character denotes the decimal by which value needs to move left. For example, 2000000000000001000 converts to 10.00. | N | String | F&O | |
32 | globexDisplayFactor | Exchange-recommended factor to apply to raw CME Globex prices for display. Returns in a 19 character CME Globex format string. First character denotes the decimal by which value needs to move left. For example, 2000000000000000001 converts to 0.01. | N | String | ALL | |
33 | globexEligible | Indicates if product is CME Globex eligible. (Y/N) | N | String | ALL | |
34 | 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. | N | String | ALL | |
35 | globexGroupDescr | For BrokerTec fields, this describes the Globex Group Code. | N | String | ALL | |
36 | globexGtEligible | Y/N flag to indicate if product allows GTC or GTD orders on CME Globex. | N | String | ALL | |
37 | globexListingRules | The listing rules for instruments on CME Globex. In some cases, the CME Globex listing is a subset of the full set of exchange-defined contracts. | Y | Listed Contracts | String | F&O |
38 | globexMinTick | Smallest standard pricing increment for CME Globex markets.
| N | String | F&O | |
39 | globexProductCode | CME Globex Product Code (MDP 3.0 tag 6937-Asset) For spreads and combinations (securityType=COMBO), the CME Globex Product Code will be postpended with additional information. To ensure you receive all product records, CME Group recommends querying with a wild card when using this parameter, for example: "globexProductCode=CL*" Examples of globexProductCodes for combos:
| Y | Globex Product Code | String | ALL |
40 | globexSchedule | Standard CME Globex trading hours. Attribute is under development. | N | String | F&O | |
41 | ilinkEligible | iLink Mass Quote Eligible Products | N | String | ALL | |
42 | isBticProduct | Boolean flag to identify BTIC products ("Y", "N"). | N | String | F&O | |
43 | isSyntheticProduct | Boolean flag to identify synthetic products ("Y", "N"). | N | String | F&O | |
44 | isTacoProduct | Boolean flag to identify TACO products ("Y", "N"). | N | String | F&O | |
45 | isTamProduct | Boolean flag to identify TAM products ("Y", "N"). | N | String | F&O | |
46 | isTasProduct | Boolean flag to identify TAS products ("Y", "N"). | N | String | F&O | |
47 | itcCode | Product code as reflected on ITC market data. | N | String | ALL | |
48 | itmOtm | Describes status of in-the-money / out-of-the-money. Values:
| N | String | F&O | |
49 | lastDeliveryRules | Rules for the last delivery day of an expiring contract. | Y | Listed Contracts | String | F&O |
50 | lastUpdated | Timestamp from last time the instrument definition was touched:
| N | Date Format: "YYYY-MM-DDThh:mm:ss.SSS+ZZZZ", | ALL | |
51 | limitRules | Standard limits or circuit breakers which might apply. Links to a human-readable source. | Y | Price Limit or Circuit | String | F&O |
52 | mainFraction | Denominator of main fraction for products priced in fractional terms, as detailed in the Fractional Pricing topic. E.g., a product that trades in 1/64ths will have "64" in this field. Will be sent with "null" for non-fractional products. | N | Integer | ALL | |
53 | markerStlmtRules | TAM/TAS text from contract specs. | Y | Trade At Marker Or Trade At Settlement Rules | String | F&O |
54 | marketSegmentId | Numeric value for CME Globex Market Segment on which the product is traded. | N | String | ALL | |
55 | massQuoteEligible | Boolean flag to indicate if product is eligible for Mass Quote messages on CME Globex. | N | String | F&O | |
56 | masterSymbol | This code is only used to associate outright instruments (futures and options) with the product-level spreads/combos. It is not a meaningful attribute of the product itself. This is the only way to query for all products associated with a single business product. For example: Three-Month SOFR futures, Options on three month futures and the intraspread use master code SR3, clearing symbol SR3, and CME Globex product code SR3. The SOFR futures bundle combo uses master code SR3, clearing symbol SR3 and CME Globex product code SR3 : AB. To see all of the futures, options and combinations, only the masterSymbol query will return them all. | N | String | ALL | |
57 | maxGlobexOrdQty | Maximum value allowed for a single quote or order on CME Globex. | N | String | ALL | |
58 | mdp3Channel | Market Data Platform channel for CME Globex book | N | String | ALL | |
59 | midcurveOptionsRules | General rules for mid-curve options. | Y | Listed Contracts | String | F&O |
60 | midcurveTickRules | Tick behavior for midcurve options. | Y | Listed Contracts | String | F&O |
61 | minCabinetTickRules | The human-readable rules for minimum the cabinet tick for eligible options products. | Y | Minimum Price Fluctuation | String | F&O |
62 | minClearPortFloorTick | Minimum tick that applies to both CME ClearPort and trading floor. | Y | Minimum Price Fluctuation | String | F&O |
63 | minClearPortTick | Minimum tick applicable to CME ClearPort. | Y | Minimum Price Fluctuation | String | F&O |
64 | minDaysToMat | The minimum number of days remaining on an allocated collateral before it must be substituted. | N | Integer | BrokerTec | |
65 | minGlobexOrdQty | Minimum order or quote size required on CME Globex. For BrokerTec orders, this will reflect the minimum initial order. | N | String | ALL | |
66 | minimumHalfTick | Description of half-tick behavior. | Y | Minimum Price Fluctuation | String | F&O |
67 | minimumTickNote | Footnote for minimum tick behaviors. | Y | Minimum Price Fluctuation | String | F&O |
68 | minIncrementalOrder | Minimum incremental order. | N | Integer | ALL | |
69 | minOutrightTick | Description of minimum tick for outrights. | Y | Minimum Price Fluctuation | String | F&O |
70 | minQtrlySerialTick | Description of minimum tick for Quarterly and serial products | Y | Minimum Price Fluctuation | String | F&O |
71 | negativePxEligible | Y/N flag to indicate if product may use negative book and trade prices | N | String | ALL | |
72 | negativeStrikeEligible | Y/N flag to indicate if options can be listed with a negative strike price. | N | String | F&O | |
73 | otcEligible | OTC Eligible products | N | String | F&O | |
74 | optStyle | Style of option: Future or Equity
| N | String | F&O | |
75 | parOrMoney | Collateral is valued with, or without, accrued interest, when being allocated. | N | String | BrokerTec | |
76 | priceBand | Price range enabled for order entry on CME Globex F&O as defined in the GCC Price Banding topic. Returns in a 19 character CME Globex format string. First character denotes the decimal by which value needs to move left. For example, 2000000000000001000 converts to 10.00. | N | String | ALL | |
77 | priceMultiplier | Multiplier to convert price to actual economic value. | N | Decimal | ALL | |
78 | priceQuotation | How price quotes are described on the website for the product. | Y | Price Quotation | String | F&O |
79 | productGuid | Unique product identifier | N | String | ALL | |
80 | productGuidInt | Unique product identifier in integer-only format. | N | Integer | ALL | |
81 | productName | Legal Product Name. For Combos, drill down to underlying products for a more accurate product name. For some weeklies, the legal product name will be the same for all related products. | N | String | ALL | |
82 | pxQuoteMethod | Defines the method for price quotes. | N | String | ALL | |
83 | pxUnitofMeasure | Defines the unit of measure of the price if different from the product. | N | String | ALL | |
84 | pxUnitofMeasureQty | Defines the unit of measure quantity of the price if different from the product. | N | Integer | ALL | |
85 | quarterlyListingRules | Describes the listing rule for quarterly products. | Y | Listed Contracts | String | F&O |
86 | reducedTickNotes | Description of when reduced ticks apply. | Y | Minimum Price Fluctuation | String | F&O |
87 | regularListingRules | Describes the standard product listing rule. | Y | Listed Contracts | String | F&O |
88 | reportablePositions | Links to the relevant information for reportable positions. | N | String | Under Development | |
89 | repoYearsDays | The number of days in year used in REPO consideration calculations. | N | String | BrokerTec | |
90 | rfqCrossEligible | Boolean flag to indicate if product is Cross eligible on CME Globex and requires an RFQ prior to Cross submission. | N | String | F&O BrokerTec (Under Development) | |
91 | sector | Sector associated with product. For example: Product E-mini S&P futures are in sector "US INDEX." For some products, such as combos, and products with a Btic underlying, the sector will be found at the underlying product level. Synthetic products will not have sector information. | N | String | ALL | |
92 | securityType | Type of derivative, e.g. FUT for future | N | String | ALL | |
93 | serialListingRules | Describes the listing rule for serial products. | Y | Listed Contracts | String | F&O |
94 | settlementAtExpiration | How settlement at expiration is handled. | Y | Settlement at Expiration | String | F&O |
95 | settlementProcedure | Methodology used to determine settlement. Links to a human-readable source. | Y | Settlement Procedures | String | F&O |
96 | settleMethod | Settlement Method. Indicates if product is financially or physically settled. Note: For Security type COMBO or OOC (Options On Combos) the settleMethod is defined on the underlying product and will be null for the spread or OOC. Valid values:
| Y | Settlement Method | String | F&O |
97 | settlePxCcy | The currency for the settlement price. | N | String | ALL | |
98 | settlementType | Type of settlement:
| N | String | ALL | |
99 | settleUsingFixingPx | Boolean flag to identify whether settled using fixed price ("Y", "N"). | N | String | F&O | |
100 | stdTradingHours | Website hours for CME Globex, Floor and CME ClearPort. The API concatenates the venue trading hours if there are multiple. Attribute is under development. | Y | Trading Hours | String | F&O |
101 | strategyType | Spread type code; used to understand spread construction, pricing, and leg price assignment. | N | String | ALL | |
102 | strikePriceInterval | Describes the strike price interval. Links to a human-readable source. | Y | Strike Price Listing Procedures | String | F&O |
103 | subFraction | Denominator of sub fraction for products priced in fractional terms, as detailed in the Fractional Pricing topic. E.g., a product that trades in 1/2 1/64ths will have "2" in this field. Will be sent with "null" for non-fractional products and for fractional products that do not have a sub-fraction. | N | String | ALL | |
104 | subSector | Sub-sector associated with product. For example: E-Mini S&P 500 futures are in sub-sector "SMALL CAP INDEX." | N | String | F&O | |
105 | subtype | Product sub type Note: Not all products will have subtype populated. | N | String | ALL | |
106 | totClearport | Termination of trading rules on the CME ClearPort venue. | Y | Termination of Trading | String | F&O |
107 | totDefault | Default termination of trading rules. | Y | Termination of Trading | String | F&O |
108 | totFloor | Termination of trading rules for the Floor venue. | Y | Termination of Trading | String | F&O |
109 | totGlobex | Termination of trading rules on the CME Globex venue. | Y | Termination of Trading | String | F&O |
110 | totLtd | Termination of trading rules which are applicable on the last trade date. | Y | Termination of Trading | String | F&O |
111 | totMidcurve | Termination of trading rules for midcurve products. | Y | Termination of Trading | String | F&O |
112 | totQuarterly | Termination of trading rules for quarterly products. | Y | Termination of Trading | String | F&O |
113 | totSerial | Termination of trading rules for serial products. | Y | Termination of Trading | String | F&O |
114 | tradePxCcy | The currency for the trade price. | N | String | ALL | |
115 | tradingCutOffTime | Cut off time for trading. | N | String Samples:
| F&O | |
116 | unitOfMeasure | Unit of measure for the product. For example, "IPNT" (Index Points) for E-mini S&P Futures. Unit of measure values are defined in the MDP 3.0 - Tag 996-UnitOfMeasure Table of Values. | N | String | ALL | |
117 | unitOfMeasureQty | Unit of measure quantity for the product. | N | String | ALL | |
118 | valuationMethod | Type of valuation method used Valid values:
| N | String | ALL | |
119 | varCabPxHigh | For non-CME Globex trades, option products may be negotiated in pure dollar terms between $1 and the varCabPxHigh value. The high price is always less than the premium value equivalent of the lowest standard tick. | N | String | F&O | |
120 | varCabPxLow | Lowest premium cabinet price the product is eligible to be traded at. | N | String | F&O | |
121 | variableQtyFlag | Y/N flag to indicate if instrument size varies from maturity to maturity. | N | String | F&O | |
122 | variableTickTable | Variable tick table for trading on CME Globex. | N | String | F&O | |
123 | rbtEligibleInd | Relationship Based Trading Eligibility Indicator. RBT eligible products are not eligible to trade on Globex. | N | BrokerTec | ||
124 | repoYearDays | The number of days in year used in REPO consideration calculations. 360 365 | N | String | BrokerTec | |
125 | dirtyPriceTick | This is the tick for the dirty price (price + accrued interest). Dirty price is used to value repo collateral. | N | Number | BrokerTec | |
126 | dirtyPriceRounding | Numerical codes to indicate rounding type. 0 (nearest) 1 (rounds up) 2 (rounds down) | N | Number | BrokerTec | |
127 | contractNotionalAmount | The currency amount of a single unit of the security. | N | Number | BrokerTec | |
128 | globexMatchAlgo | Match algorithm indicator for CME Globex markets.
Note: All other EBS Markets on CME Globex will use FIFO (F) match algorithm | N | String | ALL | |
129 | gcBasketIdentifier | CUSIP or ISIN of Repo Basket | N | String | BrokerTec | |
130 | spreadPricingConvention | Spread Pricing Convention Valid Values: Common - the contract would only be priced on a date when both legs are priced Non-Common - individual legs would continue to take the price for every applicable day, regardless if the other one did not have a good price for that day. | N | VARCHAR2 (20 Char) | ||
131 | onSef | Indicates if the instrument is SEF regulated.
| N | Boolean | EBS | |
132 | onMtf | Indicates if the instrument is MTF regulated.
| N | Boolean | EBS | |
133 | tradeCloseOffset | Fixing close offsets - Time duration before scheduled fixing time of the eFix Matching Service instrument. e.g. 00:05:30 to denote the 6:24:30 PM ET close for the 6:30 PM ET Fix. | N | HH:MM:SS | EBS | |
134 | pricePrecision | Specifies the price decimal precision for EBS instruments: For eFix Instruments – specifies the decimal precision of the assigned price when fixing rate applied to price found in iLink tag 6262 - BenchmarkPrice For non eFix Instruments – specifies the decimal precision of the order price assigned at the time of execution in iLink tag 1799 - OrderEventPx eFix Matching Service Post Trade messages are converted to underlying Spot CCY Pair. Due to differences in fixing prices from the pricing sources, trades resulting from the eFix Matching Service can be at a different price precision from the normal EBS Markets order book. | N | Integer | EBS | |
135 | settlementLocale | Settlement Location. Valid Values:
Only supported for Spot Precious Metals. | N | String | EBS | |
136 | fixingTimeZone | The region/time zone associated with the fixing time. | N | Char | EBS | |
137 | fixingSource | Fixing Rate Source. e.g. ABS | N | String | EBS | |
138 | goodForSessionEligible | Boolean flag (“Y”,”N”) to identify GFS (Good For Session) TimeInForce eligibility on CME Globex. | N | Boolean | EBS | |
139 | settlCcy | The base currency for the settlement price when different from local currency. The local currency price can be found in the settlePxCcy field. | N | String | EBS | |
140 | isEfixProduct | Boolean flag to identify eFix Matching Service (Y, N). | N | String | EBS | |
141 | Repeating Group | |||||
142 | marketData | Globex market data repeating group. The repeating group list the market data feedID, channelID and transport (UDP or TCP). Currently market data repeating groups is only supported on EBS markets when applicable. | N | String | EBS | |
143 | feedID | Globex market data feed id. | N | String | EBS | |
144 | channelID | Globex market data channel id. | N | String | EBS | |
145 | transport | Globex market data transport protocol (UDP or TCP). | N | String | EBS |
Instrument Attributes
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.
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 Label | Description | Found in Web Calendar Specifications? | Web Attribute Name | Type | Exchange |
---|---|---|---|---|---|---|
1 | 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 | |
2 | bilAccRejTimer | Bilateral accept reject timer - number of seconds. Post trade attibute only available via CME Reference Data API version 2. | N | Integer | BrokerTec | |
3 | clrAlias | Clearing alias | N | String | F&O | |
4 | cfiCode | CFI Codes in RD API match those used in clearing systems but will not necessarily match those used on Globex. | N | String | ALL | |
5 | couponDayCount | The convention used for accruing interest. Values include:
| N | String | BrokerTec | |
6 | couponFreqPeriod | Number of periods in a year. Data example is for a Semiannual coupon frequency unit. | N | Integer | BrokerTec | |
7 | couponFreqUnit | How often are there are coupon payments. | N | String | BrokerTec | |
8 | couponRate | The fixed rate at which a bond or loan pays out on a periodic basis (rate of interest * principal). | N | Integer | ALL | |
9 | couponType | Describes the type of interest payment such a discount, fixed, float, and variable. | N | String | BrokerTec | |
10 | cusip | US & Canadian externally registered security identifier. | N | String | BrokerTec | |
11 | 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 | |
12 | daysToMaturity | The number of calendar days between current exchange business day and the contract's final settlement date. | N | Number | F&O | |
13 | debtSecurityMaturity | The date the debt security matures. | N | Date Format: "YYYY-MM-DD" | BrokerTec | |
14 | endDate | Date a repo ends | N | Date | BrokerTec | |
15 | exchangeClearing | Query for all products by Exchange identifier used in the Post Trade Application. Valid Values
| N | String | ALL | |
16 | 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
| N | String | ALL | |
17 | exchBusinessDate | Exchange business date.
| N | Date | F&O | |
18 | finalSettlementDate | Final settlement date: Final settlement date for futures | Y | Settlement | Date Format: "YYYY-MM-DD" | F&O |
19 | firstDeliveryDate | First delivery date. The first date that users will complete delivery. Not applicable to financially settled instruments. | Y | First Delivery | Date Format: "YYYY-MM-DD" | F&O |
20 | 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. | Y | First Notice | Date Format: "YYYY-MM-DD" | F&O |
21 | firstIntDate | First position date. The first date on which CME Clearing will accept intents and run assignments for deliverable contracts. Not applicable to financially settled instruments. | Y | First Position | Date Format: "YYYY-MM-DD" | F&O |
22 | firstTradeDate | Clearing first trade date (actual contract trade date) | Y | First Trade | Date Format: "YYYY-MM-DD" | ALL |
23 | fisn | Financial instrument short name. Used for MiFid reporting. | N | String | BrokerTec | |
24 | flexIndicator | Y/N flag that indicates if instrument is Flex-defined. | N | String | F&O | |
25 | fnlInvDate | Final inventory date | N | Date Format: "YYYY-MM-DD" | F&O | |
26 | gbxAlias | CME Globex alias | N | String | ALL | |
27 | globexLastTradeDate | Last date instrument is tradable on CME Globex CLOB. | N | Date Format is in Central Time YYYYMMDDHHMMSS | ALL | |
28 | gcBasketIndentifier | Underlying cusip or isin for repo special | String | BrokerTec | ||
29 | globexFirstTradeDate | The calendar date when the instrument becomes tradable on CME Globex.
| N | Date Format is in Central Time YYYYMMDDHHMMSS | ALL | |
30 | 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 | String | ALL | |
31 | globexSecurityId | A unique identifier for each CME Globex instrument; same value as in tag 48-SecurityID on iLink and MDP. | N | String | ALL | |
32 | globexSymbol | CME Globex instrument product symbol. | N | String | ALL | |
33 | govBondType | Sub-category for government bonds. | String | BrokerTec | ||
34 | guid | Unique instrument identifier in alpha-numeric format. | N | String | ALL | |
35 | guidInt | Unique instrument identifier in integer format. | N | Integer | ALL | |
36 | initialInventoryDueDate | First inventory date also considered the First Holding Date. The date when CME Clearing will begin accepting position dates, where applicable, for deliverable contracts.
| N | Date Format: "YYYY-MM-DD" | F&O | |
37 | instrumentName | Human-readable instrument name for display purposes. | N | String | F&O | |
38 | isBticProduct | Boolean flag to identify whether the overlying product is a BTIC product ("Y", "N"). | N | String | F&O | |
39 | isSyntheticInstrument | Boolean flag to identify Synthetic instruments ("Y", "N"). | N | String | F&O | |
40 | isTamProduct | Boolean flag identifies whether the overlying product is a TAM product ("Y", "N"). | N | String | F&O | |
41 | isTasProduct | Boolean flag to identifies whether the overlying product is a TAS product ("Y", "N"). | N | String | F&O | |
42 | isin | European externally registered security identifier. | N | String | BrokerTec | |
43 | issueDate | This is the issue date (which is the first settlement date with the issuing counterparty). | N | Date Format: "YYYY-MM-DD" | BrokerTec | |
44 | issuerCountry | The country the issuer is domiciled in. The 2 character ISO code will be used. | N | String | BrokerTec | |
45 | issuerLei | Issuers Legal Entity ID | N | String | BrokerTec | |
46 | issuerLongName | The entity issuing the debt instrument. | N | String | BrokerTec | |
47 | issuerSubType | Sub category for assets | N | String | BrokerTec | |
48 | issuerType | The 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 | String | BrokerTec | |
49 | IsUserDefined | Identifies a Tailor-Made or UDI. UDS instruments (Under Development) | N | String | ALL | |
50 | itcAlias | ITC alias | N | String | ALL | |
51 | lastDeliveryDate | Last delivery date. The last date that users will complete delivery.
| Y | Last Delivery | Date Format: "YYYY-MM-DD" | F&O |
52 | lastEFPDate | Last EFP Date | N | Date Format: "YYYY-MM-DD" | F&O | |
53 | lastInventoryDueDate | Last 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 | |
54 | lastIntDate | Last intent date | N | Date Format: "YYYY-MM-DD" | ALL | |
55 | 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. | Y | Last Notice | Date Format: "YYYY-MM-DD" | F&O |
56 | lastTradeDate | Last date instrument is tradable across all venues and trade types | Y | Last Trade | Date Format: "YYYY-MM-DD" | ALL |
57 | lastUpdated | Timestamp from last time the instrument definition was touched:
| N | Date Format: YYYY-MM-DDThh:mm:ss.SSS+ZZZZ | ALL | |
58 | longName | BrokeTec - 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 | |
59 | 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 | Double | F&O | |
60 | originalContractSize | Sent for Decay-eligible instruments. Indicates the contract size before decay begins. | N | String | F&O | |
61 | positionRemovalDate | Position removal date. | N | Date Format: "YYYY-MM-DD" | ALL | |
62 | priceBand | Differential value for price bands on CME Globex. | N | String | F&O | |
63 | priceBandDl | Decimal locator for price band (priceBand). | N | String | F&O | |
64 | productGuidInt | Unique product identifier in integer-only format. | N | Integer | ALL | |
65 | putCallIndicator | Indicates whether an option instrument is a put or call. 0 - Put | N | String | F&O | |
66 | pxUomCcy | Price unit of measure currency | N | String | Under development | |
67 | repoTermCode | The 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 | String | BrokerTec | |
68 | settleDays | How many days after a trade the debt security settles. | N | Integer | BrokerTec | |
69 | settlementTick | Used when instruments settle in a smaller tick than they are traded at; this field supports the settlement tick. | N | Double | ALL | |
70 | spreadTick | Spread tick. Used for any spread where there is no “non-consecutive-month” spread tick. Only applicable to ClearPort contracts. | N | Double | F&O | |
71 | startDate | Date a repo starts | N | Date | BrokerTec | |
72 | strikePx | Strike price for an option. The option strike price format in RD APIv2 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 APIv2 Strike Price Format = 10.70 vs MDP 3.0 Security Definition Strike Price Format = 1070. | N | Double | F&O | |
73 | strikePxCcy | Strike price currency for an option. | N | String | F&O | |
74 | tccAlias | TCC alias | N | String | ALL | |
75 | tradeTick | Trade price tick. May differ from the settlementTick. | N | Double | ALL | |
76 | uomCcy | Unit of measure currency | N | String | ALL | |
77 | valuationMethod | Type of valuation method applied. Valid values:
| N | String | ALL | |
78 | vttHighTick | For some instruments, the tick is price dependent. This field defines the widest tick the instrument can trade at. | N | Double | F&O | |
79 | vttLowTick | For some instruments, the tick is price dependent. This field defines the smallest tick the instrument can trade at. | N | Double | F&O | |
80 | vttPriceThreshold | For some instruments, the tick is price dependent. This field defines the price threshold at which the minimum tick changes. | N | Double | F&O | |
81 | workupPrivateTimer | Where workup session are used, this would be the duration in seconds for the private phase. 0 (= Disabled) | N | Integer | BrokerTec | |
82 | workupPublicTimer | Where workup session are used, this would be the duration in seconds for the publicphase. 0 (= Disabled) | N | Integer | BrokerTec | |
83 | workupPublicTimerExt | Where workup session are used, this would be the duration in seconds for the extending the public phase. 0 (= Disabled) | N | Integer | BrokerTec | |
84 | zeroPriceEligible | Y/N flag to indicate if instrument may be quoted and/or traded at a zero price. | N | String | ALL | |
85 | maxSubstitionCnt | Number of substitutions allowed for the GC; 0 value will indicate the repo is not eligible for substitutions. Also called rights of substitution. | Integer | BrokerTec | ||
86 | instrumentType | Description of instrument type. | N | String | ALL | |
87 | settleMethod | Query for all products by settlement method. | Y | Settlement Method | String | F&O |
88 | priceRatio | Used for price calculation in spread and leg pricing for Implied Intercommodity Ratio | N | Number | F&O | |
89 | baseIndexType | Returned value represents base index name | N | Varchar (2) | BrokerTec | |
90 | minGlobexOrdQty | Minimum order or quote size required on CME Globex.
| N | String | ALL | |
91 | maxGlobexOrdQty | Maximum value allowed for a single quote or order on CME Globex.
| N | String | ALL | |
92 | minIncrementalOrder | Minimum incremental order quantity. | N | String | ALL | |
93 | minIntraGlobexOrdQty | MidSession value allowed for a single order. | N | String | BrokerTec | |
94 | maxIntraGlobexOrdQty | MidSession Maximum value allowed for a single order. | N | String | BrokerTec | |
95 | minIntraIncrementalOrder | MidSession Minimum incremental order. | N | String | BrokerTec | |
96 | minInitialOrder | Minimum initial order. | N | Integer | BrokerTec | |
97 | parValue | The par value of the bond. | N | Number | BrokerTec | |
98 | maxSubstitutionCnt | Number of substitutions allowed for the GC; 0 value will indicate the repo is not eligible for substitutions. | N | Integer | BrokerTec | |
99 | isAONInstrument | Boolean flag to identify AON instrument ("Y", "N"). | N | String | BrokerTec | |
100 | 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 | |
101 | firstCouponDate | The first coupon date of the debt maturity | N | Date Format: "YYYY-MM-DD" | BrokerTec | |
102 | allocationDeadline | 17:15:00 (for LCH German Special) | N | String | BrokerTec | |
103 | airAccruedFunding | The accrued funding value for this contract for the specified business date, to seven decimal places. | N | Number | ||
104 | airDailyFunding | Today’s contribution to that aggregate Accrued Funding value, likewise to seven decimal places. | N | Number | ||
105 | airBusinessDate | The business date to which these values pertain. | N | Date | ||
106 | airFundingStatus | An indicator which specifies whether these are the final or preliminary values for the specified business date. Valid values:
| N | VARCHAR2 | ||
107 | 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 | ||
108 | 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 | |
109 | exchangeClearing | Exchange identifier used in the CME Group Post Trade Application. | N | String | ALL | |
105 | Repeating Group | |||||
110 | bookDepth | Globex market data book depth repeating group. | N | String | ALL | |
111 | mdFeedType | Globex market data feed type. Describes a class of service for a given data feed.
| N | String | ALL | |
112 | marketDepth | Identifies the depth of book of the Globex market data feed type. | N | String | ALL | |
108 | Repeating Group | |||||
113 | clrSymbol | The product code used in CME Clearing for post-trade processing and back-office functions Example: “L1” | N | String | F&O | |
114 | trdgUnitPeriodMult | Transaction Size
Example: 22, 392 | N | Number | F&O | |
115 | transformationDate | Date of Transformation Example: “2021-06-01” | N | Date | F&O | |
116 | peakType | Peak Type Example: Peak, Off-Peak, Null | N | String | F&O | |
117 | transformedInstruments | Repeating Group listing the instruments trades are transformed into, using the Clearing product code Example: "JD 20210601”, “JD 20210602”... “JD 20210630" | N | String | F&O | |
118 | legID | Leg ID represents day of month Example: 1 - 31 | N | String | F&O | |
119 | daysHours | 1 Day or 1 - 24 Hours Example: “1”, “8” | N | String | F&O | |
120 | swapEffDate | Swap start date | N | N | Date Format: "YYYY-MM-DD" | F&O |
121 | maturityDate | Swap termination date | N | N | Date Format: "YYYY-MM-DD" | F&O |
122 | notionalPerContract | Notional amount per contract | N | N | Number | F&O |
123 | ctdCusip | Related treasury cusip | N | N | String | F&O |
124 | isEfixInstrument | Boolean flag to identify eFix Matching Service (Y, N). | N | Boolean | EBS | |
125 | 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 |
| Number | EBS |
126 | 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 Format | EBS |
127 | 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 | Integer | EBS | |
128 | fixingName | Name that includes the fixing source, time and location. Only for eFix Matching Service instruments. | N |
| String | EBS |
129 | fixingSourceLocalTime | The local time of the fixing source. | N | String | EBS | |
130 | 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
| N |
| String | EBS |
131 | maxSweepQty | The maximum quantity a Sweepable order may be submitted for in units of the instrument’s unitOfMeasureQty | N | String | EBS |
The information contained in the CME Reference Data API has been compiled by CME Group for the convenience of the user and is furnished without responsibility for accuracy or content. Although every attempt has been made to ensure the accuracy of this information, CME Group assumes no responsibility for any errors or omissions. It is accepted by the user on the condition that errors or omissions shall not be made the basis for any claim, demand or cause of action.
Product Retention Rules
The table below lists the instrument retention rules for expired, expired tradable and matured collateral available via CME Reference Data API version 2.
Product category | Instrument Retention Date | Available via CME Reference Data API Version 2 after the Retention Date |
---|---|---|
Futures and Options | Last delivery date for physically-delivered instruments. Settlement date for other instruments. | 5 days after the Last delivery date for physically-delivered instruments. 5 days after the Settlement date for other instruments. |
US Repo EU Repo GC Allocations | Equal to Repo END DATE | 14 days after End Date / Termination Date of the REPO. |
EGB | Instrument maturity date | 30 days after Trade Date or 14 days past maturity of the EGB (whichever is greater). |
Active US Treasuries | Active → OFTR transition date | Active → OFTR transition date. Note: Instrument will be maintained as non-tradeable collateral (OFTR) until 14 days after maturity |
Non-Tradeable Collateral | Instrument maturity date | 14 days after maturity date. |
CME Reference Data API Version 2 for EBS Market
For EBS on CME Group services, the product referential data is available on the CME Reference Data APIv2 for the following trading modes and platforms:
- EBS Market on CME Globex
- eFix Matching on CME Globex
- EBS Direct
EBS Referential Data Solutions
RD APIv2 vs MDP3
RD APIv2 is an Out-of-Band solution for comprehensive referential information, whereas MDP3 is an In-Band solution for critical dynamic information for trading on CME Globex. RD APIv2 includes referential information for EBS Market, eFix Matching Service, and EBS Direct at both the product and instrument level, whereas MDP3 supports instrument-level information only for EBS Market and eFix Matching Service.
Service | RD APIv2 | MDP3 |
---|---|---|
Trade Date to Settlement Date | Separate API with 10 business days of trade dates (full current week plus following week) | 10 business days included on Security Definition messages (current week plus following week). |
Ability to query for currency pairs across liquidity pools | Clients can query for currency pairs across:
| Not Supported |
Ability to query by venue type | Clients can query for currency pairs by venue type:
| Not Supported |
Products and Instrument Information | Product and Instrument information Relationship details (e.g., eFix to core currency pair) | Instrument information only |
Includes relationship definitions:
| EBS Market and eFix matching only - platform information includes:
| |
Ability to query for products by order duration eligibility is applicable | Good for session eligibility indicator Boolean flag (“Y”,”N”) to identify GFS (Good For Session) TimeInForce eligibility on CME Globex. | Not Supported |
Ability to identify the product Fixing Close Offset time | Fixing close offsets - Time duration before scheduled fixing time of the eFix Matching Service instrument. e.g. 00:05:30 to denote the 6:24:30 PM ET close for the 6:30 PM ET Fix. | Not Supported |
Availability to query for products by order duration | Good for session eligibility indicator Boolean flag (“Y”,”N”) to identify GFS (Good For Session) TimeInForce eligibility on CME Globex. | Not Supported |
Availability | Cloud service over the internet, available 24x7 | MDP service over production connectivity; available whenever CME Globex platform is available |
EBS Market Globex Group Code
Customers should note the Globex Group Code (globexGroupCode) at the Product level in the Reference Data API does not align with the Globex Group Code at the instrument level or in the MDP 3.0 Security Definition Message tag 1151-SecurityGroup.
Example: Globex Product and Group Codes published in Reference Data API
Product Name | Instrument Symbol | Product Level CME Globex Product Code (MDP 3.0 tag 6937-Asset) | Product Level CME Globex Group Code (Only available in Reference Data API) | Instrument Level CME Globex Group Code MDP 3.0 tag 1151-Security Group |
FXSPOT.USD/CAD WM_LN | USD/CAD WM 1600 LN | EW6EBP | ENW | NW160 |
FXSPOT.USD/SGD WM_LN | USD/SGD WM 1600 LN | EW6DSG | ELW | NW160 |
Globex Group Code - EBS eFix Matching Service Instruments: If the Globex Group Code value in the Product API service and Instrument API service are different, customers should use the value in the Instrument API service.
Product or Instrument | Attribute Name | Description | Type | Exchange |
---|---|---|---|---|
Product | globexGroupCode | CME Globex uses this group code to identify logical groupings of products. Note: For eFix this field will be different in the Instrument API | String | ALL |
Instrument | globexGroupCode | CME Globex uses this group code to identify logical groupings of products. Note: For eFix this field is different from Product API. | String | ALL |
EBS Trading Session Value Dates
Trading Session Value Dates is a separate API service call which provides the trade date to value date (date of settlement) mapping in a repeating Trade Session Group. Any additional information which will change for each trade date and/or value date will be included in the repeating group, e.g., dsbIsin for ON SEF/ON MTF NDFs, which is different for each different value date.
Sending Query Requests
The following request can be made using an OAuth authorized API ID and access token.
Client systems send Query Requests by invoking the HTTPS GET method to a URL of the form: v2/tradingSessionValueDates
EBS Trading Session Value Dates Attributes
Client systems can query the trading session value dates API service using any of the attribute query parameters noted as filter type.
Available Days
Attribute | Description | Type | Query Parameters | Query Description |
---|---|---|---|---|
instrumentguidInt | Unique instrument identifier in integer-only format. | Integer | Filter Type | Query for trade date to value date (date of settlement) mapping for a specific instrument. |
globexSymbol | CME Globex instrument symbol. | String | Filter Type | Query for trade date to value date (date of settlement) mapping for EBS Direct or EBS Markets on CME Globex for a specific CME Globex symbol. |
rbtEligibleInd | Boolean flag to identify eligibility for EBS Direct ("Y","N"). | String | Filter Type | Query for trade date to value date (date of settlement) mapping for EBS Direct. |
globexSecurityId | A unique identifier for each CME Globex instrument; same value as in tag 48-SecurityID on iLink and MDP. | String | Filter Type | Query for instrument by Security ID (MDP 3.0 tag 48-SecurityID). |
noTradingSessions | Repeating group for trading session value and/or settlement dates. | String | ||
tradeDate | Date of the Trade. | Date | ||
settlementDate |
| Date | ||
ndfFixingDate | NDF fixing (maturity) date. The NDF ndfFixingDate is not used nor linked in any way to the eFix Matching Service. | Date | ||
dsbIsin | ISIN value as provided by ANNA, Association of National Numbering Agencies. This field is populated for MTF-Regulated NDFs and is unique for each Settle Date. | String | ||
venueType | Venue Type
| String | Filter Type | Query for all trade dates by venue type |
ccyPair | Currency pair as listed in the instrument long name field. e.g. longName: "FXSPOT.EUR/USD" (EUR/USD) | String | Filter Type | Query for trade dates by currency pair using currency pair as listed in the instrument long name field. |
Example: Structure of Trading Session Value Dates Display.
tradingSessionValueDates | |||||
---|---|---|---|---|---|
instrumentguidInt | Unique instrument identifier in integer-only format. | ||||
globexSymbol | CME Globex instrument symbol. | ||||
rbtEligibleInd | Boolean flag to identify EBS Direct ("Y","N"). | ||||
globexSecurityId | A unique identifier for each CME Globex instrument; same value as in tag 48-SecurityID on iLink and MDP. | ||||
venueType | CLOB | ||||
ccyPair | USD/DKK | ||||
noTradingSessions | Repeating group for trading session value and/or settlement dates. | ||||
tradeDate | Date of the Trade | Date of the Trade | Date of the Trade | Date of the Trade | Date of the Trade |
settlementDate |
|
|
|
|
|
ndfFixingDate | NDF fixing (maturity) date | NDF fixing (maturity) date | NDF fixing (maturity) date | NDF fixing (maturity) date | NDF fixing (maturity) date |
dsbIsin | ISIN value as provided by ANNA | ISIN value as provided by ANNA | ISIN value as provided by ANNA | ISIN value as provided by ANNA | ISIN value as provided by ANNA |
Trade and Value Date Processing Examples
This section includes examples of how to obtain the trade date to settlement/value date for a variety of instrument types using the Trading Session Value Dates API service.
FXSPOT EUR/USD
In this example, there is a Trading Session Value Dates List for the current week starting on Sunday, March 21, 2021. A trading session list has been published for an FXSPOT EUR/USD instrument in Trading Session Value Dates API with the following information:
tradingSessionValueDates | |||||
---|---|---|---|---|---|
ccyPair | FXSPOT EUR/USD | ||||
Trade Session | |||||
tradeDate | 2021-03-22 (Monday) | 2021-03-23 (Tuesday) | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) |
settlementDate | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) | 2021-03-29 (Monday) | 2021-03-30 (Tuesday) |
eFix Matching Service FXSPOT EUR/USD WM 1500 LN
In this example, there is a Trading Session Value Dates List for the current week starting on Sunday, March 21, 2021. A trading session list has been published for an eFix Matching Service FXSPOT EUR/USD WM 1500 LN instrument in Trading Session Value Dates API with the following information:
tradingSessionValueDates | |||||
---|---|---|---|---|---|
ccyPair | eFIX Matching Service FXSPOT EUR/USD WM 1500 LN | ||||
Trade Session | |||||
tradeDate | 2021-03-22 (Monday) | 2021-03-23 (Tuesday) | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) |
settlementDate | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) | 2021-03-29 (Monday) | 2021-03-30 (Tuesday) |
Rolling FXNDF USD/CLP 1M SEF
In this example, there is a Trading Session Value Dates List for the current week starting on Sunday, March 21, 2021. A trading session list has been published for a Rolling FXNDF USD/CLP 1M SEF instrument in the Trading Session Value Dates API with the following information:
The ISIN (dsbIsin) is populated for MTF-Regulated NDFs and is unique for each Settlement Date
tradingSessionValueDates | |||||
---|---|---|---|---|---|
ccyPair | Rolling FXNDF USD/CLP 1M SEF | ||||
Trade Session | |||||
tradeDate | 2021-03-22 (Monday) | 2021-03-23 (Tuesday) | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) |
settlementDate | 2021-04-26 (Monday) | 2021-04-26 (Monday) | 2021-04-26 (Monday) | 2021-04-29 (Friday) | 2021-04-30 (Friday) |
ndfFixingDate | 2021-04-22 (Thursday) | 2021-04-22 (Thursday) | 2021-04-22 (Thursday) | 2021-04-27 (Tuesday) | 2021-04-28 (Tuesday) |
dsbIsin | EXXXXXXXXX20 | EXXXXXXXXX20 | EXXXXXXXXX20 | EXXXXXXXXX03 | EXXXXXXXXX09 |
Fixed Date FXNDF USD/INR EOM
In this example, there is a Trading Session Value Dates List for the current week starting on Sunday, March 21, 2021. A trading session list has been published for a Fixed Date FXNDF USD/INR EOM instrument in the Trading Session Value Dates API with the following information:
For Fixed Date NDFs Settlement (Value) Date, Fixing (Maturity) Date, and ISIN (where applicable) remain constant for all Trade Dates.
tradingSessionValueDates | |||||
---|---|---|---|---|---|
ccyPair | Fixed Date FXNDF USD/INR EOM March 2021 ON SEF | ||||
Trade Session | |||||
tradeDate | 2021-03-22 (Monday) | 2021-03-23 (Tuesday) | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) |
settlementDate | 2021-03-31 (Wednesday) | 2021-03-31 (Wednesday) | 2021-03-31 (Wednesday) | 2021-03-31 (Wednesday) | 2021-03-31 (Wednesday) |
ndfFixingDate | 2021-03-29 (Friday) | 2021-03-29 (Friday) | 2021-03-29 (Friday) | 2021-03-29 (Friday) | 2021-03-29 (Friday) |
dsbIsin | EXXXXXXXXX21 | EXXXXXXXXX21 | EXXXXXXXXX21 | EXXXXXXXXX21 | EXXXXXXXXX21 |
Available Days
RD APIv2 will maintain 10 business days (Monday - Friday) of trade date to value dates. The 10 business days consist of the current business week and the future business week. Clients should be aware if polling mid-week the results will contain past trade and settlement dates for the current week.
Example: Mid-Week Query
In this example there is a Trading Session Value Dates List for the current week starting on Sunday, March 21, 2021. A trading session list has been published for an FXSPOT EUR/USD. The client system sends a GET request at 8:00 am (CT) on Wednesday, March 24, 2021. The results returned will contain all business days for the current trading week.
tradingSessionValueDates | |||||
---|---|---|---|---|---|
ccyPair | FXSPOT EUR/USD | ||||
Trade Session | |||||
tradeDate | 2021-03-22 (Monday – Prior Trade Date) | 2021-03-23 (Tuesday – Prior Trade Date) | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) |
settlementDate | 2021-03-24 (Wednesday) | 2021-03-25 (Thursday) | 2021-03-26 (Friday) | 2021-03-29 (Monday) | 2021-03-30 (Tuesday) |