Skip to main content

Create Universal Transfer

Transfer between sub-sub or main-sub.

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.
  • You can not transfer between the same UID.
  • Currently, the funding wallet only supports outgoing transfers in cryptocurrency, not in fiat currency.

HTTP Request

POST /v5/asset/transfer/universal-transfer

Request Parameters

ParameterRequiredTypeComments
transferIdtruestringUUID. Please manually generate a UUID
cointruestringCoin
amounttruestringAmount
fromMemberIdtrueintegerFrom UID
toMemberIdtrueintegerTo UID
fromAccountTypetruestringFrom account type
toAccountTypetruestringTo account type

Response Parameters

ParameterTypeComments
transferIdstringUUID

Request Example

POST /v5/asset/transfer/universal-transfer HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672189449697
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXX
Content-Type: application/json

{
"transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
"coin": "ETH",
"amount": "0.5",
"fromMemberId": 592334,
"toMemberId": 691355,
"fromAccountType": "CONTRACT",
"toAccountType": "UNIFIED"

}

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"transferId": "be7a2462-1138-4e27-80b1-62653f24925e"
},
"retExtInfo": {},
"time": 1672189450195
}