关于API将优化现有V2版本Websocket订单推送接口推送事件的公告

尊敬的用户:

当前,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” –

字段数据类型描述
eventTypestring事件类型,有效值:creation
symbolstring交易代码
orderIdlong订单ID
clientOrderIdstring用户自编订单号(如有)
orderPricestring订单价格
orderSizestring订单数量
typestring订单类型,有效值:sell-market, buy-limit, sell-limit, buy-limit-maker, sell-limit-maker, buy-ioc, sell-ioc, buy-limit-fok, sell-limit-fok
orderStatusstring订单状态,有效值:submitted
orderCreateTimelong订单创建时间

接口为市价买单推送的订单创建事件,orderSize被orderValue字段取代,订单状态(orderStatus)为“submitted” –

字段数据类型描述
eventTypestring事件类型,有效值:creation
symbolstring交易代码
orderIdlong订单ID
clientOrderIdstring用户自编订单号(如有)
orderPricestring订单价格
orderValuestring订单金额
typestring订单类型,有效值:buy-market
orderStatusstring订单状态,有效值:submitted
orderCreateTimelong订单创建时间

注:止盈止损订单在被触发前,接口不会推送其创建事件。

对用户的影响:

API用户需自行评估此新接口上线对用户自身业务的适配,并更新相关应用。

所有变更将自本通知生效之日起更新至 Huobi API Docs