Cancel Order

Cancel one or more orders.

HTTP Request

POST

/api/perp-trade-api/trade/cancelorder

Request Frequency Restriction:

Recommended: no more than 10 times per second

Authentication Required:

JWT Token required
X-Wallet-Address header required

Limit:

Maximum 10 orders can be cancelled at once

Request Headers

Name	Type	Required	Description
Authorization	string	Yes	JWT Token, format: `Bearer {token}`
X-Wallet-Address	string	Yes	Wallet address

Request Parameters

Name	Type	Required	Description
symbol	string	Yes	Trading pair, e.g., ETH-PERP
orderHashes	array	Yes	Order hash list, maximum 10
signature	string	Yes	Cancel order signature
parentAddress	string	No	Parent address (if using sub-account)

Request Example

{
  "symbol": "ETH-PERP",
  "orderHashes": [
    "0xabc123def456...",
    "0xdef456abc123..."
  ],
  "signature": "0x123...",
  "parentAddress": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78"
}

Response Fields Description

Name	Type	Description
results	array	Cancel order result list

Each result contains:

Name	Type	Description
orderHash	string	Order hash
status	string	Cancel status: SUCCESS (success) or FAILED (failed)
errorCode	integer	Error code (when failed)
errorMessage	string	Error message (when failed)

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "results": [
      {
        "orderHash": "0xabc123def456...",
        "status": "SUCCESS",
        "errorCode": null,
        "errorMessage": null
      },
      {
        "orderHash": "0xdef456abc123...",
        "status": "FAILED",
        "errorCode": 10005,
        "errorMessage": "Order not found"
      }
    ]
  }
}