Skip to main content
POST
Cancel a specific set of orders atomically at the selection layer

Authorizations

X-Client-Id
string
header
required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key
string
header
required

64-char hex API key.

X-Api-Secret
string
header
required

64-char hex API secret.

Body

application/json

Body for POST /orders/cancel-batch.

order_ids
string<uuid>[]
required

Internal order ids to cancel. Deduplicated server-side; must be non-empty and at most 100 entries.

Maximum array length: 100

Response

Per-order batch-cancel outcome.

Response for POST /orders/cancel-batch.

success
boolean
required

True iff failed_count == 0.

cancelled_count
integer
required
noop_count
integer
required

Orders the venue reported as a no-op (e.g. already filled/cancelled at the venue) — still counted as handled, not a failure.

failed_count
integer
required
cancelled_order_ids
string<uuid>[]
required
noop_order_ids
string<uuid>[]
required
failures
object[]
required