用户计划委托单订阅
提示
- 该功能使用之前需要调用
server.sign
方法进行签名鉴权 - 该接口推送延迟为:实时推送
用户计划委托单订阅
- 方法:
stop.subscribe
- 参数:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
market_list | true | []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
- 参数:
参数名 | 类型 | 说明 |
---|---|---|
event | string | 计划单更新事件类型 |
stop | object | 计划委托信息 |
stop.stop_id | int | 订单id |
stop.market | string | 市场名 |
stop.margin_market | string | 杠杆市场名,如果是非杠杆市场则为空 |
stop.type | string | 订单类型,limit 或 market 或 maker_only 或 IOC 或 FOK |
stop.side | string | sell 或 buy |
stop.amount | string | 触发后的下单数量 |
stop.price | string | 触发后的下单价格,市价单为"0" |
stop.trigger_price | string | 触发价格 |
stop.trigger_direction | string | 计划单触发方向 |
stop.taker_fee_rate | string | taker 费率 |
stop.maker_fee_rate | string | maker 费率 |
stop.client_id | string | 用户自定义id |
stop.status | string | 计划单状态 |
stop.created_at | int | 委托时间,毫秒 |
stop.updated_at | int | 委托时间,毫秒 |
- 示例:
{
"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_list | true | []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
}