> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/smarttrade/trades/cancel-trade.md).

# Cancel trade

**Description:** Cancels a specific trade within a SmartTrade using its ID\ <br>

{% hint style="warning" %}
Keep in mind, to avoid canceling the SmartTrade, make sure to leave at least one step in the Take Profit trade and avoid deleting the Stop Loss trade.
{% endhint %}

<br>

**Permission:** SMART\_TRADES\_WRITE\
**Security:** SIGNED\ <br>

***

<mark style="color:red;">**DELETE**</mark>

<mark style="color:red;">**/v2/smart\_trades/{smart\_trade\_id}/trades/{id}**</mark>

***

\ <br>

## Path Parameters<br>

| Name                | Type      | Mandatory | Values | Description                                   |
| ------------------- | --------- | --------- | ------ | --------------------------------------------- |
| **smart-trade\_id** | `integer` | Yes       | -      | Unique 3Commas ID for this SmartTrade entity. |
| **id**              | `integer` | Yes       | -      | Unique 3Commas ID for Trade entity            |

\ <br>

## Response Parameters<br>

{% hint style="info" %}
If successful response, the response includes a copy of the updated SmartTrade entity. You can find a total description of all attributes on the page about [SmartTrade](https://github.com/3commas-io/3commas-official-api-docs/blob/gitbook/SmartTrade/README.md).
{% endhint %}

\ <br>

## Example Request<br>

```json
/v2/smart_trades/30428625/trades/1008300673
```

\ <br>

## Example Response and errors<br>

<details>

<summary>Status: 200 OK</summary>

<br>

```json
{
    "id": 30428625,
    "version": 2,
    "account": {
        "id": 32402783,
        "type": "binance_us",
        "name": "My Binance US",
        "market": "Binance US Spot",
        "link": "/accounts/32402783"
    },
    "pair": "USDT_DOGE",
    "instant": false,
    "status": {
        "type": "waiting_targets",
        "basic_type": "waiting_targets",
        "title": "Waiting Targets"
    },
    "leverage": {
        "enabled": false
    },
    "position": {
        "type": "buy",
        "editable": true,
        "units": {
            "value": "20.0",
            "editable": false
        },
        "price": {
            "value": "0.10268",
            "value_without_commission": null,
            "editable": true
        },
        "total": {
            "value": "2.0536"
        },
        "order_type": "market",
        "status": {
            "type": "smart_sell",
            "basic_type": "smart_sell",
            "title": "Own funds"
        }
    },
    "take_profit": {
        "enabled": true,
        "price_type": "value",
        "steps": [
            {
                "id": 1008300673,
                "order_type": "limit",
                "editable": true,
                "units": {
                    "value": "7.0"
                },
                "price": {
                    "type": "last",
                    "value": "0.3",
                    "percent": null
                },
                "volume": "35.0",
                "total": "2.1",
                "trailing": {
                    "enabled": false,
                    "percent": null
                },
                "status": {
                    "type": "order_placed",
                    "basic_type": "order_placed",
                    "title": "Placed"
                },
                "data": {
                    "cancelable": true,
                    "panic_sell_available": true
                },
                "position": 1
            },
            {
                "id": 1008300674,
                "order_type": "limit",
                "editable": true,
                "units": {
                    "value": "7.0"
                },
                "price": {
                    "type": "last",
                    "value": "0.4",
                    "percent": null
                },
                "volume": "35.0",
                "total": "2.8",
                "trailing": {
                    "enabled": false,
                    "percent": null
                },
                "status": {
                    "type": "order_placed",
                    "basic_type": "order_placed",
                    "title": "Placed"
                },
                "data": {
                    "cancelable": true,
                    "panic_sell_available": true
                },
                "position": 2
            }
        ]
    },
    "stop_loss": {
        "enabled": true,
        "price_type": "value",
        "breakeven": false,
        "order_type": "market",
        "editable": true,
        "price": {
            "value": null,
            "percent": null
        },
        "conditional": {
            "price": {
                "value": "0.09754",
                "type": "last",
                "percent": null
            },
            "trailing": {
                "enabled": false,
                "percent": null
            }
        },
        "timeout": {
            "enabled": false,
            "value": null
        },
        "status": {
            "type": "to_process",
            "basic_type": "to_process",
            "title": "Pending"
        }
    },
    "reduce_funds": {
        "steps": []
    },
    "market_close": {},
    "note": "",
    "note_raw": null,
    "skip_enter_step": true,
    "data": {
        "editable": true,
        "current_price": {
            "day_change_percent": "-2.728",
            "bid": "0.10257",
            "ask": "0.1027",
            "last": "0.10268",
            "quote_volume": "136509.39725"
        },
        "target_price_type": "price",
        "orderbook_price_currency": "USDT",
        "base_order_finished": true,
        "missing_funds_to_close": "0.0",
        "liquidation_price": null,
        "average_enter_price": null,
        "average_close_price": null,
        "average_enter_price_without_commission": null,
        "average_close_price_without_commission": null,
        "panic_sell_available": true,
        "add_funds_available": true,
        "reduce_funds_available": true,
        "force_start_available": false,
        "force_process_available": true,
        "cancel_available": true,
        "finished": false,
        "base_position_step_finished": true,
        "entered_amount": "20.0",
        "entered_total": "2.0536",
        "closed_amount": "0.0",
        "closed_total": "0.0",
        "commission": 0.001,
        "created_at": "2024-08-14T19:51:43.100Z",
        "updated_at": "2024-08-14T19:51:43.892Z",
        "type": "smart_sell"
    },
    "profit": {
        "volume": "-0.0042514",
        "usd": "-0.0042514",
        "percent": "-0.21",
        "roe": null
    },
    "margin": {
        "amount": null,
        "total": null
    },
    "is_position_not_filled": false
}
```

</details>

<details>

<summary>Status:</summary>

<br>

```json
```

</details>