Viewing or Changing Risk Rules

The Customer Web Portal and Secure Web API will support the download of currently effective risk rules for either the current trading date or the next trading date. In addition, the tool will allow privileged users to upload new rules to be applied effective immediately (via Web Portal only) or for the next trading date (via Web Portal or Web API). The cutoff for the next trading date is 6:30 a.m. ET for BYX/EDGA and 3:30 a.m. ET for BZX/EDGX. Effective 12/07/26, the EDGX cutoff for the next trading date will be 8:30 p.m. ET. For example, a change uploaded for BZX at 2:00 a.m. ET on Tuesday will be effective for trading on Tuesday if the option to apply on the next trading date is selected.

The file format used for uploading a new profile or downloading a copy of an active file is identical. Each line of the file represents a rule containing a comma separated list of fields. An example file is provided within the Customer Web Portal Risk Management tool. The file format for Equities is defined below.

Mpid, limit_type, symbol, limit_value, risk_group_id, reject_behavior

Table 1. Viewing or Changing Risk Rules
ParameterDescription
mpid Specifices the MPID to which the risk setting applies. A valid MPID must be included and the firm must have control of the MPID.
limit_type
  • The limit type must be one of the following values:
  • abs_ntnl - Absolute Gross Notional
  • abs_nntnl - Absolute Net Notional
  • agg_gcdt - Aggregated Gross Credit
  • agg_ncdt - Aggregated Net Credit
symbolNot supported. Must be blank.
limit_valueThis value must be an integer value. Floating point values are not accepted. When the limit type is a notional type, this represents whole dollars.
risk_group_id*Optional field, integer 1-65535. Used to specify a risk group for an MPID.
reject_behavior*
  • rej_cncl (resting orders are cancelled and inbound orders are rejected) or
  • rej_only (resting orders are not cancelled and inbound orders are rejected)
  • If not specified, rej_cncl is default.
  • Please note that only one reject_behavior per limit_type is allowed.

*Optional parameter

Cboe Titanium U.S. Equities Risk Management Specification - Viewing or Changing Risk Rules | Cboe