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.
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
}