Get Wallet Balance

Get your futures wallet balance — total + available + per-symbol breakdown of locked margin.

HTTP

Method	GET
Endpoint	/trade/api/v2/futures/wallet_balance
Rate limit	20 requests per 60 seconds

Request Parameters

None.

Example

Python

import requests

headers, path = sign_request("GET", "/trade/api/v2/futures/wallet_balance")
response = requests.get(BASE_URL + path, headers=headers)
print(response.json())

Java

HttpResponse<String> resp = client.send(
    "GET", "/trade/api/v2/futures/wallet_balance", null, null);
System.out.println(resp.body());

Go

headers, p, err := SignRequest("GET", "/trade/api/v2/futures/wallet_balance", nil)
if err != nil { panic(err) }

req, _ := http.NewRequest("GET", BaseURL+p, nil)
for k, v := range headers { req.Header.Set(k, v) }
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))

Node.js

const {signRequest, BASE_URL} = require('./reference-client');

const {headers, path} = signRequest('GET', '/trade/api/v2/futures/wallet_balance');
const r = await fetch(BASE_URL + path, {
  method: 'GET',
  headers,
});
console.log(await r.json());

Response

{
  "data": {
    "base_asset_balances": [
      {
        "base_asset": "USDT",
        "balances": {
          "total_balance": "60960.82599588",
          "total_available_balance": "60910.77418715",
          "total_blocked_balance": "50.05180873",
          "total_position_margin": "56.83032573",
          "total_open_order_margin": "-6.778517"
        }
      }
    ],
    "asset": [
      {
        "symbol": "DOGEUSDT",
        "base_asset": "USDT",
        "exchange": "EXCHANGE_2",
        "blocked_balance": "50.04968529",
        "position_margin": "50.04959675",
        "open_order_margin": "0.00008854"
      }
    ]
  }
}

Response Parameters

data has two arrays.

base_asset_balances — overall totals per quote/settlement asset (USDT)

Field	Type	Description
base_asset	string	Settlement asset, currently USDT.
balances.total_balance	string	Total wallet balance (USDT).
balances.total_available_balance	string	Available for new orders/positions or for Add Margin.
balances.total_blocked_balance	string	Locked in open orders + active positions.
balances.total_position_margin	string	Sum of position_margin across all open positions.
balances.total_open_order_margin	string	Margin reserved for open orders. May be negative for reduce-only orders.

asset — per-symbol breakdown of locked margin

Field	Type	Description
symbol	string	Symbol.
base_asset	string	Settlement asset (USDT).
exchange	string	Exchange identifier.
blocked_balance	string	Total locked balance for this symbol.
position_margin	string	Margin held against the open position on this symbol.
open_order_margin	string	Margin reserved for open orders on this symbol.