设置仓位止盈
HTTP 请求
POST /futures/set-position-take-profit
请求参数
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| market | true | string | 市场名称 |
| market_type | true | string | 市场类型。 注意：在现货相关功能中，只可使用 SPOT 或 MARGIN在合约相关功能中，只可使用 FUTURES |
| position_side | false | string | 双向持仓模式下必填；单向持仓模式下不传 |
| take_profit_type | true | string | 止盈触发价格类型。CoinEx支持在设置「止盈止损」时选择不同的触发价格 类型，用户可自由选择「最新成交价」、「标记价格」或「指数价格」作为触发价格。 |
| take_profit_price | true | string | 止盈价格 |
| take_profit_amount | false | string | 止盈数量。不传时会先取消全部止盈单，再设置新的全仓止盈；传入时表示设置部分仓位止盈。同一仓位最多可设置20个止盈单 |
请求响应
| 参数名 | 类型 | 说明 |
|---|---|---|
| position_id | int | 仓位 ID |
| market | string | 市场名称 |
| market_type | string | 市场类型 |
| side | string | 仓位方向 |
| margin_mode | string | 仓位类型 |
| open_interest | string | 持仓数量 |
| close_avbl | string | 可平仓数量。剩余可平仓的仓位数量 |
| ath_position_amount | string | 历史最大仓位数量 |
| unrealized_pnl | string | 未实现收益。未平仓合约的当前盈亏，通过标记价格或最新成交价估算得出 |
| realized_pnl | string | 已实现盈亏 |
| avg_entry_price | string | 平均开仓价格 |
| cml_position_value | string | 累计开仓价值（按开仓均价计算，不随标记价格变化） |
| max_position_value | string | 历史最大开仓价值（按开仓价格计算，不随标记价格变化） |
| take_profit_price | string | 止盈价格 |
| stop_loss_price | string | 止损价格 |
| take_profit_type | string | 止盈触发价格类型。CoinEx支持在设置「止盈止损」时选择不同的触发价格类型，用户可自由选择「最新成交价」或「标记价格」作为触发价格。 |
| stop_loss_type | string | 止损触发价格类型。CoinEx支持在设置「止盈止损」时选择不同的触发价格类型，用户可自由选择「最新成交价」或「标记价格」作为触发价格。 |
| leverage | int | 杠杆倍数 |
| margin_avbl | string | 占用保证金。 全仓：U本位合约=开仓数量*标记价格/杠杆；币本位合约=开 仓数量/标记价格/杠杆。 逐仓：初始保证金+追加保证金-减少保证金。 部分平仓时，占用保证金按平仓比例等比减少；逐仓追加/减少保证金包含手动划转和资金费用收付。 |
| ath_margin_size | string | 历史最大保证金数量 |
| position_margin_rate | string | 仓位保证金率 |
| maintenance_margin_rate | string | 维持保证金率。CoinEx采用阶梯维持保证金制度。 仓位数量越多，维持保证金率越高，用户可选择的杠杆倍数越低； 仓位数量越少，维持保证金率越低，用户可选择的杠杆倍数越高 |
| maintenance_margin_value | string | 维持保证金数量。维持保证金：维持当前仓位所需的最低保证金水平。 （U本位合约）维持保证金=标记价格*仓位数量*维持保证金率 （币本位合约）维持保证金=仓位数量/标记价格*维持保证金率 |
| liq_price | string | 强平价格。由系统基于当前标记价格实时计算的预估触发价格。计算会综合仓位模式（单向/双向）、合约类型（U本位/币本位）、仓位数量、结算价格、保证金、维持保证金、未实现盈亏及未成交委托的潜在风险等因素。全仓模式下，同一结算资产下的仓位会共同影响强平价格；逐仓模式下按该仓位独立计算。市场价格、委托状态或账户资金变化时，强平价格可能随之变化。当不存在有效强平价格时，接口返回值以实际响应为准。 |
| bkr_price | string | 破产价格。 全仓破产价格不再计算。 逐仓破产价格可使用强平价格公式计算，其中维持保证金率取值为0。 |
| adl_level | int | 自动减仓风险等级，为 [1, 5] 范围内的数字，数字越小等级越低，反之越高 |
| settle_price | string | 结算价格，按标记价格计算 |
| settle_value | string | 结算价值，按标记价格计算 |
| risk_rate | string | 仓位风险率。计算会考虑仓位保证金、未实现盈亏、维持保证金及未成交委托的潜在风险；数值会随标记价格、委托和资金变化实时调整。 |
| created_at | int | 订单创建时间 |
| updated_at | int | 订单更新时间 |
| stop_loss_list | array | 止损单列表 |
| stop_loss_list[].id | int | 止损单ID |
| stop_loss_list[].price | string | 止损价格 |
| stop_loss_list[].type | string | 止损触发价格类型 |
| stop_loss_list[].amount | string | 止损数量 |
| stop_loss_list[].is_all | bool | 是否为全仓止损单 |
| stop_loss_list[].created_at | int | 止损单创建时间 |
| take_profit_list | array | 止盈单列表 |
| take_profit_list[].id | int | 止盈单ID |
| take_profit_list[].price | string | 止盈价格 |
| take_profit_list[].type | string | 止盈触发价格类型 |
| take_profit_list[].amount | string | 止盈数量 |
| take_profit_list[].is_all | bool | 是否为全仓止盈单 |
| take_profit_list[].created_at | int | 止盈单创建时间 |
请求示例
{
"market": "CETUSDT",
"market_type": "FUTURES",
"take_profit_type": "mark_price",
"take_profit_price": "0.072",
"take_profit_amount": "500000"
}
响应示例
{
"code": 0,
"data": {
"position_id": 927266133,
"market": "CETUSDT",
"market_type": "FUTURES",
"side": "long",
"margin_mode": "cross",
"open_interest": "1000000",
"close_avbl": "1000000",
"ath_position_amount": "1000000",
"unrealized_pnl": "8391.123989502",
"realized_pnl": "110396.83471965",
"avg_entry_price": "0.0631",
"cml_position_value": "1118787.958709152",
"max_position_value": "1302421.11392201",
"take_profit_price": "0.072",
"stop_loss_price": "",
"take_profit_type": "mark_price",
"stop_loss_type": "",
"leverage": "10",
"margin_avbl": "210396.83471965",
"ath_margin_size": "210396.83471965",
"position_margin_rate": "0.050",
"maintenance_margin_rate": "0.005",
"maintenance_margin_value": "5000",
"liq_price": "0.05679",
"bkr_price": "0.053635",
"adl_level": 5,
"settle_price": "0.06817",
"settle_value": "1291322.83913829",
"risk_rate": "0.1234",
"created_at": 1691482451000,
"updated_at": 1691482451000,
"stop_loss_list": [],
"take_profit_list": [
{
"id": 123456,
"price": "0.072",
"type": "mark_price",
"amount": "500000",
"is_all": false,
"created_at": 1691482451000
}
]
},
"message": "OK"
}