Skip to main content
POST
/
api
/
v4
/
order
/
cancel
/
bulk
Cancel bulk orders
curl --request POST \
  --url https://whitebit.com/api/v4/order/cancel/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --header 'X-TXC-PAYLOAD: <api-key>' \
  --header 'X-TXC-SIGNATURE: <api-key>' \
  --data '
{
  "orders": [
    {
      "market": "BTC_USDT",
      "orderId": 4326248250
    },
    {
      "market": "ETH_USDT",
      "clientOrderId": "my-client-id"
    }
  ],
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
[
  {
    "result": {
      "orderId": 4326248250,
      "clientOrderId": "my-client-id",
      "market": "BTC_USDT"
    },
    "error": {
      "code": 30,
      "message": "Validation failed",
      "errors": {}
    }
  }
]

Authorizations

​
X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

​
X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

​
X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

Body

application/json
​
orders
object[]
required

Array of orders to cancel. From 1 to 100 items per request.

Required array length: 1 - 100 elements
​
request
string
required
Example:

"{{request}}"

​
nonce
string
required
Example:

"{{nonce}}"

Response

Bulk cancel result. The response is an array — response[i] corresponds to request.orders[i]. Each item contains either a result (cancellation succeeded) or an error (cancellation failed for that item). Partial failures within the array are normal; the request itself returns HTTP 200.

​
result
object

Acknowledgement that a single item was cancelled. The endpoint echoes the identifiers from the request item; full order state is not returned. Use the single Cancel order endpoint when post-cancel order state is required.

​
error
object