Create Universal Transfer

Create Universal Transfer

It allows to transfer funds between sub accounts, or master-sub account.

caution

• Can use master or sub acct api key to request
  • To use sub acct api key, it must have "SubMemberTransferList" permission
  • When use sub acct api key, it can only transfer to main 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.
• Currently, the funding wallet only supports outgoing transfers in cryptocurrency, not in fiat currency.

HTTP Request

POST /asset/v3/private/transfer/universal-transfer

Request Parameters

Parameter	Required	Type	Comments
transferId	true	string	UUID, which is unique across the platform
coin	true	string	Currency type
amount	true	string	Exchange to amount
fromMemberId	true	string	From UserID. fromMemberId cannot be the same as toMemberId
toMemberId	true	string	To UserID. fromMemberId cannot be the same as toMemberId
fromAccountType	true	string	Account type
toAccountType	true	string	Account type

Response Parameters

Parameter	Type	Comments
transferId	string	UUID, which is unique across the platform

Request Example

POST /asset/v3/private/transfer/universal-transfer HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: xxxxxxxxxxxx
X-BAPI-API-KEY: xxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1671163372208
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 219

{
    "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06",
    "coin": "USDT",
    "amount": "10",
    "fromMemberId":"111111",
    "toMemberId":"222222",
    "fromAccountType": "UNIFIED",
    "toAccountType": "SPOT"
}

Response Example

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "transferId": "42c0cfb0-6bca-c242-bc76-4e6df6cbcb06"
    },
    "retExtInfo": {},
    "time": 1671163373537
}