用户成交订阅

提示

• 该功能使用之前需要调用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	成交时间戳(毫秒)
order_id	int	关联的订单id
client_id	string	客户端 ID
position_id	int	仓位 ID
market	string	市场名
side	string	buy 或 sell
price	string	成交价
amount	string	成交量
role	string	taker或者maker
fee	string	收取的交易手续费
fee_ccy	string	收取的手续费币种

• 示例:

{
    "method": "user_deals.update",
    "data": {
        "deal_id": 123456789,
        "created_at": 1689152421692,
        "order_id": 12345678,
        "client_id": "client_id_1",
        "position_id": 927266133,
        "market": "BTCUSDT",
        "side": "buy",
        "price": "30718.42",
        "amount": "0.123",
        "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
}