v1

latestOpenAPI 3.0.32026-07-2659172194.6 KB
orders

Cancel one or more orders

Cancel one or more orders

post/v1/chains/{chain_name}/orders/cancel

Path parameters

chain_namestring required

The name of chain

Example:imtbl-zkevm-testnet

Request body

account_addressstring required

Address of the user initiating the cancel request

ordersstring[] required

List of order ids proposed for cancellation

signaturestring required

Signature generated by the user for the specific cancellation request

Example request

{
  "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "ids": [
    "018a8c71-d7e4-e303-a2ef-318871ef7756",
    "238a8c71-d7e4-e303-a2ef-318871ef7778",
    "458a8c71-d7e4-e303-a2ef-318871ef7790"
  ],
  "signature": 291
}

Response

Orders cancellation response.

Example response

{
  "result": {
    "successful_cancellations": [
      "018a8c71-d7e4-e303-a2ef-318871ef7756",
      "458a8c71-d7e4-e303-a2ef-318871ef7778"
    ],
    "pending_cancellations": [
      "238a8c71-d7e4-e303-a2ef-318871ef7778",
      "898a8c71-d7e4-e303-a2ef-318871ef7735"
    ],
    "failed_cancellations": [
      {
        "order": "458a8c71-d7e4-e303-a2ef-318871ef7790",
        "reason_code": "FILLED"
      },
      {
        "order": "338a8c71-d7e4-e303-a2ef-318871ef7342",
        "reason_code": "FILLED"
      }
    ]
  }
}