現貨帳戶餘額訂閱

資訊

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