跳到主要内容

用户计划委托单订阅

提示
  • 该功能使用之前需要调用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.sidestringbuy 或 sell
stop.typestring订单类型,limit 或 market 或 GTC 或 IOC 或 FOK
stop.pricestring触发后的下单价格,市价单为"0"
stop.amountstring触发后的下单数量
stop.trigger_pricestring触发价格
stop.trigger_directionstring计划单触发方向
stop.trigger_price_typestring触达价格类型,latest_price 或 mark_price 或 index_price
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": "put",
"stop": {
"stop_id": 98389557871,
"market": "BTCUSDT",
"side": "sell",
"type": "limit",
"price": "20000.00",
"amount": "0.0100",
"trigger_price": "20000.00",
"trigger_direction": "higer",
"trigger_price_type": "index_price",
"taker_fee_rate": "0.00046",
"maker_fee_rate": "0.00026",
"client_id": "",
"status": "active_success",
"created_at": 1689146382674,
"updated_at": 1689146382674
}
},
"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
}