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