账户余额

接口描述

查询合约交易账户余额。

HTTP请求

GET /fapi/v2/balance (HMAC SHA256)

请求权重

5

请求参数

名称	类型	是否必需	描述
timestamp	LONG	YES	时间戳

响应示例

[
    {
        "accountAlias": "SBNv99",
        "asset": "USDT",
        "balance": "122607.35137903",        // 总余额
        "crossWalletBalance": "23.72469206",  // 全仓钱包余额
        "crossUnPnl": "0.00000000",           // 全仓仓位未实现盈亏
        "availableBalance": "23.72469206",    // 下单可用余额
        "maxWithdrawAmount": "23.72469206",   // 最大可提现金额
        "marginAvailable": true,              // 是否可用作保证金
        "updateTime": 1561727140669
    }
]

代码示例

curl

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY_STRING}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')
curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api-sepolia.ztdx.io/fapi/v2/balance?${QUERY_STRING}&signature=${SIGNATURE}"

Python

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.ztdx.io"

timestamp = int(time.time() * 1000)
query_string = f"timestamp={timestamp}"
signature = hmac.new(API_SECRET.encode(), query_string.encode(), hashlib.sha256).hexdigest()

response = requests.get(
    f"{BASE_URL}/fapi/v2/balance",
    params={"timestamp": timestamp, "signature": signature},
    headers={"X-MBX-APIKEY": API_KEY}
)
for bal in response.json():
    print(f"{bal['asset']}: balance={bal['balance']} available={bal['availableBalance']}")