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

尊敬的用户:

自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权限:读取

CME比特币期货平均每日交易量在1月创新纪录:CME代表表示,在今年一月份,比特币期货平均每日交易量(ADV)达到月度记录,共计17,549张合约(合8.77万枚比特币)。在2020年12月,每日平均交易量达到11,179张合约(相当于5.59万枚比特币),这意味着增加了57%。(cointelegraph)[2021/2/25 17:50:00]

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

###订阅主题

`orders#${symbol}`

###订阅参数

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

研究:区块链行业自2013年已完成价值约27亿美元并购交易:金色财经报道,根据The Block的研究,自2013年以来,区块链领域共进行了134项并购交易,总价值约为27亿美元。其中,加密货币交易所的并购交易数量领先。[2020/7/4]

```

>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”。

动态 | 美国证券交易委员会将增加四个新职位以监管数字资产:据Cointelegraph消息,5月8日,美国证券交易委员会(SEC)和商品期货交易委员会(CFTC)两家金融机构的主席参加了国会预算听证会。SEC主席Jay Clayton在会上指出了数字资产和区块链技术的重要性,称SEC将会对包括加密货币相关高风险投资进行合规检查,要求在交易市场部门增加四个新职位负责监管数字资产市场。[2019/5/9]

```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"????}}```

当订单成交后–

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

```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:15ms0-2:596ms