Wallet Balance

Get wallet balance

HTTP Request

GET /unified/v3/private/account/wallet/balance

Request Parameters

Parameter	Required	Type	Comments
coin	false	string	Coin name

Response Parameters

Parameter	Type	Comments
accountIMRate	string	Initial Margin Rate: Account Total Initial Margin Base Coin / Account Margin Balance Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
accountMMRate	string	Maintenance Margin Rate: Account Total Maintenance Margin Base Coin / Account Margin Balance Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
totalEquity	string	Equity of account converted to usd：Account Margin Balance Base Coin + Account Option Value Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
totalWalletBalance	string	Wallet Balance of account converted to usd：∑ Asset Wallet Balance Base Coin。In non-uniform margin mode, the field will be returned as an empty string.
totalMarginBalance	string	Margin Balance of account converted to usd：Account Wallet Balance Base Coin + Account Perp UPL Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
totalAvailableBalance	string	Available Balance of account converted to usd：RM：Account Margin Balance Base Coin - Account Initial Margin Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
totalPerpUPL	string	Unrealised P&L of perpetuals of account converted to usd：∑ Asset Perp UPL Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
totalInitialMargin	string	Initial Margin of account converted to usd：∑ Asset Total Initial Margin Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
totalMaintenanceMargin	string	Maintenance Margin of account converted to usd: ∑ Asset Total Maintenance Margin Base Coin. In non-uniform margin mode, the field will be returned as an empty string.
coin	array	Object
> currencyCoin	string	Coin name, such as BTC, ETH, USDT, USDC
> availableToBorrow	string	Depreciated field, always return "" due to feature of main-sub uid sharing borrow quota
> borrowSize	string	Lending amount used. For USDC and USDT only. For BTC and ETH, return 0
> bonus	string	Trial fund
> accruedInterest	string	Accrued interest of an asset
> availableBalanceWithoutConvert	string	Available balance, Margin Balance - Total Initial Margin
> totalOrderIM	string	Order margin pre-occupied. For portfolio margin mode, it returns ""
> equity	string	Equity
> totalPositionMM	string	Sum of maintenance margin for all positions. For portfolio margin mode, it returns ""
> usdValue	string	usd value
> availableBalance	string	AB from other assets + the actual AB balance from the current assets (cannot be negative)
> unrealisedPnl	string	Unrealised P&L
> totalPositionIM	string	Sum of initial margin of all positions + Pre-occupied liquidation fee. For portfolio margin mode, it returns ""
> marginBalanceWithoutConvert	string	Margin balance
> walletBalance	string	Wallet balance
> cumRealisedPnl	string	Cumulative Realised P&L
> marginBalance	string	MB from other assets + the actual MB balance from the current assets

Request Example

GET /unified/v3/private/account/wallet/balance?coin=ETH HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672021457498
X-BAPI-RECV-WINDOW: 5000

Response Example

{
    "retCode": 0,
    "retMsg": "Success",
    "result": {
        "totalEquity": "5952.13539158",
        "accountIMRate": "0.1037",
        "totalMarginBalance": "6003.96034690",
        "totalInitialMargin": "622.37237856",
        "totalAvailableBalance": "5381.58796835",
        "accountMMRate": "0.0361",
        "totalPerpUPL": "-733.16272882",
        "totalWalletBalance": "6733.45726207",
        "totalMaintenanceMargin": "216.49590186",
        "coin": [
        {
            "currencyCoin": "ETH",
            "availableToBorrow": "0.00000000",
            "borrowSize": "0.00000000",
            "bonus": "0.00000000",
            "accruedInterest": "0.00000000",
            "availableBalanceWithoutConvert": "0.00000000",
            "totalOrderIM": "",
            "equity": "0.00000000",
            "totalPositionMM": "",
            "usdValue": "0.00000000",
            "availableBalance": "4.41128415",
            "unrealisedPnl": "",
            "totalPositionIM": "",
            "marginBalanceWithoutConvert": "0.00000000",
            "walletBalance": "0.00000000",
            "cumRealisedPnl": "",
            "marginBalance": "4.92144238"
        }
    ]
},
    "retExtInfo": {},
    "time": 1672021457963
}