请求体
timeoutSecondsinteger必填部署级上下限内自选(默认 5s–300s);建议每 timeout/3 打一次
marketIdsstring[]必填显式列出要保护的市场(上限默认 64,自动去重)
响应
200保护生效expiresAtSint64本次心跳截止(epoch 秒)
marketIdsstring[]实际生效的保护市场列表
在响应示例中切换状态码查看错误响应,完整错误码见 错误码页。
做市商定期打心跳并声明要保护的市场,超时未续则交易所代撤这些市场的全部挂单。返回 200 不是 202——不是命令,截止时刻同步写登记簿。客户端逻辑只有一句:每隔 timeout/3 打一次。timeoutSeconds 有部署级上下限 (默认 5s–300s),marketIds 上限默认 64、自动去重。部署关闭时返回 501 `heartbeat_disabled`(不是 400)。
请求头 Authorization: Bearer <token>。token 由 POST /api/v1/auth/verify 签发,24h 空闲或签发满 7d 后失效。
timeoutSecondsinteger必填部署级上下限内自选(默认 5s–300s);建议每 timeout/3 打一次
marketIdsstring[]必填显式列出要保护的市场(上限默认 64,自动去重)
expiresAtSint64本次心跳截止(epoch 秒)
marketIdsstring[]实际生效的保护市场列表
在响应示例中切换状态码查看错误响应,完整错误码见 错误码页。