Skip to main content

Create Subaccount Transfer

Transfer funds between the parent and child (sub) accounts.

To send a transfer which is accountType & parent/sub agnostic, use the Create Universal Transfer endpoint.

tip
  • Please note that the transferId field in the incoming request data of this interface is UUID globally unique
  • This interface can only be used for transfer between parent and child accounts
  • A subaccount can only be attributed to a parent account.
  • If you encounter errorCode: 131228 and msg: your balance is not enough, please go to Get Single Coin Balance to check transfer safe amount.
  • It's mandatory to utilize the API key of the main account

HTTP Request

POST /asset/v3/private/transfer/sub-member-transfer

Request Parameters

ParameterRequiredTypeComments
transferIdtruestringUUID, which is unique across the platform
cointruestringCurrency type
amounttruestringExchange to amount
subMemberIdtrueintegerSubaccount userid
typetruestringDetermines the direction of transfer.
  • IN transfer from main account to subaccount
  • OUT transfer from subaccount to main account

Response Parameters

ParameterTypeComments
transferIdstringUUID, which is unique across the platform

Request Example

POST /asset/v3/private/transfer/sub-member-transfer HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1670925915816
X-BAPI-RECV-WINDOW: 50000
X-BAPI-SIGN: xxxxxxxxxxxxx
Content-Type: application/json
Content-Length: 144

{
"transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f",
"coin": "USDT",
"amount": "5",
"subMemberId": 554137,
"type": "IN"
}

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"transferId": "2811a2ca-b42c-4cda-a21f-3df0a1f2516f"
},
"retExtInfo": {},
"time": 1670925915979
}