关于API将优化现有V2版本Websocket订单推送接口推送事件的公告
- API 公告
尊敬的用户:
当前,V2版本订单推送接口“orders#${symbol}”仅推送maker订单的创建事件(eventType=creation)。当taker订单被创建后,该接口仅推送成交事件(eventType=trade)。
自本通知生效之日起,火币Global将为以下场景的订单创建,首先推送订单创建事件(eventType=creation)-
1) 限价taker订单(type=buy-limit, sell-limit)下单后即刻部分成交;
2) 限价taker订单(type=buy-limit, sell-limit)下单后即刻全部成交;
3) IOC订单(type=buy-ioc, sell-ioc)下单后即刻完全成交;
4) IOC订单(type=buy-ioc, sell-ioc)下单后即刻部分成交,剩余撤销;
5) IOC订单(type=buy-ioc, sell-ioc)下单后不能成交,即刻完全撤销;
6) FOK订单(type=buy-limit-fok, sell-limit-fok)下单后即刻完全成交;
7) FOK订单(type=buy-limit-fok, sell-limit-fok)下单后不能完全成交,即刻完全撤销;
8) 市价卖单(type=sell-market)下单后即刻完全成交;
9) 市价卖单(type=sell-market)下单后即刻部分成交,剩余撤销;
10) 市价卖单(type=sell-market)下单后即刻全部撤销;
11) 限价maker(type=buy-limit-maker, sell-limit-maker)订单下单后即刻全部撤销;
12) 市价买单(type=buy-market)下单后即刻完全成交;
13) 市价买单(type=buy-market)下单后即刻部分成交,剩余撤销;
14) 市价买单(type=buy-market)下单后即刻全部撤销。
生效日期:2020年5月29日(GMT+8)
具体变更细节及参数要求,请参考API文档:https://huobiapi.github.io/docs/spot/v1/cn/
火币全球站
2020年5月26日
接口为以上场景推送的订单创建事件,消息格式与现有相同,订单状态(orderStatus)为“submitted” –
字段 | 数据类型 | 描述 |
eventType | string | 事件类型,有效值:creation |
symbol | string | 交易代码 |
orderId | long | 订单ID |
clientOrderId | string | 用户自编订单号(如有) |
orderPrice | string | 订单价格 |
orderSize | string | 订单数量 |
type | string | 订单类型,有效值:sell-market, buy-limit, sell-limit, buy-limit-maker, sell-limit-maker, buy-ioc, sell-ioc, buy-limit-fok, sell-limit-fok |
orderStatus | string | 订单状态,有效值:submitted |
orderCreateTime | long | 订单创建时间 |
接口为市价买单推送的订单创建事件,orderSize被orderValue字段取代,订单状态(orderStatus)为“submitted” –
字段 | 数据类型 | 描述 |
eventType | string | 事件类型,有效值:creation |
symbol | string | 交易代码 |
orderId | long | 订单ID |
clientOrderId | string | 用户自编订单号(如有) |
orderPrice | string | 订单价格 |
orderValue | string | 订单金额 |
type | string | 订单类型,有效值:buy-market |
orderStatus | string | 订单状态,有效值:submitted |
orderCreateTime | long | 订单创建时间 |
注:止盈止损订单在被触发前,接口不会推送其创建事件。
对用户的影响:
API用户需自行评估此新接口上线对用户自身业务的适配,并更新相关应用。
所有变更将自本通知生效之日起更新至 HTX API Docs。