査詢現貨/資金帳戶資產

提示

• 因歷史原因，該API使用v1的鑒權方式

HTTP 請求

GET /cloud/trade/v3/asset/transfer/query-asset-info

請求參數

參數	是否必需	類型	說明
accountType	true	string	賬戶類型. SPOT 或者 FUND，默认SPOT
coin	false	string	幣種

響應參數

參數	類型	說明
spot	Object
> status	string	賬戶狀態. ACCOUNT_STATUS_NORMAL: 正常, ACCOUNT_STATUS_UNSPECIFIED: 禁用
> assets	array	Object
>> coin	string	幣種
>> free	string	可用余額
>> total_balance	string	总余額
fund	Object
> status	string	賬戶狀態. ACCOUNT_STATUS_NORMAL: 正常, ACCOUNT_STATUS_UNSPECIFIED: 禁用
> assets	array	Object
>> coin	string	幣種
>> free	string	可用余額
>> total_balance	string	总余額

---

請求示例

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

def create_request(apiKey, secret, params):
    url = 'https://openapi-testnet.zoomex.com/cloud/trade/v3/asset/transfer/query-asset-info'
    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:", response.status_code)
    print("response info:", response.json())
    print("response time:", response.elapsed.total_seconds())

apiKey = 'your key'
secret = 'your secret'
params = {
    "accountType": "SPOT",
}

create_request(apiKey, secret, params)

響應示例

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "spot": {
            "status": "ACCOUNT_STATUS_NORMAL",
            "assets": [
                {
                    "coin": "BTC",
                    "free": "0.004560435",
                    "total_balance": "0.004560435"
                }
            ]
        }
},
    "retExtInfo": {},
    "time": 1672136539127
}