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 0(default)：false, 1：true What is delay withdraw amount?
withLtvTransferSafeAmount	false	integer	For OTC loan users in particular, you can check the transferable amount under risk level 0(default)：false, 1：true toAccountType is mandatory

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
}