> ## Documentation Index
> Fetch the complete documentation index at: https://docs.futuur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch cancel orders

> Cancel multiple open limit orders by ID in a single request.

Cancel a list of open limit orders in one API call. Each order is canceled independently — a failure on one order does not block the others. Use this to wind down a quoting ladder or unwind a set of stale orders quickly.

## Endpoint

```
POST https://api.futuur.com/orders/batch-cancel/
```

## Authentication

<Note>
  This endpoint requires HMAC authentication. Include the `Key`, `Timestamp`, and `HMAC` headers on every request. See the [authentication guide](/authentication) for signing instructions.
</Note>

## Request

<ParamField body="order_ids" type="integer[]" required>
  Array of limit order IDs to cancel. Must contain at least one ID.
</ParamField>

## Response

Returns `200 OK` with a result item for each requested order ID, in the same order as the request.

<ResponseField name="index" type="integer" required>
  Zero-based position of this order in the request payload.
</ResponseField>

<ResponseField name="order_id" type="integer" required>
  The order ID that was submitted.
</ResponseField>

<ResponseField name="success" type="boolean" required>
  `true` if the order was canceled.
</ResponseField>

<ResponseField name="error" type="string">
  Human-readable error message when `success` is `false`. For example, `Order is being processed.` or `Order already filled.`
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url "https://api.futuur.com/orders/batch-cancel/" \
    --header "Key: YOUR_PUBLIC_KEY" \
    --header "Timestamp: 1712500000" \
    --header "HMAC: YOUR_HMAC_SIGNATURE" \
    --header "Content-Type: application/json" \
    --data '{
      "order_ids": [100, 101, 102]
    }'
  ```
</CodeGroup>

```json Sample response (200 OK) theme={null}
[
  { "index": 0, "order_id": 100, "success": true },
  { "index": 1, "order_id": 101, "success": false, "error": "Order is being processed." },
  { "index": 2, "order_id": 102, "success": true }
]
```

<Tip>
  To cancel every open order at once instead of providing IDs, use [Cancel all orders](/api-reference/orders/cancel-all).
</Tip>