关于API将上线V2版本Websocket订单更新推送接口“orders#${symbol}”的通知

尊敬的用户:

自2020年4月3日起,火币Global将上线V2版本Websocket订单更新推送接口“orders#${symbol}”。

在以上新功能上线一个月之后,即2020年5月4日,火币Global将下线以下V1版本Websocket订单接口1)订单更新推送“orders.$symbol”;2)订单更新推送“orders.$symbol.update”;3)请求当前及历史订单“order.list”;4)以订单编号请求订单“orders.detail”。

生效日期:2020年4月3日

具体变更细节及参数要求,请参考API文档:https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站2020年4月4日

##订阅订单更新

APIKey权限:读取

美国将举行关于央行数字货币和稳定币的听证会:美国参议院银行委员会、住房和城市事务委员会将举行”货币的数字化和支付”听证会。虽然细节尚未公布,但前商品期货交易委员会(CFTC)主席 J. Christopher Giancarlo、Paxos联合创始人兼首席执行官Charles Cascarilla和杜克大学法学教授Nakita Cuttino将作证词。听证会重点部分可能集中在央行数字货币和稳定币上。(coindesk)[2020/6/30]

订单的更新推送由任一以下事件触发:-订单创建;-订单成交;-订单撤销。但根据不同事件类型所推送的消息中,字段列表略有不同。

###订阅主题

`orders#${symbol}`

###订阅参数

参数数据类型描述symbolstring交易代码>Subscriberequest```json{????"action":"sub",????"ch":"orders#btcusdt"}

公告 | 中币(ZB)关于支持BSV Genesis升级公告:BSV将于区块高度620,538进行Genesis升级,为支持本次升级,中币(ZB)将于香港时间2020年2月3日21:00暂停BSV充值和提现业务,BSV交易不受影响。更多BSV Genesis升级详情请登录中币(ZB)官网。[2020/2/3]

```

>Response

```json{????"action":"sub",????"code":200,????"ch":"orders#btcusdt",????"data":{}}```

###数据更新字段列表

当订单被创建后–

字段数据类型描述eventTypestring事件类型,有效值:creationsymbolstring交易代码orderIdlong订单IDclientOrderIdstring用户自编订单号orderPricestring订单价格orderSizestring订单数量typestring订单类型,有效值:buy-limit,sell-limit,buy-limit-maker,sell-limit-makerorderStatusstring订单状态,有效值:submittedorderCreateTimelong订单创建时间注:止盈止损订单在尚未被触发时,接口将不会推送此订单的创建。仅当止盈止损订单被触发且未成交,接口才会被推送此订单的“creation”事件类型。并且,推送消息中的订单类型不再是原始订单类型“buy-stop-limit”或“sell-stop-limit”,而是变为“buy-limit”或“sell-limit”。

汇币网发布关于MOAC暂停充值业务公告:由于MOAC主网上线,HB.top现已暂停MOAC的充值业务,提币业务不受影响。[2018/5/8]

```json{"action":"push","ch":"orders#btcusdt","data":{????"orderSize":"2.000000000000000000",????"orderCreateTime":1583853365586,????"orderPrice":"77.000000000000000000",????"type":"sell-limit",????"orderId":27163533,????"clientOrderId":"a001",????"orderStatus":"submitted",????"symbol":"btcusdt",????"eventType":"creation"????}}```

Upbit发布关于开展GTO活动的公告:为了庆祝GTO在Upbit上市,Upbit将进行两个活动。第一是针对持有1000个以上GTO的用户,从中抽取117名用户发送加密货币GTO。第二是持有加密货币GTO数量TOP100发放虚拟货币。其活动时间是从4月27日至5月4日。[2018/4/27]

当订单成交后–

字段数据类型描述eventTypestring事件类型,有效值:tradesymbolstring交易代码tradePricestring成交价tradeVolumestring成交量orderIdlong订单IDclientOrderIdstring用户自编订单号tradeIdlong成交IDtradeTimelong成交时间aggressorbool是否交易主动方,有效值:true,falseorderStatusstring订单状态,有效值:partial-filled,filledexecAmtstring已成交数量remainAmtstring未成交数量注:当一张taker订单同时与对手方多张订单成交后,所产生的每笔成交将被分别推送。

关于开放ETP、CMC币种充提币服务的公告:元界(ETP)钱包已经更新维护完成,QBTC平台已开放ETP、CMC币种充提币服务。[2018/3/22]

```json{????"action":"push",????"ch":"orders#btcusdt",????"data":????{????"tradePrice":"76.000000000000000000",????"tradeVolume":"1.013157894736842100",????"tradeId":301,????"tradeTime":1583854188883,????"aggressor":true,????"execAmt":"1.013157894736842100",????"remainAmt":"0.000000000000000400000000000000000000",????"orderId":27163536,????"clientOrderId":"",????"orderStatus":"filled",????"symbol":"btcusdt",????"eventType":"trade"????}}```

当订单被撤销后–

字段数据类型描述eventTypestring事件类型,有效值:cancellationsymbolstring交易代码orderIdlong订单IDclientOrderIdstring用户自编订单号orderStatusstring订单状态,有效值:partial-canceled,canceledremainAmtstring未成交数量lastActTimelong订单最近更新时间```json{????"action":"push",????"ch":"orders#btcusdt",????"data":????{????"lastActTime":1583853475406,????"remainAmt":"2.000000000000000000",????"orderId":27163533,????"clientOrderId":"a001",????"orderStatus":"canceled",????"symbol":"btcusdt",????"eventType":"cancellation"????}}```

在以上新接口上线一个月之后,即2020年5月4日,火币Global将下线以下V1版本Websocket接口–1)订单更新推送“orders.$symbol”;2)订单更新推送“orders.$symbol.update”;3)请求当前及历史订单“order.list”;4)以订单编号请求订单“orders.detail”。用户可以通过订阅新上线的“orders#${symbol}”获取订单更新推送,并通过现有RESTful订单查询接口获取订单列表及订单详情。

对用户的影响:API用户需自行评估此新接口上线对用户自身业务的适配,以及即将下线接口的迁移,并更新相关应用。

所有变更将自本通知生效之日起更新至HuobiAPIDocs。

郑重声明: 本文版权归原作者所有, 转载文章仅为传播更多信息之目的, 如作者信息标记有误, 请第一时间联系我们修改或删除, 多谢。

银河链

[0:0ms0-0:932ms