Skip to main content

Wallet Balance

Get wallet balance, including Derivatives account and USDC account.

HTTP Request

GET /contract/v3/private/account/wallet/balance

Request Parameters

ParameterRequiredTypeComments
coinfalsestringCoin
  • Return all wallet info if not passed
  • Multiple coins are allowed, separated by comma, like USDT,USDC

Response Parameters

ParameterTypeComments
listarrayObject
> coinstringCoin
> equitystringTotal equity
> walletBalancestringWallet balance
> positionMarginstringPosition margin
> availableBalancestringAvailable balance
> orderMarginstringPre-occupied order margin
> occClosingFeestringPosition closing fee occupied. formula: opening fee + expected maximum closing fee
> occFundingFeestringPre-occupied funding fee
> unrealisedPnlstringUnrealised pnl
> cumRealisedPnlstringCumulative realised pnl (all-time)
> givenCashstringTrial fund. Find out more here
> serviceCashstringCoupon. Find out more here
> accountIMstringUSDC account initial margin
> accountMMstringUSDC account maintenance margin

Request Example

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

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"list": [
{
"coin": "USDC",
"equity": "1259.7788251",
"walletBalance": "1259.7488251",
"positionMargin": "1259.7788251",
"availableBalance": "1246.7387871",
"orderMargin": "0",
"occClosingFee": "0",
"occFundingFee": "0",
"unrealisedPnl": "0.03",
"cumRealisedPnl": "26.6561752",
"givenCash": "0",
"serviceCash": "0",
"accountIM": "13.040038",
"accountMM": "1.367038"
}
]
},
"retExtInfo": {},
"time": 1670923631261
}