用户成交订阅

提示

该功能使用之前需要调用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
}