【API 公告】2021/01/12 API更新-火币API新增自动撤单接口通知

尊敬的用户：

为了防止API用户在发生网络故障或用户端系统故障与火币系统失去联系时，给用户造成意外损失，火币已于2021年1月11日18:00 (GMT+8) 提供“Dead man's switch“接口（当用户与火币发生意外断连时，能自动帮用户取消全部委托单，以避免损失），详情如下：

自动撤单

开启和关闭Dead man's switch，若开启，在设定的时间数完前，接口没有被再次调用，则用户所有现货委托单将被取消（最大支持撤500单）。

HTTP 请求

POST/v2/algo-orders/cancel-all-after

请求示例

POST/v2/algo-orders/cancel-all-after {"timeout":"10"}（参数放在body里）

请求参数

参数名称	是否必须	类型	描述	默认值	取值范围
timeout	true	int	超时时间（单位：秒），设置建议见附注	NA	0或者大于等于5秒

附注：

若开启此操作，常见的使用模式是设timeout为60秒，并每隔15秒调用一次。 这将给用户足够的时间，保持委托的同时，容许短暂的网络拥挤，并在如大停电的情况下提供重要的保护。因此建议将超时时间设置为不小于5秒钟，以避免用户被频率限制或在网络拥塞的情况下，委托被意外取消； 若要取消此操作并保持你的委托有效，请设置参数timeout为0。

响应数据

参数名称	是否必须	数据类型	描述
code	true	int	状态码
message	false	string	错误描述（如有）
data	true	object
{ currentTime	true	long	当前时间
triggerTime }	true	long	触发时间

响应示例-开启成功

Response:
{

"code": 200,

"data": [

{

"currentTime":"1587971400",

"triggerTime":"1587971460"

}

]

}

响应示例-关闭成功

Response:
{

"code": 200,

"data": [

{

"currentTime":"1587971400",

"triggerTime":"0"

}

]

}

响应示例-开启/关闭失败

Response:
{

"code": 2003,

"message": "missing mandatory field"

}

生效日期：2021年1月11日18:00 (GMT+8)

具体变更细节及参数要求，请参考 【API 文档】或下载。

API用户需自行评估以上新增接口对用户自身业务的适配，必要时进行更新。