市場成交訂閱

資訊

• 此介面推送延遲為：200ms

市場成交訂閱

• 方法: deals.subscribe
• 參數:

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

• 訂閱範例:

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

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

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

最新市場成交推送

• 方法: deals.update
• 參數:

參數名	類型	說明
market	string	市場名
deal_list	array	最新成交列表
deal_list[n].deal_id	int	成交id
deal_list[n].created_at	int	成交時間戳記（毫秒）
deal_list[n].side	string	taker方向, "buy"或"sell"
deal_list[n].price	string	成交價格
deal_list[n].amount	string	成交數量

• 範例:

// market's deal
{
    "method": "deals.update",
    "data": {
        "market": "BTCUSDT",
        "deal_list": [
            {
                "deal_id": 3514376759,
                "created_at": 1689152421692,
                "side": "buy",
                "price": "30718.42",
                "amount": "0.00000325"
            },
            {
                "deal_id": 3514376758,
                "created_at": 1689152421692,
                "side": "buy",
                "price": "30718.42",
                "amount": "0.00015729"
            },
            {
                "deal_id": 3514376757,
                "created_at": 1689152421692,
                "side": "sell",
                "price": "30718.42",
                "amount": "0.00154936"
            }
        ]
    },
    "id": null
}

取消最新市場成交訂閱

• 方法: deals.unsubscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場名列表，如果為空列表則全部取消訂閱

• 範例:

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

// 取消多個訂閱

{
    "method": "deals.unsubscribe",
    "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
    "id": 1
}

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