Order Entry API V2 - Mass Order Cancel

1

header

2

→ applicationName

Application Name

String

Identifies the application generating the message.

3

→ applicationVendor

Application Vendor

String

Identifies the vendor of the application generating the message.

4

→ applicationVersion

Application Version

String

Identifies the version of the application generating the message.

5

→ requestId

Request ID

String

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

6

→ sentTime

Sent Time

DateTime

Timestamp of the message leaving the producing application.

7

payload

8

→ customerAccountId

Customer Account ID

String

• Length: 1 - 12

Support for single Customer Account ID is offered today

9

→ durationType

Duration Type

OrderDurationType

• DAY (Day) - Order expires at the end of the trading day.

• GOOD_TILL_CANCEL (Good till Cancel) - Order remains working until cancelled

• GOOD_TILL_DATE (Good till Date) - Order remains working until the end of the trading session of the local market date specified in the ExpirationDate field.

10

→ entityScope

Entity Scope

OrderEntityScope

• CUSTOMER_ACCOUNT (Customer Account)

• OPERATOR (Operator)

11

→ executingFirmId

Executing Firm ID

String

• Length: 1 - 10

Support for single Executing Firm ID is offered today

12

→ glbxGroupId

Globex Group ID

String

Support for single Globex Group ID is offered today

Criteria

• ALWAYS when payload.instrumentScope = PRODUCT_GROUP

13

→ glbxSecurityId

Globex Security ID

Integer

Support for single Globex Security ID is offered today

Criteria

• ALWAYS when payload.instrumentScope = INSTRUMENT

14

→ instrumentScope

Instrument Scope

OrderInstrumentScope

• ALL (All)

• INSTRUMENT (Instrument)

• MARKET_SEGMENT (Market Segment)

• PRODUCT_GROUP (Product Group)

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

15

→ manualInd

Manual Indicator

YesNoIndicator

• NO (No) - No

• YES (Yes) - Yes

Indicates whether the order was generated by automated trading logic.

16

→ marketSegmentId

Market Segment ID

Integer

Support for single Market Segment ID is offered today

Criteria

• ALWAYS when payload.instrumentScope = MARKET_SEGMENT

17

→ operatorId

Operator ID

String

• Length: 1 - 18

Support for single Operator ID is offered today

18

→ senderCountry

Sender Country

String

• Length: 1 - 2

19

→ senderState

Sender State

String

• Length: 2 - 2

20

→ sideInd

Side Indicator

MarketSideIndicator

• BUY (Buy) - Identifies a buy side order

• CROSS (Cross)

• SELL (Sell) - Identifies a sell side order

21

→ type

Type

OrderType

• 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 (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.

1

header

2

→ reportId

Report ID

string

3

→ requestId

Request ID

string

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

4

→ responseCount

Response Count

int32

5

→ responseLastFragmentInd

Response Last Fragment Indicator

yesNoIndicator

• NO (No) - No

• YES (Yes) - Yes

6

→ sentTime

Sent Time

dateTime

Timestamp of the message leaving the producing application.

7

payload

8

→ action

Action

orderAction

• CANCEL_MASS (Mass Cancel)

9

→ durationType

Duration Type

orderDurationType

• DAY (Day) - Order expires at the end of the trading day.

• FILL_AND_KILL (Fill and Kill) - Order is immediately executed against any available quantity and any remaining quantity is eliminated

• FILL_OR_KILL (Fill or Kill) - Order is filled completely or else eliminated

• GOOD_TILL_CANCEL (Good till Cancel) - Order remains working until cancelled

• GOOD_TILL_DATE (Good till Date) - Order remains working until the end of the trading session of the local market date specified in the ExpirationDate field.

10

→ manualInd

Manual Indicator

yesNoIndicator

• NO (No) - No

• YES (Yes) - Yes

Indicates whether the order was generated by automated trading logic.

11

→ marketSegmentId

Market Segment ID

int32

ALWAYS when Instrument Scope in (MARKET_SEGMENT, ALL)

12

→ orderKeys[]

13

→ → canceledQtyInt

Canceled Quantity Int

int32

14

→ → customerOrderId

Customer Order ID

string

15

→ → venueOrderId

Venue Order ID

string

16

→ senderCountry

Sender Country

string

17

→ senderState

Sender State

string

18

→ sideInd

Side Indicator

marketSideIndicator

• BUY (Buy) - Identifies a buy side order

• CROSS (Cross)

• SELL (Sell) - Identifies a sell side order

19

→ transactionTime

Transaction Time

dateTime

20

→ type

Type

orderType

• 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) - 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 (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) - 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 (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.

1

errors[]

2

→ code

Code

string

• 1 - {Unclassified error message}

• 100 - Request is invalid: {Error Message}

• 101 - {Field} is not present

• 102 - {Field} has an incorrect value: {Value}

• 103 - {Field} is invalid

3

→ message

Message

string

4

header

5

→ requestId

Request ID

string

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

6

→ sentTime

Sent Time

dateTime

Timestamp of the message leaving the producing application.

1

errors[]

2

→ code

Code

string

• 1 - {Unclassified error message}

• 100 - Request is invalid: {Error Message}

• 101 - {Field} is not present

• 102 - {Field} has an incorrect value: {Value}

• 103 - {Field} is invalid

3

→ message

Message

string

4

header

5

→ requestId

Request ID

string

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

6

→ sentTime

Sent Time

dateTime

Timestamp of the message leaving the producing application.

1

errors[]

2

→ code

Code

string

• 1 - {Unclassified error message}

• 100 - Request is invalid: {Error Message}

• 101 - {Field} is not present

• 102 - {Field} has an incorrect value: {Value}

• 103 - {Field} is invalid

3

→ message

Message

string

4

→ referenceField

Reference Field

string

5

header

6

→ requestId

Request ID

string

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

7

→ sentTime

Sent Time

dateTime

Timestamp of the message leaving the producing application.

8

payload[]

9

→ transactionTime

Transaction Time

dateTime