Latest

双WebSocket架构设计17

双 WebSocket 架构设计 1. 问题与方案 问题:TRADING_NETWORK=testnet 时订单通过测试网 HTTP 提交,但 WebSocket 推送仍来自主网,导致收不到测试网的 orderUpdates/userFills,持仓/余额与测试网不一致。 方案:拆为两条独立 WebSocket 连接—— 连接 URL source 订阅 Market WS 主网固定 "market" candle, l2Book Trading WS 随 TRADING_NETWORK "trading" orderUpdates, userFills, user 实现原则: * 老代码彻底删除,不打补丁;

By SHI XIAOLONG

双WebSocket架构设计16

双 WebSocket 架构设计 1. 问题与方案 问题:TRADING_NETWORK=testnet 时订单通过测试网 HTTP 提交,但 WebSocket 推送仍来自主网,导致收不到测试网的 orderUpdates/userFills,持仓/余额与测试网不一致。 方案:拆为两条独立 WebSocket 连接—— 连接 URL source 订阅 Market WS 主网固定 "market" candle, l2Book Trading WS 随 TRADING_NETWORK "trading" orderUpdates, userFills, user 实现原则: * 老代码彻底删除,不打补丁;

By SHI XIAOLONG

双WebSocket架构设计15

双 WebSocket 架构设计 1. 问题与方案 问题:TRADING_NETWORK=testnet 时订单通过测试网 HTTP 提交,但 WebSocket 推送仍来自主网,导致收不到测试网的 orderUpdates/userFills,持仓/余额与测试网不一致。 方案:拆为两条独立 WebSocket 连接—— 连接 URL source 订阅 Market WS 主网固定 "market" candle, l2Book Trading WS 随 TRADING_NETWORK "trading" orderUpdates, userFills, user 实现原则: * 老代码重写,不打补丁;

By SHI XIAOLONG

双WebSocket架构设计14

双 WebSocket 架构设计 1. 问题与方案 问题:TRADING_NETWORK=testnet 时订单通过测试网 HTTP 提交,但 WebSocket 推送仍来自主网,导致收不到测试网的 orderUpdates/userFills,持仓/余额与测试网不一致。 方案:拆为两条独立 WebSocket 连接—— 连接 URL source 订阅 Market WS 主网固定 "market" candle, l2Book Trading WS 随 TRADING_NETWORK "trading" orderUpdates, userFills, user 实现原则: * 老代码重写,不打补丁;

By SHI XIAOLONG

双WebSocket架构设计13

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 版本 日期 变更说明 v1.0 2026-02-22 初始版本 v1.1 2026-02-22 评审优化:校验改 ValueError、补充线程安全/重连订阅/容错/背压说明、完善测试清单 1. 目标与约束 背景:原单 WebSocket 连接主网;当 TRADING_NETWORK=testnet 时订单在测试网提交,但推送仍来自主网,导致收不到测试网 orderUpdates/userFills,持仓/余额数据与测试网不一致。本设计拆分为 Market WS(主网固定)+ Trading WS(随配置)解决该问题。

By SHI XIAOLONG

双WebSocket架构设计12

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 背景:原单 WebSocket 连接主网;当 TRADING_NETWORK=testnet 时订单在测试网提交,但推送仍来自主网,导致收不到测试网 orderUpdates/userFills,持仓/余额数据与测试网不一致。本设计拆分为 Market WS(主网固定)+ Trading WS(随配置)解决该问题。 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills

By SHI XIAOLONG

双WebSocket架构设计11

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 背景:原单 WebSocket 连接主网;当 TRADING_NETWORK=testnet 时订单在测试网提交,但推送仍来自主网,导致收不到测试网 orderUpdates/userFills,持仓/余额数据与测试网不一致。本设计拆分为 Market WS(主网固定)+ Trading WS(随配置)解决该问题。 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills

By SHI XIAOLONG

双WebSocket架构设计10

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 背景:原单 WebSocket 连接主网;当 TRADING_NETWORK=testnet 时订单在测试网提交,但推送仍来自主网,导致收不到测试网 orderUpdates/userFills,持仓/余额数据与测试网不一致。本设计拆分为 Market WS(主网固定)+ Trading WS(随配置)解决该问题。 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills

By SHI XIAOLONG

双WebSocket架构设计9

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills / user:连接随 TRADING_NETWORK 变化的 WebSocket(testnet 时 wss://api.hyperliquid-testnet.xyz/ws,mainnet 时与主网一致),与下单/查单网络保持一致。 非目标 * 不改变现有交易 HTTP API、订单状态机与 WebSocketOrderManager

By SHI XIAOLONG

双WebSocket架构设计8

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills / user:连接随 TRADING_NETWORK 变化的 WebSocket(testnet 时 wss://api.hyperliquid-testnet.xyz/ws,mainnet 时与主网一致),与下单/查单网络保持一致。 非目标 * 不改变现有交易 HTTP API、订单状态机与 WebSocketOrderManager

By SHI XIAOLONG

双WebSocket架构设计7

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills / user:连接随 TRADING_NETWORK 变化的 WebSocket(testnet 时 wss://api.hyperliquid-testnet.xyz/ws,mainnet 时与主网一致),与下单/查单网络保持一致。 非目标 * 不改变现有交易 HTTP API、订单状态机与 WebSocketOrderManager

By SHI XIAOLONG

双WebSocket架构设计6

双 WebSocket 架构设计文档(K 线主网 + 订单/用户推送随配置) 1. 目标与约束 需求 * K 线与 L2 订单簿:始终连接主网 WebSocket(wss://api.hyperliquid.xyz/ws),与 TRADING_NETWORK 无关。 * orderUpdates / userFills / user:连接随 TRADING_NETWORK 变化的 WebSocket(testnet 时 wss://api.hyperliquid-testnet.xyz/ws,mainnet 时与主网一致),与下单/查单网络保持一致。 非目标 * 不改变现有交易 HTTP API、订单跟踪逻辑、WebSocketOrderManager

By SHI XIAOLONG