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

Input Parameters	Definition	Example	Required?	Supported Values	Data Types	Notes

Input Parameters	Definition	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
Clearing Firm	Firm identifier	027	Yes		string
Account Number	Number of the account	011	Yes		string
tradable	Retrieve limit utilization for tradable products	true	No	true false	string	When called with tradable=true, any products with limits, that are no longer tradable for the account are filtered out. If not supplied, this defaults to false.
nonZeroLimits	Filter products with 0 (zero) limits	true	No	true false	string	If nonZeroLimits=true, then any products that have 0 limits will be filtered out.

Example Return Messages

{
    "service": "ICC",
    "clearingFirm": "GREENTEA_API_CLEARING2",
    "accountNumber": "DV10121801A",
   "limits": [
        {
            "product": "CJ.FUT.NYMEX",
            "productFullName": "NYMEX Cocoa Futures ",
            "efId": "3N1",
            "efLimits": {
                "short": 567,
                "long": 324
            },
            "cmfLimits": {
                "short": 2000,
                "long": 9000
            }
        },
        {
            "product": "CJ.FUT.NYMEX",
            "productFullName": "NYMEX Cocoa Futures ",
            "efId": "350",
            "efLimits": {
                "short": 456,
                "long": 123
            },
            "cmfLimits": {
                "short": 30989,
                "long": 1000
            }
        },
        {
            "product": "DRS.FUT.CBT",
            "productFullName": "Bloomberg Roll Select Commodity Index Futures",
            "efId": "350",
            "efLimits": {
                "short": 789,
                "long": 456
            },
            "cmfLimits": {
                "short": 120,
                "long": 120
            }
        }
    ],
    "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"
        }
    ]
}

Output Parameters

Output Parameters	Definition	Example	Supported Values	Data Types	Notes

Output Parameters	Definition	Example	Supported Values	Data Types	Notes
service	Venue	CPC	ICC	string
clearingFirm	Firm identifier	027		string
accountNumber	Number of the account	011		string
limits	Returns limits information by credit control type	limits		string
product	Symbol.ProductType.Exchange	GIE.FUT.CME		string	Also used with Span Limit.
productFullName	Full name of product	GSCI ER FUTURES		string