Get Single Coin Balance
You could get a single coin balance under the master account, and sub account coin balance. Also, you can check the transferable amount from master to sub account, sub to master account or sub to sub account, especially for user who has an institutional loan.
Important
It is not allowed to get master account coin balance via sub account api key.
HTTP Request
GET /asset/v3/private/transfer/account-coin/balance/query
Request Parameters
Parameter | Required | Type | Comments |
---|---|---|---|
memberId | false | string | User Id. It is required when you use master api key to check sub account coin balance |
toMemberId | false | string | UID. Required when querying the transferable balance between different uids |
accountType | true | string | Account type |
toAccountType | false | string | To account type. Required when querying the transferable balance between different account types |
coin | true | string | Coin name |
withBonus | false | integer | Whether query bonus or not. 0 (default):false; 1 :true |
withTransferSafeAmount | false | integer | Whether query delay withdraw/transfer safe amount
|
withLtvTransferSafeAmount | false | integer | For OTC loan users in particular, you can check the transferable amount under risk level
|
Response Parameters
Parameter | Type | Comments |
---|---|---|
accountType | string | Account type |
bizType | integer | Account business subtype |
accountId | string | AccountID |
memberId | string | UserID |
balance | Object | |
> coin | string | Currency type |
> walletBalance | string | Wallet balance |
> transferBalance | string | Transferable balance |
> bonus | string | The bonus |
> transferSafeAmount | string | Safe amount to transfer. Keep "" if not query |
> ltvTransferSafeAmount | string | Transferable amount for ins loan account. Keep "" if not query |
Request Example
GET /asset/v3/private/transfer/account-coin/balance/query?accountType=CONTRACT&coin=USDT&withTransferSafeAmount=1&withBonus=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1678794085278
X-BAPI-RECV-WINDOW: 50000
Response Example
{
"retCode": 0,
"retMsg": "success",
"result": {
"accountType": "CONTRACT",
"bizType": 1,
"accountId": "533285",
"memberId": "533285",
"balance": {
"coin": "USDT",
"walletBalance": "0",
"transferBalance": "-995.3506",
"bonus": "995.3506",
"transferSafeAmount": "-995.3506",
"ltvTransferSafeAmount": ""
}
},
"retExtInfo": {},
"time": 1678794085705
}