合約帳戶餘額訂閱

資訊

• 此功能使用前需要呼叫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
}