Skip to main content
Cancel bulk orders

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
integer
required
Example:

1594297865000

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.

A failed item carries an error object in the standard error shape. Per-item error codes:

  • 30 - validation failure, including both or neither of orderId and clientOrderId sent
  • 31 - market has an invalid format
  • 36 - clientOrderId is invalid
  • 404 - the order with the given orderId was not found or is already cancelled
  • 500 - the trading engine is unavailable; the request itself still returns HTTP 200

Example of a failed item:

result
object | null

Acknowledgement that a single item was canceled. The endpoint echoes the identifiers from the request item and, when available, the order's timestamp and mtime. Full order state is not returned. Use the single Cancel order endpoint when post-cancel order state is required.

error
object | null