🚀 概述
Hyperliquid Whale Tracker 是 MagicTradeBot v3.1 中的新模块,专为希望利用链上透明度的交易者设计。它会持续监控选定的鲸鱼钱包,并在这些钱包开仓或平仓时自动响应。您可以以两种主要模式使用它:
- 仅信号模式 — 通过 Telegram、Discord、WhatsApp 或 Webhooks 接收实时鲸鱼交易警报。
- 镜像模式 — 在您连接的交易所账户上自动执行镜像交易,并具有智能安全防护。
所有配置均通过 tradesettings.yaml 文件管理,并可按机器人实例启用。默认情况下,为了安全起见,该功能是关闭的。
⚙️ 配置示例
要启用追踪器,请在您的 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
此配置会追踪两个鲸鱼钱包,以 3 倍杠杆复制其交易,每笔交易金额为 150 美元,并在鲸鱼平仓时自动关闭对应的镜像仓位。
🧠 工作原理
- 事件源 — 机器人订阅 Hyperliquid 上指定地址的钱包事件。
- 事件检测 — 当鲸鱼开仓或平仓时,机器人会根据过滤条件(大小、冷却时间、方向)验证交易。
- 决策 — 如果
place_order = true,则会使用您连接的交易所 API 创建镜像交易;否则仅广播信号。 - 执行 — 下单时遵守滑点限制、杠杆和可用保证金。部分成交订单可按比例镜像。
- 生命周期 — 若启用
close_on_whale_close,机器人会自动监控并关闭镜像仓位。 - 日志与警报 — 所有事件都会被记录,并可选择发送到通知或监控渠道。
🔒 安全与风险控制
- 切勿硬编码 API 密钥或私钥 — 请使用环境变量或加密密钥。
- 权限应仅限于 交易操作;绝不要启用提现权限。
- 上线前请使用
DemoMode进行测试。 - 保守设置 max_open_per_whale 和 slippage_tolerance_percent。
- 在生产环境中启用错误监控(如 Sentry、PagerDuty)。
📣 通知与广播
当 broadcast_signals: true 时,MagicTradeBot 会为每个鲸鱼交易事件发送格式化警报。
示例(Telegram / Discord):
[Hyperliquid Whale] 新订单
鲸鱼地址: 0x2aB3...Ff12
操作: 买入 (做多)
交易对: BTCUSDT
数量: 0.5 BTC (~25,000 USDT)
杠杆: 3x
是否镜像: 是 (订单ID: M-123456)
示例(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,
"timestamp": "2025-10-16T12:34:56Z"
}
🧩 测试与演示模式
- 设置
place_order: false和DemoMode: true以安全测试。 - 启用镜像交易前请验证信号消息。
- 从较小的
order_amount开始,并确认事件检测准确。 - 在
completedorders.yaml中监控镜像交易日志。
⚡ 操作最佳实践
- 使用 cooldown_seconds 防止鲸鱼拆分订单导致过度交易。
- 在波动市场中保持 仅信号模式。
- 结合 资金管理模块 实现动态仓位和风险控制。
- 使用 Prometheus 和 Loki 进行指标监控与事件审计。
⚠️ 限制与风险
- 追踪鲸鱼 ≠ 保证盈利 —— 鲸鱼也可能亏损或操纵市场。
- 执行延迟和滑点可能导致镜像交易结果偏差。
- 追踪过多钱包会增加 API 负载 —— 请适当调整速率限制。
💬 常见问题
问:我可以追踪任何钱包吗?
可以。将任何公开钱包地址添加到 tracking_addresses 下,机器人会自动检测相关交易活动。
问:是否会匹配鲸鱼的精确仓位大小?
不会。机器人使用您配置的 order_amount,或在启用 follow_partial_fills 时按比例调整。
问:如果鲸鱼发送多个小额订单怎么办?
使用 cooldown_seconds 和 follow_partial_fills 控制重复交易并防止过度暴露。
⚖️ 法律与合规声明
虽然跟踪公开钱包活动在链上是透明的,但请确保遵守交易所条款和当地法规。 MagicTradeBot 提供工具,您需自行承担合法与道德使用的责任。
🛠️ 支持与故障排除
- 检查
completedorders.yaml和日志以排查错误。 - 验证 API 权限和环境变量配置。
- 通过您的控制面板联系官方 MagicTradeBot 支持团队 以获得技术帮助。