Skip to main content
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

This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions.

​
Request

​
order_ids
integer[]
required
Array of limit order IDs to cancel. Must contain at least one ID.

​
Response

Returns 200 OK with a result item for each requested order ID, in the same order as the request.
​
index
integer
required
Zero-based position of this order in the request payload.
​
order_id
integer
required
The order ID that was submitted.
​
success
boolean
required
true if the order was canceled.
​
error
string
Human-readable error message when success is false. For example, Order is being processed. or Order already filled.

​
Example

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]
  }'
Sample response (200 OK)
[
  { "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 }
]
To cancel every open order at once instead of providing IDs, use Cancel all orders.