尊敬的用户:
为了防止API用户在发生网络故障或用户端系统故障与火币系统失去联系时,给用户造成意外损失,火币已于2021年1月11日18:00(GMT8)提供“Deadman'sswitch“接口,详情如下:
自动撤单
开启和关闭Deadman'sswitch,若开启,在设定的时间数完前,接口没有被再次调用,则用户所有现货委托单将被取消。
HTTP请求
POST/v2/algo-orders/cancel-all-after
请求示例
POST/v2/algo-orders/cancel-all-after{"timeout":"10"}
请求参数
参数名称是否必须类型描述默认值取值范围timeouttrueint超时时间,设置建议见附注NA0或者大于等于5秒附注:
若开启此操作,常见的使用模式是设timeout为60秒,并每隔15秒调用一次。这将给用户足够的时间,保持委托的同时,容许短暂的网络拥挤,并在如大停电的情况下提供重要的保护。因此建议将超时时间设置为不小于5秒钟,以避免用户被频率限制或在网络拥塞的情况下,委托被意外取消;若要取消此操作并保持你的委托有效,请设置参数timeout为0。响应数据
参数名称是否必须数据类型描述codetrueint状态码messagefalsestring错误描述datatrueobject{currentTimetruelong当前时间triggerTime}truelong触发时间响应示例-开启成功
Response:{
"code":200,
"data":[
{
"currentTime":"1587971400",
"triggerTime":"1587971460"
}
]
}
响应示例-关闭成功
Response:{
"code":200,
"data":[
{
"currentTime":"1587971400",
"triggerTime":"0"
}
]
}
响应示例-开启/关闭失败
Response:{
"code":2003,
"message":"missingmandatoryfield"
}
生效日期:2021年1月11日18:00(GMT8)
具体变更细节及参数要求,请参考或下载。
API用户需自行评估以上新增接口对用户自身业务的适配,必要时进行更新。
郑重声明: 本文版权归原作者所有, 转载文章仅为传播更多信息之目的, 如作者信息标记有误, 请第一时间联系我们修改或删除, 多谢。