跳到主要内容

用户委托单订阅

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

用户委托单订阅

  • 方法: order.subscribe
  • 参数:
参数名是否必须类型说明
market_listtrue[]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
  • 参数:
参数名类型说明
eventstring订单更新事件类型
orderobject订单数据
order.order_idint订单id
order.stop_idint关联的计划委托订单id
order.marketstring市场名
order.sidestring订单方向,buy 或 sell
order.typestring订单类型,limit 或 market 或 GTC 或 IOC 或 FOK
order.amountstring订单数量
order.pricestring价格
order.unfilled_amountstring未成交数量
order.filled_amountstring成交量
order.filled_valuestring成交额
order.client_idstring用户自定义id
order.feestring收取的交易手续费
order.fee_ccystring收取的手续费币种
order.taker_fee_ratestringtaker 费率
order.maker_fee_ratestringmaker 费率
order.last_filled_amountstring最后一笔成交的数量
order.last_filled_pricestring最后一笔成交的价格
order.created_atint下单时间戳(毫秒)
order.updated_atint最新更新时间戳(毫秒)
  • 示例:
{
"method": "order.update",
"data": {
"event": "put",
"order": {
"order_id": 98388656341,
"stop_id": 0,
"market": "BTCUSDT",
"side": "buy",
"type": "limit",
"amount": "0.0010",
"price": "50000.00",
"unfilled_amount": "0.0010",
"filled_amount": "0",
"filled_value": "0",
"fee": "0",
"fee_ccy": "USDT",
"taker_fee_rate": "0.00046",
"maker_fee_rate": "0.00000000000000000000",
"client_id": "",
"last_filled_amount": "0.0010",
"last_filled_price": "30721.35",
"created_at": 1689145715129,
"updated_at": 1689145715129
}
},
"id": null
}

取消委托订阅

  • 方法: order.unsubscribe
  • 参数:
参数名是否必须类型说明
market_listtrue[]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
}