Product Reference Data
In order to populate the trade submission requests, all clients must retrieve the reference data necessary to enter the correct proprietary values into the appropriate FIXML elements.
To obtain product reference data MQ Series clients must use the FIXML Product Reference Files (FPRF) generated daily by CME Group. The data will be loaded daily for all products across the NYMEX, COMEX, CME, CBOT, and DME exchanges. The FPRF provides a complete list of all contracts for all products.
Find the FPRF files located on the CME Public FTP server at ftp://ftp.cmegroup.com/fprf/.
HTTP clients can use FPRF or Request/Response methods over CME ClearPort API.
Any user wishing to obtain a complete list of all contracts should use the FPRF.
See Also
Request/Response Method
CME ClearPort API provides various request and response methods to retrieve product reference data. Each request type using the FIXML Security Definition Request message has its own predefined Request Type (ReqTyp) number.
Clients must specify a Request ID on each request, which clients must use to uniquely identify the response to its specific request.
All Contract Month or Option Series Requests must include a SecurityID (e.g ID=”CL”) specifying the product.
The API supports the creation of dynamic strike prices for certain options (eligible products are identified by ListMeth=”1”), which are available on subsequent downloads.
Message Specification
Message Type | FIXML Abbreviation | Description |
|---|---|---|
Security Definition Request | SecDefReq | Sent by submitter to obtain a complete list of products, futures contracts for a particular product, options series for a particular product, or synthetic spreads (underlying Options on Combos). |
Derivative Security List Request | DevSecListReq | Sent by submitter to obtain a list of options strikes for a specific options series. |
Security Definition | SecDef | Response for Security Definition Request. |
Derivative Security List | DerivSecList | Response for Derivative Security List Request. |
Request Types
Product Request
Request Type | Description | Examples |
|---|---|---|
Product Request - no filter | All products requested: Request Type (ReqTyp) = 100 | FIXML v="5.0 SP2" xv="109" s="20090815" cv="CME.0001">
<SecDefReq ReqID="123412" ReqTyp="100">
<Hdr SID="BRKR" SSub="user123" TID="CME" TSub="CPAPI"/>
</SecDefReq>
</FIXML> |
Filter by Product Exchange |
| <FIXML v="5.0 SP2" xv="109" s="20090815" cv="CME.0001">
<SecDefReq ReqID="123443" ReqTyp="100">
<Hdr SID="PLTFM" SSub="user789" TID="CME" TSub="CPAPI"/>
<Instrmt Exch="CME"/>
</SecDefReq>
</FIXML> |
Filter by Product Exchange and Security Type |
| <FIXML v="5.0 SP2" xv="109" s="20090815" cv="CME.0001">
<SecDefReq ReqID="123477" ReqTyp="100">
<Hdr SID="BRKR" SSub="user123" TID="CME" TSub="CPAPI"/>
<Instrmt Exch="NYMEX" SecTyp="FUT"/>
</SecDefReq>
</FIXML> |
Filter by Product Exchange, Security Type and Security ID (w/ source code H) |
|
Futures Maturity Request
Request Type | Description | Examples |
|---|---|---|
Request for all futures contracts | The Request Type (ReqTyp) number for the list of Futures contracts with product family information request is 103. Filters on Product Exchange, Security Type, and Security ID (w/ source code H). | |
Request for all futures contracts - no product information | The Request Type (ReqTyp) number for the list of Futures contracts without product family information request is 104. Filters on Product Exchange, Security Type, and Security ID (w/ source code H). | |
Request for all futures contracts with maturity month | A request for product family information for the specified futures contract. Filters on Product Exchange, Security Type, Security ID (w/ source code H) and Maturity Month. | |
Request for all futures contracts with maturity month and no product information | A request for the specified futures contract without product family information (basically a check that the contract is valid). Filters on Product Exchange, Security Type, Security ID (w/ source code H) and Maturity Month. |
Option Series Request
Request Type | Description | Examples |
|---|---|---|
Options Series with product family information | The Request Type (ReqTyp) number for the list of Options Series with product family information request is 101. Security type indicates an option. | |
Options Series without product family information | The Request Type (ReqTyp) number for the list of Options Series without product family information request is 102. Security type indicates an option. |
Spread Request
Request Type | Description | Examples |
|---|---|---|
Spread Request | Allows clients to request a list of synthetic spreads that are underlyings for Options on Combos.The Request Type (ReqTyp) number for the synthetic spread request type is 105. Filter options:
| With Maturity Date: |
How was your Client Systems Wiki Experience? Submit Feedback
Copyright © 2024 CME Group Inc. All rights reserved.