whale-index

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Whale Index — Auto-Mirror Top Discovery Traders

Whale Index — 自动镜像Discovery顶级交易员

Scan the Discovery leaderboard, score traders, create mirror strategies, and rebalance daily. Set your risk level and budget — the agent handles selection, allocation, monitoring, and swaps.
扫描Discovery排行榜,为交易员评分,生成镜像策略并每日再平衡。设置你的风险等级和预算即可,Agent会负责交易员筛选、资金分配、监控和更换操作。

5-Step Flow

5步流程

Step 1: Onboard the User

步骤1:用户初始化

Collect: budget, risk tolerance (conservative/moderate/aggressive).
BudgetSlots
$500-$2k2
$2k-$5k3
$5k-$10k4
$10k+5
Risk mapping:
RiskAllowed LabelsMax Leverage
ConservativeELITE only10x
ModerateELITE, RELIABLE15x
AggressiveELITE, RELIABLE, BALANCED25x
收集信息:预算、风险承受能力(保守/适中/激进)。
预算插槽数
$500-$2k2
$2k-$5k3
$5k-$10k4
$10k+5
风险映射:
风险等级允许标签最高杠杆
保守型仅ELITE10x
适中型ELITE, RELIABLE15x
激进型ELITE, RELIABLE, BALANCED25x

Step 2: Discover Traders

步骤2:筛选交易员

2a. Pull candidates:
discovery_top_traders(limit=50, timeframe="30d")
2b. Hard filters:
  • Consistency label matches risk level
  • Risk label matches risk level
  • Min 30d track record
  • Not already in user's portfolio
2c. Score remaining candidates:
score = 0.35 × pnl_rank + 0.25 × win_rate + 0.20 × consistency + 0.10 × hold_time + 0.10 × drawdown
All components normalized 0-100.
2d. Overlap check: Compare active positions across selected traders. Flag >50% position overlap.
2e. Allocation weighting: Score-weighted allocation with 35% cap per slot. Re-normalize after capping.
2a. 拉取候选名单:
discovery_top_traders(limit=50, timeframe="30d")
2b. 硬性过滤规则:
  • 一致性标签匹配风险等级
  • 风险标签匹配风险等级
  • 至少30天交易记录
  • 未出现在用户现有投资组合中
2c. 为剩余候选交易员评分:
score = 0.35 × pnl_rank + 0.25 × win_rate + 0.20 × consistency + 0.10 × hold_time + 0.10 × drawdown
所有评分维度均已归一化到0-100区间。
2d. 持仓重叠校验: 对比选中交易员的活跃持仓,标记持仓重叠度超过50%的组合。
2e. 资金分配权重: 按评分加权分配资金,每个插槽最高占比35%,封顶后重新归一化权重。

Step 3: Present & Confirm

步骤3:方案展示与确认

Show the user: trader address, rank, labels, win rate, allocation amount. Wait for approval before executing.
向用户展示:交易员地址、排名、标签、胜率、分配金额。执行操作前等待用户确认。

Step 4: Execute

步骤4:执行策略

For each slot:
  1. Create mirror strategy via
    strategy_create_mirror
  2. Set strategy-level stop loss (-10% conservative, -15% moderate, -25% aggressive)
  3. Confirm mirroring is active
对每个插槽依次操作:
  1. 通过
    strategy_create_mirror
    创建镜像策略
  2. 设置策略级止损(保守型-10%,适中型-15%,激进型-25%)
  3. 确认镜像策略已正常激活

Step 5: Daily Monitoring (Cron)

步骤5:每日监控(定时任务)

See references/daily-monitoring.md for the complete daily check procedure, swap criteria, and rebalance logic.
Swap criteria (ALL must be true):
  1. Degraded: dropped below rank 50 OR consistency fell OR inactive 48h+ OR drawdown 2× historical
  2. Sustained: WATCH status for 2+ consecutive days (tracked via
    watchCount
    )
  3. Better alternative: replacement scores ≥15% higher
  4. User's strategy-level SL not hit
Key principle: The 2-day watch period prevents churn from temporary dips.
完整的每日检查流程、更换标准和再平衡逻辑见references/daily-monitoring.md
更换交易员标准(需全部满足):
  1. 表现退化:排名掉出前50 OR 一致性下降 OR 超过48小时无活跃交易 OR 回撤达到历史水平的2倍
  2. 持续性确认:连续2天以上处于观察状态(通过
    watchCount
    追踪)
  3. 存在更优替代:备选交易员评分高出至少15%
  4. 未触发用户设置的策略级止损
核心原则: 2天观察期可避免因短期波动导致的频繁换仓。

Teardown

退出流程

To exit: close all mirror strategies, return funds to main wallet.
要终止所有策略:关闭所有镜像策略,将资金转回主钱包。

API Dependencies

API依赖

  • discovery_top_traders
    — trader leaderboard
  • strategy_create_mirror
    — create mirror strategy
  • strategy_get_clearinghouse_state
    — check positions
  • strategy_close_strategy
    — teardown
  • discovery_top_traders
    — 交易员排行榜
  • strategy_create_mirror
    — 创建镜像策略
  • strategy_get_clearinghouse_state
    — 检查持仓
  • strategy_close_strategy
    — 关闭策略

Fee Estimates

费用预估

Mirror strategies incur the same trading fees as the mirrored trader's activity. Budget ~0.5-1% daily in fees for active traders.
镜像策略的交易费率与被镜像交易员的交易费率一致。活跃交易员的每日费用预算约为总资金的0.5-1%。