操作手册
完整的交易台就绪检查清单与集成认证测试。
交易台就绪检查清单
正式上线前,请验证:
API 连接
- 已测试预发布(Staging)端点
- 已配置生产环境端点(如可用)
- 健康检查端点响应正常
- WebSocket 连接稳定
身份验证
- EIP-712 签名正常工作
- 已配置代理授权(如适用)
- 已实现 Nonce 管理
- 已测试签名验证
报价系统
- 已测试批量下单
- 已验证订单生命周期对账
- 已实现成交跟踪
- 已测试撤单功能
风险控制
- 已配置并测试 MMP
- 已理解保证金模型
- 已验证层级限制
- 已实现投资组合监控
监控
- 已订阅 WebSocket 数据流
- 已自动化订单/成交对账
- 已配置健康检查
- 已设置告警
紧急停止开关
- 能够撤销所有订单
- 能够立即断开连接
- 已记录应急流程文档
对冲
- 已验证与 Hyperliquid 永续合约的集成
- 已实现 Delta对冲策略
- 已理解永续合约保证金计算
结算
- 已测试到期日处理
- 已验证头寸结算
- 已理解参考价格来源
集成认证测试
测试 1:下单
步骤:
- 通过
POST /order下达单笔订单 - 验证订单状态:
ACKED→OPEN - 检查订单是否出现在
GET /orders?wallet=...中 - 验证已收到 WebSocket
order_updates
预期结果:订单成功下达,收到状态更新
测试 2:批量下单
步骤:
- 通过
POST /bulk_order下达 10 笔订单 - 验证所有订单均被接受
- 通过 REST 和 WS 检查订单状态
- 验证无签名/身份验证错误
预期结果:所有订单成功下达
测试 3:成交跟踪
步骤:
- 下达一笔将会成交的订单
- 监控 WebSocket
fills频道 - 验证收到的成交带有正确的
order_id - 检查成交是否出现在
GET /fills?wallet=...中 - 验证订单状态更新为
FILLED
预期结果:成交跟踪正确,订单状态已更新
测试 4:部分成交跟踪
步骤:
- 下达一笔将会部分成交的订单
- 监控 WebSocket
fills频道(而非order_updates) - 验证收到部分成交
- 按
order_id聚合成交以计算已成交数量 - 验证订单状态保持为
OPEN(WS 上不会显示PARTIALLY_FILLED)
预期结果:通过 fills 频道跟踪部分成交,订单状态正确
测试 5:撤单
步骤:
- 通过
POST /order下达订单 - 通过
DELETE /order撤销订单 - 验证订单状态:
CANCELED - 检查已收到 WebSocket
order_updates
预期结果:订单成功撤销,收到状态更新
测试 6:MMP 触发
步骤:
- 通过
POST /mmp-config配置 MMP - 下达启用 MMP 的订单
- 通过超出限额触发 MMP
- 验证订单以 MMP 原因被撤销
- 检查其他启用 MMP 的订单也被撤销
预期结果:MMP 正确触发,订单被撤销
测试 7:保证金拒单
步骤:
- 下达一笔超出保证金的订单
- 验证订单以 "Insufficient margin" 原因被拒绝
- 检查拒绝原因中包含所需保证金、可用保证金和缺口数值
- 验证订单状态:
REJECTED
预期结果:订单被拒绝并附有明确原因
测试 8:层级限制
步骤:
- 使用配置为仅限做多权限的钱包
- 在没有多头头寸的情况下尝试下达卖单
- 验证订单以层级原因被拒绝
- 下达买单(应成功)
- 下达卖单以平仓(应成功)
预期结果:层级限制被正确执行
测试 9:WebSocket 重连
步骤:
- 连接 WebSocket
- 订阅频道
- 断开 WebSocket 连接
- 使用指数退避策略重新连接
- 重新订阅频道
- 轮询 REST 以补齐错过的更新
预期结果:重连正常工作,状态已恢复
测试 10:投资组合对账
步骤:
- 下单并成交
- 通过
GET /portfolio?wallet=...检查投资组合 - 验证头寸与成交一致
- 检查保证金占用正确
- 与 WebSocket
portfolio更新进行对账
预期结果:投资组合状态准确,对账成功
生产就绪
生产前检查清单
- 所有集成测试已通过
- 已配置监控与告警
- 已测试紧急停止开关
- 已记录应急流程文档
- 团队已完成事件响应培训
- 已确定支持联系人
上线检查清单
- 预发布环境已充分测试
- 已验证生产环境端点
- 监控仪表板已就绪
- 已配置告警
- 已建立团队值班安排
- 已审阅文档
参考资料
- 快速入门:Quickstart
- API 参考:REST API
- 错误与拒单:Errors
- 事件处理手册:Incidents