---
title: "Execute a resting DeFi order cancellation"
url: https://docs.truemarkets.co/api/gateway/execute-cancel-order
description: "Submits the client's signatures over the payloads returned by POST /orders/{id}/cancel to cancel a resting DeFi limit or TP/SL order. The order moves to canceled once the venue confirms, keeping any quantity that filled before the cancel in executed_qty/executed_vwap. An order that filled before the cancel landed moves to complete. An order that is no longer open, including one the venue reports closed before it can say how, returns 422 with code order_not_open."
---

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

# Execute a resting DeFi order cancellation

Submits the client's signatures over the payloads returned by
`POST /orders/{id}/cancel` to cancel a resting DeFi limit or TP/SL order.
The order moves to `canceled` once the venue confirms, keeping any
quantity that filled before the cancel in `executed_qty`/`executed_vwap`.
An order that filled before the cancel landed moves to `complete`. An
order that is no longer open, including one the venue reports closed
before it can say how, returns `422` with code `order_not_open`.

## Request

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

### 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 |

### Body

`application/json`, required

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `signatures` | array of string | yes | One stamp per payload, in the same order as the payloads returned by the create endpoint. With `auth_type: api_key`, an entry is the base64url encoding, without padding, of the JSON `{"publicKey": "<compressed P-256 public key, hex>", "signature": "<DER signature, hex>", "scheme": "SIGNATURE_SCHEME_TK_API_P256"}`, signed as `UnsignedPayload` describes. With `auth_type: web_authn`, an entry is the browser's WebAuthn stamp. |
| `auth_type` | string, one of `web_authn`, `api_key` | yes | The authentication method used to sign transaction payloads. * **web_authn** — Signed using a passkey (WebAuthn/FIDO2 credential) via the browser. * **api_key** — Signed using an API key. Suitable for programmatic/headless access. |

## Responses

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

### 200

Cancellation submitted

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string, one of `initialized`, `pending`, `cancel_pending`, `complete`, `canceled`, `active`, `failed` | no | The current status of the order. * **initialized** — Order has been created but not yet submitted. For DeFi orders, the client must sign the returned payloads and call the execute endpoint. For CeFi buy orders with insufficient balance, a funding bridge is prepared first. * **pending** — Order has been submitted but is not yet confirmed by the CeFi exchange or on-chain. * **active** — Order was accepted by the CeFi exchange and is open for trading. Applies to limit orders that are working in the order book. * **cancel_pending** — A cancellation request has been sent to the CeFi exchange and is awaiting confirmation. * **complete** — Order has been fully executed. For CeFi orders this means the CeFi exchange reported a fill; for DeFi orders the on-chain swap was confirmed. * **canceled** — Order was successfully canceled via a cancel request or by exchange/market conditions. * **failed** — Order was rejected by the CeFi exchange or DeFi execution failed (e.g. on-chain transaction reverted, balance check failed). |

### 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

### 409

Conflict

### 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
