移仓功能(适用主账户)

接口描述

支持主账户和母账户，子账户和子账户之间的移仓

HTTP请求

POST /sapi/v1/sub-account/futures/move-position

请求权重(ORDER)

150

请求参数

名称	类型	是否必需	描述
fromUserEmail	STRING	YES
toUserEmail	STRING	YES
productType	STRING	YES	仅支持 UM
orderArgs	LIST<JSON>	YES	一次最多支持 10 个仓位转移. orderArgs.symbol的参数类型为STRING, orderArgs.quantity的参数类型为BIGDECIMAL, orderArgs.positionSide的参数类型为STRING, positionSide 支持 BOTH,LONG and SHORT. 请求参数格式如下 orderArgs[0].symbol=BTCUSDT,orderArgs[0].quantity=0.001,orderArgs[0].positionSide=BOTH. 举例: orderArgs[0].symbol=BTCUSDT orderArgs[0].quantity=0.001 orderArgs[0].positionSide=BOTH orderArgs[1].symbol=ETHUSDT orderArgs[1].quantity=0.01 orderArgs[1].positionSide=BOTH
recvWindow	LONG	NO
timestamp	LONG	YES

• 您需要打开 API Key 的 Trading 权限以使用此接口。
• 该功能仅对VIP7-9开放.
• 只有母账户可以调用此接口。
• Quantity 必须为正数。
• 本功能支持普通合约账户, PM PRO 和 PM PRO SPAN 用户的仓位转移。
• 只有 from account 存在仓位才能调用此功能。
• 在同一个 orderArgs 的请求, 如果任何symbol的平仓总量大于该symbol的当前持仓量，则整个请求的订单都会失败。
• 仅支持全仓的仓位模式。
• 移仓价格默认且仅支持标记价格.
• MSA无法使用此功能。
• 用户账户上存在Reduce-Only设置的symbol无法使用此功能。

响应示例

{
	"movePositionOrders": [{
		"fromUserEmail": "testFrom@google.com",
		"toUserEmail": "testTo@google.com",
		"productType": "UM",
		"symbol": "BTCUSDT",
		"priceType": "MARK_PRICE",
		"price": "97139.00000000",
		"quantity": "0.001",
		"positionSide": "BOTH",
		"side": "BUY",
		"success": true
	}, {
		"fromUserEmail": "testFrom1@google.com",
		"toUserEmail": "1testTo@google.com",
		"productType": "UM",
		"symbol": "BTCUSDT",
		"priceType": "MARK_PRICE",
		"price": "97139.00000000",
		"quantity": "0.0011",
		"positionSide": "BOTH",
		"side": "BUY",
		"success": true
	}]
}