Query Wallet Balance

GET🔒 Read

⚡ Query: 15 req/s per endpoint · 30 req/s per user

tip

Try It Out — test this endpoint in the API Explorer

Returns the user's futures wallet balance.

Request Parameters

Name	Type	Required	Description
wallet	String	No	Wallet identifier — CROSS@ or ISOLATED@{symbol}-USDT (e.g. ISOLATED@BTC-PERP-USDT). Optional — if omitted, returns balances across all wallets.

Response Content

Name	Type	Description
wallet	String	Wallet identifier
activeWalletName	String	Active wallet name
queryType	Integer	Query type
trackingID	Long	Internal tracking ID
walletTotalValue	Double	Wallet total value
totalValue	Double	Total value
marginBalance	Double	Margin balance
availableBalance	Double	Available balance
unrealisedProfitLoss	Double	Unrealized P&L
maintenanceMargin	Double	Maintenance margin
leverage	Double	Current leverage (CROSS: current, not setting)
openMargin	Double	Open margin
assets	Object[]	Available assets
assetsInUse	Object[]	Assets in use

example

GEThttps://api.btse.com/futures/api/v2.3/user/wallet

Response

[
  {
    "wallet": "CROSS@",
    "activeWalletName": "String",
    "queryType": 0,
    "trackingID": 0,
    "walletTotalValue": 0,
    "totalValue": 100,
    "marginBalance": 100,
    "availableBalance": 100,
    "unrealisedProfitLoss": 0,
    "maintenanceMargin": 0,
    "leverage": 0,
    "openMargin": 0,
    "assets": [
      {
        "balance": 0.20183537,
        "assetPrice": 7158.845,
        "currency": "BTC"
      }
    ],
    "assetsInUse": [
      {
        "balance": 0.01,
        "assetPrice": 7158.845,
        "currency": "BTC"
      }
    ]
  }
]