---
title: "Cancel one or more orders"
method: POST
path: "/v1/chains/{chain_name}/orders/cancel"
tags: ["orders"]
---

# Cancel one or more orders

`POST /v1/chains/{chain_name}/orders/cancel`

Cancel one or more orders

## Path parameters

- `chain_name` string, required — The name of chain

## Request body

- CancelOrdersRequestBody
  - `account_address` string, required — Address of the user initiating the cancel request
  - `orders` string[], required — List of order ids proposed for cancellation
  - `signature` string, required — Signature generated by the user for the specific cancellation request

## Response `200`

Orders cancellation response.

- CancelOrdersResult
  - `result` CancelOrdersResultData, required
    - `successful_cancellations` string[], required — Orders which were successfully cancelled
    - `pending_cancellations` string[], required — Orders which are marked for cancellation but the cancellation cannot be guaranteed
    - `failed_cancellations` FailedOrderCancellation[], required — Orders which failed to be cancelled
      - `order` string, required — ID of the order which failed to be cancelled
      - `reason_code` 'FILLED', required — Reason code indicating why the order failed to be cancelled

## Other responses

- `400` — Bad Request (400)
- `401` — Unauthorised Request (401)
- `404` — The specified resource was not found (404)
- `429` — Too Many Requests (429)
- `500` — Internal Server Error (500)
- `501` — Not Implemented Error (501)

---

[API](https://skmtc.dev/immutable/apis/immutable-zkevm-api.md) · [All operations](https://skmtc.dev/immutable/apis/immutable-zkevm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/immutable/immutable-zkevm-api/revisions/59f94155fcd0/schema)