> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wooxpro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 合约止盈止损下单 (SIGNED)

`适用于用户进行合约止盈止损订单下单`

#### 请求URL

`POST https://cloud-api.wooxpro.com/contract/private/submit-tp-sl-order`

#### 请求限制

参见 [速率限制详细](/cn/rate-limit)

#### 请求参数

> 请求

```shell theme={null}
curl 
 -H 'X-API-KEY:{{AccessKey}}'
 -H 'X-API-TIMESTAMP:{{currentTime}}'
 -H 'X-API-SIGN:{{SIGN}}' 
 -X POST -d '{
  "symbol":"ETHUSDT",
  "side":2,
  "type":"take_profit",
  "size":10,
  "trigger_price":"2000",
  "executive_price":"1450",
  "price_type":1,
  "plan_category":1,
  "client_order_id":"123456789",
  "category":"limit"
}'
https://cloud-api.wooxpro.com/contract/private/submit-tp-sl-order
```

| 参数                | 类型     | 是否必填 | 描述                                                           |
| :---------------- | :----- | :--- | :----------------------------------------------------------- |
| symbol            | String | 必填   | 合约交易对（如BTCUSDT）                                              |
| type              | String | 必填   | 订单类型<br />-`take_profit`=止盈单<br />-`stop_loss`=止损单           |
| side              | Int    | 必填   | 订单方向                                                         |
| size              | Int    | 选填   | 订单数量 张数 默认仓位数量（对应仓位止盈止损）                                     |
| trigger\_price    | String | 必填   | 触发价格                                                         |
| executive\_price  | String | 必填   | 执行价格                                                         |
| price\_type       | Int    | 必填   | 触发价格类型<br />-`1`=最新成交价<br />-`2`=标记价格                        |
| plan\_category    | Int    | 选填   | 止盈止损类型<br />-`1`=部分仓位止盈止损<br />-`2`=全仓止盈止损（默认）               |
| client\_order\_id | String | 选填   | 用户自定义ID, 字母（区分大小写）与数字的组合，可以是纯字母、纯数字且长度要在1-32位之间              |
| category          | String | 选填   | 触发订单的类型,全仓止盈止损默认为market<br />-`limit`=限价单<br />-`market`=市价单 |

#### 响应详情

> 响应

```json theme={null}
{
  "code": 1000,
  "message": "Ok",
  "data": {
    "order_id": "220609666322019",
    "client_order_id": "123456789"
  },
  "trace": "13f7fda9-9543-4e11-a0ba-cbe117989988"
}
```

| 字段                | 类型     | 描述       |
| :---------------- | :----- | :------- |
| order\_id         | String | 订单编号     |
| client\_order\_id | String | 客户端自定义id |