---
title: "Batch Cancel Orders"
method: POST
path: "/api/v1/order/cancel-batch"
tags: ["Trade"]
---

# Batch Cancel Orders

`POST /api/v1/order/cancel-batch`

Cancel multiple existing orders in a single request

## Request body

- BatchCancelOrdersRequest — Batch cancel order request. You can cancel unfilled or partially filled orders. TODO: Maximum 20 orders per request
  - `await_outcome` boolean — If true, gateway waits up to a server-defined timeout (currently 3s) for final engine outcomes and maps them into `exit_info`. If false (default), `exit_info` reports edge outcomes (validation + publish ack).
  - `request` CancelOrderRequest[], required
    - `order_id` string, uuid
    - `order_link_id` string
    - `sub_account_address` string, required
    - `symbol` string, required

## Response `200`

Orders canceled

- BatchCancelOrdersResponse — Response of batch cancel orders.
  - `exit_info` ExitMessage[], required — Information about the exit status of each order in the batch.
    - union
      - object
        - `Error` object, required
          - `code` integer, required
          - `msg` string, required
      - object
        - `Success` object, required
          - `code` integer, required
          - `msg` string, required
  - `result` CancelOrderResponse[], required
    - `order_id` string, uuid
    - `order_link_id` string
  - `time` string, date-time, required

---

[API](https://skmtc.net/ekidenfi/apis/ekiden-gateway.md) · [All operations](https://skmtc.net/ekidenfi/apis/ekiden-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ekidenfi/ekiden-gateway/revisions/75ffe546b73a/schema)