合约账户余额订阅

信息

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

资产余额订阅

• 方法: balance.subscribe
• 参数:

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

• 订阅示例:

// 订阅单个资产余额
{
    "method": "balance.subscribe",
    "params": {"ccy_list": ["USDT"]},
    "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].ccy	string	资产名
balance_list[n].available	string	可用余额
balance_list[n].frozen	string	冻结余额
balance_list[n].margin	string	仓位保证金
balance_list[n].transferrable	string	可转余额
balance_list[n].unrealized_pnl	string	未实现收益
balance_list[n].equity	string	账户权益

• 示例:

{
    "method": "balance.update",
    "data": {
        "balance_list": [
            {
                "ccy": "USDT",
                "available": "97.92470982756335000001",
                "frozen": "0.00000000000000000000",
                "margin": "0.61442700000000000000",
                "transferrable": "97.92470982756335000001",
                "unrealized_pnl": "-0.00807000000000000000",
                "equity": "97.92470982756335000001"
            },
            {
                "ccy": "BTC",
                "available": "97.92470982756335000001",
                "frozen": "0.00000000000000000000",
                "margin": "0.61442700000000000000",
                "transferrable": "97.92470982756335000001",
                "unrealized_pnl": "-0.00807000000000000000",
                "equity": "97.92470982756335000001"
            }
        ]
    },
    "id": null
}

取消资产余额订阅

• 方法: balance.unsubscribe
• 参数:

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

• 示例:

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

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

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