# Reference: Order Response Types

The tables below provide detailed reference for specific validation scenarios and their responses.

# New Orders

# Stateless validation

Order requests with below errors are validated and rejected by the gateway. They do not send any request to the engine, and do not create an order or execution. They result in either 400 (invalid input) or 401 (unauthorized)

Problem	Response Code	Response
Not logged in	401	Invalid Request
Symbol length is more than 23 characters or contains non-ascii characters	400	Invalid symbol
Cannot determine order type from input	400	Invalid ordType
Contains an ExecInst that does not exist	400	Invalid execInst
Order quantity is not set and is not a close order	400	orderQty is required
Close stop order does not specify side	400	Invalid side
Order quantity is zero for a non-close whole position order	400	Invalid orderQty
Side is not 'Buy' or 'Sell'	400	Invalid side
Side is buy, but quantity is negative	400	Inconsistent side/orderQty
Price is not specified on a Limit, StopLimit or LimitIfTouched order	400	Invalid price
Price is specified on a Market, Stop or MarketIfTouched order	400	Invalid price
Specified price is not finite	400	Invalid price
Display quantity is larger than quantity	400	Invalid displayQty
Stop price specified on non-stop order	400	Invalid stopPx for ordType
Client order id is longer than 36 characters	400	clOrdID must be at most 36 characters.
Client order id contains non-ascii characters	400	Invalid clOrdLinkID
Expire time set for a non-goodtilldate order	400	expireTime is not valid for this TimeInForce
Stop price type specified on a non-stop order	400	Invalid ordType for execInst
Price type not set on a stop order	400	Invalid execInst
Order is ParticipateDoNotInitiate and also ImmediateOrCancel	400	Invalid ordType or timeInForce for execInst
Contingency type is set but not OneCancelsTheOther or OneTriggersTheOther	400	Invalid contingencyType
Contingency type is set but clOrdLinkID is not	400	Invalid clOrdLinkID for contingencyType
Text is longer than 128 characters	400	text must be at most 128 characters.
Text contains non-ascii characters	400	Invalid text
Text is longer than 128 characters	400	text must be at most 128 characters.

# Stateful validation

Order requests with below errors are validated causing a command to be sent to the engine. They are then rejected by the engine. The engine sends an immediate rejection and does not create an order, nor does it create an execution.

Problem	Response Code	Response	Notes
Instrument does not exist	400	Unknown or expired instrument
Account number is negative	400	Specified account number must be positive
Exchange is suspended	400	Exchange is suspended
Expire time on good-till-date order is in the past	400	Expire time on a GoodTillDate order must be in the future
Another order with this client order id already exists on this account	400	Duplicate clOrdID
Instrument has expired	400	Instrument expired
Order entered before instrument listingTime	400	Market is not open yet
Price is above the maximum price	400	Price is above the maximum
Price is below the minimum price	400	Price is below the minimum
Price divided by tick size is not an integer	400	Price must be a multiple of	If price / tick size is within 0.000001, it's rounded to the 'correct' price. Otherwise reject.
Marked price stop order on a last-priced instrument	400	Cannot place a market price stop order on a last-priced instrument:
Stop price is above the maximum price	400	Price is above the maximum
Stop price is below the minimum price	400	Price is below the minimum
Stop price divided by tick size is not an integer	400	Price must be a multiple of
Quantity exceeds max order quantity	400	Order quantity is above the maximum for this instrument
Quantity is not a multiple of the lot size	400	Order quantity must be a multiple of lot size:
Display quantity is not a multiple of the lot size	400	Display quantity must be a multiple of lot size:
Too many open orders	400	Too many open orders	Limit of 200 per instrument by default
Contingent link id is not valid for the contingency type	400	This contingency link ID is invalid
Position count limit exceeded	400	Cannot have positions/orders on more than instruments	If a limit is set on the exchange

# Market validation

Order requests below are valid and result in a new order being created and subsequently canceled

Problem	Creates Execution	Response Code	Response	OrdRejReason	Notes
Close order quantity increases the position	New,Cancel	200		OrderIncreasesPosition
Order would exceed the open value cap	New,Cancel	400	Exchange would exceed the maximum available open interest for this instrument	InstrumentOpenValueCapExceeded
Post only trade would match immediately	New,Cancel	200		ImmediateMatchPostOnly
Fill or kill trade cannot be immediately filled	New,Cancel	200		UnfilledFillOrKill
Insufficient margin	New,Cancel	400	Account has insufficient Available Balance, required	InsufficientBalance
Exceeds risk limit	New,Cancel	400	Order would exceed the risk limit on the account	RiskLimitExceeded
ImmediateOrCancel order could not be completely filled	New,(Trade,)*Cancel	200		UnfilledImmediateOrCancel	Can contain partial fills
Market order could not be completely filled	New,(Trade,)*Cancel	200		UnfilledMarketOrder
Trigger order for OneTriggersTheOther is already canceled	New,Cancel	200		TriggerCanceled
Another order in a OneCancelsTheOther group is already filled	New,Cancel	200		OcoFilled
Implied price on a pegged order be above max price	New,Cancel	200		PeggedOrderPriceAboveMaxPrice
Implied price on a pegged order be below min price	New,Cancel	200		PeggedOrderPriceBelowMinPrice
Market lacks a bid/offer to use for creating a pegged order	New,Cancel	200		NoLiquidityForPeg

# Amends

# Stateless validation

Amend requests with below errors are validated and rejected by the gateway. They do not send any command to the engine. They result in either 400 (invalid input) or 401 (unauthorized)

Problem	Response Code	Response
Not logged in	401	Invalid Request
orderId is not a valid UUID	400	OrderID is not a valid UUID
Client order id is longer than 36 characters	400	clOrdID must be at most 36 characters.
Client order id contains non-ascii characters	400	Invalid clOrdLinkID
Original client order id is longer than 36 characters	400	clOrdID must be at most 36 characters.
Original client order id contains non-ascii characters	400	Invalid clOrdLinkID
Text is longer than 128 characters	400	text must be at most 128 characters.
Text contains non-ascii characters	400	Invalid text

# Stateful validation

Amend requests with below errors are validated and rejected by the engine. The engine sends an immediate rejection and does not amend the order.

Problem	Creates Command	Amends Order	Response Code	Response	Notes
Exchange is suspended	TRUE	FALSE	400	Exchange is suspended
Amending an unknown orderId	TRUE	FALSE	400	Unknown orderID
new clOrderId already exists	TRUE	FALSE	400	Duplicate clOrdID
passed an orderId and a clOrdId that refer to different orders	TRUE	FALSE	400	orderID and clientOrderId resolve to different orders
Amending an unknown clOrdId	TRUE	FALSE	400	Invalid clientOrderId	This applies to amend that are exclusively referencing a clOrdId
Amending a Filled order	TRUE	FALSE	400	Cannot amend a filled order
Amending a Canceled order	TRUE	FALSE	400	Cannot amend a cancelled order
Amending an Expired order	TRUE	FALSE	400	Cannot amend an expired order
Price is below the minimum price	TRUE	FALSE	400	Price is below the minimum
Quantity exceeds max order quantity	TRUE	FALSE	400	Order quantity is above the maximum for this instrument
Quantity is not a multiple of the lot size	TRUE	FALSE	400	Order quantity must be a multiple of lot size:
Price is above the maximum price	TRUE	FALSE	400	Price is above the maximum
Price is below the minimum price	TRUE	FALSE	400	Price is below the minimum
Price divided by tick size is not an integer	TRUE	FALSE	400	Price must be a multiple of	If price / tick size is within 0.000001, it's rounded to the 'correct' price. Otherwise reject.
Amending stop price on an already activated stop order	TRUE	FALSE	400	Cannot amend stop price on an already activated stop order
Stop price is above the maximum price	TRUE	FALSE	400	Price is above the maximum
Stop price is below the minimum price	TRUE	FALSE	400	Price is below the minimum
Stop price divided by tick size is not an integer	TRUE	FALSE	400	Price must be a multiple of	If price / tick size is within 0.000001, it's rounded to the 'correct' price. Otherwise reject.
Amending expire time on an order that is not a GoodTillDate order	TRUE	FALSE	400	Can only amend expire time on GoodTillDate orders
Amending an order in a way that doesn't change anything on the order	TRUE	FALSE	400	Invalid amend: orderQty, leavesQty, price, stopPx, client order Id, and expire time unchanged
Amending price on post only order in a way that makes it immediately match	TRUE	FALSE	400	Post only order would match immediately
Amending the order in a way that exceeds risk limit	TRUE	FALSE	400	Order would exceed the risk limit on the account
Amending the order in a way that exceeds open value cap	TRUE	FALSE	400	Exchange would exceed the maximum available open interest for this instrument
Amending the order in a way that requires more margin than available	TRUE	FALSE	400	Account has insufficient Available Balance, required

# Market validation

Amend requests below are valid and result in an order being amended and subsequently cancelled

Problem	Creates Command	Amends Order	Creates Execution	Response Code	Response	Notes
Amend quantity to 0 or negative number	TRUE	TRUE	Cancel	200	Success	quantity on amends is in absolute value as we can't change side on an order
Amend quantity to less than the amount already filled cancels the order	TRUE	TRUE	Cancel	200	Success
Amend leaves quantity to 0 or negative number	TRUE	TRUE	Cancel	200	Success	quantity on amends is in absolute value as we can't change side on an order
Amend expire time to the past on GoodTillDate order	TRUE	TRUE	Cancel	200	Success
Amend an order price in a way that makes it match in the market	TRUE	TRUE	Fill/PartialFill	200	Success

# Cancels

# Stateless validation

Cancel requests with below errors are validated and rejected by the gateway. They do not send any request to the engine. They result in either 400 (invalid input) or 401 (unauthorized)

Problem	Creates Command	Response Code	Response	Notes
Not logged in	FALSE	401	Invalid Request
Text is longer than 128 characters	FALSE	400	text must be at most 128 characters.
Text contains non-ascii characters	FALSE	400	Invalid text
Cancelling too many orders	FALSE	400	OrderID list is too long, the maximum is 256 orders
orderId is not a valid UUID	FALSE	400	OrderID is not a valid UUID
Client order id is longer than 36 characters	FALSE	400	clOrdID must be at most 36 characters.
Client order id contains non-ascii characters	FALSE	400	Invalid clOrdLinkID
Not specifying any order to cancel	FALSE	400	No orders were specified
Cancel all after doesn't specify a timeout	FALSE	400	timeout required	a timeout of 0 is valid and annuls the previous cancel all after command

# Stateful validation

Cancel requests with below errors are validated and rejected by the engine. The engine sends an error for the impacted order ids but could still proceed to cancel other valid order ids in the same cancel request

Problem	Creates Command	Response Code	Response	Notes
Cancelling an unknown order Id	TRUE	200	NotFound	The cancel order commands can take multiple order IDs. The response is 200 but can still contain errors for some of the orderIds while valid ones get canceled
Cancelling an unknown client order Id	TRUE	200	NotFound	The cancel order commands can take multiple order IDs. The response is 200 but can still contain errors for some of the orderIds while valid ones get canceled
Cancelling an already cancelled order	TRUE	200	Cannot cancel an already cancelled order
Cancelling an already filled order	TRUE	200	Cannot cancel an already filled order
Cancelling an already expired order	TRUE	200	Cannot cancel an expired order

# Other reasons an order could get canceled

Problem	Creates Execution
Timeout of "cancel all after" is reached	Cancel
Another "oneCancelsTheOther" contingent order is PartiallyFilled/Filled	Cancel
Trigger of "oneTriggersTheOther" contingent order is Cancelled	Cancel
Instrument is expired	Cancel
Account is liquidated	Cancel
Amend quantity down to leave 0 quantity to be filled	Cancel
Market order is not fully filled	PartialFill*, Cancel
ImmediateOrCancel is not fully filled	PartialFill*, Cancel