Skip to content

撤单

撤单

撤销一个或多个订单。

HTTP 请求

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

请求频率限制:

  • 建议不超过 10 次/秒

认证要求:

  • 需要 JWT Token
  • 需要 X-Wallet-Address 请求头

限制:

  • 单次最多撤销 10 个订单

请求头

名称 类型 必填 描述
Authorization string 是 JWT Token，格式：Bearer {token}
X-Wallet-Address string 是 钱包地址

请求参数

名称 类型 必填 描述
symbol string 是 交易对，如 ETH-PERP
orderHashes array 是 订单哈希列表，最多 10 个
signature string 是 撤单签名
parentAddress string 否 父地址（如果使用子账户）

请求示例

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

响应字段说明

名称 类型 描述
results array 撤单结果列表

每个结果包含：

名称 类型 描述
orderHash string 订单哈希
status string 撤单状态：SUCCESS（成功）或 FAILED（失败）
errorCode integer 错误码（失败时）
errorMessage string 错误信息（失败时）

响应示例

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