---
title: "Cancel Spot batch"
method: DELETE
path: "/v1/spot/orders/batch"
tags: ["Spot trading"]
---

# Cancel Spot batch

`DELETE /v1/spot/orders/batch`

## Request

- Base URL: `https://api.ondoperps.xyz`
- URL: `https://api.ondoperps.xyz/v1/spot/orders/batch`
- Auth: one of:
  - HTTP bearer
  - API key in header `ONDO-KEY-ID`

Cancel 1–20 exchange IDs or client:-prefixed IDs. Inspect successfulCancels and failedCancels; this is not an atomic cancel-and-replace.

See the [Spot API guide](/api-reference/spot-api-guide). Requires authentication; API-key scope: `trade`.

## Query parameters

- `orderIDs` string, required

## Response `200`

Success. Inspect item-level outcomes for batch operations.

- object
  - `success` boolean, required
  - `result` SpotBatchCancelRes
    - `successfulCancels` SpotOrder[], nullable
      - `orderId` string, required: Internal order ID
      - `clientOrderId` string: Client-provided order ID (if set)
      - `side` 'buy' | 'sell', required: buy or sell
      - `price` string, required: Limit price
      - `size` string, required: Order quantity in base currency
      - `market` string, required: Trading market
      - `filledSize` string, required: Quantity of the order that has been filled
      - `lastFillSize` string, required: Quantity filled in the most recent trade
      - `filledCost` string, required: Cost of the filled portion of the order (filledSize × fill price)
      - `fee` string, required: Fee in the asset received: base equivalent quantity for buys, USDC for sells. Zero during the launch promotion.
      - `status` 'open' | 'fullyfilled' | 'canceled', required: Order status
      - `createdAt` string, date-time, required: Order creation time
      - `filledAt` string, date-time: Time when the order was fully filled (if applicable)
      - `canceledAt` string, date-time: Order cancellation time (if cancelled)
      - `cancelReason` string: Cancellation reason when provided. Treat this as an extensible string.
      - `type` 'limit' | 'market', required: Order type
      - `timeInForce` 'GTC' | 'IOC': Time in force (GTC or IOC). Not returned for market orders.
    - `failedCancels` object[], nullable
      - `orderId` string
      - `error` string
      - `errorCode` string

## Other responses

- `400`: Validation error; inspect error_code and error.
- `429`: Rate limit exceeded. Slow down request frequency.

## Changes

- **2026-11-03** `1601c3adedda`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/changes/v1/spot/orders/batch/delete.md)

---

[API](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api.md) - [All operations](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ondoperps/apis/ondo-perps-rest-api/revisions/1601c3adedda?raw)