Hyperliquid Trading Agent

核心功能

Hyperliquid Trading Agent 是一款面向 DeFi 衍生品交易的智能执行工具，通过聚合三类实时数据源构建复合交易信号：

• Smart Money 追踪：监控 500+ 分类钱包的持仓动向，计算多空比率与钱包集中度
• 多时间框架技术分析：整合 15m/1h/4h/1d 周期的 SuperTrend、RSI、MACD、EMA、布林带等指标
• 衍生品市场数据：实时获取资金费率、持仓量变化、多空比、清算热力图

信号权重默认配置为 SM 40% + TA 35% + 市场数据 25%，支持用户自定义调整。

显著优点

1. 全链路闭环：从信号生成、回测验证到实盘部署的完整工作流，30+ CLI 命令覆盖交易全生命周期
2. HIP-3 资产原生支持：可直接交易 TSLA、NVDA、GOLD、US500 等链上美股通证，采用 dex:COIN 格式隔离标识
3. HITL 人机协同：支持半自动模式，Agent 生成交易计划后推送 Telegram 待人工确认，降低误触发风险
4. 自学习引擎：每笔交易后反馈优化信号权重与执行参数

潜在局限

• Polymarket 限制：预测市场数据可读，但 Agent 创建与自动交易尚未开放
• HIP-3 成本劣势：手续费为普通永续合约 2 倍，需纳入止盈目标计算
• 杠杆-止损耦合约束：高杠杆场景强制最低止损比例（15x≥5%/10x≥4%/5x≥3%），限制策略灵活性
• 最小持仓时间：剥头皮策略 1h/其他策略 3h，禁止高频刷单
• 全量提现设计：agent-withdraw 仅支持全额 sweep，无法部分提取

适合人群

• 熟悉 Python CLI 操作的进阶 DeFi 交易者
• 希望系统化执行"跟单聪明钱"策略的量化用户
• 需要 7×24 监控 HIP-3 美股通证持仓的链上投资者
• 风险承受能力中高、能接受衍生品爆仓风险的投机型用户

常规风险

• 资金托管风险：USDC 需先桥接至 Hyperliquid 链上 vault，存在智能合约与桥接多重风险
• 信号滞后风险：巨鲸钱包数据非实时成交，存在 1-4h 延迟，极端行情下可能反向跟单
• API 密钥泄露：ZONEIN_API_KEY 为唯一鉴权凭证，泄露可导致资金损失
• 确认门槛误用：--confirm 为金融操作唯一闸门，误操作或社工攻击可绕过人工审核
• 地址 hallucination：Agent ID 与充值地址必须从当前 turn 的工具输出精确复制，记忆重构将导致永久丢币

核心用法

Hyperliquid Trading Agent 是一个面向 Hyperliquid 生态的自主交易技能，通过 CLI 工具 zonein.py 提供 30+ 条命令，覆盖三大核心场景：

1. 市场情报读取：实时追踪 500+ 鲸鱼钱包的聪明钱信号（Smart Money），结合多时间框架技术分析（15m/1h/4h/1d）与衍生品市场数据（资金费率、持仓变化、清算地图），生成复合 AI 评分信号。支持常规加密货币永续合约、HIP-3 资产（如 xyz:TSLA、xyz:NVDA、xyz:GOLD）以及 Polymarket 预测市场数据读取。

2. AI 交易 Agent 全生命周期管理：从创建、回测、部署到监控的完整工作流。用户通过自然语言描述交易风格（趋势跟踪、动量狩猎、均值回归等），系统自动推断 Agent 类型并配置触发条件、风险参数和执行模式（全自动 auto 或人机协同 hitl）。支持自定义触发条件 DSL，实现复杂策略逻辑。

3. 交易执行与风控：开仓、平仓、止损止盈调整、资金桥接、提现等操作均受 --confirm 程序化保护。HITL 模式下，Agent 生成交易计划后推送 Telegram 等待用户确认，2 小时内未响应自动过期。

显著优点

• 信号来源权威：聪明钱数据覆盖 500+ 分类钱包，技术分析接入 TAAPI.io，市场数据来自 CoinGlass，三方数据源交叉验证。
• 资产覆盖广泛：除主流加密货币外，原生支持 HIP-3 标准下的股票、大宗商品、指数类永续合约，实现"链上券商"体验。
• 安全机制严谨：金融命令强制 --confirm 门控、地址双重验证、响应字段截断、反提示词注入防御，代码仅依赖 Python 标准库，无供应链风险。
• 人机协同灵活：HITL 模式平衡自动化效率与人工风控，适合策略验证期；全自动模式满足成熟策略无人值守需求。
• 配置透明可审计：完整的参考文档体系（Commands、Data Sources、Trigger Conditions、Agent Config、Workflows），策略逻辑可回溯、可复现。

潜在缺点与局限性

• Polymarket 交易 Agent 未开放：当前仅支持 PM 数据读取，无法创建 PM 交易 Agent。
• 外部 API 单点依赖：全部功能依赖 mcp.zonein.xyz，服务可用性、数据中立性需持续信任。
• HIP-3 费用较高：2 倍标准费率，需纳入策略盈亏计算。
• 高杠杆与强平风险：15x 以上杠杆需 5%+ 止损，策略设计不当易导致快速清算。
• 提现限制：仅支持全额提现，无部分提现；必须先禁用 Agent 才能执行。
• 策略学习曲线：自定义触发条件需理解 DSL 语法，对非技术用户存在门槛。

适合的目标群体

• 量化交易者：希望将聪明钱信号纳入策略、需要多源数据复合验证的系统性交易者。
• Hyperliquid 生态用户：已在 Hyperliquid 交易，希望提升自动化水平的永续合约玩家。
• 链上股票/商品交易者：对 HIP-3 资产（TSLA、NVDA、GOLD 等）感兴趣，寻求链上敞口替代传统券商的用户。
• 风控优先的自动化尝试者：愿意从 HITL 模式起步、逐步验证策略后转向全自动的谨慎型用户。
• Polymarket 分析师：需要聚合预测市场信号、追踪聪明钱押注方向的研究者（交易功能待开放）。

使用风险

资金安全风险：尽管有 --confirm 保护，用户一旦确认即承担全部交易后果。信号仅反映历史聪明钱活动，不保证未来收益。建议首次使用小额测试，设置合理 --max-daily-loss 限额。

API 密钥泄露风险：密钥存储于内存和环境变量，共享环境或内存转储场景存在暴露可能。建议优先使用环境变量配置、定期轮换密钥、避免多用户系统运行。

外部服务中断风险：Zonein API 服务不可用时，Agent 将停止信号更新和交易执行。需关注官方状态公告，关键交易建议人工备份监控。

策略过拟合风险：回测表现不代表实盘收益，聪明钱信号可能滞后或反转。建议结合基本面判断，避免单一信号源依赖。

智能合约与跨链风险：资金桥接至 Hyperliquid 涉及跨链操作，HIP-3 资产由第三方 DEX 发行，需额外承担对应智能合约风险。