Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt
hiddenfalse

Submit mass order cancel request.


Style
.wiki-content .columnLayout .cell.aside {width:400px;}



Panel
borderColorlightgray


Page Properties


URL/order/cancel-mass
HTTP MethodPUT
Version2.0.0




Panel
borderColorlightgray
titleBGColorwhitesmoke
titleContents
Table of Contents
maxLevel3


Request

Body

RefFieldNameData TypeValuesUsageDescription
1header
2→ applicationNameApplication NameString
REQUIRED

Identifies the application generating the message.

3→ applicationVendorApplication VendorString
REQUIRED

Identifies the vendor of the application generating the message.

4→ applicationVersionApplication VersionString
REQUIRED

Identifies the version of the application generating the message.

5→ requestIdRequest IDString
REQUIRED

A unique identifier for the request provided by the client for correlation.

6→ sentTimeSent TimeDateTime
REQUIRED

Timestamp of the message leaving the producing application.

7payload
8→ customerAccountIdCustomer Account IDString
  • Length: 1 - 12
REQUIRED

Support for single Customer Account ID is offered today

9→ durationTypeDuration TypeOrderDurationType
  • DAY DAY (Day) - Order expires at the end of the trading day.
  • GOOD_TILL_CANCEL CANCEL (Good till Cancel) - Order remains working until cancelled
  • GOOD_TILL_DATE DATE (Good till Date) - Order remains working until the end of the trading session of the local market date specified in the ExpirationDate field.
OPTIONAL
10→ entityScopeEntity ScopeOrderEntityScope
  • CUSTOMER_ACCOUNT ACCOUNT (Customer Account)
  • OPERATOR OPERATOR (Operator)
OPTIONAL
11→ executingFirmIdExecuting Firm IDString
  • Length: 1 - 10
REQUIRED

Support for single Executing Firm ID is offered today

12→ glbxGroupIdGlobex Group IDString
CONDITIONAL

Support for single Globex Group ID is offered today

Criteria
  • ALWAYS when payloadwhen payload.instrumentScope = PRODUCT_GROUP
13→ glbxSecurityIdGlobex Security IDInteger
CONDITIONAL

Support for single Globex Security ID is offered today

Criteria
  • ALWAYS when payloadwhen payload.instrumentScope = INSTRUMENT
14→ instrumentScopeInstrument ScopeOrderInstrumentScope
  • ALL ALL (All)
  • INSTRUMENT INSTRUMENT (Instrument)
  • MARKET_SEGMENT SEGMENT (Market Segment)
  • PRODUCT_GROUP GROUP (Product Group)
REQUIRED

Support for Instrument Scope == ALL will be extended to the API in Q4 2023

15→ manualIndManual IndicatorYesNoIndicator
  • NO NO (No) - No
  • YES YES (Yes) - Yes
REQUIRED

Indicates whether the order was generated by automated trading logic.

16→ marketSegmentIdMarket Segment IDInteger
CONDITIONAL

Support for single Market Segment ID is offered today

Criteria
  • ALWAYS when payloadwhen payload.instrumentScope = MARKET_SEGMENT
17→ operatorIdOperator IDString
  • Length: 1 - 18
REQUIRED

Support for single Operator ID is offered today

18→ senderCountrySender CountryString
  • Length: 1 - 2
REQUIRED
19→ senderStateSender StateString
  • Length: 2 - 2
OPTIONAL
20→ sideIndSide IndicatorMarketSideIndicator
  • BUY BUY (Buy) - Identifies a buy side order
  • CROSS CROSS (Cross)
  • SELL SELL (Sell) - Identifies a sell side order
OPTIONAL
21→ typeTypeOrderType
  • LIMIT LIMIT (Limit) - A Limit order defines the upper price limit at which to buy an instrument and lower price limit at which to sell an instrument. The price limit is defined in the Price field. If the price is not immediately available, the Limit order will rest until filled or cancelled.
  • STOP_LIMIT LIMIT (Stop Limit) - A Stop order is an order which, when accepted, does not immediately go on the book, but must be "triggered" by a trade in the market at the price level submitted with the order. A Stop-Limit order goes on the book as a Limit order once triggered.
OPTIONAL

Response - 200

Body

RefFieldNameData TypeValuesUsageDescription
1header
2→ reportIdReport IDstring
ALWAYS
3→ requestIdRequest IDstring
ALWAYS

A unique identifier for the request provided by the client for correlation.

4→ responseCountResponse Countint32
ALWAYS
5→ responseLastFragmentIndResponse Last Fragment IndicatoryesNoIndicator
  • NO NO (No) - No
  • YES YES (Yes) - Yes
OPTIONAL
6→ sentTimeSent TimedateTime
ALWAYS

Timestamp of the message leaving the producing application.

7payload
8→ actionActionorderAction
  • CANCEL_MASS MASS (Mass Cancel)
ALWAYS
9→ durationTypeDuration TypeorderDurationType
  • DAY DAY (Day) - Order expires at the end of the trading day.
  • FILL_AND_KILL KILL (Fill and Kill) - Order is immediately executed against any available quantity and any remaining quantity is eliminated
  • FILL_OR_KILL KILL (Fill or Kill) - Order is filled completely or else eliminated
  • GOOD_TILL_CANCEL CANCEL (Good till Cancel) - Order remains working until cancelled
  • GOOD_TILL_DATE DATE (Good till Date) - Order remains working until the end of the trading session of the local market date specified in the ExpirationDate field.
OPTIONAL
10→ manualIndManual IndicatoryesNoIndicator
  • NO NO (No) - No
  • YES YES (Yes) - Yes
ALWAYS

Indicates whether the order was generated by automated trading logic.

11→ marketSegmentIdMarket Segment IDint32
OPTIONAL

ALWAYS when Instrument Scope in (MARKET_SEGMENT, ALL)

12→ orderKeys[]
13→ → canceledQtyIntCanceled Quantity Intint32
ALWAYS
14→ → customerOrderIdCustomer Order IDstring
ALWAYS
15→ → venueOrderIdVenue Order IDstring
ALWAYS
16→ senderCountrySender Countrystring
ALWAYS
17→ senderStateSender Statestring
OPTIONAL
18→ sideIndSide IndicatormarketSideIndicator
  • BUY BUY (Buy) - Identifies a buy side order
  • CROSS CROSS (Cross)
  • SELL SELL (Sell) - Identifies a sell side order
OPTIONAL
19→ transactionTimeTransaction TimedateTime
ALWAYS
20→ typeTypeorderType
  • LIMIT LIMIT (Limit) - A Limit order defines the upper price limit at which to buy an instrument and lower price limit at which to sell an instrument. The price limit is defined in the Price field. If the price is not immediately available, the Limit order will rest until filled or cancelled.
  • MARKET MARKET (Market) - A Market order with protection is filled within a pre-defined range of prices referred to as the protected range. For buy orders, protection points are added to the current best offer price to calculate the protection price limit. For sell orders, protection points are subtracted from the current best bid price.
  • MARKET_TO_LIMIT LIMIT (Market to Limit) - A Market-limit order is executed at the best price available in the market. If the market-limit order can only be partially filled, the order becomes a limit order and the remaining quantity remains on the order book at the specified limit price.
  • STOP STOP (Stop) - A Stop order is an order which, when accepted, does not immediately go on the book, but must be "triggered" by a trade in the market at the price level submitted with the order. A Stop order goes on the book as a Market order once triggered.
  • STOP_LIMIT LIMIT (Stop Limit) - A Stop order is an order which, when accepted, does not immediately go on the book, but must be "triggered" by a trade in the market at the price level submitted with the order. A Stop-Limit order goes on the book as a Limit order once triggered.
OPTIONAL

Response - 400

Body

RefFieldNameData TypeValuesUsageDescription
1errors[]
2→ codeCodestring
  • 1 - {Unclassified error message}
  • 100 100 - Request is invalid: {Error Message}
  • 101 101 - {Field} is not present
  • 102 102 - {Field} has an incorrect value: {Value}
  • 103 103 - {Field} is invalid
ALWAYS
3→ messageMessagestring
ALWAYS
4header
5→ requestIdRequest IDstring
ALWAYS

A unique identifier for the request provided by the client for correlation.

6→ sentTimeSent TimedateTime
ALWAYS

Timestamp of the message leaving the producing application.

Response - 403

Body

RefFieldNameData TypeValuesUsageDescription
1errors[]
2→ codeCodestring
  • 1 - {Unclassified error message}
  • 100 100 - Request is invalid: {Error Message}
  • 101 101 - {Field} is not present
  • 102 102 - {Field} has an incorrect value: {Value}
  • 103 103 - {Field} is invalid
ALWAYS
3→ messageMessagestring
ALWAYS
4header
5→ requestIdRequest IDstring
ALWAYS

A unique identifier for the request provided by the client for correlation.

6→ sentTimeSent TimedateTime
ALWAYS

Timestamp of the message leaving the producing application.

Response - 500

Body

RefFieldNameData TypeValuesUsageDescription
1errors[]
2→ codeCodestring
  • 1 - {Unclassified error message}
  • 100 100 - Request is invalid: {Error Message}
  • 101 101 - {Field} is not present
  • 102 102 - {Field} has an incorrect value: {Value}
  • 103 103 - {Field} is invalid
ALWAYS
3→ messageMessagestring
ALWAYS
4→ referenceFieldReference Fieldstring
OPTIONAL
5header
6→ requestIdRequest IDstring
ALWAYS

A unique identifier for the request provided by the client for correlation.

7→ sentTimeSent TimedateTime
ALWAYS

Timestamp of the message leaving the producing application.

8payload[]
9→ transactionTimeTransaction TimedateTime
OPTIONAL