用户委托单订阅

提示

• 该功能使用之前需要调用server.sign方法进行签名鉴权
• 该接口推送延迟为：实时推送

用户委托单订阅

• 方法: order.subscribe
• 参数:

参数名	是否必须	类型	说明
market_list	true	[]string	市场列表，空列表代表订阅所有市场

• 示例:

// 订阅单个市场
{
  "method": "order.subscribe",
  "params": {"market_list": ["BTCUSDT"]},
  "id": 1
}

// 订阅多个市场
{
  "method": "order.subscribe",
  "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
  "id": 1
}

// 订阅所有市场
{
  "method": "order.subscribe",
  "params": {"market_list": []},
  "id": 1
}

用户委托单更新推送

• 方法: order.update
• 参数:

参数名	类型	说明
event	string	订单更新事件类型
order	object	订单数据
order.order_id	int	订单id
order.market	string	市场名
order.margin_market	string	杠杆市场名，如果是非杠杆市场则为空
order.type	string	订单类型，limit 或 market 或 maker_only 或 IOC 或 FOK
order.side	string	订单方向，buy 或 sell
order.amount	string	订单数量
order.price	string	价格
order.unfilled_amount	string	未成交数量
order.filled_value	string	成交额
order.taker_fee_rate	string	taker 费率
order.maker_fee_rate	string	maker 费率
order.base_ccy_fee	string	交易币种支付的手续费
order.quote_ccy_fee	string	报价币种支付的手续费
order.discount_ccy_fee	string	主要为cet支付的手续费
order.last_filled_amount	string	最后一笔成交的数量
order.last_filled_price	string	最后一笔成交的价格
order.client_id	string	用户自定义id
order.created_at	int	下单时间戳，单位毫秒
order.updated_at	int	最新更新时间戳，单位毫秒

• 示例:

{
    "method": "order.update",
    "data": {
        "event": "put",
        "order": {
            "order_id": 12750,
            "market": "BTCUSDT",
            "margin_market": "BTCUSDT",
            "type": "limit",
            "side": "buy",
            "price": "5999.00",
            "amount": "1.50000000",
            "unfill_amount": "1.50000000",
            "fill_value": "1.50000000",
            "taker_fee_rate": "0.0001",
            "maker_fee_rate": "0.0001",
            "base_ccy_fee": "0.0001",
            "quote_ccy_fee": "0.0001",
            "discount_ccy_fee": "0.0001",
            "last_fill_amount": "0",
            "last_fill_price": "0",
            "client_id": "buy1_1234",
            "created_at": 1689152421692,
            "updated_at": 1689152421692,
        }
    },
    "id": null
}

取消委托订阅

• 方法: order.unsubscribe
• 参数:

参数名	是否必须	类型	说明
market_list	true	[]string	市场列表，空列表代表取消所有市场的订阅

• 示例:

// 取消单个市场订阅
{
  "method": "order.unsubscribe",
  "params": {"market_list": ["BTCUSDT"]},
  "id": 1
}

// 取消多个市场订阅
{
  "method": "order.unsubscribe",
  "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
  "id": 1
}

// 取消所有市场的订阅
{
  "method": "order.unsubscribe",
  "params": {"market_list": []},
  "id": 1
}