📖 概述
Hyperliquid Whale Tracker 是一项高级功能，用于监控 Hyperliquid 交易所上的大户（“鲸鱼”）钱包活动，并支持自动复制交易。当被跟踪的鲸鱼开设新仓位时，系统可以自动将信号广播到 Discord/Telegram，并/或在您的账户上进行镜像交易。
🔍 实时检测
每 5 分钟监控一次鲸鱼仓位，即时检测新仓位。
📢 多平台警报
以丰富格式将信号广播到 Discord、Telegram 和 WhatsApp。
🤖 自动复制交易
根据您的自定义设置和风险参数自动镜像鲸鱼仓位。
🎯 智能平仓跟踪
当鲸鱼平仓时，自动关闭您的仓位。
⚙️ 配置
基本设置
位于您的配置文件中，位于 HyperLiquidWhaleTracker 下：
消息平台配置
交易设置
🔧 工作原理
检测过程
1初始扫描
首次运行时，系统会注册所有现有的鲸鱼仓位，但不进行广播（防止垃圾信息）。
2持续监控
每 5 分钟，系统会执行以下操作：
- 获取每只被跟踪鲸鱼的当前仓位
- 与之前看到的仓位进行比较
- 检测之前不存在的新仓位
3仓位识别
当满足以下条件时，仓位被视为新仓位：
- 在上次检查时，该币种不在鲸鱼的投资组合中
- 系统之前未广播过该仓位
4执行操作
对于每个新仓位：
- 将信号广播到配置的平台（如果启用）
- 放置复制交易订单（如果启用）
- 将仓位添加到监控系统以进行自动平仓跟踪
跟踪的鲸鱼仓位数据
| 数据点 | 描述 |
|---|---|
| 币种 | 交易对（如 BTC、ETH、SOL） |
| 方向 | 多头或空头仓位 |
| 规模 | 仓位规模（以合约计） |
| 入场价格 | 鲸鱼的入场价格 |
| 杠杆 | 仓位杠杆 |
| 未实现盈亏 | 当前盈亏 |
| 清算价格 | 风险阈值 |
📢 信号广播
启用广播
在配置中设置 broadcast_signals: true，以在鲸鱼开设仓位时接收通知。
Discord 通知
丰富嵌入格式
- 颜色编码（多头为绿色，空头为红色）
- 包含所有仓位详情的有序字段
- 可点击的鲸鱼投资组合链接
- 用于跟踪的时间戳
Telegram 通知
Markdown 格式
- 简洁易读的文本格式
- 用于数据的等宽代码块
- 直接跟踪链接
- 适合移动设备的布局
平台选择
系统会将信号广播到所有配置了有效凭据的平台。没有凭据的平台会自动跳过：
- Discord：需要
discord_webhook_url - Telegram：需要
telegram_bot_token和telegram_chat_id - WhatsApp：需要
whatsapp_token和whatsapp_phone_id
🤖 自动复制交易
启用自动交易
设置 place_order: true 以自动镜像鲸鱼仓位。
复制交易的工作原理
- 仓位检测：系统检测到新的鲸鱼仓位
- 符号匹配：在您的交易所找到对应的交易对
- 订单验证：检查鲸鱼订单限制和机器人可用性
- 订单放置：根据您的配置设置放置市场订单
- 监控：将仓位添加到平仓监控系统
⚠️ 重要提示：使用您的设置，而非鲸鱼的设置
您的复制交易使用您的设置，而不是鲸鱼的设置：
- 您的仓位规模（而不是鲸鱼的）
- 您的杠杆（而不是鲸鱼的）
- 您的止盈/止损百分比
- 您的风险管理规则
示例：鲸鱼以 20x 杠杆开设 100 BTC 多头仓位 → 您的复制交易：$100 BTC 多头，10x 杠杆（您的设置）
交易所兼容性
系统会自动为您的交易所调整符号：
| 交易所 | 鲸鱼符号 | 您的符号 |
|---|---|---|
| Binance | BTC | BTCUSDT |
| OKX | BTC | BTC-USDT-SWAP |
| Bybit | BTC | BTCUSDT |
| Bitget | BTC | BTCUSDT |
| HyperLiquid | BTC | BTC（无变化） |
订单放置逻辑
👁️ 仓位监控与自动平仓
自动平仓跟踪
当您复制鲸鱼交易时，系统会持续监控鲸鱼的仓位。如果鲸鱼关闭其仓位，您的复制交易也会自动关闭。
工作原理
- 仓位注册：放置复制交易后，仓位被添加到监控系统
- 持续检查：每 5 分钟，系统检查鲸鱼的当前仓位
- 平仓检测：识别鲸鱼仓位规模减少或消失的情况
- 自动平仓执行：立即关闭您的对应仓位
平仓场景
完全平仓（100%）
鲸鱼：关闭整个仓位
您的交易：自动关闭 100% 仓位
结果：交易移至已完成，running_orders 清空
部分平仓
鲸鱼：减少仓位规模（例如，关闭 50%）
您的交易：关闭匹配的百分比
结果：交易更新为新的数量
状态管理
🛡️ 安全功能
订单限制
单鲸鱼限制（max_orders_per_whale）
- 默认值：每只鲸鱼 2 个并发订单
- 可配置：可设置任意数字（建议 1-10）
- 目的：防止对单一鲸鱼的过度暴露
示例：鲸鱼 #1 有 2 个活跃仓位 → 检测到新仓位 → 系统检查：达到 2/2 限制 → 订单跳过：“达到鲸鱼订单限制”
演示模式
在不冒真实资本风险的情况下测试系统：
在演示模式下：
- ✅ 检测鲸鱼仓位
- ✅ 广播信号
- ✅ 记录订单详情
- ❌ 不放置真实订单
- ❌ 不调用交易所 API
机器人冲突预防
在放置复制交易之前：
- 检查目标机器人是否有正在运行的订单
- 如果机器人已在交易，则跳过订单
- 防止在同一符号上存在多个并发仓位
仓位验证
每个订单都会进行以下验证：
- 有效符号：必须在您的交易所上存在
- 当前价格：必须可获取（> 0）
- 数量计算：必须满足交易所的最低要求
- 杠杆限制：在交易所允许的范围内
🔧 故障排除
常见问题
❌ “未配置鲸鱼地址”
问题：tracking_addresses 列表为空
解决方案：