Orders

Cancel a specific set of orders atomically at the selection layer

Validates the ENTIRE selection before sending any venue request — if any requested order is missing, not owned by the caller, already terminal, on a mismatched exchange, or has no exchange order id yet (pre-submission), the whole request is rejected with no venue call made and no partial cancels. Once validation passes, the venue's native batch-cancel endpoint determines the per-order result; a venue-refused cancel is reported in failures without marking the local row cancelled. All selected orders must belong to the SAME exchange_id — a mixed-venue batch is rejected with 400. Auth & scope. Requires trade:execute.

post/orders/cancel-batch

Request

  • Base URL
    https://execution.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Request body

order_idsstring[] required

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

Response

Per-order batch-cancel outcome.

successboolean required

True iff failed_count == 0.

cancelled_countinteger required
noop_countinteger 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_countinteger required
cancelled_order_idsstring[] required
noop_order_idsstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.