跳到主要内容

子母账户划转接口

限速规则 20次/1s (UID)

描述​

子母账户资产划转，该接口支持的划转类型包括

  • 母账户转子账户（仅母账户APIKey有权限）
  • 子账户转母账户（仅母账户APIKey有权限）
  • 子账户转子账户（仅母账户APIKey有权限，并要求发起与接收方子账户归属于同一母账户）
  • 子账户内部划转（仅母账户APIKey有权限，并要求发起与接收方子账户为同一子账户）

请求参数中的转入及转出账户UID须为母子/兄弟关系，且所有转账操作均只有母账户才有操作权限

HTTP请求​

  • POST /api/v2/spot/wallet/subaccount-transfer
请求示例
curl -X POST "https://api.bitget.com/api/v2/spot/wallet/subaccount-transfer" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json" \  
   -d \'{
    "fromUserId":"71292037611",
    "toUserId":"78643397621",
    "fromType":"spot",
    "toType":"spot",
    "amount":"10",
    "coin":"USDT",
    "clientOid":"1665300784123"
}'

请求参数​

参数名参数类型是否必须描述
fromTypeString是转出账户类型
spot 现货账户
coin_futures 币本位合约账户
usdt_futures U本位合约账户
usdc_futures USDC合约账户
crossed_margin 全仓杠杆账户
isolated_margin 逐仓杠杆账户
toTypeString是转入账户类型
spot 现货账户
coin_futures 币本位合约账户
usdt_futures U本位合约账户
usdc_futures USDC合约账户
crossed_margin 全仓杠杆账户
isolated_margin 逐仓杠杆账户
amountString是划转的数量
coinString是币种，如BTC
symbolString否交易对名称，如BTCUSDT (涉及到逐仓杠杆的划转时需要传)
clientOidString否客户自定义ID
fromUserIdString是转出账户UID
toUserIdString是转入账户UID
返回示例
{
    "code": "00000",
    "msg": "success",
    "requestTime": 1683875302853,
    "data": {
        "transferId": "112321312312312",
        "clientOid": "myclinetOid000001"
    }
}

返回参数​

返回字段参数类型字段说明
transferIdString划转产生的划转ID
clientOidString自定义clientOid