跳到主要内容

用户计划委托单订阅

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

用户计划委托单订阅

  • 方法: stop.subscribe
  • 参数:
参数名是否必须类型说明
market_listtrue[]string市场列表,空列表代表订阅所有市场
  • 示例:
// 订阅单个市场
{
"method": "stop.subscribe",
"params": {"market_list": ["BTCUSDT"]},
"id": 1
}

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

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

计划委托单更新推送

  • 方法: stop.update
  • 参数:
参数名类型说明
eventstring计划单更新事件类型
stopobject计划委托信息
stop.stop_idint订单id
stop.marketstring市场名
stop.margin_marketstring杠杆市场名,如果是非杠杆市场则为空
stop.typestring订单类型,limit 或 market 或 maker_only 或 IOC 或 FOK
stop.sidestringsell 或 buy
stop.amountstring触发后的下单数量
stop.pricestring触发后的下单价格,市价单为"0"
stop.trigger_pricestring触发价格
stop.trigger_directionstring计划单触发方向
stop.taker_fee_ratestringtaker 费率
stop.maker_fee_ratestringmaker 费率
stop.client_idstring用户自定义id
stop.statusstring计划单状态
stop.created_atint委托时间,毫秒
stop.updated_atint委托时间,毫秒
  • 示例:
{
"method": "stop.update",
"data": {
"event": 1,
"stop": {
"stop_id": 102067022299,
"market": "BTCUSDT",
"margin_market": "BTCUSDT",
"type": "limit",
"side": "buy",
"price": "20000.00",
"amount": "0.10000000",
"trigger_price": "20000.00",
"trigger_direction": "lower",
"taker_fee_rate": "0.0016",
"maker_fee_rate": "0.0016",
"status": "active_success",
"client_id": "",
"created_at": 1689152996689,
"updated_at": 1689152996689,
}
},
"id": null
}

取消计划委托订阅

  • 方法: stop.unsubscribe
  • 参数:
参数名是否必须类型说明
market_listtrue[]string市场列表,空列表代表订阅所有市场
  • 示例:

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

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

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