---
title: "Cancel OCO (TRADE)"
method: DELETE
path: "/api/v3/orderList"
tags: ["Trade"]
---

# Cancel OCO (TRADE)

`DELETE /api/v3/orderList`

Cancel an entire Order List

Canceling an individual leg will cancel the entire OCO

Weight(IP): 1

## Query parameters

- `symbol` string, required
- `orderListId` integer
- `listClientOrderId` string
- `newClientOrderId` string
- `recvWindow` integer
- `timestamp` integer, required
- `signature` string, required

## Response `200`

Report on deleted OCO

- OcoOrder
  - `orderListId` integer, required
  - `contingencyType` string, required
  - `listStatusType` string, required
  - `listOrderStatus` string, required
  - `listClientOrderId` string, required
  - `transactionTime` integer, required
  - `symbol` string, required
  - `orders` object[], required
    - `symbol` string, required
    - `orderId` integer, required
    - `clientOrderId` string, required
  - `orderReports` object[], required
    - `symbol` string, required
    - `origClientOrderId` string, required
    - `orderId` integer, required
    - `orderListId` integer, required
    - `clientOrderId` string, required
    - `price` string, required
    - `origQty` string, required
    - `executedQty` string, required
    - `cummulativeQuoteQty` string, required
    - `status` string, required
    - `timeInForce` string, required
    - `type` string, required
    - `side` string, required
    - `stopPrice` string, required
    - `selfTradePreventionMode` string, required
    - `transactTime` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized Request

## Changes

- **2023-09-02** `6622e0c15100` — 1 info
  - added the required property `orderReports/items/transactTime` to the response with the `200` status
- **2023-04-26** `042dad2ebffe` — 1 info
  - added the required property `orderReports/items/selfTradePreventionMode` to the response with the `200` status
- **2021-10-25** `a484ce871a72` — 3 breaking, 30 info
  - for the `query` request parameter `orderListId`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `recvWindow`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `timestamp`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - the response property `code` became required for the status `400`
  - …29 more

[Change history](https://skmtc.dev/binance/apis/binance-public-spot-api/changes/api/v3/orderList/delete.md)

---

[API](https://skmtc.dev/binance/apis/binance-public-spot-api.md) · [All operations](https://skmtc.dev/binance/apis/binance-public-spot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/binance/binance-public-spot-api/revisions/0dd2f133e12d/schema)