外部数据源 (External Data Sources)

XBlade Studio 的底层行情系统深度集成了 Hyperliquid，通过直连 Hyperliquid API 获取高精度的实时市场数据，确保交易环境的专业性和准确性。

数据中心：Hyperliquid

系统目前统一使用 Hyperliquid 作为核心外部数据源，所有前台展示的实时价格、K 线以及深度数据均来源于此。

集成细节

维度	实现方式	说明
API 端点	https://api.hyperliquid.xyz/info	使用 Hyperliquid Info API 的 POST 请求进行数据检索。
实时行情 (Ticker)	metaAndAssetCtxs	聚合获取所有资产的标记价格 (Mark Price)、24小时成交额 (Notional Volume) 以及 24h 涨跌幅。
K 线数据 (Candles)	candleSnapshot	支持从 1m 到 1d 的全周期历史蜡烛图。系统自动将成交额 (Notional) 处理为对应币种的交易量。
订单簿 (Orderbook)	l2Book	提供实时 L2 深度数据。API 统一返回前 20 档买卖单，确保响应速度。
最新成交 (Trades)	实时合成	由于 Hyperliquid 公共 Info API 不直接提供逐笔成交，系统通过 L2 深度与实时价差合成成交历史，确保前端视觉流畅。

数据处理逻辑

后端服务（Rust Backend）在采集数据后会进行以下标准处理：

1. 符号规范化 (Symbol Normalization)

   • 内部支持 BTCUSDT, ETHUSDT 等标准格式。
   • 自动将 BTC-USD, btcusdt 等前端请求自动路由并匹配到 Hyperliquid 的原生资产（如 BTC）。

2. 成交量转换

   • Hyperliquid 默认返回 USD 面值的成交额。
   • 系统会根据实时 标记价格 (Mark Price) 自动将其换算为 Base Asset 单位，以符合标准交易习惯。

3. 时序对齐

   • 所有 K 线数据均按毫秒级时间戳对齐，并支持 1m, 5m, 15m, 30m, 1h, 4h, 1d 等周期。

---

运维建议

外部数据采集模块运行在独立的 external_data 服务层：

• 如果前端价格停止更新，请优先检查后端对 https://api.hyperliquid.xyz 的网络连接。
• 系统具备“冷启动”能力，即使外部数据源短暂波动，也会保留最后一帧有效行情。