现货账户余额订阅

信息

• 该功能使用之前需要调用server.sign方法进行签名鉴权，具体签名规则请参阅认证
• 该接口推送延迟为：实时推送

资产余额订阅

• 方法: balance.subscribe
• 参数:

参数名	是否必须	类型	说明
ccy_list	true	[]string	资产名列表

• 订阅示例:

// 订阅单个资产余额
{
    "method": "balance.subscribe",
    "params": {"ccy_list": ["BTC"]},
    "id": 1
}

// 订阅多个资产余额
{
    "method": "balance.subscribe",
    "params": {"ccy_list": ["BTC", "ETH"]},
    "id": 1
}

// 订阅所有资产余额
{
    "method": "balance.subscribe",
    "params": {"ccy_list": []},
    "id": 1
}

资产余额推送

• 方法: balance.update
• 参数:

参数名	类型	说明
balance_list[n].margin_market	string	杠杆账户名，如果非杠杆市场，则为空
balance_list[n].ccy	string	资产名
balance_list[n].available	string	可用余额
balance_list[n].frozen	string	冻结余额
balance_list[n].updated_at	int	最新更新时间戳， 毫秒

• 示例:

{
    "method": "balance.update",
    "data": {
        "balance_list": [
            {
                "margin_market": "BTCUSDT",
                "ccy": "BTC",
                "available": "44.62207740",
                "frozen": "0.00000000",
                "updated_at": 1689152421692
            },
            {
                "margin_market": "BTCUSDT",
                "ccy": "USDT",
                "available": "44.62207740",
                "frozen": "0.00000000",
                "updated_at": 1689152421692
            }
        ]
    },
    "id": null
}

取消资产余额订阅

• 方法: balance.unsubscribe
• 参数:

参数名	是否必须	类型	说明
ccy_list	true	[]string	资产名列表

• 示例:

// 取消单个资产余额订阅
{
    "method": "balance.unsubscribe",
    "params": {"ccy_list": ["BTC"]},
    "id": 1
}

// 取消多个资产余额订阅
{
    "method": "balance.unsubscribe",
    "params": {"ccy_list": ["BTC", "ETH"]},
    "id": 1
}

// 取消所有资产余额订阅
{
    "method": "balance.unsubscribe",
    "params": {"ccy_list": []},
    "id": 1
}