【API 公告】关于API支持止盈止损限价订单的公告

尊敬的用户：

当前火币Global官网web页面支持止盈止损订单。自本通知生效之日起，火币Global将在API接口中也支持这一订单类型（目前仅支持限价单）。

生效日期：2019年8月29日（GMT+8）
具体变更细节及参数要求，请参考API文档：https://huobiapi.github.io/docs/spot/v1/cn/

火币全球站
2019年9月2日

以下为接口变更的细则：
用户在下止盈止损订单时，须额外填写触发价 “stop-price” 与触发价运算符“operator”，并在订单类型 “type” 中指定订单类型 – “buy-stop-limit” 或 “sell-stop-limit”。其中，触发价运算符为 ”gte” 时，表示当市场最新成交价大于等于此触发价时该止盈止损订单将被触发；触发价运算符为 ”lte” 时，表示当市场最新成交价小于等于此触发价时该止盈止损订单将被触发。如果用户设置的触发价及运算符导致下单即被触发，该止盈止损订单将被拒绝接受。

在目前阶段，火币Global将仅支持止盈止损限价订单。

止盈止损订单在被创建时，订单状态 “state” 为 “created”。在被触发后，订单状态 “state” 变为 “submitted”，进入待撮合订单队列。订单为 “created” 状态时，Websocket订单更新接口将不会推送该订单，但该状态止盈止损订单可被查询。当订单被触发订单状态变为 “submitted” 时，Websocket订单更新接口将推送该订单。

所涉及的接口包括 ：

1）现有REST API下单节点 - POST /v1/order/orders/place
新增止盈止损订单相关请求字段 “stop-price” 和 “operator”，新增现有请求字段 “type” 的枚举值；

2）现有REST API未成交订单查询节点 - GET /v1/order/openOrders
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值，新增现有返回字段 “state” 的枚举值；

3）现有REST API特定订单（指定订单号）查询节点 - GET /v1/order/orders/
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值，新增现有返回字段 “state” 的枚举值；

4）现有REST API特定订单（指定用户自编订单号）查询节点 - GET /v1/order/orders/getClientOrder
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值，新增现有返回字段 “state” 的枚举值；

5）现有REST API历史订单查询节点 - GET /v1/order/orders
新增现有请求字段 “types” 的枚举值，新增现有请求字段 “states” 的枚举值；
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值，新增现有返回字段 “state” 的枚举值；

6）现有REST API历史订单（48小时内）查询节点 - GET /v1/order/history
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值；
注：止盈止损订单未触发即被撤销将不返回

7）现有REST API特定订单成交明细查询节点 - GET /v1/order/orders//matchresults
新增现有返回字段 “type” 的枚举值；

8）现有REST API历史成交查询节点 - GET /v1/order/matchresults
新增现有请求字段 “type” 的枚举值；
新增现有返回字段 “type” 的枚举值；

9）现有Websocket订单更新推送订阅 - orders.$symbol
新增现有返回字段 “order-type” 的枚举值；
注：止盈止损订单成功下单但未被触发将不推送

10）现有Websocket订单更新推送订阅（新版） - orders.$symbol.update
新增现有返回字段 “order-type” 的枚举值；
注：止盈止损订单成功下单但未被触发将不推送

11）现有Websocket当前及历史订单请求 - order.list
新增现有请求字段 “types” 的枚举值，新增现有请求字段 “states” 的枚举值；
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值，新增现有返回字段 “state” 的枚举值；

12）现有Websocket特定订单请求 - order.detail
新增止盈止损订单相关返回字段 “stop-price” 和 “operator”， 新增现有返回字段 “type” 的枚举值，新增现有返回字段 “state” 的枚举值。