Hyperliquid Whale 跟单交易 — 即刻镜像专业交易

MagicTradeBot的Hyperliquid鲸鱼追踪器允许您追踪Hyperliquid及其他基于钱包的交易所的钱包级活动。您可以追踪任何钱包地址，接收通知，并可选择通过灵活的安全和过滤控制自动镜像（下单/平仓）交易。

概述

Hyperliquid鲸鱼追踪器监控钱包地址（鲸鱼），并在这些钱包开仓或平仓时作出反应。它支持两种主要模式：

  • 仅信号模式 — 将鲸鱼事件广播到您的通知渠道（Telegram、Discord、WhatsApp等）。
  • 镜像模式 — 自动下单镜像订单，并在鲸鱼平仓时关闭这些订单。

该功能可通过tradesettings.yaml完全配置，并可为每个机器人实例启用。默认情况下是禁用的。

配置

在您的tradesettings.yaml（或集中设置的appsettings.yaml变体）中添加或更新HyperLiquidWhaleTracker部分。示例： 

HyperLiquidWhaleTracker:
  is_enabled: false
  tracking_addresses:
    - "0x2aB3...Ff12"            # 添加一个或多个鲸鱼钱包地址
    - "0x1cD4...Aa77"
  place_order: false             # true = 自动下单镜像订单，false = 仅信号
  order_amount: 100.0            # 每笔镜像交易的基准货币金额
  leverage: 3                    # 镜像交易使用的杠杆（如果适用）
  broadcast_signals: true        # true = 当鲸鱼开仓/平仓时发送通知
  max_open_per_whale: 2          # 每追踪鲸鱼的最大镜像开仓交易数（安全）
  slippage_tolerance_percent: 0.5 # 下单镜像订单时最大可接受滑点
  follow_partial_fills: true     # 如果为true，机器人按比例镜像部分成交
  close_on_whale_close: true     # 当鲸鱼平仓时关闭镜像订单
  include_liquidations: false    # 如果为true，将镜像清算（不推荐）
  only_follow_buy: false         # 如果为true，仅追踪买入
  only_follow_sell: false        # 如果为true，仅追踪卖出
  min_whale_order_value: 50.0    # 追踪/镜像的最小订单价值（基准货币）
  cooldown_seconds: 30           # 同一鲸鱼事件处理之间的等待秒数

字段说明

  • is_enabled — 启用/禁用鲸鱼追踪器（默认：false）。
  • tracking_addresses — 要追踪的钱包地址列表。无硬性限制；可添加任意数量，但需注意资源使用情况。
  • place_order — 当为true时，机器人将尝试自动下单镜像订单。当为false时，仅广播信号。
  • order_amount — 每笔交易的镜像订单在基准货币（例如USDT）中的规模。生产环境中建议使用资金管理规模调整。
  • leverage — 开启镜像期货头寸的杠杆（仅在交易所支持杠杆的情况下适用）。
  • broadcast_signals — 向配置的广播渠道发送格式化消息。
  • max_open_per_whale — 避免对单一鲸鱼过度暴露的安全限制。
  • slippage_tolerance_percent — 下单时的最大可接受滑点。
  • follow_partial_fills — 如果鲸鱼的订单部分成交，机器人按相同成交比例镜像。
  • close_on_whale_close — 当鲸鱼平仓时关闭镜像订单。
  • include_liquidations — 仅在理解极端风险的情况下镜像清算。
  • only_follow_buy / only_follow_sell — 仅追踪买入或卖出的过滤器。
  • min_whale_order_value — 忽略低于此阈值的微小鲸鱼订单。
  • cooldown_seconds — 通过为每只鲸鱼设置处理间隔防止事件泛滥。

工作原理（技术流程）

  1. 事件源：机器人订阅Hyperliquid钱包事件（或轮询区块链/API）以获取配置的地址信息。
  2. 事件检测：检测到新的开仓/平仓订单事件后，机器人根据过滤器（最小价值、操作类型、冷却时间）进行验证。
  3. 决策：如果place_order = true，机器人使用配置的交易所凭证创建镜像订单请求，包括杠杆和规模规则。如果为false，仅构建广播消息。
  4. 执行：尝试下单，考虑滑点容忍度和可用余额。如果follow_partial_fills = true，机器人相应调整镜像订单数量。
  5. 生命周期：机器人监控镜像订单状态，如果close_on_whale_close = true，将在鲸鱼平仓时关闭镜像订单。
  6. 日志记录和警报：所有事件和操作均被记录（参见日志记录和监控）。如果已配置，将广播通知。

前提条件和权限

  • 具有有效许可证且配置了tradesettings.yaml的正常运行的MagicTradeBot实例。
  • 如果启用了place_order，需要具有交易权限的交易所API密钥。对于基于Hyperliquid钱包的操作，您可能还需要一个私钥 — 切勿以明文存储私钥（使用环境变量）。
  • 稳定的互联网连接和appsettings.yaml中适当的速率限制设置，以避免API禁制。

安全注意事项

  • 切勿在存储库文件中硬编码私钥或API密钥。使用环境变量或操作系统级别的密钥管理。
  • 将API密钥权限限制在必需范围内（理想情况下仅限交易，禁止提款）。
  • 在启用实时镜像订单之前，在DemoMode中进行彻底测试。
  • 设置保守的默认值：max_open_per_whale、slippage_tolerance_percent和min_whale_order_value。
  • 启用日志记录和事件警报（Sentry、PagerDuty），以便在执行错误或意外行为时收到通知。

通知和广播示例

当broadcast_signals为true时，机器人会发送格式化消息。以下是示例模板：

Telegram / Discord（文本）


[Hyperliquid鲸鱼] 新订单
鲸鱼: 0x2aB3...Ff12
操作: 买入（多头）
符号: BTCUSDT
规模: 0.5 BTC（约25000 USDT）
杠杆: 3倍
时间: 2025-10-16T12:34:56Z
镜像: 是（订单ID: M-123456）   # 或如果place_order=false则为“镜像: 否”

WhatsApp / Webhook（JSON负载）

{
  "type": "hyperliquid.whale.event",
  "whale_address": "0x2aB3...Ff12",
  "action": "open",
  "side": "buy",
  "symbol": "BTCUSDT",
  "size": 0.5,
  "notional": 25000,
  "leverage": 3,
  "mirrored": true,
  "mirrored_order_id": "M-123456",
  "timestamp": "2025-10-16T12:34:56Z"
}

测试和演示模式

  • 始终先使用DemoMode: true或交易所测试网进行测试。
  • 将place_order: false设置为验证事件检测和广播格式，而不执行交易。
  • 在实时测试期间使用较小的order_amount，并监控completedorders.yaml和终端输出中的日志。

操作最佳实践

  • 使用max_open_per_whale避免对单一鲸鱼的交易序列过度暴露。
  • 启用cooldown_seconds以减少鲸鱼将订单拆分为多个微小订单时的重复处理。
  • 在市场波动较大或无法确保快速执行/滑点控制时，优先选择仅信号模式。
  • 如果使用杠杆进行镜像，确保有保证金和故障保护（全局强制平仓阈值）。
  • 记录每个传入事件和镜像操作，以确保可审计性和回测。

日志记录和监控

建议在appsettings.yaml或机器人配置中启用的日志记录/监控：

  • 用于实时故障排除的终端日志。
  • completedorders.yaml — 用于回测和盈亏的持久化完成镜像交易。
  • 可选远程日志记录：Sentry、Loki、LogDNA、DataDog，用于警报和历史审计日志。
  • Prometheus指标，用于开仓头寸数、镜像订单数和错误率。

错误处理和重试

  • 订单执行失败时，机器人将以指数退避（可配置）最多重试3次。
  • 如果滑点超过slippage_tolerance_percent，订单将被取消并发出警告。
  • 如果因余额不足无法执行镜像订单，机器人将广播警告并跳过镜像。

限制和风险

  • 追踪钱包并不能保证盈利 — 鲸鱼可能是市场制造者、内幕人士或进行短期操纵。
  • 镜像清算或高杠杆鲸鱼操作可能会放大损失。
  • 执行延迟和滑点可能导致与鲸鱼不同的交易结果。
  • 遵守交易所API速率限制 — 追踪多个鲸鱼会增加API调用和资源使用。

常见问题

问：我可以追踪任何钱包地址吗？

答：可以 — 将任何公开钱包地址添加到tracking_addresses。机器人将尝试检测与该地址相关的开仓/平仓事件。

问：机器人会精确复制头寸规模吗？

答：不一定。机器人使用order_amount作为镜像交易规模（或在启用时按比例镜像部分成交）。您可以在高级资金管理配置中实现基于百分比的规模调整。

问：如果鲸鱼将订单拆分为多个微小订单怎么办？

答：使用cooldown_seconds和follow_partial_fills控制拆分订单的镜像方式，并避免过度暴露。

入门清单

  1. 启用追踪器：在tradesettings.yaml中设置is_enabled: true。
  2. 将鲸鱼地址添加到tracking_addresses。
  3. 最初设置place_order: false以验证事件和通知。
  4. 验证广播是否传递到Telegram/Discord/WhatsApp。
  5. 在确认无误后切换到place_order: true，并在实时验证完成前保持DemoMode: true。
  6. 监控日志并为下单错误、滑点和余额不足事件设置警报。

完整示例片段（复制到tradesettings.yaml）

HyperLiquidWhaleTracker:
  is_enabled: true
  tracking_addresses:
    - "0x2aB3...Ff12"
    - "0x1cD4...Aa77"
  place_order: true
  order_amount: 150.0
  leverage: 3
  broadcast_signals: true
  max_open_per_whale: 2
  slippage_tolerance_percent: 0.5
  follow_partial_fills: true
  close_on_whale_close: true
  include_liquidations: false
  only_follow_buy: false
  only_follow_sell: false
  min_whale_order_value: 100.0
  cooldown_seconds: 60

追踪和镜像公开钱包活动在技术上是可行的，但您应确保遵守当地法律、交易所条款和道德交易实践。MagicTradeBot提供工具 — 您有责任合法且负责任地使用它们。

支持和故障排除

如果遇到问题：

  • 检查终端日志和completedorders.yaml以查找错误。
  • 验证API密钥和权限（允许交易，禁用提款）。
  • 如果用于密钥，确保环境变量覆盖文件设置。
  • 通过MagicTradeBot仪表板联系支持，或查阅完整的配置文档。

📎 Related Topics