市场成交订阅

信息

• 该接口推送延迟为：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	deal 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
}