---
title: "GET /private/cancel_by_label"
method: GET
path: "/private/cancel_by_label"
tags: ["Trading", "Matching Engine", "Private"]
---

# GET /private/cancel_by_label

`GET /private/cancel_by_label`

Cancels all orders (including trigger orders) that have a specific label. This is useful for managing groups of related orders that share the same label.

Orders can be cancelled across all currencies or filtered to a specific currency. When cancelling by currency, the currency queue is used for processing.

**Rate Limits:** When called without the `currency` parameter, this method is subject to `cancel_all` rate limits. Different rate limit values may apply for per-currency cancels versus calls without providing the currency parameter.

**Scope:** `trade:read_write`

[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fcancel_by_label)

## Query parameters

- `label` string, required
- `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`

## Response `200`

Success response

- PrivateCancelAllResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` number, required — Total number of successfully cancelled orders

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/versions/430b3f0bc67c/schema)