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 GME 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

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

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

  • All products requested: Request Type (ReqTyp) = 100

  • Exchange = "CME"

 <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

  • Exchange = "NYMEX"

  • Security Type = "FUT"



 <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)

  • :Exchange = "CBT"

  • Security Type = "OOF"

  • Security ID = "ZC"

  • Src = "H"

Futures Maturity Request

Request Type

Description

Examples

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

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

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:

  • Product Exchange, Security Type, and Security ID (w/ source code H)

  • Product Exchange, Security Type, Security ID (w/ source code H).and Maturity Month

With Maturity Date:




How was your Client Systems Wiki Experience? Submit Feedback

Copyright © 2024 CME Group Inc. All rights reserved.