跳转到主要内容
所有 WebSocket 频道都可能返回错误帧,而非预期响应。错误帧共享统一的结构。

错误消息封装

字段

incoming_message 使用与请求相同的带标签格式:{ "type": "<snake_case>", "params": { ... } }。

错误代码

以下值与服务端枚举一一对应:

限流说明

服务器根据消息 "type"(例如 "add_order"、"cancel_order")计算消息权重,并在滑动窗口上应用限制。部分消息权重更高。遇到 RateLimited 时,应延迟并降低频率;可行时优先合并为数量更少、内容更集中的请求。

示例

1. JSON 无效

2. 已经完成认证

3. 参数无效

4. 权限不足

5. 触发限流

6. 服务端错误

客户端处理模式

认证与错误

  • trade.qfex.com 要求在连接建立后的 1 分钟内完成认证。
  • 对已经认证的连接再次认证,会返回 AlreadyAuthenticated。

排查清单

  1. 验证 JSON,包括类型、枚举及必填字段。
  2. 遵守速率限制,降低突发流量并尽可能批量处理。
  3. 确保 API 密钥拥有正确权限。
  4. 记录错误帧中的 incoming_message,便于重现问题。
  5. ServerError 持续发生时,向 support@qfex.com 提供时间戳及引发错误的 incoming_message。