一键市价平仓 (TRADE)
- POST
/capi/v3/closePositions
权重(IP): 40
请求参数
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| symbol | String | 否 | 指定交易对平仓 |
| positionId | Long | 否 | 仓位 ID |
- 当
symbol与positionId同时传递时，系统以positionId为准进行平仓操作，但会校验该仓位是否属于symbol指定的交易对，若校验不通过则拒绝执行。 - 当
symbol与positionId同时为空时，系统将平掉账户的所有仓位。 - 仅传递
symbol，系统平仓指定交易对（symbol）下的全部持仓（含多空双向仓位）。 - 仅传递
positionId，系统平仓指定仓位 ID（positionId）所对应的仓位。
请求示例
curl -X POST "https://api-contract.weex.com/capi/v3/closePositions" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*******" \
-H "ACCESS-PASSPHRASE:*****" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "Content-Type: application/json" \
-d '{
"symbol": "BTCUSDT"
}'
返回参数
返回一个数组，字段如下：
| 参数名 | 类型 | 说明 |
|---|---|---|
| positionId | Long | 仓位 ID。 |
| success | Boolean | 是否平仓成功。 |
| successOrderId | Long | 创建的平仓订单 ID（成功时返回）。 |
| errorMessage | String | 失败原因（当 success = false 时返回）。 |
返回示例
[
{
"positionId": 689987235755328154,
"success": true,
"successOrderId": 702345678901234580,
"errorMessage": ""
}
]