查詢代理商直客資產餘額

信息

• 每行為 user + coin 的總量，原幣種，不折算。

API頻率: 5次/秒

HTTP 請求

GET /private/v1/broker/asset-balance

請求參數

參數	是否必需	類型	說明
uid	false	string	輸入子UID查詢指定直客 不傳則返回當前代理商下全部子UID（仍按 UID 分頁）
coin	false	string	幣種篩選：不傳則每個 UID 下 coins 含全部幣種；傳值則每個 UID 下僅保留該幣種
cursor	false	string	游標，用於按 UID 翻頁，首次調用時不用傳
limit	false	integer	每頁最多 UID 數，取值 [1, 50]，默認 20

響應參數

參數	類型	說明
list	array	本頁每個 UID 一條
> user_id	string	直客UID
> coins	array	按幣種餘額
> > coin	string	幣種
> > total_balance	string	該幣種總量，口徑以業務約定為準
next_cursor	string	下一頁 UID 游標；無更多 UID 時為空

請求示例

import time
import hmac
import hashlib
import requests
import urllib.parse

def create_request(apiKey, secret, params):
    url = 'https://openapi-testnet.zoomex.com/private/v1/broker/asset-balance'
    timestamp = int(time.time() * 1000)
    recv_window = 1000000

    params['api_key'] = apiKey
    params['timestamp'] = timestamp
    params['recv_window'] = recv_window

    ordered_params = '&'.join([f"{key}={params[key]}" for key in sorted(params.keys())])

    signature = hmac.new(secret.encode('utf-8'), ordered_params.encode('utf-8'), hashlib.sha256).hexdigest()

    params['sign'] = signature

    headers = {
        'X-BAPI-API-KEY': apiKey,
        'X-BAPI-SIGN': signature,
        'X-BAPI-TIMESTAMP': str(timestamp),
        'X-BAPI-RECV-WINDOW': str(recv_window)
    }

    query_string = urllib.parse.urlencode(params)
    full_url = f"{url}?{query_string}"

    response = requests.get(full_url, headers=headers)

    print("响应状态:", response.status_code)
    print("响应信息:", response.json())
    print("响应时间:", response.elapsed.total_seconds())

apiKey = 'your key'
secret = 'your secret'
params = {
    "limit": 20,
}

create_request(apiKey, secret, params)

響應示例

{
    "ret_code": 0,
    "ret_msg": "OK",
    "ext_code": "",
    "result": {
        "list": [
            {
                "user_id": "101479471",
                "coins": [
                    {
                        "coin": "USDT",
                        "total_balance": "1000.25"
                    }
                ]
            }
        ],
        "next_cursor": ""
    },
    "ext_info": null,
    "time_now": 1718353045150
}