> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/order-management/cancel-order-by-client-order-id.md).

# Cancel Order by Client Order ID

Cancel an order using its client-provided order ID.

### Endpoint

`DELETE /v1/client/order?client_order_id={client_order_id}&symbol={symbol}`

Mainnet: `DELETE https://api.orderly.org/v1/client/order?client_order_id={client_order_id}&symbol={symbol}`

Testnet: `DELETE https://testnet-api.orderly.org/v1/client/order?client_order_id={client_order_id}&symbol={symbol}`

**Request limit:** 10 requests per second. This route cancels an order by the client-assigned ID rather than the server order ID. It requires an API key with the `trading` scope.

### Authentication headers

* `orderly-timestamp` — required signed-request timestamp in milliseconds.
* `orderly-account-id` — required account ID.
* `orderly-key` — required public API key.
* `orderly-signature` — required request signature.

### Query parameters

* `client_order_id` (string, required) — client ID assigned to the order.
* `symbol` (string, required) — market symbol for the order.

### Example request

```bash
curl --request DELETE \
  --url 'https://api.orderly.org/v1/client/order?client_order_id=pango-demo-001&symbol=PERP_ETH_USDC' \
  --header 'orderly-account-id: <account-id>' \
  --header 'orderly-key: <public-api-key>' \
  --header 'orderly-signature: <signature>' \
  --header 'orderly-timestamp: <timestamp-in-ms>'
```

### Successful response

HTTP `200` indicates that the cancellation request was sent.

```json
{
  "success": true,
  "data": { "status": "CANCEL_SENT" },
  "timestamp": 1702989203989
}
```
