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用户需自行评估以上新增接口对用户自身业务的适配,必要时进行更新。