用户委托单订阅
提示
- 该功能使用之前需要调用
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.stop_id | int | 关联的计划委托订单id |
order.market | string | 市场名 |
order.side | string | 订单方向,buy 或 sell |
order.type | string | 订单类型,limit 或 market 或 GTC 或 IOC 或 FOK |
order.amount | string | 订单数量 |
order.price | string | 价格 |
order.unfilled_amount | string | 未成交数量 |
order.filled_amount | string | 成交量 |
order.filled_value | string | 成交额 |
order.client_id | string | 用户自定义id |
order.fee | string | 收取的交易手续费 |
order.fee_ccy | string | 收取的手续费币种 |
order.taker_fee_rate | string | taker 费率 |
order.maker_fee_rate | string | maker 费率 |
order.last_filled_amount | string | 最后一笔成交的数量 |
order.last_filled_price | string | 最后一笔成交的价格 |
order.created_at | int | 下单时间戳(毫秒) |
order.updated_at | int | 最新更新时间戳(毫秒) |
- 示例:
{
"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_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
}