CME AMS API Inline Credit Controls Specifications

These specifications are for Inline Credit Controls. CME Direct and CME ClearPort specifications are located here.

Contents

1 User Firms and Services
2 Retrieve All Accounts
3 Retrieve Eligible Products for an Account
4 Limits and Utilization for an Account
- 4.1 GET Call
- 4.2 POST Call
5 Update an Account to Active or Inactive
6 Execution Firm Status
- 6.1 GET Call
- 6.2 POST Call

User Firms and Services

Returns results for all clearing firms, and Account management services that the customer has access to.

Method	GET
URL	_/v#/myFirms/
URL Parameters	None
Pagination Enabled?	No
HATOAS Links	Links to retrieve permissioned accounts by service: Retrieve CMED Accounts Retrieve CPC Accounts Retrieve ICC Accounts

Example Return Message for ICC

{
  "entitlements": [
    {
      "service": "CPC",
      "clearingFirms": [
        {
          "firmName": "GREENTEA_API_CLEARING2",
          "firmLongName": "GREENTEA_API_CLEARING2",
          "clearingId": "780"
        }
      ]
    },
    {
      "service": "CMED",
      "clearingFirms": [
        {
          "firmName": "GREENTEA_API_CLEARING2",
          "firmLongName": "GREENTEA_API_CLEARING2",
          "clearingId": "780"
        }
      ]
    },
    {
      "service": "ICC",
      "clearingFirms": [
        {
          "firmName": "GREENTEA_API_CLEARING2",
          "firmLongName": "GREENTEA_API_CLEARING2",
          "clearingId": "780"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "Retrieve CMED Accounts",
      "href": "Eligible Products and Permissioned Products for an Account/v#/accounts/clearing/CMED/GREENTEA_API_CLEARING2"
    },
    {
      "rel": "Retrieve CPC Accounts",
      "href": "_/v#/accounts/clearing/CPC/GREENTEA_API_CLEARING2"
    },
    {
      "rel": "Retrieve ICC Accounts",
      "href": "_/v#/accounts/clearing/ICC/GREENTEA_API_CLEARING2"
    }
  ]
}

Output Parameters

Output Parameters	Definition	Example	Supported Values	Data Types	Notes

Output Parameters	Definition	Example	Supported Values	Data Types	Notes
entitlements	Services and firms user has access to
service	Venue	CPC	CPC CMED ICC (Globex)	string
clearingFirms / fradingFirms	Contain clearing firm information on firms user has access to
firmName	Firm identifier	GREENTEA_API_CLEARING1		string	Unique
firmLongName	Firm identifier (firm long name)	GREENTEA_API_CLEARING1		string	Not unique
clearingId	Firm identifier	984		string	Unique
links	Links to navigate the site's REST interfaces dynamically			string

Return to top

Retrieve All Accounts

Retrieves all the accounts the user has access to for a specific service (venue), type (clearing) and clearing firm. Account owner and number are optional.

Method	GET
URL	_/v#/accounts/[Type]/[Service]/[Clearing Firm]/[Account Owner]/[Account Number]
Pagination Enabled?	Yes
HATEOAS Links	Links to retrieve all other account-related details: get accountLimitsUtilization get eligibleProducts get efStatus

Input Parameters

Input Parameters	Definition	Example	Required?	Supported Values	Data Types	Notes

Input Parameters	Definition	Example	Required?	Supported Values	Data Types
type	Clearing account	clearing	Yes	clearing	string
service	Venue	ICC	Yes	ICC	string
clearingFirm	Firm identifier	027	Yes		string
owner	Firm that owns the account (Uses it for trading)	Generic_trading	No		string
accountNumber	Number of the account	GT_12345	No		string

Example Return

{
    "service": "ICC",
    "counts": 31,
    "clearingAccounts": [
        {
            "clearingFirm": "GREENTEA_API_CLEARING1",
            "accountNumber": "CPCICCCOPY",
            "owner": "GREENTEA_API_TRADINGFIRM1",
            "segType": "C",
            "status": "Active",
            "ownerLongName": "GREENTEA_API_TRADINGFIRM1",
            "executionFirms": [
                {
                    "efId": "XX0",
                    "suspended": "N"
                }
            ],
            "links": [
                {
                    "rel": "self",
                    "href": "https://amsapinr.cmegroup.com/rest/v2/accounts/clearing/ICC/GREENTEA_API_CLEARING1?accountNumber=CPCICCCOPY"
                },
                {
                    "rel": "get accountLimitsUtilization",
                    "href": "https://amsapinr.cmegroup.com/rest/v2/accountLimitsUtilization/clearing/ICC/GREENTEA_API_CLEARING1/CPCICCCOPY"
                },
                {
                    "rel": "get eligibleProducts",
                    "href": "https://amsapinr.cmegroup.com/rest/v2/eligibleProducts/clearing/ICC/GREENTEA_API_CLEARING1/CPCICCCOPY"
                },
                {
                    "rel": "get efStatus",
                    "href": "https://amsapinr.cmegroup.com/rest/v2/efStatus/clearing/ICC/GREENTEA_API_CLEARING1/CPCICCCOPY"
                }
            ]
        }
]

Output Parameters

Output Parameters	Definition	Example	Supported Values	Data Types	Notes

Output Parameters	Definition	Example	Supported Values	Data Types	Notes
Service	Venue	ICC	ICC	string
counts	Number of accounts returned	2		number
type	Clearing account	clearingAccounts	clearingAccounts	string
id	Unique alias	A-7400		string
clearingFirm	Firm identifier	092		string
accountNumber	Number of the account	OTCFXACCT2		string
owner	Trading Firm Owner of the account	KRBroker7		string
segType	Account segregation. Customer or House	H	C H	string
status	Status of an account	active	active inactive closed	string
senderComp	CMED only: senderComp associated to an account specific to venue	2MG350		string	Only for Service CMED.
assetmanager	Asset Manager assigned to an account	ENERGY ACTIVE TRADERS		string	Optional field may or may not have a value.
executionFirms	List of execution Firms and suspended status			Execution firm and suspended information
efID	Execution Firm ID			String
suspended	Is Firm Suspended	N	N		Should always be N
links	Links to navigate the site's REST interfaces dynamically

Return to top

Retrieve Eligible Products for an Account

Retrieve all eligible products for a specific account, by venue.

Method	GET
URL	^{_/v#/eligibleProducts/[Type]/[Service]/[Clearing Firm]/[Account Number]}
Pagination Enabled?	Yes
HATEOAS Links	Links to available from Eligible Products call: get/update accountLimitsUtilization delete accountLimitsUtilization

Calls to the ICC service return eligible products per execution firm.

Input Parameters

Input Parameters	Defintion	Example	Required?	Supported Values	Data Types	Notes

Input Parameters	Defintion	Example	Required?	Supported Values	Data Types	Notes
type	Clearing account	clearing	Yes	clearing	string
service	Venue	ICC	Yes	ICC	string	One service at a time.
clearingFirm	Firm identifier	027	Yes		string
accountNumber	Number of the account	DG-41	Yes		string

Example Return Message

Supports products listed by execution firm.

{
  "service": "ICC",
  "clearingFirm": "GREENTEA_API_CLEARING2",
  "accountNumber": "DV10121801A",
  "products": [
    {
      "executionFirm": "XX0",
      "productList": [
        {
          "product": "GLB.FUT.CME",
          "productFullName": "ONE-MONTH SOFR FUTURES"
        },
        {
          "product": "L0A.OOC.CME",
          "productFullName": "1st contract back Live Cattle CSO"
        },
        {
          "product": "6Z.FUT.CME",
          "productFullName": "ZAR/USD FUTURES"
        },
        {
          "product": "RO.OOF.CME",
          "productFullName": "ZAR/USD OPTIONS AMER-STYLE"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "get/update accountLimitsUtilization",
      "href": "_/v#/accountLimitsUtilization/clearing/ICC/GREENTEA_API_CLEARING2/DV10121801A"
    },
    {
      "rel": "delete accountLimitsUtilization",
      "href": "_/v#/accountLimitsUtilization/clearing/ICC/GREENTEA_API_CLEARING2/DV10121801A?delete=true"
    }
  ],
  "limit": 50,
  "offset": 1,
  "availableOffsets": 1
}

Output Parameters

Output Parameters	Definition	Example	Supported Values	Data Types	Notes

Output Parameters	Definition	Example	Data Types
service	Venue	ICC	string
clearingFirm	Firm identifier	027	string
accountNumber	Number of the account	011	string
products	Indicates return of products for one or more services		String
executionFirm	Execution firm identifier for ICC	0OJ	string
productList	Encapsulates list of products	productList	string
product	Symbol.ProductType.Exchange	^GLB.FUT.CME	string
productFullName	Full name of product	^{ONE-MONTH SOFR FUTURES}	string
links	Information to navigate the site's REST interfaces dynamically: get/update accountLimitsUtilization delete accountLimitsUtilization		string

Return to top

Limits and Utilization for an Account

GET Call

Retrieves all limits and utilization for a specific account, by venue.

Method	GET
URL	^{_/v#/accountLimitsUtilization/[Type]/[Service]/[Clearing Firm]/[Account Number]}
Pagination Enabled?	Yes
HATOAS Links	Links available from an Account Limits Utilization call: get/update accountLimitsUtilization delete accountLimitsUtilization
Notes	Products with unlimited long / short limits with utilization in the current business day will be included. Products with unlimited long / short limits without utilization in the current business day will be excluded.

Input Parameters

Example Return Messages

Output Parameters

POST Call

Update, add or delete account limits using the accountsLimitsUtilization POST call.

To post a delete, append the call with ?delete=true
When Request body is submitted for Limits Update (Post) or Delete - usage field is ignored, it cannot be updated

Method	POST
Function	Update or Delete Limits for an Account
URL	_/v#/accountLimitsUtilization/[Type]/[Service]/[Clearing Firm]/[Account Number]
Pagination Enabled?	No
HATOAS Links	Links available from an Account Limits Utilization query:: get/update accountLimitsUtilization delete accountLimitsUtilization

Input Parameters

Examples

POST calls require a body that contains the update information. A request call can be used to retrieve related information, and then the return can be modified and used as the body for the POST call.

Updating and deleting account limits are permitted for Inline Credit Controls.

Example call and return for an update

This example shows an update to the limits utilization for a product.

1) GET Call: /_/v#/accountLimitsUtilization/[Type]/[Service]/[Clearing Firm]/[Account Number]

Query used: /_/v#/accountLimitsUtilization/clearing/ICC/77777/TESTPOST

Return message from call:

2) Utilize the return as the body for the Post call. For example, for product "CJ.FUT.NYME", update EF short limit from 567 to 600.

Only the modified record is required:

Sample Post Body:

3) POST Call: Use the same URL as in (1), and use the modified request as the POST body, in JSON format.

Return message from post call should include all information:

Return to top

Update an Account to Active or Inactive

Method	POST
URL	_/v#/status/[Type]/[Clearing Firm]
Pagination Enabled?	No

Input Parameters

Example: Update an Account to Active or Inactive

Account Information Before Update

Clearing Firm account information only, as shown in a "Retrieve all Accounts" call.

Input body for POST to update status to Active or Inactive

Successful Return Message

Account information after update

Output parameters will be account parameters with updated status. Status is now "Inactive."

Return to top

Execution Firm Status

GET Call

Retrieve status (suspended = "Y" or "N") for a Clearing Firm's execution firms.

Method	GET
URL	^{_/v#/efStatus/[Type]/[Service]/[Clearing Firm]/[Account Number]}
Pagination Enabled?	Yes
HATEOAS Links	Links to available from Execution Firm Status call: get accounts

Input Parameters

Example Return Message

Supports execution firm status.

Output Parameters

Return to top

POST Call

Update status (suspended = "Y" or "N") for one or more of a Clearing Firm's execution firms. If suspended, an account cannot trade.

Method	POST
URL	^{_/v#/efStatus/[Type]/[Service]/[Clearing Firm]/[Account Number]}
Pagination Enabled?	Yes
HATEOAS Links	Links to available from Execution Firm Status call: get accounts

Input Parameters

Account Information Before Update

Return with Execution Firms and suspended status.

Input body for POST to update status to Active or Inactive

Successful Return Message

Return to top