---
title: "Cancel a limit or TP/SL order (CeFi or DeFi)"
url: https://docs.truemarkets.co/api/gateway/prepare-cancel-order
description: "Venue-polymorphic cancel. The payloads field is the signal."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Cancel a limit or TP/SL order (CeFi or DeFi)

Venue-polymorphic cancel. The `payloads` field is the signal:
- **CeFi** orders are canceled immediately and return `202 Accepted` with no
  `payloads`. Poll `GET /orders/{id}/status` for the terminal state.
- **DeFi** (Hyperliquid) resting orders return `200 OK` with unsigned
  `payloads`. Sign each locally and post the signatures to
  `POST /orders/{id}/cancel/execute`.

Only cancellable orders (CeFi `pending`/`active` limit orders, DeFi
`active` limit or TP/SL trigger orders) can be canceled. An order that
is no longer open (`complete`, `canceled` or `failed`) returns `422`
with code `order_not_open`; refetch it for its final status. Other
orders return 400. An order with `strategy_managed` set is cancelled by
its strategy, not here, and returns 422.

## Request

```
POST https://api.truemarkets.co/v1/gateway/orders/{id}/cancel
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `TM-On-Behalf-Of` | header | string (uuid) | no | Act as one of your organization's users. The value is the `user_id` returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: `400` for a personal token, a repeated header or a non-UUID, `403` for a user outside your organization. Not accepted on organization-scoped routes. |
| `id` | path | string | yes | Order ID |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Resting DeFi order; unsigned cancel payloads to sign and execute

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `payloads` | array of object | no | Unsigned cancel payloads the client signs and returns via the cancel-execute endpoint. Present for resting DeFi orders, absent for CeFi orders. |
| `payloads[].digest` | string | yes | Lowercase hex SHA-256 of the `payload` bytes. A signing API that takes a pre-hashed input signs the hex-decoded digest; a library that hashes its input takes `payload` instead. Passing the hex digest to a library that hashes signs the wrong bytes. |
| `payloads[].payload` | string | yes | The exact text to sign: a Turnkey activity as JSON, including its trailing newline. Sign its UTF-8 bytes as-is with ECDSA P-256 and SHA-256; never decode, reformat or re-serialize it. |

### 202

CeFi cancel accepted; poll order status for the terminal state

### 400

Bad request

### 401

Unauthorized

### 403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

### 404

Not found

### 422

Request is well-formed but cannot be processed (e.g. leverage missing or out of range for a perp order)

### 500

Internal server error

### 503

Service unavailable
