仓位转移

描述

当前仅限模拟盘

支持母子账户互转及子账户间移仓：

1. 母账户向子账户移仓
2. 子账户向母账户移仓
3. 子账户向子账户移仓（需隶属于相同母账户）

• 该功能仅对白名单用户开放，仅能通过母账户的API Key调用，必须是同一母账户体系，当前仅支持USDT和USDC合约，仅支持全仓模式。
• 移仓生成的交易不会出现在公有行情的成交中，不产生手续费。
• 整点前后5分钟不支持移仓，源账户mmr>=80%不支持移仓。移仓前会撤销源账户和目标账户对应合约的订单，移仓价格默认且仅支持标记价格。
• 用户每日最多可触发50次移仓请求，调用成功算1次，每次移仓请求需间隔1分钟，每个移仓请求最多支持10个仓位。

HTTP请求

• POST /api/v3/account/move-positions
• 限频规则: 1次/秒/UID
• 需要统一账户交易读写权限

请求示例

curl -X POST "https://api.bitget.com/api/v3/account/move-positions" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json" \
  -d '{
    "fromUid": "111111111",
    "toUid": "222222222",
    "category": "USDT-FUTURES",
    "positionList": [
      {
        "symbol": "BTCUSDT",
        "side": "sell",
        "qty": "0.5"
      }
    ]
  }'

请求参数

参数名	参数类型	是否必须	描述
fromUid	String	是	移仓发起账户UID 转出仓位的账户 fromUid及toUid需隶属于同一母子账户体系
toUid	String	是	移仓目标账户UID 接收仓位的账户 fromUid及toUid需隶属于同一母子账户体系
category	String	是	产品类型 USDT-FUTURES USDT合约 COIN-FUTURES 币本位合约 USDC-FUTURES USDC合约
positionList	Array	是	仓位列表 单次请求最多10个仓位
>symbol	String	是	交易对名称 例如：BTCUSDT
>side	String	是	下单方向 buy/sell 单向模式/双向模式处理逻辑一致 持有多仓时，需传入side=sell进行减仓 持有空仓时，需传入side=buy进行减仓
>qty	String	是	转移数量 需满足最小数量精度要求

返回示例

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1695806875837,
  "data": {
    "fromList": [
      {
        "orderId": "121211212122",
        "clientOid": "131311313133",
        "code": "",
        "msg": ""
      }
    ],
    "toList": [
      {
        "orderId": "121211212123",
        "clientOid": "131311313134",
        "code": "",
        "msg": ""
      }
    ]
  }
}

返回参数

返回字段	参数类型	字段说明
fromList	Array	发起账户仓位列表
>orderId	String	发起订单ID
>clientOid	String	发起订单自定义ID
>code	String	错误码 平仓产生错误时返回
>msg	String	错误信息 平仓产生错误时返回
toList	Array	目标账户仓位结果列表
>orderId	String	目标订单ID
>clientOid	String	目标订单自定义ID
>code	String	错误码 开仓产生错误时返回
>msg	String	错误信息 开仓产生错误时返回