Globex Credit Controls API
The CME Globex Credit Controls (GC2) API provides pre-execution risk controls that enable Clearing Firm or Partner Exchange Clearing Firm risk administrators to set exposure limits for CME Globex order and trade activity cleared by CME Clearing. The Clearing firm or partner exchange Clearing firm risk administrators can choose a set of real-time actions to follow if specified limits are breached, including email notifications, order blocking, and order cancellation.
The GC2 API is a JSON (JavaScript Object Notation) Representation State Transfer (REST) API which provides REST endpoints (URLs) representing the HTTP methods GET request to retrieve records, POST request to create new records and PATCH requests to update existing records. The GC2 API authenticates risk administrators using OAuth 2.0 protocol.
Clearing Firm Risk administrators can use the GC2 API or application to manage risk.
For additional details about Globex Credit Controls, please refer to the User Help System.
Contents
Use this search bar to search topics within Globex Credit Controls API.
Onboarding
This GC2 API uses OAuth, an open protocol that supports secure authorization in a simple, standard method and decouples authentication from authorization. More details about OAuth API ID authorization and authentication are available in Client API Service Adoption using OAuth 2.0 Protocol.
To access the GC2 API, client API IDs must be assigned entitlements. To request access contact Global Account Management (GAM).
Connectivity
Clients can access the GC2 API over the internet, using the following URLs:
Service | Environment | Base URL |
|---|---|---|
CME Globex Credit Control (GC2) API over HTTPS | New Release | http://risk.api.uat.cmegroup.com/gc2/v1 |
Production | http://risk.api.cmegroup.com/gc2/v1 |
These URLs use certificates signed by an official trusted Certificate Authority (CA). Customers do not need to install additional certificates.
Testing and Certification
Client systems are required to certify in New Release before accessing the GC2 API in production.
For more information on testing and certification contact Certification Support for Electronic Trading (CSET).
Hours of Availability
See CME Group Trading Hours.
The GC2 API will be available in Production on a 24/7 basis .
CME Globex Credit Control (GC2) API Message Specifications
The GC2 API business message specifications are detailed below
The Path value with environment specific Base URL prefix will be a specific end point for the HTTPS GET/POST/PATCH calls.
Each HTTPS GET/POST/PATCH call must have the header parameter "Authorization" with value "Bearer" pre-pended to the OAuth token (including a space separator).
example: "Bearer <Oauth Access token>"
Name | Path | Method | Description |
|---|---|---|---|
/execution-firms | GET | Retrieves a list of Execution Firms GFIDs, optionally filtered by a Legal Clearing Entity (LCE) ID or a search term in the Firm description. | |
Get Exchange Group - Risk Limits - Utilizations - Alert Settings | /legal-clearing-entities/{legalClearingEntityId}/execution-firms/{gfid}/exchange-groups | GET | Retrieves all limits (including Exposure and Max Quantity), utilizations, and alert threshold settings by exchange group for a specific execution firm Globex Firm Identifier (GFID). |
/legal-clearing-entities | GET | Retrieves a list of all available LCEs who have at least one Execution Firm associated with them. |
Contact Information
For technical development support, contact Certification Support for Electronic Trading (CSET).
For production requests, please contact the Global Command Center (GCC).
For all other inquiries, please contact Global Account Management (GAM).