Skip to content
FalsifyLab FalsifyLab Alpha MCP

hl_vault_leaderboard

hl_vault_leaderboard

Hyperliquid vault leaderboard. Ranks active vaults by NAV, 30-day return, max drawdown, and composite score.

Signature

hl_vault_leaderboard({
  sort?: "nav" | "return_30d" | "score" | "drawdown",
  min_nav?: number,        // USD, default 50_000
  min_age_days?: number,   // default 30
  limit?: number,          // 1-100, default 10
})

Returns

[
  {
    "vault_address": "0x...",
    "leader": "0x...",
    "name": "Hummingbird Perp",
    "nav_usd": 4_280_000,
    "return_30d_pct": 14.2,
    "max_drawdown_30d_pct": 6.8,
    "sharpe_30d": 1.45,
    "follower_count": 312,
    "follower_pnl_usd": 184_000,
    "score": 0.78,
    "url": "https://app.hyperliquid.xyz/vaults/0x..."
  }
]

Example agent prompt

“list the top 5 HL vaults with >$1M NAV, sharpe > 1.0, max drawdown <10%.”

Why this exists

Hyperliquid’s UI surfaces vaults but the data is hard to programmatically query. This tool wraps the HL public API and adds:

  • Composite score: 0.4*return_norm + 0.3*sharpe_norm + 0.3*(1 - dd_norm)
  • Follower-PnL: how much following wallets made (proof of copyability)
  • Age gate: filter out brand-new vaults with no track record

Powers the Mongoose copy-trading bot — same data, same ranking.

Free tier

24h cached top-10 by score. Good for “what HL vaults are working right now” queries.

Pro tier

Real-time refresh. Full ranking (100 vaults). Filter by sort dim. 90-day history of NAV + returns for each vault.

See also