事件应对手册
常见问题的应对流程。
连接问题
WebSocket 断连
症状：WebSocket 连接丢失，未收到任何消息
措施：
- 实现带指数退避的自动重连
- 轮询 REST 端点以补齐错过的更新
- 重连后重新订阅所有频道
预防：监控连接状态并实现健壮的重连逻辑
API 超时
症状：REST 请求超时或返回 5xx 错误
措施：
- 使用指数退避进行重试
- 检查健康检查端点：
GET /health - 若系统过载，降低请求频率
预防：实现请求限流和熔断机制
订单问题
拒单率过高
症状：大量订单被拒绝
排查：
- 通过
GET /orders?wallet=...查看拒单原因 - 检查保证金：
GET /portfolio?wallet=... - 检查等级：
GET /user-tier?wallet=... - 确认合约未到期：
GET /instruments
措施：
- 若为保证金问题：减小仓位规模或增加抵押品
- 若为等级问题：升级至 tier2 或对卖单进行备兑
- 若已到期：使用其他合约
成交通知缺失
症状：订单已成交但未收到成交通知
排查：
- 通过
GET /fills?wallet=...查看成交记录 - 确认已订阅 WebSocket
fills频道 - 检查 WebSocket 连接状态
措施：
- 重新订阅
fills频道 - 轮询 REST 端点补齐错过的成交
- 将成交记录与订单状态进行核对
订单状态过期
症状：REST 中的订单状态与 WS 不一致
排查：
- 检查 WebSocket 连接状态
- 确认订单缓存为最新
- 对比 REST 与 WS 的订单状态
措施：
- WS 重连后轮询 REST 以补齐数据
- 以 REST 作为核对的权威数据源
MMP 问题
MMP 触发过于频繁
症状：大量订单被 MMP 取消
排查：
- 检查 MMP 配置：
GET /mmp-config?wallet=...¤cy=... - 审查成交模式和累计指标
- 检查限额是否设置过低
措施：
- 提高 MMP 限额（数量、Delta、Vega）
- 增大
interval_ms以允许窗口内更多成交 - 降低报价频率
MMP 未触发
症状：成交量超过限额但 MMP 未触发
排查：
- 确认 MMP 已启用：
GET /mmp-config?wallet=...¤cy=... - 检查订单上是否设置了
mmp_enabled=true - 确认币种与订单标的资产匹配
措施：
- 在订单上启用 MMP：
mmp_enabled=true - 为正确的币种配置 MMP
- 视需要调整限额
保证金问题
保证金不足
症状：订单被拒绝并提示 "Insufficient margin"
排查：
- 检查投资组合：
GET /portfolio?wallet=... - 审查保证金计算
- 检查是哪个情景未通过
措施：
- 减小仓位规模
- 增加抵押品（待充值流程上线后）
- 平仓以释放保证金
- 对冲敞口以降低最坏情景损失
现货价格缺失
症状：订单被拒绝并提示 "No spot price available"
排查：
- 检查 Hyperliquid 现货价格数据源的连接状态
- 确认标的资产代码正确
- 检查现货价格数据源是否正常运行
措施：
- 等待现货价格数据源恢复
- 如可行，使用其他标的资产
- 若问题持续，请联系支持团队
系统问题
高延迟
症状：API 响应缓慢或 WebSocket 消息延迟
排查：
- 检查系统负载
- 监控响应时间
- 检查网络连接
措施：
- 降低请求频率
- 实现请求限流
- 若问题持续，请联系支持团队
速率限制
症状：请求被拒绝或被限流
现状：速率限制按钱包实施。详情请参阅速率限制。
措施：
- 检查
Retry-After响应头，等待后再重试 - 监控
X-RateLimit-Remaining以避免触及限额 - 尽可能使用批量端点
紧急处理流程
紧急停止
立即执行：
- 取消所有订单：
DELETE /bulk_order或DELETE /bulk_order_cloid - 断开 WebSocket 连接
- 停止报价系统
恢复：
- 确认所有订单已取消：
GET /orders?wallet=... - 检查投资组合：
GET /portfolio?wallet=... - 排查根本原因
- 问题解决后恢复报价
数据核对
事件发生后：
- 轮询 REST 端点获取当前状态
- 核对订单：
GET /orders?wallet=... - 核对成交：
GET /fills?wallet=... - 核对投资组合：
GET /portfolio?wallet=... - 恢复 WebSocket 订阅
问题升级
若问题持续：
- 查看随访问权限提供的已知问题与预发布环境通知
- 参阅运维手册了解详细流程
- 联系支持团队并提供以下信息：
- 钱包地址
- 错误消息
- 时间戳
- 复现步骤