Cancel Pending Trade
MngCancelPendingTrade¶
Description: Allows a manager to cancel a pending trade order using its unique order ID.
This method follows the common Trade Request Lifecycle. A successful response means the pending-order cancel request was accepted into runtime processing.
Warning
this method work only for pending trades
Access Control¶
Requires dealer_trades for manager/dealer sessions. The target account must also match the manager groups and brand scope loaded from the cached manager record. Token payload is used only for manager id and session type.
Request Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
| order | int | Yes | ID of the pending trade order to cancel |
| __access | object | Yes | Access object containing session type information |
Request Example¶
{
"order": 1001234,
"__access": {
"type": 1
}
}
Response Semantics¶
If the request is accepted:
- the cancel request passed validation
- the order was accepted into runtime processing
- final pending-order cancellation is resolved asynchronously
The response should be treated as an acknowledgment object.
Response Parameters¶
| Name | Type | Description |
|---|---|---|
| accepted | bool | Always true on successful acknowledgment |
| order | int | Order identifier being cancelled |
| state | int | Accepted request state, typically TS_CANCEL_REQUEST |
Response Example¶
{
"accepted": true,
"order": 1001234,
"state": 9
}
Lifecycle Notes¶
- The immediate response is an acknowledgment, not a final cancellation report.
- The order should be tracked by
order. - Final resulting state is resolved later in runtime processing.