Delete Trade
MngDeleteTrade¶
Description: Allows a manager to permanently delete a closed trade by its order ID. This action is typically used to remove invalid or test trades.
This method follows the common Trade Request Lifecycle. A successful response means the delete request was accepted into runtime processing.
Warning
this method work only for closed trades
Access Control¶
Requires del_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 | The ID of the trade order to delete |
| __access | object | Yes | Access object with session type info |
Request Example¶
{
"order": 1001234,
"__access": {
"type": 1
}
}
Response Semantics¶
If the request is accepted:
- the delete request passed validation
- the order was accepted into runtime processing
- final removal 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 deleted |
| state | int | Accepted request state, typically TS_DELETE_REQUEST |
Response Example¶
{
"accepted": true,
"order": 1001234,
"state": 8
}
Lifecycle Notes¶
- The immediate response is not a final delete confirmation.
- Final trade removal is resolved later in runtime processing.
- The trade should be tracked by
order.