使用说明 - Hyperliquid Copy Trade

📋 第一步：准备工作

1.1 获取交易所 API 密钥

⚠️ 重要：本软件仅支持合约跟单，不支持现货。请确保你的 API 密钥有合约交易权限！

🔵 OKX 平台（推荐）：

登录 OKX，点击右上角头像 → 选择 "API"
点击 "创建 API" → 选择 "交易 API"
填写 API 名称（随便填，比如："跟单工具"）
权限设置（关键！）：
- ✅ 勾选：读取
- ✅ 勾选：交易（必须！）
- ❌ 不要勾选：提现（安全考虑）
IP 白名单（可选）：如果你知道服务器 IP，建议绑定，更安全
完成后，保存好这三个信息：
- API Key - 一串很长的字符
- Secret Key - 另一串很长的字符
- Passphrase - 你自己设置的密码

🟡 Binance 平台：

登录 Binance，点击右上角头像 → 选择 "API 管理"
点击 "创建 API" → 完成安全验证（邮箱/手机）
填写 API 标签（随便填，比如："跟单机器人"）
权限设置（关键！）：
- ✅ 勾选：启用合约交易（必须！）
- ❌ 不要勾选：启用现货交易（不支持）
- ❌ 不要勾选：提现（安全考虑）
IP 限制（可选）：可以限制只有你的服务器能用这个 API
完成后，保存好这两个信息：
- API Key - 一串很长的字符
- Secret Key - 另一串很长的字符

⚠️ 安全提示：

API 密钥就像银行卡密码，别人有了就能操作你的账户！
绝对不要分享给任何人（包括截图、发群）
建议绑定 IP 白名单，只有你的服务器能用
不要给提现权限！即使泄露也无法转走你的钱

1.2 找到优质的交易员地址

👉 打开这个网站：https://hyperbot.network/discover

💡 怎么选高手？看这几个指标：

胜率 (Win Rate) > 60% - 赢的比输的多
总交易 (Total Trades) > 100 笔 - 样本够多，不是运气好
最大回撤 (Max Drawdown) < 20% - 不会一次亏太多
总盈利 (PnL) > $50,000 - 总体赚钱能力强
最近还在盈利 - 说明他还在活跃

📋 操作步骤：
1️⃣ 在 HyperBot 网站上找到合适的交易员
2️⃣ 点击他的名字，进入详情页
3️⃣ 复制他的钱包地址（页面顶部，以 0x 开头的40个字符）
4️⃣ 把地址粘贴到配置文件里

⚙️ 第二步：填写配置文件

程序压缩包里已经有 config.yaml 文件，直接用记事本打开，按照里面的说明填写即可。

💡 如何打开配置文件？
1. 解压下载的压缩包
2. 找到 config.yaml 文件
3. 右键 → 用记事本打开
4. 按照文件里的注释填写你的信息

📝 配置文件说明（已内置详细注释）

配置文件中每个参数都有详细的说明和举例，这里列出核心参数：

1️⃣ 高手地址（必填！）

hyperliquid:
  target_addresses:
    - "0x你的高手地址"  # 在 https://hyperbot.network/ 找到高手后复制地址

2️⃣ 交易所 API（必填！）

OKX 用户：

target_exchange:
  name: "okx"
  okx:
    api_key: "你的API密钥"
    api_secret: "你的Secret密钥"
    passphrase: "你的Passphrase"
    is_demo: false  # true=模拟盘, false=真实盘

Binance 用户：

target_exchange:
  name: "binance"
  binance:
    api_key: "你的API密钥"
    api_secret: "你的Secret密钥"
    is_testnet: false  # true=测试网, false=主网

3️⃣ 跟单比例（重要！）

💡 multiplier - 跟单比例

• 高手下单 100 USDT，multiplier=0.1 → 你下单 10 USDT
• 高手下单 100 USDT，multiplier=1.0 → 你下单 100 USDT
• 简单算法：如果高手账户 10 万 u，你的账户 1000u，那就写 0.01

strategy:
  position_mode: "ratio"
  ratio:
    multiplier: 0.1      # 👈 跟单比例，建议从 0.1 开始
    min_amount: 10       # 最小跟单金额
    max_amount: 1000     # 单笔订单最大金额

4️⃣ 风险控制

risk_control:
  stop_loss:
    enabled: false            # 👈 建议关闭，让高手控制平仓
    percentage: 50.0          # 如果开启：单个订单亏损 50% 触发止损
  
  max_positions: 5            # 最多同时持有 5 个币种
  max_daily_trades: 200       # 每天最多 200 笔交易
  max_position_per_symbol: 10000   # 单币种总仓位上限
  max_total_position: 200000       # 所有币种总仓位上限

5️⃣ Web 管理界面

💡 如何访问？

• 本地电脑：浏览器打开 http://127.0.0.1:8080
• 服务器：浏览器打开 http://服务器IP:8080
• 默认账号：admin / admin123

web:
  enabled: true
  port: 8080
  username: "admin"
  password: "admin123"  # 👈 建议修改密码

⚠️ 重要提醒：

配置文件里每个参数都有详细的中文说明和举例，请仔细阅读
trade_type: "futures" 不要改，当前只支持合约跟单
止损功能 enabled: false 表示下面的参数不起作用
填写完成后记得保存文件！

🚀 第三步：运行程序

Windows 系统

双击 copytrade.exe 启动程序
程序会自动读取同目录下的 config.yaml
看到 "🚀 系统已启动" 提示即表示运行成功

Linux 系统

添加执行权限：chmod +x copytrade
运行程序：./copytrade
后台运行（可选）：nohup ./copytrade &

💡 程序启动后会显示广告信息和目标交易员的分析链接，您可以点击链接查看交易员的历史表现。

📊 第四步：Web 管理界面

程序运行后，可以通过浏览器访问 Web 管理界面。

👉 如何访问？

本地电脑运行：浏览器打开 http://127.0.0.1:8080 或 http://localhost:8080
服务器运行：浏览器打开 http://你的服务器IP:8080
默认账号：用户名 admin，密码 admin123 （建议修改）

📊 管理界面功能：

实时持仓 - 查看当前所有持仓状态和盈亏
交易记录 - 查看历史跟单记录
收益统计 - 查看盈亏情况和收益率
性能监控 - 查看系统运行状态

💡 提示：如果访问不了，检查防火墙是否允许 8080 端口。

🔧 高级功能

多目标跟单（当前版本暂不支持）

⚠️ 注意：当前版本（v1.0.0）仅支持跟随一个目标地址。多目标跟单功能将在后续版本推出。

配置文件示例：

hyperliquid:
  target_addresses:
    - "0x03b9a189e2480d1e4c3007080b29f362282130fa"  # 仅支持单个地址

币种过滤

只跟单特定币种（白名单模式）：

symbol_filter:
  mode: "whitelist"
  list: ["BTC-USDT", "ETH-USDT", "SOL-USDT"]

排除特定币种（黑名单模式）：

symbol_filter:
  mode: "blacklist"
  list: ["SHIB-USDT", "DOGE-USDT"]

自动止损止盈

程序会自动为每笔跟单设置止损止盈，保护您的资金安全。

⚠️ 注意事项

风险提示：加密货币交易存在风险，请谨慎操作
资金管理：建议从小金额开始测试
网络稳定：确保服务器网络稳定，避免错过交易信号
监控运行：定期查看程序运行状态和交易记录
API 安全：不要将 API 密钥暴露给他人