用戶成交訂閱

提示

此功能使用前需要呼叫server.sign方法進行簽章鑑權

資訊

• 此介面推送延遲為：即時推送

用戶成交訂閱

• 方法: user_deals.subscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場列表，空白列表代表訂閱所有市場

• 範例:

// 訂閱單一市場
{
    "method": "user_deals.subscribe",
    "params": {"market_list": ["BTCUSDT"]},
    "id": 1
}

// 訂閱多個市場
{
    "method": "user_deals.subscribe",
    "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
    "id": 1
}

// 訂閱所有市場
{
    "method": "user_deals.subscribe",
    "params": {"market_list": []},
    "id": 1
}

用戶成交推送

• 方法: user_deals.update
• 參數:

參數名	類型	說明
deal_id	int	成交id
created_at	int	成交時間戳，毫秒
market	string	市場名
side	string	buy或者sell
order_id	int	訂單id
client_id	string	客戶端ID
margin_market	string	槓桿市場，如果是非槓桿市場則為空
price	string	成交價
amount	string	成交量
role	string	taker或maker
fee	string	收取的交易手續費
fee_ccy	string	收取的手續費幣種

• 範例:

{
    "method": "user_deals.update",
    "data": {
        "deal_id": 3514376759,
        "created_at": 1689152421692,
        "market": "BTCUSDT",
        "side": "buy",
        "order_id": 8678890,
        "client_id": "client_id_1",
        "margin_market": "BTCUSDT",
        "price": "30718.42",
        "amount": "0.00000325",
        "role": "taker",
        "fee": "0.0299",
        "fee_ccy": "USDT"
    },
    "id": null
}

取消用戶成交訂閱

• 方法: user_deals.unsubscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場列表，空白列表代表取消所有市場的訂閱

• 範例:

// 取消訂閱單一市集
{
    "method": "user_deals.unsubscribe",
    "params": {"market_list": ["BTCUSDT"]},
    "id": 1
}

// 取消訂閱多個市場
{
    "method": "user_deals.unsubscribe",
    "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
    "id": 1
}

// 取消訂閱所有市場
{
    "method": "user_deals.unsubscribe",
    "params": {"market_list": []},
    "id": 1
}